# 模块名称: 薪酬管理模块 (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. 负责人
待定（迭代启动会指定）。