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

状态：**一期批次1开发中 —— T09 审计底座已完成**（agent.develop，见 docs/02-develop/dev-notes.md）
所属应用：hr-web（Web版人事系统）

> 说明：本模块为迭代1规划的系统支撑模块（ocai 口径），取代 v1 同名应用 `apps/hr-system.md`（Java 口径，已废弃）。

## 1. 模块功能
迭代1系统支撑能力模块，承载权限、日志、工作台与员工服务提醒（对应 SRS v3.1 FEAT-B1-01 权限/日志部分、FEAT-B1-09）：

| 功能编号 | 功能 | 说明 | 状态 |
|---|---|---|---|
| F11 | 权限管理 | 管理角色（创建角色并设置权限）；人员范围管理；管理员管理 | 待开发（T08） |
| F12 | 操作日志 | 按操作时间/类型查看操作记录，详情含前后对比、操作人、时间；全量记录增删改 | **已完成（T09）** |
| F14 | 工作台 | 员工/经理/管理员工作台 | 待开发（T21） |
| F15 | 员工服务与提醒 | 生日/周年关怀、政策/公告、到期提醒 | 待开发（T16/T22） |

输入/处理/输出/可验收标准见 `docs/00-requirement/iteration1-function-detail.md`（F11/F12/F14/F15 合计 18 条验收项）。

## 2. 仓库
- 仓库 URL：`git@git.opencomputing.cn:yumoqing/hr-system.git`（复用现有仓）
- 工作空间目录：`repos/hr-system`
- 分支：`main`

## 3. 技术栈（ocai 规范，设计已冻结）
- 前端：bricks 组件体系 + dspy 声明式页面（audit_log_list.ui 已完成）
- 后端：ahserver（Python）；ServerEnv 注册横切公共函数 `write_audit_log(...)` 等
- 数据层：apppublic/sqlor；本模块 7 张表（前缀 sys_）
- 权限：复用 rbac 基础包
- 消息推送：站内消息优先

## 4. 模块依赖
同 v1 基线（见设计文档）。

## 5. 设计落点（迭代1）
- 总体设计：`docs/01-design/architecture.md`、`api-design.md` §2.6、`ui-design.md` §3.8/§3.9
- 开发任务：T08（权限底座）、T09（审计底座，**已完成**）、T16/T21/T22/T23

## 6. 负责人
待定（迭代启动会指定）。