hr-system/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. 负责人

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