51 lines
2.7 KiB
Markdown
51 lines
2.7 KiB
Markdown
# 模块名称: 合同模块 (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. 负责人
|
||
待定（迭代启动会指定）。
|