模块名称: 流程审批模块 (hr-flow)

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

1. 模块功能

迭代1通用审批引擎模块，支撑入转调离等人事流程（对应 SRS v3.1 FEAT-B1-01 流程配置/人事流程部分）：

功能编号	功能	说明
F10	流程审批	自定义入转调离表单（花名册字段可被审批引用）；自定义流程（多条件审批、字段权限设置）；审批角色配置（流程范围/操作权限/数据查看范围）；人事流程（入职/转正/异动/离职/离职交接审批，通过后自动更新花名册）；审批数据查询（按表单/状态/发起人/审批编号/时间搜索与导出）；审批在线打印

输入/处理/输出/可验收标准见 docs/00-requirement/iteration1-function-detail.md（F10 共 7 条验收项）。批次1范围外（置后）：考勤流程联动考勤系统（一期仅表单桩位，无考勤系统，SRS §9-D5）；薪酬流程与组合审批在批次2随薪酬模块落地（仍复用本引擎）。能力边界（任务拆解 §1.3 裁决）：迭代1锁定串行节点 + any/all 通过规则 + 节点字段权限 + 抄送；并行分支/条件分支留 flow_node_def JSON 扩展位。

2. 仓库（规划地址）

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

3. 技术栈（ocai 规范，设计已冻结）

前端：bricks 组件体系 + dspy 声明式页面（todo_list.ui 待办、inst_detail.ui 动态表单审批单、flow_design.ui 流程配置）
后端：ahserver（Python）；load_hrflow() 注册 ServerEnv；状态机 running→approved/rejected/cancelled；业务回写经 biz_type+biz_id 关联 + 完成回调 hook（调 hr-roster roster_writeback）
数据层：apppublic/sqlor；表单/流程/节点全部 JSON 化配置（fields_json/match_cond_json/field_perm_json），无硬编码；本模块 7 张表（前缀 flow_）
模块结构遵循 module-development-spec 标准结构

4. 模块依赖

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

依赖模块	依赖内容
hr-roster	审批表单引用花名册字段；审批通过后调用花名册回写能力
hr-org	审批表单引用组织、职位职级主数据
hr-system	审批角色的权限基础、操作日志

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

调用方	依赖内容
hr-org	F04~F08 全部审批流转（入职/转正/调动/离职/兼岗）
hr-contract	F09 合同新签/续签/变更/终止审批

5. 设计落点（迭代1）

总体设计：docs/01-design/architecture.md §4.2（引擎与业务解耦规则）、database-design.md §4.3、api-design.md §2.3（18 个端点）、§3.1 转正调用链、ui-design.md §3.6
开发任务：T10（引擎核心，关键路径）、T11（审批界面）、T12（查询导出）

6. 负责人

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

3.1 KiB Raw Blame History Unescape Escape