Refactor code structure and optimize performance across multiple modules

2026-08-23 12:23:34 +08:00
parent 490722a20e
commit ada6383e49
2547 changed files with 1071 additions and 223062 deletions
@@ -0,0 +1,43 @@
+# OPC 培训站（website）
+
+> 📍 工作区位置：`code/opc-training/website/`（培训系统代码）。课程内容见 `materials/培训计划/`；关联后端 `../server/`、小程序 `../miniprogram/`。
+
+课程体系 0.1 的对外展示与内部运营站。React + Vite SPA，暗色粒子品牌语言。
+
+## 运行方式
+
+```bash
+npm install
+npm run dev        # 开发（含 /api 模拟认证）
+npm run build      # 构建 dist
+npm run preview    # 预览构建产物（含 /api 模拟认证）
+node server/start.mjs   # 独立服务：托管 dist + /api（默认 8091，生产/演示用）
+```
+
+## 路由与权限
+
+| 路由 | 内容 | 权限 |
+|------|------|------|
+| `#/` | 首页营销落地页 | 公开 |
+| `#/opc-test` | OPC 创业基因测评 | 公开 |
+| `#/pine` 及 `#/pine/*` | 内部工具（课程体系/结构/课程表/卡片/工具） | 需登录 |
+
+**内部工具登录**：访问 `#/pine/*` 时路由守卫触发登录门。账号 `pine` / 密码 `123456`（**模拟**，见下）。
+
+内部工具**不进公开导航**，仅通过 URL 直达；公开导航只含「首页 / OPC测评」。
+
+## 模拟认证与迁移
+
+- 模拟接口：`server/mock-api.mjs`（`POST /api/auth/login`、`POST /api/auth/logout`、`GET /api/auth/verify`），账号密码暂时写死 `pine/123456`。
+- 已挂载到 Vite dev / preview / 独立服务三处。
+- **迁移为真实 API**：只需改 `src/services/auth.js` 顶部的 `API_BASE` 指向真实后端，并替换 `server/` 下的 mock 实现即可；SPA 其余代码无需改动。
+
+## 目录速览
+
+```
+server/           模拟认证 API + 独立启动服务
+src/pages/        页面（Home/OPCTest 公开；System/Structures/Schedule/Cards/Tools 内部）
+src/data/         内容数据（home/system/structures/schedule/cards/timetable/opcTest/site）
+src/components/   原子/分子/组织/模板组件
+src/services/     auth 认证服务
+```