5.4 KiB
5.4 KiB
迭代1功能清单（F01~F15，ocai 口径）
- 版本：v2.0（替换原 299B 占位文件；占位文件内容为 v1 Java 口径描述，已废弃）
- 需求基线：
docs/00-requirement/requirement-spec.md（SRS v2）+docs/00-requirement/iteration1-function-detail.md - 应用：hr-web（
apps/hr-web.md）；模块定义：modules/hr-*.md
0. 范围与角色
迭代1 = 组织人事底座，规模 100 人账号。技术口径统一 ocai：前端 bricks + dspy 声明式页面，后端 ahserver（Python），数据层 apppublic/sqlor。
| 角色 | 代码 | 主要能力 |
|---|---|---|
| 系统管理员 | admin | 全部数据与配置、角色/管理员/数据范围、操作日志 |
| 人事 | hr | 组织、花名册、入转调离、合同、流程配置、报表 |
| 部门经理 | manager | 数据范围内入转调离审批、团队统计、关怀提醒 |
| 员工（自助） | employee | 个人档案、发起审批、待办、企业政策/公告 |
脱敏基线：身份证号全角色脱敏（前3后3）；手机号前3后4；薪资/职级敏感字段仅 admin/hr 可见（由 roster_field_def.sensitive 驱动）。
1. 功能清单（F01~F15，共 81 条验收项）
| # | 功能 | 承载模块 | 表前缀 | 验收项数 | 关键交付 | 范围边界 |
|---|---|---|---|---|---|---|
| F01 | 组织架构 | hr-org | org_ | 6 | 组织树/架构图(含 as_of 历史)/新建变更停用移动/字段自定义/时间轴/Excel 导入 | 编制管理、项目式组织范围外 |
| F02 | 职位职级体系 | hr-org | org_ | 5 | 职位/职务/职级/职等/序列 CRUD + 导入导出 + options | 全量 |
| F03 | 花名册 | hr-roster | roster_ | 8 | 自定义字段(EAV)/分组/工号多规则/自助修改+审核/时间轴/类型规则/搜索/导入导出 | 附件预览依赖 files/ |
| F04 | 入职管理 | hr-org | org_ | 7 | 审批入职/手动批量入职/登记表邀请/黑名单拦截/入职通知/复职 | 扫码入职、身份证读取为降级项 |
| F05 | 转正管理 | hr-org | org_ | 4 | 审批/手动转正、回写花名册、转正提醒 | 全量 |
| F06 | 调动管理 | hr-org | org_ | 4 | 调动查询/审批(晋升/降级/调岗/组织调整)/批量调动 | 全量 |
| F07 | 离职管理 | hr-org | org_ | 7 | 审批/手动离职、交接、离职证明、黑名单、信息存储 | 钉钉资源交接置后 |
| F08 | 兼岗管理 | hr-org | org_ | 3 | 一人多兼岗记录、兼岗审批、通过自动同步 | 全量 |
| F09 | 合同台账 | hr-contract | contract_ | 6 | 台账/类型自定义/模板/审批(新签续签变更终止)/到期提醒 | 电子签置后(esign_stub 预留) |
| F10 | 流程审批 | hr-flow | flow_ | 7 | 表单/流程/节点配置、审批角色、流转引擎、查询导出、打印 | 考勤/薪酬/组合审批置后 |
| F11 | 权限管理 | hr-system | sys_ | 4 | 管理角色、人员范围(组织维度+花名册字段维度)、管理员管理 | 全量 |
| F12 | 操作日志 | hr-system | sys_ | 4 | 全量写操作留痕、前后对比、时间/类型查询 | 全量 |
| F13 | 人事报表 | hr-report | —（只读） | 6 | 花名册/入职/转正/调岗/离职五类分析，数据范围受控 | 全量 |
| F14 | 工作台 | hr-system | sys_ | 5 | 员工/经理/管理员三工作台聚合 | 绩效/考勤统计预留占位 |
| F15 | 员工服务与提醒 | hr-system | sys_ | 5 | 生日周年关怀、政策、公告、多场景到期提醒 | 站内消息优先，短信/邮件预留 |
合计：81 条可验收项（逐项输入/处理/输出见 iteration1-function-detail.md）。
2. 功能 → 模块 → 数据表落点
| 模块 | 功能 | 主要数据表 |
|---|---|---|
| hr-org | F01/F02/F04/F05/F06/F07/F08 | org_unit, org_unit_change, org_field_def/value, org_job, org_position, org_sequence, org_grade_level, org_grade_rank, org_blacklist, org_contract_company, org_entry, org_regularization, org_transfer(+detail), org_leave(+handover), org_concurrent_post（18 张） |
| hr-roster | F03 | roster_field_group, roster_field_def, roster_employee, roster_field_value, roster_empno_rule, roster_timeline, roster_type_rule（7 张） |
| hr-flow | F10 | flow_form_def, flow_def, flow_node_def, flow_role, flow_instance, flow_task, flow_op_log（7 张） |
| hr-contract | F09 | contract_type, contract_template, contract_info, contract_remind_rule（4 张） |
| hr-report | F13 | 无自有表，只读聚合 org_/roster_/flow_ |
| hr-system | F11/F12/F14/F15 | sys_data_scope, sys_audit_log, sys_message, sys_remind_rule, sys_announcement, sys_policy, sys_care_config（7 张） |
共 43 张业务表，详见 database-design.md。
3. 设计文档索引
| 文档 | 内容 |
|---|---|
| architecture.md | 系统架构、技术选型、模块划分与依赖、hr-system/staff-mgr 职责边界、部署、安全、非功能 |
| database-design.md | ER、43 表结构、索引、数据字典、models JSON、staff-mgr 迁移 |
| api-design.md | dspy 端点清单、通用约定、鉴权、错误码、典型调用链、v1 接口替代 |
| ui-design.md | 布局、路由表、页面组件树、核心交互流程、设计规范、页面-接口追溯 |
| iteration1-task-breakdown.md | 技术可行性、风险、开发任务拆解（T01~T24，约 84 人日） |
4. 迭代1范围外（既定）
编制管理、项目式组织、钉钉同步、考勤流程、薪酬流程、组合审批、电子签、短信/邮件通道、浏览器插件——列为后续迭代/集成迭代，本期仅预留字段或桩接口。