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