61 lines
3.9 KiB
Markdown
61 lines
3.9 KiB
Markdown
# 模块名称: 组织人事模块 (hr-org)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：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. 负责人
|
||
待定（迭代启动会指定）。
|