# 应用名称: Web版人事系统 (hr-web)

## 1. 应用描述
对标钉钉睿人事的 Web 版人事管理系统（账号规模 100 人）。**一期（初始迭代 k1bIV7ab0-_EHo6E680kv）单迭代交付组织人事、薪酬管理、招聘管理三大模块本地功能闭环**（29 项已批准 feature，外部对接放二期）。

- 前端：基于 **bricks 组件体系 + dspy 声明式页面**（ocai 规范）
- 后端：基于 **ahserver（Python）**
- 数据层：基于 **apppublic/sqlor**（MariaDB）
- 需求基线：`docs/00-requirement/requirement-spec.md`（《人事系统一期需求规格说明书》SRS v3.1，2026-08-18 复核修订）
- 功能基线：`docs/00-requirement/approved-features.md`（29 项）；追溯：`docs/00-requirement/requirement-traceability.md`
- 迭代1组织人事底座设计：`docs/01-design/*`（F01~F15）

## 2. 包含模块（应用关联 8 个模块，≥1 满足）

| 模块 | 说明文件 | 一期范围（批次） |
|---|---|---|
| hr-org 组织人事 | modules/hr-org.md | F01 组织架构、F02 职位职级、F04~F08 入转调离兼岗、编制、项目式组织（批次1） |
| hr-roster 花名册 | modules/hr-roster.md | F03 花名册（批次1） |
| hr-flow 流程审批 | modules/hr-flow.md | F10 流程审批引擎，支撑人事/薪酬/合同/招聘全部审批（批次1基座） |
| hr-contract 合同 | modules/hr-contract.md | F09 合同台账（不含电子签）（批次1） |
| hr-report 报表 | modules/hr-report.md | F13 人事报表 + 薪酬/招聘报表只读聚合（批次1~3） |
| hr-system 权限日志与通用服务 | modules/hr-system.md | F11 权限、F12 操作日志、F14 工作台、F15 员工服务与提醒、消息通道（批次1基座） |
| hr-salary 薪酬管理 | modules/hr-salary.md | 薪资档案/算薪引擎/定调薪/核算/个税(本地)/社保/工资条/成本预算（批次2，10 feature） |
| hr-recruit 招聘管理 | modules/hr-recruit.md | 职位需求/人才库简历/招聘流程/渠道/邮件提醒/报表面试登记/官网内推（批次3，7 feature，其中官网内推可拆独立子模块） |

## 3. 部署环境需求（已明确）

### 3.1 测试环境
| 项 | 内容 |
|---|---|
| 主机 | hrstest@192.168.16.12:22（免密已验证） |
| 应用端口 | **9280**（Web 访问与 ahserver 统一入口，反向代理/ahserver 直接监听；2026-08 客户确认由 9182 变更） |
| 数据库 | MariaDB 本地，账号 test/test123，库名 hrs |
| 缓存/会话 | Redis 本地 |
| 资源规格 | 建议 ≥2C4G，磁盘 ≥40G（含备份空间）；100 人规模单实例即可满足 NFR-1 |
| 环境变量/配置 | conf/config.json：processors(.tmpl/.ui/.dspy)、databases.hrs、Redis session（session_max_time/session_issue_time） |
| 用途 | 全链路冒烟、功能验收、性能抽测、迁移演练 |

### 3.2 生产环境
| 项 | 内容 |
|---|---|
| 主机 | hrs@192.168.16.10:22 |
| 应用端口 | **9280**（与测试环境统一口径，2026-08 客户确认由 9182 变更） |
| 数据库 | MariaDB 本地，库名 hrs（生产账号口令部署时另行安全配置，待明确 Q2） |
| 高可用 | 一期单实例（100 人规模）+ systemd 进程守护自动重启；月度可用率 ≥99%（工作时间） |
| 备份策略 | MariaDB 每日全量备份，保留 ≥30 天；附件随应用数据备份 |
| 域名/证书 | **待补**（SRS §11-Q1；一期接受 IP:9280 HTTP 直连，HTTPS 证书补齐后经反向代理升级） |
| 监控告警 | 进程存活 + 端口 9280 探活 + 备份结果告警（基础项；告警接收渠道待明确 Q8） |
| 安全 | MariaDB/Redis 仅内网监听；未注册路径默认拒绝；全量审计日志 |

> 说明：design v1.1 中 dev/test 8080 / ahserver 9080 / prod 443 为早期规划口径，v1.2 原写 9182 统一端口口径；**2026-08 客户最新确认统一端口为 9280**，conf/config.json 与 systemd unit、Nginx 反代样例已同步修改。

## 4. 端口清单
| 服务 | 测试环境 | 生产环境 |
|---|---|---|
| Web 访问（应用统一入口） | 9280 | 9280 |
| MariaDB | 3306（仅本机/内网） | 3306（仅本机/内网） |
| Redis | 6379（仅本机/内网） | 6379（仅本机/内网） |

## 5. 负责人
待定（迭代启动会由 PM 指定应用负责人；需求文档责任人：agent.requirement）。

## 6. 状态
**一期需求规格已交付（SRS v3.1，2026-08-18 复核修订），批次1组织人事底座总体设计完成，批次2/3 待设计**

> 备注：v1 遗留应用 `apps/hr-system.md`（Java/Spring Boot 口径）已废弃，由本应用取代。