221 lines
15 KiB
Plaintext
221 lines
15 KiB
Plaintext
===== modules/hr-roster.md =====
|
||
# 模块名称: 花名册模块 (hr-roster)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
迭代1人员主数据模块，是全系统员工数据的唯一事实来源（对应 SRS v2 §3.1.3）：
|
||
|
||
| 功能编号 | 功能 | 说明 |
|
||
|---|---|---|
|
||
| F03 | 花名册 | 花名册搭建（自定义字段：文本/数字/附件）、分组管理（工作信息/个人信息等）、在线查看（附件预览、拖拽排序）、自动生成工号（多规则）、员工自助修改（可配置范围与审核）、时间轴信息管理（全周期成长记录）、分类管理（不同员工类型字段规则）、个性化搜索筛选、自定义批量导入、自定义导出（指定数据日期/字段/顺序） |
|
||
|
||
输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F03 共 8 条验收项）。
|
||
|
||
## 2. 仓库（规划地址）
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_roster.git`（规划，建仓时以 PM 确认为准）
|
||
- 工作空间目录：`repos/hr-roster`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范，设计已冻结）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（roster_list.ui DataViewer 列表、employee_detail.ui 档案 Tabs+时间轴、field_config.ui 字段配置拖拽）
|
||
- 后端：ahserver（Python）；load_hrroster() 注册 ServerEnv，暴露 roster_writeback 供 hr-org/hr-flow 服务内回调（不注册 HTTP 路径）
|
||
- 数据层：apppublic/sqlor；自定义字段采用 EAV 双表（roster_field_def + roster_field_value），高频字段冗余 roster_employee 主表；附件走 ahserver files/ 存储；本模块 7 张表（前缀 roster_）
|
||
- 列表性能模式：主表条件分页 + 值表批量 IN 拼装 + 敏感字段按角色脱敏（roster_field_def.sensitive 驱动）
|
||
- 模块结构遵循 module-development-spec 标准结构
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-org | 员工任职信息引用组织、职位职级主数据（options 端点） |
|
||
| hr-flow | 员工自助修改可配置审核环节（biz_type=roster_self_edit） |
|
||
| hr-system | 字段级数据权限、敏感信息脱敏角色矩阵、操作日志 |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-org | 入转调离审批通过后回写花名册（本模块提供回写能力，唯一写入入口） |
|
||
| hr-flow | 审批表单引用花名册字段 |
|
||
| hr-contract | 合同与员工花名册关联 |
|
||
| hr-report | F13 花名册信息分析数据源 |
|
||
| hr-system | F14 个人档案、F15 提醒规则字段 |
|
||
|
||
## 5. 设计落点（迭代1）
|
||
- 总体设计：`docs/01-design/architecture.md` §4、`database-design.md` §4.2（EAV 方案）、`api-design.md` §2.2（16 个端点）、`ui-design.md` §3.3/§3.4
|
||
- 开发任务：T05（字段体系）、T06（花名册主体）、T07（导入导出）
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== modules/hr-flow.md =====
|
||
# 模块名称: 流程审批模块 (hr-flow)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
迭代1通用审批引擎模块，支撑入转调离等人事流程（对应 SRS v2 §3.1.14 系统-流程）：
|
||
|
||
| 功能编号 | 功能 | 说明 |
|
||
|---|---|---|
|
||
| F10 | 流程审批 | 自定义入转调离表单（花名册字段可被审批引用）；自定义流程（多条件审批、字段权限设置）；审批角色配置（流程范围/操作权限/数据查看范围）；人事流程（入职/转正/异动/离职/离职交接审批，通过后自动更新花名册）；审批数据查询（按表单/状态/发起人/审批编号/时间搜索与导出）；审批在线打印 |
|
||
|
||
输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F10 共 7 条验收项）。
|
||
迭代1范围外（置后）：考勤流程联动考勤系统（接口预留）、薪酬流程与组合审批（依赖薪酬模块，迭代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. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== modules/hr-salary.md =====
|
||
# 模块名称: 薪酬管理模块 (hr-salary)
|
||
|
||
状态：**一期需求规格完成（批次2，待总体设计）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
一期批次2薪酬管理模块，承载 10 项已批准 feature（SRS v3.0 §3.2）：
|
||
|
||
| feature（SRS 编号） | 优先级 | 功能 |
|
||
|---|---|---|
|
||
| FEAT-B2-01 薪资档案与岗酬体系 | P0 | 薪资档案字段自定义；薪资标准（职位/职级/序列匹配，固定值/带宽管控）；薪资包（按员工类型/岗位/签约主体，字段级管控规则：带宽强弱/试用期折算/公式） |
|
||
| FEAT-B2-02 薪资方案与算薪规则引擎 | P0 | 多薪资组方案（可复制）；自定义算薪周期；核算方式=自动集成/自定义公式/手动录入；公式引擎（Excel 常用函数+薪资专用函数，员工信息为计算因子）；薪酬累加器（合并计税）；离职结薪；薪资分段计算（月中转正/异动） |
|
||
| FEAT-B2-03 定调薪管理 | P0 | 手工/审批/批量定调薪；薪资体系自动匹配与管控报错；人事流程合并（转正调薪/调岗调薪）；调薪历史 |
|
||
| FEAT-B2-04 发薪活动与薪资核算 | P0 | 核算组选人；一月多次发薪与合并计税；算薪名单自动生成与上月差异核对、调薪提醒；兼岗核对；数据手动导入（自动解析）；本地算税算薪；结果导出 Excel |
|
||
| FEAT-B2-05 薪资校验、锁定与发薪审批 | P1 | 校验规则（与上月/固定值按差额比例）；智能校验异常名单；薪资锁定/解锁留痕；发薪审批（内嵌明细在线预览） |
|
||
| FEAT-B2-06 个税管理（本地计算） | P1 | 多报税主体；多地经营；一人多主体；增减员本地记录；累计预扣法本地计算+专项附加手工维护；个税倒算；申报缴纳记录管理（税局对接二期） |
|
||
| FEAT-B2-07 社保公积金管理 | P1 | 社保账单导入；参保方案（地区/险种/基数/比例/取整）；员工社保档案维护并参与算薪 |
|
||
| FEAT-B2-08 工资条管理 | P1 | 自定义内容与样式；一对一发放/分类定时/状态追踪；阅后即焚/手写签名/反馈/自动确认；二次加密水印查询；留档导出 PDF |
|
||
| FEAT-B2-09 薪酬报表 | P2 | 薪资明细表（任意周期）、成本拆分、同岗位薪酬分析、薪酬总量分析、人均薪酬分析（人效预留） |
|
||
| FEAT-B2-10 成本与预算管理 | P2 | 成本中心/成本方案/拆分规则/成本明细报表；预算方案/在线填报追踪/预算分析 |
|
||
|
||
输入/处理/输出/验收标准详见 `docs/00-requirement/requirement-spec.md` §3.2。
|
||
|
||
## 2. 仓库（规划地址）
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_salary.git`（规划，建仓时以 PM 确认为准）
|
||
- 工作空间目录：`repos/hr-salary`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（薪资档案/方案配置/核算工作台/工资条发放追踪/报表看板）
|
||
- 后端：ahserver（Python）；load_hrsalary() 注册 ServerEnv；公式引擎与累计预扣法为核心计算服务；审批走 hr-flow（biz_type=salary_adjust/payroll_approve 等）
|
||
- 数据层：apppublic/sqlor；表前缀 sal_（规划 25~30 张：薪资档案/薪资包/标准/定调薪记录/方案/规则/发薪活动/算薪结果(分段)/个税主体与记录/社保方案与档案/工资条/成本拆分/预算），总体设计阶段细化
|
||
- 安全：薪资字段全量 sensitive，仅 admin/hr 可见；算薪结果锁定机制；操作日志全覆盖
|
||
- 模块结构遵循 module-development-spec 标准结构
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-roster | 员工主数据（部门/职位/司龄/学历/职级等计算因子）、兼岗记录 |
|
||
| hr-org | 组织/职位职级主数据、离职日期（离职结薪） |
|
||
| hr-flow | 定调薪审批、发薪审批、转正调薪等组合审批 |
|
||
| hr-system | 权限/数据范围、操作日志、工资条站内消息通道、提醒 |
|
||
| hr-report | 薪酬报表只读聚合框架（Chart/DataViewer 复用） |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-system | 员工工作台工资条展示（批次2） |
|
||
| hr-report | 薪酬总量/人均分析数据源 |
|
||
|
||
## 5. 一期降级项
|
||
- 考勤/绩效/审批/宜搭数据一键同步（钉钉对接）→ 二期；一期手动导入 + 数据接入接口与模板预留
|
||
- 税局在线申报/缴纳/专项附加自动获取 → 二期；一期本地累计预扣法 + 记录管理
|
||
- AI 公式解析 → 二期增强；一期基础公式编辑器
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== modules/hr-recruit.md =====
|
||
# 模块名称: 招聘管理模块 (hr-recruit)
|
||
|
||
状态：**一期需求规格完成（批次3，待总体设计）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
一期批次3招聘管理模块，承载 9 项已批准 feature（SRS v3.0 §3.3）：
|
||
|
||
| feature（SRS 编号） | 优先级 | 功能 |
|
||
|---|---|---|
|
||
| FEAT-B3-01 招聘职位与招聘需求管理 | P1 | 职位审批/发布（招聘状态/流程/关联HC/负责人设置，招聘负责人唯一全权限）；职位四类角色（负责人/协助人/用人经理/面试官）；职位类型级别；招聘需求单个/多个创建、审批、状态调整（草稿/未进行中/已完成） |
|
||
| FEAT-B3-02 人才库与简历管理 | P1 | 人才库分类（在职/离职/淘汰）与激活；简历关联职位/敏感可见性/来源；标签管理；简历导出带水印；筛选规则（评分/筛选/运算/条件动作）；字段管理；标准简历；应聘表/面试登记表（扫码填写） |
|
||
| FEAT-B3-03 招聘流程管理 | P0 | 初筛→面试→offer→入职/转正确阶段与流程可配置；面试评价/轮次/反馈（**视频面试二期，一期线下面试记录**）；offer 字段/审批/规则/满意度；自动化规则（结果自动进阶段/人才库/淘汰/自动转正/锁定解除等）；候选人/流程锁定；评价模板；归档原因；招聘目标（月/周） |
|
||
| FEAT-B3-04 招聘邮件与消息提醒 | P1 | 收发邮箱配置；邮件模板（面试/offer/激活/通知/叫号，变量替换）；消息提醒（简历/初筛/面试/offer/职位/审批/@我，可配时机/渠道/角色；站内必选、邮件可选、短信二期） |
|
||
| FEAT-B3-05 招聘渠道与猎企管理（本地） | P2 | 猎企分类/查重/质量追踪；系统渠道/自定义渠道（第三方对接二期预留接口）；简历来源标记与渠道统计基础数据 |
|
||
| FEAT-B3-06 招聘报表与面试登记 | P2 | 看板（招聘概览/候选人质量/职位360/HR效率/面试/offer/渠道分析）；报表图表自定义/导出/授权；无纸化面试登记（扫码，共享签到） |
|
||
| FEAT-B3-07 招聘官网与内推官网 | P2 | 官网搭建（信息/样式/分享/在招职位/投递限制）；内推官网（规则：认证/保护期/邀请码）；内推奖励（基础/特殊规则，积分/现金）；内推人及奖励统计；一期内网部署，公网二期 |
|
||
|
||
输入/处理/输出/验收标准详见 `docs/00-requirement/requirement-spec.md` §3.3。
|
||
|
||
## 2. 仓库（规划地址）
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_recruit.git`（规划，建仓时以 PM 确认为准）
|
||
- 工作空间目录：`repos/hr-recruit`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（职位/需求台账、人才库列表、候选人流程看板 Kanban、offer 审批、官网页面、扫码登记表）
|
||
- 后端：ahserver（Python）；load_hrrecruit() 注册 ServerEnv；候选人状态机引擎（阶段可配置）；自动化规则引擎（条件-动作 JSON 配置）；offer/职位审批走 hr-flow
|
||
- 数据层：apppublic/sqlor；表前缀 rcrt_（规划 30~35 张：职位/需求/人才库/简历+EAV 字段/标签/阶段配置/候选人流转/面试记录/评价模板/offer/渠道猎企/邮件模板/内推奖励/面试登记/归档原因/目标），总体设计阶段细化
|
||
- 候选人侧：无系统账号，扫码填表走公开 dspy 端点（token 校验）
|
||
- 模块结构遵循 module-development-spec 标准结构
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-org | 组织/职位主数据（职位关联部门）、入职联动（候选人入职走批次1入职流程） |
|
||
| hr-roster | 候选人转员工时建立花名册档案 |
|
||
| hr-flow | 职位审批/需求审批/offer 审批 |
|
||
| hr-system | 权限（职位级角色授权基于数据范围机制扩展）、消息提醒通道（站内/邮件）、操作日志 |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-report | 招聘报表数据源（批次3） |
|
||
|
||
## 5. 一期降级项
|
||
- 视频面试 → 线下面试记录（D2）
|
||
- 第三方招聘渠道真实对接/浏览器插件 → 本地渠道台账 + 手工/文件导入（D7）
|
||
- 官网公网发布 → 内网形态（D10）
|
||
- 短信渠道 → 站内兜底（D9）
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|