添加一页PPT总结：突出目的与意义

run.md

@@ -0,0 +1,183 @@
+# College AI Center — 启动与调试指南
+
+## 项目结构
+
+- **后端**：`/` 根目录，NestJS + TypeORM（可选 PostgreSQL）
+- **前端**：`web/` 目录，Next.js + Tailwind CSS
+- **四个新模块**：轮转见习、技能视频、执业医师备考、学术交流
+
+---
+
+## 环境准备
+
+复制环境变量模板并按需修改：
+
+```bash
+cp .env.example .env
+```
+
+### 核心环境变量（`.env`）
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `APP_PORT` | 后端服务端口 | `3000` |
+| `NODE_ENV` | 运行环境 | `development` |
+| `DB_ENABLED` | 是否启用 PostgreSQL 持久化 | `false` |
+| `JWT_SECRET` | JWT 签名密钥 | `college-ai-center-dev-secret-change-me` |
+| `JWT_EXPIRES_IN_SECONDS` | Token 有效期（秒） | `7200` |
+| `DB_HOST` / `DB_PORT` / `DB_USERNAME` / `DB_PASSWORD` / `DB_DATABASE` | PostgreSQL 连接 | 见 `.env.example` |
+| `DB_SYNCHRONIZE` | 自动同步数据库结构（仅开发） | `false` |
+| `DB_LOGGING` | SQL 日志 | `false` |
+
+> **提示**：`DB_ENABLED=false` 时所有模块使用内存实现，无需安装 PostgreSQL，适合本地快速启动和测试。
+
+---
+
+## 安装依赖
+
+### 后端
+
+```bash
+npm install
+```
+
+### 前端
+
+```bash
+cd web && npm install
+```
+
+---
+
+## 启动命令
+
+### 1. 启动后端（开发模式，带热重载）
+
+```bash
+npm run start:dev
+```
+
+后端运行在 `http://localhost:3000`，API 前缀为 `/api/*`。
+
+### 2. 启动前端（开发模式）
+
+```bash
+cd web && npm run dev
+```
+
+前端运行在 `http://localhost:4100`。
+
+### 3. 一键同时启动前后端（后台运行）
+
+```bash
+# 在项目根目录执行
+# 1. 启动后端（后台）
+nohup npm run start:dev > backend.log 2>&1 &
+
+# 2. 启动前端（后台）
+cd web && nohup npm run dev > ../frontend.log 2>&1 &
+```
+
+停止后台进程：
+```bash
+# 查找并停止后端（NestJS）
+pkill -f "nest start"
+
+# 查找并停止前端（Next.js）
+pkill -f "next dev"
+```
+
+### 4. 生产构建
+
+```bash
+# 后端构建
+npm run build
+
+# 前端构建
+cd web && npm run build
+```
+
+---
+
+## 数据库连接（可选）
+
+如需启用 PostgreSQL 持久化：
+
+1. 确保本地 PostgreSQL 已启动。
+2. 在 `.env` 中设置：
+
+```env
+DB_ENABLED=true
+DB_HOST=localhost
+DB_PORT=5432
+DB_USERNAME=postgres
+DB_PASSWORD=postgres
+DB_DATABASE=college_ai_center
+DB_SYNCHRONIZE=true
+```
+
+3. 重启后端：`npm run start:dev`
+
+TypeORM 会在启动时自动建表（`DB_SYNCHRONIZE=true`）。
+
+### 新模块数据库实体
+
+- `exam_records` — 执业医师备考答题记录（`src/modules/exam-prep/entities/exam-record.entity.ts`）
+
+---
+
+## 新模块 API 端点
+
+| 模块 | 端点 | 方法 | 说明 |
+|------|------|------|------|
+| **轮转见习** | `/api/rotation/records` | `GET` | 列出轮转记录 |
+| | `/api/rotation/records` | `POST` | 新增轮转记录 |
+| **技能视频** | `/api/skill-videos` | `GET` | 搜索技能视频 |
+| **执业医师备考** | `/api/exam-prep/questions/generate` | `POST` | 生成试题（支持 `builtin` / `ai` / `auto` 模式） |
+| | `/api/exam-prep/questions/:id/answer` | `POST` | 提交答案 |
+| | `/api/exam-prep/stats` | `GET` | 获取备考统计 |
+| | `/api/exam-prep/history` | `GET` | 查看答题历史 |
+| | `/api/exam-prep/history/:recordId` | `DELETE` | 删除单条记录 |
+| | `/api/exam-prep/history` | `DELETE` | 清空全部记录 |
+| **学术交流** | `/api/academic/records` | `GET` | 列出交流记录 |
+| | `/api/academic/records` | `POST` | 新增交流记录 |
+
+---
+
+## 学生端前端路由
+
+| 路径 | 模块 |
+|------|------|
+| `/student/rotation` | 轮转见习 |
+| `/student/skill-video` | 技能视频 |
+| `/student/exam-prep` | 执业医师备考 |
+| `/student/academic` | 学术交流 |
+
+---
+
+## 常见问题
+
+### 1. 后端启动报错 `找不到模块 @nestjs/common`
+
+确保已执行根目录的 `npm install`。
+
+### 2. 前端无法连接后端 API
+
+确认后端已启动，且前端 `.env` 中（如有）的 API 地址正确。开发模式下前端通过代理或直连 `localhost:3000`。
+
+### 3. 数据库表未自动创建
+
+检查 `.env` 中 `DB_ENABLED=true` 且 `DB_SYNCHRONIZE=true`，然后重启后端。
+
+### 4. 答题历史未持久化
+
+确认 `DB_ENABLED=true` 并重启后端；否则数据仅保存在进程内存中，重启即丢失。
+
+---
+
+## Git 提交
+
+```bash
+git add -A
+git commit -m "你的提交信息"
+```