selfrelease
505 lines
20 KiB
Markdown
505 lines
20 KiB
Markdown
# 2-task-RSMS-001：全国记者站管理系统开发任务文档
|
||
|
||
> 文档版本：v1.0
|
||
> 状态：待确认
|
||
> 编制日期：2026-08-01
|
||
> 项目缩写：RSMS
|
||
> 适用范围：V0.1 MVP 收尾 + V0.2 阶段
|
||
|
||
---
|
||
|
||
## 阶段 0：规范文档（前置，必须先完成）
|
||
|
||
- [x] TASK-DOC-001：创建 `pmdocs/` 目录结构（changes/、adr/）
|
||
- **目标**：建立 PM 文档存放规范
|
||
- **验收**：目录存在，CHANGELOG.md 已初始化
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-DOC-002：生成 `pmdocs/0-req-RSMS.md`（需求文档）
|
||
- **目标**：固化需求范围、角色定义、状态机、NFR、验收标准
|
||
- **映射**：REQ-AUTH~REQ-SYS, NFR-*, AC-*
|
||
- **验收**：文档已创建，内容覆盖全部 REQ 编号
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-DOC-003：生成 `pmdocs/1-prd-RSMS.md`（产品需求文档）
|
||
- **目标**：固化功能清单、UI/UX 规范、公共组件规划、版本规划
|
||
- **映射**：PRD-FUNC-001~018，SCENE-001~004
|
||
- **验收**：文档已创建，公共组件规划表已填充
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-DOC-004：生成本文档 `pmdocs/2-task-RSMS.md`
|
||
- **目标**：任务拆分、编号、依赖、验收标准
|
||
- **映射**：所有 REQ、PRD-FUNC
|
||
- **验收**：本文档已创建，所有任务有验收标准
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-DOC-005：创建 `run.md`（运行手册）
|
||
- **目标**：固化安装、启动、构建、迁移命令
|
||
- **依赖**：TASK-DOC-004
|
||
- **验收**：`run.md` 存在且所有命令可执行
|
||
- **状态**：已完成
|
||
|
||
---
|
||
|
||
## 阶段 1：前端模块化重构
|
||
|
||
### 1.1 架构重构
|
||
|
||
- [x] TASK-FE-001：创建前端目录结构
|
||
- **目标**：将单文件 `App.tsx` 拆分为模块化目录
|
||
- **依赖**：TASK-DOC-005（run.md 中的构建命令验证）
|
||
- **验收**：目录结构创建完成，import 路径调整后应用能正常启动
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-002：抽取 Layout 组件
|
||
- **目标**：`PageLayout`、`Sidebar`、`TopBar` 独立
|
||
- **验收**：`App.tsx` 中 Layout 部分替换为 `<PageLayout>`，功能行为不变
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-003：抽取 UI 基础组件
|
||
- **目标**：`StatusBadge`、`EmptyState`、`LoadingBar` 独立为文件
|
||
- **验收**：各组件独立导出，App.tsx 中的内联版本替换为 import
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-004：抽取 PageHeading / PanelHeader / MetricCard
|
||
- **目标**：复用组件独立文件
|
||
- **验收**：复用点替换为 import，Props 接口独立导出
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-005：抽取数据展示组件
|
||
- **目标**：`RecordTable`（含 `review` / `compact` 模式）独立
|
||
- **验收**：工作记录页、审核中心、档案页均使用同一组件
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-006：抽取领域组件
|
||
- **目标**：`CreateRecordModal`、`RecordDrawer` 独立为 `modals/` 文件
|
||
- **验收**：新建和详情交互行为与重构前一致
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-007：抽取页面组件
|
||
- **目标**：每个页面（Dashboard / WorkList / ReviewCenter / People / Stations / Archive / Notices）独立文件
|
||
- **验收**：`App.tsx` 变为路由级条件渲染，所有页面功能可用
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-009：创建 Context（角色与 Toast）
|
||
- **目标**：`RoleContext` 管理当前角色，`ToastContext` 管理全局提示
|
||
- **验收**：全局 Toast 正常工作，角色切换后所有页面响应正确
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-010：抽取 FilterBar 组件
|
||
- **目标**：`FilterBar`（搜索 + 筛选下拉 + 重置）抽象为可复用组合组件
|
||
- **验收**：工作记录页和人员管理页使用同一 FilterBar
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-011：抽取 Pagination 组件
|
||
- **目标**：分页组件（当前 MVP 暂不使用，但预留）
|
||
- **验收**：组件存在，数据量大时分页可用
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-012：样式模块化
|
||
- **目标**：将 `styles.css` 按组件/页面拆分，引入 CSS 变量文件
|
||
- **验收**：构建后样式与重构前一致，无布局错位
|
||
- **状态**：已完成
|
||
|
||
- [x] TASK-FE-013：构建验证
|
||
- **目标**：`npm run build` 通过，`npm run lint` 无错误
|
||
- **依赖**：TASK-FE-001 ~ TASK-FE-012 全部完成
|
||
- **验收**：构建产物正常，dist/ 输出正确
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
### 1.2 功能增强
|
||
|
||
- [x] TASK-FE-014：人员管理增删改
|
||
- **目标**：总部可新增/编辑/停用人员；分站可编辑本站人员
|
||
- **映射**：REQ-USER-001, REQ-USER-002
|
||
- **依赖**：TASK-BE-006
|
||
- **验收**：
|
||
- 总部管理员可新增人员，填写姓名/站点/职务/入站时间后保存成功
|
||
- 编辑后数据持久化，再次查询反映最新值
|
||
- 停用后该人员不可登录（后端权限拦截）
|
||
- **优先级**：P0
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-FE-015：记者站管理增删改
|
||
- **目标**：总部可新增/编辑/停用记者站
|
||
- **映射**：REQ-ORG-001, REQ-ORG-002
|
||
- **依赖**：TASK-BE-007
|
||
- **验收**：
|
||
- 总部管理员可新增站点，填写名称/编码/地区/负责人后保存成功
|
||
- 站点列表反映最新数据
|
||
- **优先级**：P1
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-FE-016：通知公告发布
|
||
- **目标**：总部可发布带附件的通知；用户可查看已读状态
|
||
- **映射**：REQ-NOTICE-003, REQ-NOTICE-004
|
||
- **依赖**：TASK-BE-008
|
||
- **验收**：
|
||
- 总部可创建通知，选择接收范围（全部/站点/角色）
|
||
- 通知列表显示已读/未读统计
|
||
- 重要通知需确认回执
|
||
- **优先级**：P1
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-FE-017：个人中心
|
||
- **目标**：用户查看/编辑个人资料、修改密码（模拟）
|
||
- **映射**：REQ-HOME-004
|
||
- **验收**：个人资料页正常展示和编辑
|
||
- **优先级**：P2
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
---
|
||
|
||
## 阶段 2：后端扩展
|
||
|
||
### 2.1 API 扩展
|
||
|
||
- [x] TASK-BE-001：人员 CRUD API
|
||
- **目标**：新增 `GET/POST /api/people`、`PATCH /api/people/:id`、`DELETE /api/people/:id`
|
||
- **映射**：REQ-USER-001~003
|
||
- **依赖**：TASK-BE-005（数据库迁移）
|
||
- **接口契约**：
|
||
- `GET /api/people?station=&status=` → 按站点和状态筛选
|
||
- `POST /api/people` → body: `{ name, station, title, phone, joinedAt }`
|
||
- `PATCH /api/people/:id` → body: `{ title?, status?, phone? }`
|
||
- **验收**：curl 测试全部接口返回正确状态码和数据
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-002：记者站 CRUD API
|
||
- **目标**：新增 `GET/POST /api/stations`、`PATCH /api/stations/:id`
|
||
- **映射**：REQ-ORG-001, REQ-ORG-002
|
||
- **依赖**：TASK-BE-005
|
||
- **验收**：同上
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-003：通知公告 API
|
||
- **目标**：新增 `GET/POST /api/notices`、`PATCH /api/notices/:id`、`GET /api/notices/:id/receipts`
|
||
- **映射**：REQ-NOTICE-001~004
|
||
- **验收**：
|
||
- 总部发布通知后，其他角色可见
|
||
- 已读回执记录正确
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-004：数据统计 API
|
||
- **目标**：新增 `GET /api/stats/overview`、`GET /api/stats/records`、`GET /api/stats/scores`
|
||
- **映射**：REQ-STAT-001~003
|
||
- **验收**：
|
||
- 总部返回全国维度统计
|
||
- 分站返回本站维度统计
|
||
- 记者返回本人维度统计
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-005：数据库迁移脚本
|
||
- **目标**：将 inline schema 改为独立 migration 文件 + runner
|
||
- **依赖**：无
|
||
- **验收**：
|
||
- `npm run db:migrate` 执行成功
|
||
- `npm run db:seed` 可重新初始化数据
|
||
- `npm run db:reset` 清空后重新迁移
|
||
- **优先级**：P0
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
### 2.2 数据库迁移
|
||
|
||
- [x] TASK-BE-006：`people` 表迁移
|
||
- **文件**：`migrations/003_create_people.sql`
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-007：`stations` 表迁移
|
||
- **文件**：`migrations/004_create_stations.sql`
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-008：`notices` 和 `notice_receipts` 表迁移
|
||
- **文件**：`migrations/005_create_notices.sql`
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-BE-009：`audit_logs` 表索引优化
|
||
- **文件**：`migrations/006_optimize_indexes.sql`
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
### 2.3 后端测试
|
||
|
||
- [x] TASK-BE-010：API 接口集成测试
|
||
- **目标**：使用 Node.js + Jest/Supertest 对核心接口写集成测试
|
||
- **覆盖**：
|
||
- 角色隔离（headquarters / station / reporter 查询结果不同）
|
||
- 审核状态流转（draft→station_review→headquarters_review→archived）
|
||
- 退回重提交
|
||
- **验收**：测试全部通过，CI 环境可运行
|
||
- **优先级**：P1（不影响 MVP 上线）
|
||
- **状态**：已完成（2026-08-01）—— 34 项测试全部通过
|
||
|
||
---
|
||
|
||
## 阶段 3：考核规则配置（V0.2）
|
||
|
||
- [x] TASK-RULE-001：考核规则数据模型
|
||
- **目标**：新增 `rules`、`rule_items`、`scores` 表
|
||
- **字段**：规则 ID、版本、指标、计分公式、上限/下限、生效时间
|
||
- **验收**：规则可 CRUD，变更历史可查
|
||
- **状态**：已完成（2026-08-01）—— 迁移 007/008 已执行
|
||
|
||
- [x] TASK-RULE-002：规则可视化配置界面
|
||
- **目标**：总部可在后台配置考核规则
|
||
- **验收**：配置发布后，新提交记录使用新规则计分
|
||
- **状态**：已完成（2026-08-01）—— RulesPage、CreateRuleModal 已完成
|
||
|
||
- [x] TASK-RULE-003：规则试算
|
||
- **目标**：规则变更前用历史数据试算，输出预估得分变化
|
||
- **验收**：试算结果可展示，不影响实际数据
|
||
- **状态**：已完成（2026-08-01）—— scores/compute API 已实现试算逻辑
|
||
|
||
- [x] TASK-RULE-004：后端 rules/scores API
|
||
- **目标**：rules CRUD、activate；scores 查询、计算触发
|
||
- **验收**：54 项集成测试全部通过
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-005：前端考核配置页面
|
||
- **目标**：RulesPage（列表+创建+编辑+激活）；ScoresPage（评分结果+明细弹窗）
|
||
- **验收**：tsc + vite build 通过，V0.2 新增 API 已接入
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-008：集成测试（rules/scores API）
|
||
- **验收**：54 项测试全部通过
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-010：前端构建验证
|
||
- **验收**：`npm run build` 通过（tsc + vite build）
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-011：考核配置前端优化
|
||
- **目标**：规则预览 Drawer、指标试算交互、评分排行页面
|
||
- **验收**：RulesPage 含规则预览 Drawer + 试算评分；LeaderboardPage 完整
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-006：个人中心接入考核数据
|
||
- **目标**：当前登录记者/站点查看个人考核得分与排名
|
||
- **验收**：个人中心展示考核卡片，接入 stats/scores API
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-RULE-007：积分排行榜
|
||
- **目标**：全站记者/站点考核得分排名
|
||
- **验收**：LeaderboardPage 按记者/站点分组排行，切换周期
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
---
|
||
|
||
## 阶段 4：ADR 架构决策
|
||
|
||
- [x] TASK-ADR-001：生成 ADR-001（技术栈选型）
|
||
- **目标**：记录 React+Vite+Express+SQLite 选型理由
|
||
- **内容**：备选方案、最终决策、权衡分析
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
- [x] TASK-ADR-002：生成 ADR-002（认证方案）
|
||
- **目标**：记录角色模拟方案及升级路径
|
||
- **内容**：当前方案（header 传参）、二期目标（JWT+真实认证）
|
||
- **风险**：header 可被伪造，仅适合内部演示
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
---
|
||
|
||
## 阶段 5：`run.md` 创建
|
||
|
||
- [x] TASK-DOC-005：创建 `run.md`
|
||
- **目标**：固化所有运行、构建、迁移、测试命令
|
||
- **依赖**：TASK-BE-005（数据库迁移脚本完成）
|
||
- **内容**：
|
||
- 技术栈清单（Node.js >=18, npm, SQLite）
|
||
- 安装命令：`npm install`
|
||
- 开发命令：`npm run dev`（全栈）、`npm run web`（仅前端）、`npm run server`（仅后端）
|
||
- 构建命令：`npm run build`
|
||
- Lint：`npm run lint`
|
||
- 数据库：`npm run db:migrate` / `db:seed` / `db:reset`
|
||
- 环境变量：`API_PORT`（默认 8787）
|
||
- 端口清单：Vite:5173, API:8787
|
||
- 常见问题：
|
||
- 端口占用处理
|
||
- SQLite WAL 文件说明
|
||
- 前端热重载说明
|
||
- **验收**：`run.md` 存在，新人按文档可启动完整项目
|
||
- **状态**：已完成（2026-08-01）
|
||
|
||
---
|
||
|
||
## 任务依赖关系图
|
||
|
||
```
|
||
TASK-DOC-004 ──▶ TASK-DOC-005
|
||
│
|
||
TASK-BE-005 ──┬──▶ TASK-FE-001 ──▶ TASK-FE-002 ──▶ TASK-FE-003 ──▶ TASK-FE-004
|
||
│ │
|
||
│ ▼
|
||
│ TASK-FE-005 ──▶ TASK-FE-006 ──▶ TASK-FE-007
|
||
│ │
|
||
│ ▼
|
||
│ TASK-FE-008 ──▶ TASK-FE-009 ──▶ TASK-FE-010
|
||
│ │ │
|
||
│ ▼ ▼
|
||
│ TASK-FE-011 ──▶ TASK-FE-012 ──▶ TASK-FE-013
|
||
│
|
||
├──▶ TASK-BE-001 ──▶ TASK-FE-014
|
||
├──▶ TASK-BE-002 ──▶ TASK-FE-015
|
||
├──▶ TASK-BE-003 ──▶ TASK-FE-016
|
||
├──▶ TASK-BE-004
|
||
├──▶ TASK-BE-006
|
||
├──▶ TASK-BE-007
|
||
├──▶ TASK-BE-008
|
||
└──▶ TASK-BE-009
|
||
|
||
TASK-BE-010 ──（并行，不阻塞主要流程）
|
||
|
||
TASK-ADR-001, TASK-ADR-002 ──（随时可做）
|
||
```
|
||
|
||
---
|
||
|
||
## 优先级排序（建议执行顺序）
|
||
|
||
### 第一梯队（P0，必须完成）
|
||
|
||
1. `TASK-DOC-004` — 确认任务文档（本任务）
|
||
2. `TASK-DOC-005` — 创建 `run.md`
|
||
3. `TASK-FE-001` — 前端目录结构
|
||
4. `TASK-FE-002` — Layout 组件
|
||
5. `TASK-FE-005` — RecordTable 抽取
|
||
6. `TASK-FE-006` — CreateRecordModal / RecordDrawer 抽取
|
||
7. `TASK-FE-007` — 页面组件拆分
|
||
8. `TASK-FE-013` — 构建验证
|
||
|
||
### 第二梯队（P1，MVP 完善）
|
||
|
||
9. `TASK-FE-014` — 人员管理增删改
|
||
10. `TASK-BE-005` — 数据库迁移脚本
|
||
11. `TASK-BE-006` — people 表迁移
|
||
12. `TASK-BE-001` — 人员 CRUD API
|
||
13. `TASK-BE-007` — stations 表迁移
|
||
14. `TASK-BE-002` — 记者站 CRUD API
|
||
15. `TASK-FE-015` — 记者站管理页面
|
||
16. `TASK-BE-008` — notices 表迁移
|
||
17. `TASK-BE-003` — 通知公告 API
|
||
18. `TASK-FE-016` — 通知发布页面
|
||
19. `TASK-BE-009` — 索引优化
|
||
|
||
### 第三梯队（P1/P2，增强功能）
|
||
|
||
20. `TASK-BE-004` — 数据统计 API
|
||
21. `TASK-FE-010` — FilterBar 抽取
|
||
22. `TASK-FE-011` — Pagination 抽取
|
||
23. `TASK-FE-017` — 个人中心
|
||
24. `TASK-BE-010` — 后端集成测试
|
||
25. `TASK-ADR-001` — ADR-001 补录
|
||
26. `TASK-ADR-002` — ADR-002 创建
|
||
|
||
### 第四梯队（V0.2 考核规则）
|
||
|
||
> 关联变更文档：`pmdocs/changes/2026-08-01-001-V0.2考核规则配置.md`
|
||
> 依赖：V0.1 MVP 全部完成（TASK-BE-010 集成测试通过）
|
||
|
||
**阶段 A：数据模型与迁移**
|
||
|
||
27. `TASK-RULE-001` — 创建 rules / rule_items 表（migration 007）
|
||
- 目标：新增 `rules`（考核规则）和 `rule_items`（指标项）两张表
|
||
- 需求：CHG-20260801-001 四维度指标数据模型
|
||
- 验收标准：migration 可执行，rollback 可逆，字段符合设计文档
|
||
- 依赖：TASK-BE-005（迁移框架）
|
||
- 阶段：A
|
||
|
||
28. `TASK-RULE-002` — 创建 scores 表（migration 008）
|
||
- 目标：新增 `scores`（评分结果）表，关联 rules / work_records
|
||
- 需求：CHG-20260801-001 评分结果存储
|
||
- 验收标准：migration 可执行，rollback 可逆，索引正确
|
||
- 依赖：TASK-RULE-001
|
||
- 阶段：A
|
||
|
||
29. `TASK-RULE-003` — 插入默认考核指标模板（migration 009 / seed）
|
||
- 目标：seed 默认考核指标模板（6 个指标覆盖数量/质量/时效/合规四维度）
|
||
- 需求：CHG-20260801-001 默认指标映射
|
||
- 验收标准：seed 数据可查询，`rules` 表有 1 条草稿状态记录
|
||
- 依赖：TASK-RULE-001
|
||
- 阶段：A
|
||
|
||
**阶段 B：后端 API**
|
||
|
||
30. `TASK-RULE-004` — 规则 CRUD API
|
||
- 目标：实现 `/api/rules`（列表）、`/api/rules/:id`（详情）、`POST`（创建）、`PATCH`（更新）、`POST /api/rules/:id/activate`（激活）
|
||
- 需求：CHG-20260801-001 API 接口规划
|
||
- 验收标准：headquarters 角色可操作，激活后旧版本自动归档
|
||
- 依赖：TASK-RULE-001
|
||
- 阶段：B
|
||
|
||
31. `TASK-RULE-005` — 评分 API + 自动计算引擎
|
||
- 目标：实现 `/api/scores`（列表/详情）、`POST /api/scores/compute`（触发计算）
|
||
- 需求：CHG-20260801-001 评分计算流程（指标聚合 → 加权求和 → 结果记录）
|
||
- 验收标准：手动触发可对指定记者/站点/周期计算总分及维度分
|
||
- 依赖：TASK-RULE-002, TASK-RULE-003
|
||
- 阶段：B
|
||
|
||
**阶段 C：前端**
|
||
|
||
32. `TASK-RULE-006` — 考核规则管理页面
|
||
- 目标：总部角色可查看规则列表、创建规则（含指标项编辑）、激活规则
|
||
- 需求：CHG-20260801-001 前端配置界面
|
||
- 验收标准：规则列表/编辑器/激活流程完整，加载+空态+错误状态覆盖
|
||
- 依赖：TASK-RULE-004
|
||
- 阶段：C
|
||
|
||
33. `TASK-RULE-007` — 评分结果查看页面
|
||
- 目标：总部可按记者/站点/周期查看评分结果，含各维度得分明细
|
||
- 需求：CHG-20260801-001 评分结果展示
|
||
- 验收标准：表格+筛选+分页完整，评分明细可展开
|
||
- 依赖：TASK-RULE-005
|
||
- 阶段：C
|
||
|
||
**阶段 D：集成与文档**
|
||
|
||
34. `TASK-RULE-008` — 考核规则 API 集成测试
|
||
- 目标：Jest + Supertest 覆盖 rules/scores 全部 API 端点
|
||
- 验收标准：覆盖率 > 90%，角色权限隔离验证
|
||
- 依赖：TASK-RULE-004, TASK-RULE-005
|
||
- 阶段：D
|
||
|
||
35. `TASK-RULE-009` — `run.md` 更新（V0.2 数据库结构 + API）
|
||
- 目标：补充 V0.2 新增表结构、API 接口到 `run.md`
|
||
- 依赖：TASK-RULE-001, TASK-RULE-002, TASK-RULE-004, TASK-RULE-005
|
||
- 阶段：D
|
||
|
||
36. `TASK-RULE-010` — 前端构建验证
|
||
- 目标：`npm run build` 通过，无新增 lint 错误
|
||
- 依赖：TASK-RULE-006, TASK-RULE-007
|
||
- 阶段：D
|
||
|
||
---
|
||
|
||
## 测试策略
|
||
|
||
| 任务 | 测试类型 | 工具 | 覆盖目标 |
|
||
|---|---|---|---|
|
||
| TASK-FE-013 | 构建验证 | `npm run build` | 编译通过，类型正确 |
|
||
| TASK-FE-001~012 | 回归测试 | 手工 | 重构后所有交互行为不变 |
|
||
| TASK-BE-001~004 | 集成测试 | Jest + Supertest | 接口状态码、权限隔离、数据正确性 |
|
||
| TASK-BE-005~009 | 数据库测试 | 手工 + SQL | migration 可执行、seed 正确 |
|
||
| TASK-RULE-008 | 集成测试 | Jest + Supertest | rules/scores API，覆盖率 > 90% |
|
||
| TASK-RULE-010 | 构建验证 | `npm run build` | V0.2 前端编译通过 |
|
||
|
||
---
|
||
|
||
## 进度记录
|
||
|
||
| 日期 | 完成任务 | 备注 |
|
||
|---|---|---|
|
||
| 2026-08-01 | TASK-DOC-001~003 | 规范文档目录和 CHANGELOG 已创建 |
|
||
| 2026-08-01 | TASK-DOC-002 | `pmdocs/0-req-RSMS.md` 已创建 |
|
||
| 2026-08-01 | TASK-DOC-003 | `pmdocs/1-prd-RSMS.md` 已创建 |
|
||
| 2026-08-01 | TASK-DOC-004 | `pmdocs/2-task-RSMS.md` 已创建 |
|
||
| 2026-08-01 | TASK-FE-001~007, TASK-FE-009~012 | 前端模块化重构完成，构建验证通过（2026-08-01） |
|
||
| 2026-08-01 | TASK-DOC-005 | `run.md` 已创建 |
|
||
| 2026-08-01 | TASK-BE-005~009 | 数据库迁移框架 + 6 个迁移文件 + `db:seed` 命令已验证通过 |
|
||
| 2026-08-01 | TASK-BE-001~004 | 人员 CRUD、记者站 CRUD、通知公告、数据统计 API 已完成 |
|
||
| 2026-08-01 | TASK-FE-014~017 | 人员管理、记者站管理、通知公告、个人中心页面 API 接入完成 |
|
||
| 2026-08-01 | TASK-ADR-001~002 | 技术栈选型 ADR、认证方案 ADR 已补录完成 |
|
||
| 2026-08-01 | TASK-BE-010 | 后端集成测试 34 项全部通过（Jest + Supertest，覆盖角色隔离、审核流转、CRUD） |
|
||
| 2026-08-01 | TASK-RULE-001~010 | V0.2 考核规则任务文档已细化，关联 CHG-20260801-001 |
|
||
| 2026-08-01 | TASK-RULE-001~003, RULE-004~005 | V0.2 考核规则后端 API + 前端页面已完成，集成测试 54 项全部通过，构建验证通过 |
|
||
| 2026-08-01 | TASK-RULE-009 | `run.md` 已更新（测试命令、迁移管理、V0.2 表结构与 API 文档） |
|
||
| 2026-08-01 | TASK-RULE-006/011 | 个人中心接入考核数据 + 考核配置前端优化（含规则预览 Drawer + 试算评分 + LeaderboardPage） | |