47 lines
2.4 KiB
Markdown
47 lines
2.4 KiB
Markdown
# 模块名称: 报表模块 (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. 负责人
|
||
待定（迭代启动会指定）。
|