4.4 KiB
4.4 KiB
应用名称: 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.0，本迭代补齐落仓） - 功能基线：
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，9 feature，其中官网内推可拆独立子模块） |
3. 部署环境需求（已明确）
3.1 测试环境
| 项 | 内容 |
|---|---|
| 主机 | hrstest@192.168.16.12:22（免密已验证） |
| 应用端口 | 9182（Web 访问与 ahserver 统一入口，反向代理/ahserver 直接监听） |
| 数据库 | 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 |
| 应用端口 | 9182 |
| 数据库 | MariaDB 本地，库名 hrs（生产账号口令部署时另行安全配置，待明确 Q2） |
| 高可用 | 一期单实例（100 人规模）+ systemd 进程守护自动重启；月度可用率 ≥99%（工作时间） |
| 备份策略 | MariaDB 每日全量备份，保留 ≥30 天；附件随应用数据备份 |
| 域名/证书 | 待补（SRS §11-Q1；一期接受 IP:9182 HTTP 直连，HTTPS 证书补齐后经反向代理升级） |
| 监控告警 | 进程存活 + 端口 9182 探活 + 备份结果告警（基础项；告警接收渠道待明确 Q8） |
| 安全 | MariaDB/Redis 仅内网监听；未注册路径默认拒绝；全量审计日志 |
说明：design v1.1 中 dev/test 8080 / ahserver 9080 / prod 443 为早期规划口径，以任务明确的 9182 统一端口口径为准；反向代理层级在部署设计阶段按实际收敛（可 nginx:9182→ahserver 内部端口，或 ahserver 直接监听 9182）。
4. 端口清单
| 服务 | 测试环境 | 生产环境 |
|---|---|---|
| Web 访问（应用统一入口） | 9182 | 9182 |
| MariaDB | 3306（仅本机/内网） | 3306（仅本机/内网） |
| Redis | 6379（仅本机/内网） | 6379（仅本机/内网） |
5. 负责人
待定（迭代启动会由 PM 指定应用负责人；需求文档责任人：agent.requirement）。
6. 状态
一期需求规格已交付（SRS v3.0），批次1组织人事底座总体设计完成，批次2/3 待设计
备注：v1 遗留应用
apps/hr-system.md（Java/Spring Boot 口径）已废弃，由本应用取代。