# 模块名称: 组织人事模块 (hr-org)

状态：**迭代1总体设计完成（提交审核）**
所属应用：hr-web（Web版人事系统）

## 1. 模块功能
迭代1组织人事底座核心模块，承担组织与人员异动主线业务：

| 功能编号 | 功能 | 说明（对应 SRS v2 章节） |
|---|---|---|
| F01 | 组织架构 | 组织树查看/编辑（新建、变更、停用、移动）、字段自定义、组织架构图、时间轴管理、Excel 批量导入（SRS §3.1.2） |
| F02 | 职位职级体系 | 职位/职务/职级/职等/序列管理，新增/编辑/停启用、批量导入导出（SRS §3.1.2） |
| F04 | 入职管理 | 审批入职、手动入职（批量）、完善个人信息、黑名单校验、入职通知；扫码入职/身份证读取为集成类降级项（SRS §3.1.5） |
| F05 | 转正管理 | 审批转正、手动转正、转正提醒，通过后自动更新花名册（SRS §3.1.6） |
| F06 | 调动管理 | 调动查询/审批（晋升、降级、调岗、组织调整）、批量调动，通过后关联员工档案（SRS §3.1.7） |
| F07 | 离职管理 | 审批离职、手动离职、离职交接、离职员工信息存储、离职证明、黑名单（SRS §3.1.8；钉钉资源交接为集成类置后） |
| F08 | 兼岗管理 | 一人多条兼岗记录（起止日期、兼岗职位），兼岗审批通过后自动同步（SRS §3.1.4） |

各功能输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`。
范围外：编制管理、项目式组织架构、钉钉同步（集成类，后续迭代/集成迭代）。

## 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. 负责人
待定（迭代启动会指定）。