169 lines
9.8 KiB
Plaintext
169 lines
9.8 KiB
Plaintext
===== modules/hr-contract.md =====
|
||
# 模块名称: 合同模块 (hr-contract)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
迭代1合同台账管理模块（不含电子签，对应 SRS v2 §3.1.9）：
|
||
|
||
| 功能编号 | 功能 | 说明 |
|
||
|---|---|---|
|
||
| F09 | 合同台账 | 合同在线管理（新增与批量导入）；合同类型自定义（劳动合同、保密协议、竞业协议等）；合同模板管理；合同审批（新签、续签、变更、终止）；到期提醒（自定义提醒规则，提醒员工本人或管理人员） |
|
||
|
||
输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F09 共 6 条验收项）。
|
||
集成类置后：电子签（依赖电子签平台，接口预留 esign_stub.dspy + contract_info.esign_status 字段）。
|
||
|
||
## 2. 仓库（规划地址）
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_contract.git`（规划，建仓时以 PM 确认为准）
|
||
- 工作空间目录：`repos/hr-contract`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范，设计已冻结）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（contract_list.ui 台账含到期高亮、模板/类型/提醒规则配置页）
|
||
- 后端：ahserver（Python）；load_hrcontract() 注册 ServerEnv；合同审批复用 hr-flow 引擎（biz_type=contract_sign/renew/change/stop）；到期提醒经 hr-system remind_scan 扫描 contract_end_date
|
||
- 数据层：apppublic/sqlor；本模块 4 张表（前缀 contract_）：contract_type、contract_template、contract_info、contract_remind_rule（见 `docs/01-design/database-design.md` §4.4）
|
||
- 附件：合同文件存 ahserver files/
|
||
- 模块结构遵循 module-development-spec 标准结构
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-roster | 合同与员工花名册关联（employee_id） |
|
||
| hr-org | 签约主体引用 org_contract_company 主数据 |
|
||
| hr-flow | 合同新签/续签/变更/终止审批 |
|
||
| hr-system | 提醒推送通道、权限与操作日志 |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-report | F13 合同相关统计（如适用） |
|
||
| hr-system | F14 管理员工作台查看权限范围内合同 |
|
||
|
||
## 5. 设计落点（迭代1）
|
||
- 总体设计：`docs/01-design/api-design.md` §2.4（8 个端点）、`ui-design.md` §3（合同入口/台账页）、`database-design.md` §4.4
|
||
- 开发任务：T19（合同台账全量，依赖 T10 审批引擎与 T16 提醒引擎）
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== modules/hr-report.md =====
|
||
# 模块名称: 报表模块 (hr-report)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
## 1. 模块功能
|
||
迭代1人事报表模块，提供人事数据多维分析（对应 SRS v2 §3.1.13）：
|
||
|
||
| 功能编号 | 功能 | 说明 |
|
||
|---|---|---|
|
||
| F13 | 人事报表 | 花名册信息分析（员工类型/状态/年龄/学历/办公地点/性别等多维分布，维度可自定义）；入职分析（按部门/地区/岗位分析入职数量及趋势）；转正分析（多维度转正数量及趋势、近期待转正数据）；调岗分析（近期人员调动数据）；离职员工分析（待离职人数、离职原因、离职率、同环比） |
|
||
|
||
输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F13 共 6 条验收项）。
|
||
|
||
## 2. 仓库（规划地址）
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr_report.git`（规划，建仓时以 PM 确认为准）
|
||
- 工作空间目录：`repos/hr-report`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范，设计已冻结）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（report_board.ui 看板：Tab 切换五类分析，Chart 图表组件 + 明细 DataViewer）
|
||
- 后端：ahserver（Python）；只读聚合查询（sor.sqlExe 只读 SQL），全部接口强制叠加 sys_data_scope 数据范围；100 人规模不建物化视图
|
||
- 数据层：apppublic/sqlor；本模块无自有表，只读 org_/roster_/flow_ 表
|
||
- 模块结构遵循 module-development-spec 标准结构
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-roster | 花名册信息分析数据源（含 EAV 自定义维度） |
|
||
| hr-org | 入转调离异动记录数据源 |
|
||
| hr-system | 数据范围权限控制（报表只能看权限范围内数据）、操作日志 |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-system | F14 工作台团队人事统计卡片数据（team_stats.dspy） |
|
||
|
||
## 5. 设计落点（迭代1）
|
||
- 总体设计：`docs/01-design/api-design.md` §2.5（6 个只读端点）、`ui-design.md` §3.7 报表看板
|
||
- 开发任务：T20（人事报表，依赖 T06 与 T13~T17）
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== modules/hr-system.md =====
|
||
# 模块名称: 权限日志与通用服务模块 (hr-system)
|
||
|
||
状态：**迭代1总体设计完成（提交审核）**
|
||
所属应用：hr-web（Web版人事系统）
|
||
|
||
> 说明：本模块为迭代1规划的系统支撑模块（ocai 口径），取代 v1 同名应用 `apps/hr-system.md`（Java 口径，已废弃）。
|
||
|
||
## 1. 模块功能
|
||
迭代1系统支撑能力模块，承载权限、日志、工作台与员工服务提醒（对应 SRS v2 §3.1.1/§3.1.11/§3.1.12/§3.1.14）：
|
||
|
||
| 功能编号 | 功能 | 说明 |
|
||
|---|---|---|
|
||
| F11 | 权限管理 | 管理角色（创建角色并设置权限）；人员范围管理（按组织部门维度或花名册字段设置可管理人员范围）；管理员管理（创建管理员并调整权限） |
|
||
| F12 | 操作日志 | 按操作时间/类型查看操作记录，详情含操作前后对比、操作人、时间；全量记录增删改操作 |
|
||
| F14 | 工作台 | 员工工作台（个人档案/发起审批/待办管理）、经理工作台（权限范围内入转调离管理与审批、团队人事统计、员工关怀提醒）、管理员工作台（权限范围内入转调离与合同、人事统计、员工关怀提醒） |
|
||
| F15 | 员工服务与提醒 | 生日/周年关怀（个性化文案、到期自动推送）；企业政策查询；企业公告查询；通用场景到期提醒（入职、转正、离职、退休、合同到期、健康证到期、社保缴纳等，自定义提醒内容与时间，推送管理员或员工） |
|
||
|
||
输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F11/F12/F14/F15 合计 18 条验收项）。
|
||
|
||
## 2. 仓库
|
||
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr-system.git`（复用现有仓，迭代1总体设计文档已提交至该仓 `docs/01-design/`）
|
||
- 工作空间目录：`repos/hr-system`
|
||
- 分支：`main`
|
||
|
||
## 3. 技术栈（ocai 规范，设计已冻结）
|
||
- 前端：bricks 组件体系 + dspy 声明式页面（工作台门户 workbench_employee/manager/admin.ui、角色权限配置 role_admin.ui/data_scope.ui、日志查询 audit_log_list.ui、员工服务 service.ui）
|
||
- 后端：ahserver（Python）；ServerEnv 注册横切公共函数 `get_data_scope(user_id)`、`write_audit_log(...)`、`remind_scan()`
|
||
- 数据层：apppublic/sqlor；本模块 7 张表（前缀 sys_）：sys_data_scope、sys_audit_log、sys_message、sys_remind_rule、sys_announcement、sys_policy、sys_care_config（见 `docs/01-design/database-design.md` §4.5）
|
||
- 权限：复用 rbac 基础包做路径级功能权限，本模块扩展双维度数据范围（组织/花名册字段）
|
||
- 消息推送：站内消息优先（sys_message），短信/邮件为集成类预留（send_channel 字段）
|
||
- 模块结构遵循 module-development-spec 标准结构（包/wwwroot/models/json/init/scripts/skill）
|
||
|
||
## 4. 模块依赖
|
||
**依赖（本模块 → 其他模块）：**
|
||
|
||
| 依赖模块 | 依赖内容 |
|
||
|---|---|
|
||
| hr-org | F14 工作台展示入转调离数据引用组织与异动主数据；F11 人员范围按组织部门维度配置 |
|
||
| hr-roster | F14 个人档案、F15 提醒规则字段、花名册字段权限基础 |
|
||
| hr-contract | F14 管理员工作台查看权限范围内合同 |
|
||
|
||
**被依赖（其他模块 → 本模块）：**
|
||
|
||
| 调用方 | 依赖内容 |
|
||
|---|---|
|
||
| hr-org / hr-roster / hr-flow / hr-contract / hr-report | F11 权限校验（数据范围）与 F12 操作日志为横切能力，全模块依赖 |
|
||
| hr-contract / hr-org | F15 提醒推送通道（入职通知、转正提醒、合同到期提醒等） |
|
||
|
||
## 5. 设计落点（迭代1）
|
||
- 总体设计：`docs/01-design/architecture.md` §4.1/§4.3（职责边界）、`api-design.md` §2.6、`ui-design.md` §3.8/§3.9
|
||
- 数据迁移：staff-mgr 迁移脚本规划于本仓 `scripts/migrate_staff_mgr.py`（见 `database-design.md` §7、任务拆解 T23）
|
||
- 开发任务：T08（权限底座）、T09（审计底座）、T16（提醒引擎）、T21（工作台）、T22（员工服务）、T23（staff-mgr 迁移）
|
||
|
||
## 6. 负责人
|
||
待定（迭代启动会指定）。
|
||
===== apps/hr-system.md =====
|
||
# 应用名称: 人事系统后端服务 (hr-system) —— 【已废弃】
|
||
|
||
## 1. 描述
|
||
本应用为 v1 阶段规划的"人事系统核心后端服务"，基于 Java/Spring Boot 口径。
|
||
|
||
**状态：已废弃（v1 遗留）。**
|
||
|
||
v1 技术口径（Java/RESTful/JWT）与产线 ocai 规范冲突，已随 SRS v1 一并归档（见 `docs/_archive/`）。
|
||
Web 版人事系统统一由应用 **hr-web** 承载（前端 bricks/dspy 声明式页面，后端 ahserver Python，数据层 apppublic/sqlor），见 `apps/hr-web.md`。
|
||
|
||
## 2. 处置说明
|
||
- 关联仓库 `repos/hr-system`（git@git.opencomputing.cn:yumoqing/hr-system.git）仅保留初始提交，不再规划功能，后续可作为 ocai 规范模块仓复用或清理，由 PM 决定。
|
||
- 请勿基于本应用新增需求或设计。
|