hr-system/modules/hr-system.md

4.0 KiB
Raw Blame History

模块名称: 权限日志与通用服务模块 (hr-system)

状态:迭代1总体设计完成提交审核 所属应用hr-webWeb版人事系统

说明本模块为迭代1规划的系统支撑模块ocai 口径),取代 v1 同名应用 apps/hr-system.mdJava 口径,已废弃)。

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.mdF11/F12/F14/F15 合计 18 条验收项)。

2. 仓库

  • 仓库 URLgit@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
  • 后端ahserverPythonServerEnv 注册横切公共函数 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_configdocs/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员工服务、T23staff-mgr 迁移)

6. 负责人

待定(迭代启动会指定)。