3.1 KiB
3.1 KiB
模块名称: 花名册模块 (hr-roster)
状态：一期批次1设计定稿（基线冻结；契约变更须走设计评审）（agent.develop 定稿记录见 docs/02-develop/dev-notes.md） 所属应用：hr-web（Web版人事系统）
1. 模块功能
迭代1人员主数据模块，是全系统员工数据的唯一事实来源（对应 SRS v3.1 FEAT-B1-04）：
| 功能编号 | 功能 | 说明 |
|---|---|---|
| F03 | 花名册 | 花名册搭建（自定义字段：文本/数字/附件）、分组管理（工作信息/个人信息等）、在线查看（附件预览、拖拽排序）、自动生成工号（多规则）、员工自助修改（可配置范围与审核）、时间轴信息管理（全周期成长记录）、分类管理（不同员工类型字段规则）、个性化搜索筛选、自定义批量导入、自定义导出（指定数据日期/字段/顺序） |
输入/处理/输出/可验收标准见 docs/00-requirement/iteration1-function-detail.md（F03 共 8 条验收项）。
2. 仓库（规划地址）
- 仓库 URL：
git@git.opencomputing.cn:yumoqing/hr_roster.git（规划，建仓时以 PM 确认为准） - 工作空间目录：
repos/hr-roster - 分支：
main
3. 技术栈（ocai 规范，设计已冻结）
- 前端：bricks 组件体系 + dspy 声明式页面（roster_list.ui DataViewer 列表、employee_detail.ui 档案 Tabs+时间轴、field_config.ui 字段配置拖拽）
- 后端：ahserver（Python）；load_hrroster() 注册 ServerEnv，暴露 roster_writeback 供 hr-org/hr-flow 服务内回调（不注册 HTTP 路径）
- 数据层：apppublic/sqlor；自定义字段采用 EAV 双表（roster_field_def + roster_field_value），高频字段冗余 roster_employee 主表；附件走 ahserver files/ 存储；本模块 7 张表（前缀 roster_）
- 列表性能模式：主表条件分页 + 值表批量 IN 拼装 + 敏感字段按角色脱敏（roster_field_def.sensitive 驱动）
- 模块结构遵循 module-development-spec 标准结构
4. 模块依赖
依赖（本模块 → 其他模块）：
| 依赖模块 | 依赖内容 |
|---|---|
| hr-org | 员工任职信息引用组织、职位职级主数据（options 端点） |
| hr-flow | 员工自助修改可配置审核环节（biz_type=roster_self_edit） |
| hr-system | 字段级数据权限、敏感信息脱敏角色矩阵、操作日志 |
被依赖（其他模块 → 本模块）：
| 调用方 | 依赖内容 |
|---|---|
| hr-org | 入转调离审批通过后回写花名册（本模块提供回写能力，唯一写入入口） |
| hr-flow | 审批表单引用花名册字段 |
| hr-contract | 合同与员工花名册关联 |
| hr-report | F13 花名册信息分析数据源 |
| hr-system | F14 个人档案、F15 提醒规则字段 |
5. 设计落点（迭代1）
- 总体设计：
docs/01-design/architecture.md§4、database-design.md§4.2（EAV 方案）、api-design.md§2.2（16 个端点）、ui-design.md§3.3/§3.4 - 开发任务：T05（字段体系）、T06（花名册主体）、T07（导入导出）
6. 负责人
待定（迭代启动会指定）。