模块名称: 合同模块 (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. 负责人

待定（迭代启动会指定）。

2.7 KiB Raw Blame History Unescape Escape