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