5.9 KiB
5.9 KiB
一期批次1 组织人事底座（F01~F17）设计定稿 —— agent.develop 开发过程记录
- 迭代：人事系统-初始迭代（批次1：组织人事底座 + 系统管理与权限基座）
- 阶段：agent.develop（设计评审定稿 → 开发基线）
- 需求基线：SRS v3.1（
docs/00-requirement/requirement-spec.md）+iteration1-function-detail.md（F01F15，81 条）+12）approved-features.md（FEAT-B1-01 - 技术口径：ocai 规范 —— bricks + dspy 前端 / ahserver(Python) 后端 / apppublic/sqlor(MariaDB，库 hrs) / 应用 hr-web
- 归档：交付件正本在
deliverables/agent.develop/；设计基线文档在docs/01-design/（git 已推送）
1. 阶段目标与结论
目标：对 agent.design 产出的 4+2 份设计文档完成评审修订与定稿，形成可直接驱动 T01~T27 开发任务的契约基线。
结论：设计定稿通过，基线冻结。设计文档 6 份共 143,521B，与 SRS v3.1 完全对齐：F01~F17（17 功能，90 条验收项）、49 张业务表、112 个业务端点（另有 CRUD 自动生成端点族）、32 条 UI 路由、D1/D3/D4/D9/扫码入职/考勤与绩效桩位降级方案与二期预留均已覆盖。
2. 评审修订记录（与 SRS v3.1 对齐的差异项）
| # | 评审发现 | 修订动作 | 落点 |
|---|---|---|---|
| 1 | 批次1范围由原 F01~F15（81 条）扩入 FEAT-B1-10 编制管理、FEAT-B1-11 项目式组织 | 新增 F16 编制管理（6 条）、F17 项目式组织（3 条），验收项合计 81→90 | feature-list.md §1；architecture.md §0 |
| 2 | 表数量口径原为 43 张，未含编制/项目式/开放接口预留表 | 扩为 49 张：新增 org_headcount_scheme/headcount_item/headcount_snapshot/org_project/org_project_post/sys_openapp 共 6 张 | database-design.md §4 |
| 3 | 技术口径原写"部署端口 8000"类旧值 | 统一 9182（测试+生产）、MariaDB 库 hrs、systemd 管理、mysqldump 每日备份 ≥30 天 | architecture.md §7 |
| 4 | 降级项缺设计落点 | 新增降级项设计专章 + 降级桩端点汇总：D1 手工录入、D3 钉钉交接占位、D4 模板文本+esign_stub、D9 站内兜底、扫码入职内网链接/二维码、考勤/绩效桩位 | architecture.md §10；api-design.md §5 |
| 5 | F01~F15 缺 FEAT 编号映射 | 建立 F01 |
feature-list.md §1 |
| 6 | API 开放接口（FEAT-B1-01⑦）无规范 | 新增 API 开放接口规范 §9（签名鉴权/sys_openapp/openapi ping 桩） | architecture.md §9 |
| 7 | 缺 staff-mgr 迁移方案 | 新增 v1→hrs 迁移策略（映射/解密重加密/幂等/核对报告） | database-design.md §8；architecture.md §6 |
| 8 | 任务拆解颗粒度不足 | 重排为 T01~T27（约 92 人日），契约先行、含降级项任务落点表与集成验收标准 | iteration1-task-breakdown.md |
3. 定稿文档清单（git 仓 docs/01-design/，HEAD 与工作区一致）
| 文档 | 版本 | 字节数 | 关键内容 |
|---|---|---|---|
| architecture.md | v2.0 | 29,403B | 技术选型/模块边界/依赖/部署(9182/MariaDB hrs/systemd)/安全/NFR响应表/API开放规范§9/降级项专章§10 |
| database-design.md | v3.0 | 40,259B | 49表清单/字段/索引/ER/models JSON/DDL等价示例/数据字典/staff-mgr迁移/验收映射 |
| api-design.md | v2.0 | 29,356B | 112业务端点请求响应契约/错误码11类/典型调用链/降级桩端点表/安全要点 |
| ui-design.md | v3.0 | 23,929B | 菜单路由32条/页面组件树12组/交互时序/设计规范/页面-接口追溯 |
| feature-list.md | v2.1 | 7,103B | F01~F17↔FEAT映射/90条验收项计数/功能-模块-表落点/范围外与降级项 |
| iteration1-task-breakdown.md | v2.0 | 13,471B | T01~T27任务/依赖/估时(约92人日)/验收对照/集成验收标准 |
合计 143,521B（wc -c docs/01-design/*.md 实测）。
4. git 提交证据（hr-system 仓，远端 git@git.opencomputing.cn:yumoqing/hr-system.git）
| commit | 说明 |
|---|---|
e6b266f / bfc1003 |
design: 批次1设计评审定稿初版（后被误截断） |
857c1fd / 8e0a767 / 5a96df5 / 049e63c |
fix(design): 恢复6份设计文档完整正文 143,521B（截断问题闭环，PM 复核通过） |
043916b |
agent.develop: 批次1开发基础——数据契约(models JSON)+ahserver/bricks工程脚手架+DDL迁移基座(T01/T02 准备) |
| d801859~75d9ba3 | agent.develop: 批次1开发基础 T01/T02 —— 49 表 models JSON 契约 + ahserver/bricks 脚手架 + DDL 迁移基座 |
50f351b |
develop: 响应 QC 三轮退回——补齐 design-review-record.md（评审定量核对/问题闭环 R1~R9/QC 逐条响应/定稿结论）+ deliverables/agent.develop 交付件索引归档 |
验证方式：git log --oneline / git show --stat <commit> / git status（工作区 clean，与 origin/main 一致）。
5. 定稿后变更控制
- 设计基线冻结：表结构、端点签名、路由、权限矩阵任何变更须走设计评审（修改 docs/01-design/ 四份文档 + 评审记录）。
- T01~T27 开发任务以
iteration1-task-breakdown.md为准建卡；每任务交付模块仓代码 + 对应验收项自测记录。 - T27 集成验收标准：90 条验收项全部通过；P0（FEAT-B1-01~05）100%；降级项专项验证（D1/D3/D4/D9/扫码登记）；性能抽测（列表 ≤500ms、报表 ≤3s、导入 500 行 ≤30s）；权限与脱敏抽测（SRS §10）。
6. 遗留与风险
| 项 | 说明 | 处置 |
|---|---|---|
| 5 个模块仓库（hr_org/hr_roster/hr_flow/hr_contract/hr_report）尚未建仓 | modules/*.md 中为规划地址，实测 ls-remote 不存在 | T01 任务首项：建仓；以 PM 确认地址为准 |
| hr-system 复用现有 hr-system 仓 | sys_ 8 张表模型与端点直接在现仓开发 | 无 |
| appbase/rbac 沿用基础包 | 登录/用户/字典/rbac 不自研 | T02 验证加载与四角色初始化 |