# OPC 培训系统代码（opc-training）

**云南省 OPC 培训课程体系的全部可运行代码**，源自 `培训计划/课程体系0.1`，现按「代码与内容分离」规范独立于此。

> 课程内容、模板、知识库、交付 SOP 等**非代码资料**在 `materials/培训计划/`。本目录只含可运行的代码与部署脚本。

## 组成

| 目录 | 说明 |
|------|------|
| `miniprogram/` | **C 端微信小程序**（Taro 3.6 + React 18，编译 weapp）。页面：首页 / 活动报名 / OPC 测评 / 政策 / 我的 等。 |
| `website/` | **三端 Web 应用**（Vite 5 + React 18，`opc-training-web`）。`src/user/` 对外 C 端、`src/platform/` 管理/报表、`src/data/` 内容数据。 |
| `server/` | **后端**（FastAPI + SQLite，uv 管理，`:8091`）。认证、活动报名/签到、OPC 测评引擎、政策/计划/调研。 |
| `sync-server.sh` | 后端部署同步脚本。 |

## 与课程内容的对应关系

- 三端架构、小程序↔网页同步约束：见 `materials/培训计划/课程体系0.1/三端架构设计.md`、`小程序同步约束.md`
- 产品规格与课程设计：见 `materials/培训计划/课程体系0.1/课程产品体系.md`、`课程设计/`
- 内容数据（测评题库等）与前端展示内容：见 `materials/培训计划/课程体系0.1/` 各内容目录

## 常用命令

```bash
# 小程序（Taro → 微信）
cd miniprogram && yarn dev:weapp

# 后端（uv）
cd server && uv run uvicorn app.main:app --port 8091 --reload

# 网站（Vite）
cd website && pnpm dev
```

> 上线说明与后端部署见各子目录 `README.md`。