4.0 KiB
4.0 KiB
模块名称: 组织人事模块 (hr-org)
状态：一期批次1设计定稿（基线冻结；契约变更须走设计评审）（agent.develop 定稿记录见 docs/02-develop/dev-notes.md） 所属应用：hr-web（Web版人事系统）
1. 模块功能
迭代1组织人事底座核心模块，承担组织与人员异动主线业务：
| 功能编号 | 功能 | 说明（对应 SRS v3.1 章节） |
|---|---|---|
| F01 | 组织架构 | 组织树查看/编辑（新建、变更、停用、移动）、字段自定义、组织架构图、时间轴管理、Excel 批量导入（FEAT-B1-02） |
| F02 | 职位职级体系 | 职位/职务/职级/职等/序列管理，新增/编辑/停启用、批量导入导出（FEAT-B1-03） |
| F04 | 入职管理 | 审批入职、手动入职（批量）、登记表邀请、身份证手工录入、复职、黑名单校验、入职通知/欢迎；扫码入职降级为内网登记链接/二维码（FEAT-B1-05） |
| F05 | 转正管理 | 审批转正、手动转正、转正提醒，通过后自动更新花名册（FEAT-B1-06） |
| F06 | 调动管理 | 调动查询/审批（晋升、降级、调岗、组织调整）、批量调动，通过后关联员工档案（FEAT-B1-06） |
| F07 | 离职管理 | 审批离职、手动离职、离职交接、离职员工信息存储、离职证明、黑名单（FEAT-B1-07；钉钉资源交接为集成类置后） |
| F08 | 兼岗管理 | 一人多条兼岗记录（起止日期、兼岗职位），兼岗审批通过后自动同步（FEAT-B1-04 兼岗部分） |
各功能输入/处理/输出/可验收标准见 docs/00-requirement/iteration1-function-detail.md。
本模块批次1还承载以下已批准 feature（设计在批次1后续任务中落仓）：
- F16 编制管理（FEAT-B1-10，P1）：编制方案/占编范围/细分/超缺编状态/异动管控提醒/历史编制查询
- F17 项目式组织架构管理（FEAT-B1-11，P1）：纵向部门×横向项目组组合、横向组织信息与职务体系维护
范围外：钉钉同步（组织/人员/离职资源交接，集成类二期，SRS §9-D3）。
2. 仓库（规划地址）
- 仓库 URL：
git@git.opencomputing.cn:yumoqing/hr_org.git（规划，建仓时以 PM 确认为准） - 工作空间目录：
repos/hr-org - 分支：
main
3. 技术栈（ocai 规范，设计已冻结）
- 前端：bricks 组件体系 + dspy 声明式页面（org_tree.ui 组织树、org_chart.ui 架构图、entry_workbench/transfer_list/leave_workbench 异动工作台）
- 后端：ahserver（Python）；load_hrorg() 注册 ServerEnv；审批回写经 hr-flow 完成回调 hook
- 数据层：apppublic/sqlor；本模块 18 张表（前缀 org_）：org_unit(+change/field_def/field_value)、org_job/position/sequence/grade_level/grade_rank、org_blacklist、org_contract_company、org_entry、org_regularization、org_transfer(+detail)、org_leave(+handover)、org_concurrent_post（见
docs/01-design/database-design.md§4.1） - 模块结构遵循 module-development-spec 标准结构
4. 模块依赖
依赖（本模块 → 其他模块）：
| 依赖模块 | 依赖内容 |
|---|---|
| hr-roster | 入转调离审批通过后写入/更新花名册（roster_writeback 唯一入口）；黑名单数据 |
| hr-flow | 入职/转正/调动/离职/兼岗审批流程定义与流转引擎 |
| hr-system | 权限校验（数据范围 get_data_scope）、操作日志记录（write_audit_log） |
被依赖（其他模块 → 本模块）：
| 调用方 | 依赖内容 |
|---|---|
| hr-report | F13 报表的入转调离异动数据源 |
| hr-flow | 审批表单引用组织、职位职级主数据 |
| hr-system | F14 工作台展示入转调离数据 |
5. 设计落点（迭代1）
- 总体设计：
docs/01-design/architecture.md§4、api-design.md§2.1（约 30 个端点）、ui-design.md§3.1/§3.2/§3.5 - 开发任务：T03（组织管理）、T04（职位职级）、T13（入职）、T14（转正）、T15（调动）、T17（离职）、T18（兼岗）
6. 负责人
待定（迭代启动会指定）。