# 模块名称: 合同模块 (hr-contract)

状态：**一期批次1设计定稿（基线冻结；契约变更须走设计评审）**（agent.develop 定稿记录见 docs/02-develop/dev-notes.md）
所属应用：hr-web（Web版人事系统）

## 1. 模块功能
迭代1合同台账管理模块（不含电子签，对应 SRS v3.1 FEAT-B1-08）：

| 功能编号 | 功能 | 说明 |
|---|---|---|
| F09 | 合同台账 | 合同在线管理（新增与批量导入）；合同类型自定义（劳动合同、保密协议、竞业协议等）；合同模板管理；合同审批（新签、续签、变更、终止）；到期提醒（自定义提醒规则，提醒员工本人或管理人员） |

输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F09 共 6 条验收项）。
集成类置后：电子签（依赖电子签平台，接口预留 esign_stub.dspy + contract_info.esign_status 字段）。

## 2. 仓库（规划地址）
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_contract.git`（规划，建仓时以 PM 确认为准）
- 工作空间目录：`repos/hr-contract`
- 分支：`main`

## 3. 技术栈（ocai 规范，设计已冻结）
- 前端：bricks 组件体系 + dspy 声明式页面（contract_list.ui 台账含到期高亮、模板/类型/提醒规则配置页）
- 后端：ahserver（Python）；load_hrcontract() 注册 ServerEnv；合同审批复用 hr-flow 引擎（biz_type=contract_sign/renew/change/stop）；到期提醒经 hr-system remind_scan 扫描 contract_end_date
- 数据层：apppublic/sqlor；本模块 4 张表（前缀 contract_）：contract_type、contract_template、contract_info、contract_remind_rule（见 `docs/01-design/database-design.md` §4.4）
- 附件：合同文件存 ahserver files/
- 模块结构遵循 module-development-spec 标准结构

## 4. 模块依赖
**依赖（本模块 → 其他模块）：**

| 依赖模块 | 依赖内容 |
|---|---|
| hr-roster | 合同与员工花名册关联（employee_id） |
| hr-org | 签约主体引用 org_contract_company 主数据 |
| hr-flow | 合同新签/续签/变更/终止审批 |
| hr-system | 提醒推送通道、权限与操作日志 |

**被依赖（其他模块 → 本模块）：**

| 调用方 | 依赖内容 |
|---|---|
| hr-report | F13 合同相关统计（如适用） |
| hr-system | F14 管理员工作台查看权限范围内合同 |

## 5. 设计落点（迭代1）
- 总体设计：`docs/01-design/api-design.md` §2.4（8 个端点）、`ui-design.md` §3（合同入口/台账页）、`database-design.md` §4.4
- 开发任务：T19（合同台账全量，依赖 T10 审批引擎与 T16 提醒引擎）

## 6. 负责人
待定（迭代启动会指定）。