67 lines
4.4 KiB
Markdown
67 lines
4.4 KiB
Markdown
# 应用名称: 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 口径）已废弃，由本应用取代。
|