2.4 KiB
2.4 KiB
模块名称: 报表模块 (hr-report)
状态：一期批次1设计定稿（基线冻结；契约变更须走设计评审）（agent.develop 定稿记录见 docs/02-develop/dev-notes.md） 所属应用：hr-web（Web版人事系统）
1. 模块功能
迭代1人事报表模块，提供人事数据多维分析（对应 SRS v3.1 FEAT-B1-12）：
| 功能编号 | 功能 | 说明 |
|---|---|---|
| F13 | 人事报表 | 花名册信息分析（员工类型/状态/年龄/学历/办公地点/性别等多维分布，维度可自定义）；入职分析（按部门/地区/岗位分析入职数量及趋势）；转正分析（多维度转正数量及趋势、近期待转正数据）；调岗分析（近期人员调动数据）；离职员工分析（待离职人数、离职原因、离职率、同环比） |
输入/处理/输出/可验收标准见 docs/00-requirement/iteration1-function-detail.md（F13 共 6 条验收项）。
2. 仓库（规划地址）
- 仓库 URL：
git@git.opencomputing.cn:yumoqing/hr_report.git（规划，建仓时以 PM 确认为准） - 工作空间目录：
repos/hr-report - 分支：
main
3. 技术栈（ocai 规范，设计已冻结）
- 前端：bricks 组件体系 + dspy 声明式页面（report_board.ui 看板：Tab 切换五类分析，Chart 图表组件 + 明细 DataViewer）
- 后端：ahserver（Python）；只读聚合查询（sor.sqlExe 只读 SQL），全部接口强制叠加 sys_data_scope 数据范围；100 人规模不建物化视图
- 数据层：apppublic/sqlor；本模块无自有表，只读 org_/roster_/flow_ 表
- 模块结构遵循 module-development-spec 标准结构
4. 模块依赖
依赖（本模块 → 其他模块）：
| 依赖模块 | 依赖内容 |
|---|---|
| hr-roster | 花名册信息分析数据源（含 EAV 自定义维度） |
| hr-org | 入转调离异动记录数据源 |
| hr-system | 数据范围权限控制（报表只能看权限范围内数据）、操作日志 |
被依赖（其他模块 → 本模块）：
| 调用方 | 依赖内容 |
|---|---|
| hr-system | F14 工作台团队人事统计卡片数据（team_stats.dspy） |
5. 设计落点（迭代1）
- 总体设计：
docs/01-design/api-design.md§2.5（6 个只读端点）、ui-design.md§3.7 报表看板 - 开发任务：T20（人事报表，依赖 T06 与 T13~T17）
6. 负责人
待定（迭代启动会指定）。