6.9 KiB
6.9 KiB
一期批次1功能清单（F01~F17，ocai 口径）
- 版本：v2.1（批次1设计定稿；v2.1 变更：对齐 SRS v3.1 —— 批次1范围扩入 F16 编制管理（FEAT-B1-10）、F17 项目式组织（FEAT-B1-11），合计 90 条验收项；补充 F01~F15 ↔ FEAT-B1 编号映射）
- 需求基线：
docs/00-requirement/requirement-spec.md（SRS v3.1）+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（MariaDB，库 hrs）。
| 角色 | 代码 | 主要能力 |
|---|---|---|
| 系统管理员 | admin | 全部数据与配置、角色/管理员/数据范围、操作日志 |
| 人事 | hr | 组织、花名册、入转调离、合同、流程配置、报表、编制 |
| 部门经理 | manager | 数据范围内入转调离审批、团队统计、关怀提醒 |
| 员工（自助） | employee | 个人档案、发起审批、待办、企业政策/公告 |
脱敏基线：身份证号全角色脱敏（前3后3）；手机号前3后4；薪资/职级敏感字段仅 admin/hr 可见（由 roster_field_def.sensitive 驱动）。
1. 功能 → FEAT 映射与清单（F01~F17，共 90 条验收项）
| # | 功能 | 对应 FEAT（SRS v3.1） | 承载模块 | 表前缀 | 验收项数 | 关键交付 | 范围边界 |
|---|---|---|---|---|---|---|---|
| F01 | 组织架构 | FEAT-B1-02 | hr-org | org_ | 6 | 组织树/架构图(含 as_of 历史)/新建变更停用移动/字段自定义/时间轴/Excel 导入/合同公司 | 全量 |
| F02 | 职位职级体系 | FEAT-B1-03 | hr-org | org_ | 5 | 职位/职务/职级/职等/序列 CRUD + 导入导出 + options | 全量 |
| F03 | 花名册 | FEAT-B1-04 | hr-roster | roster_ | 8 | 自定义字段(EAV)/分组/工号多规则/自助修改+审核/时间轴/类型规则/搜索/导入导出 | 附件预览依赖 files/ |
| F04 | 入职管理 | FEAT-B1-05 | hr-org | org_ | 7 | 审批入职/手动批量入职/登记表邀请(扫码降级)/身份证手工录入(D1)/黑名单拦截/入职通知/复职 | 读卡二期、对外二维码二期 |
| F05 | 转正管理 | FEAT-B1-06 | hr-org | org_ | 4 | 审批/手动转正、回写花名册、转正提醒 | 全量 |
| F06 | 调动管理 | FEAT-B1-06 | hr-org | org_ | 4 | 调动查询/审批(晋升/降级/调岗/组织调整)/批量调动/编制联动提醒 | 全量 |
| F07 | 离职管理 | FEAT-B1-07 | hr-org | org_ | 7 | 审批/手动离职、交接(钉钉占位 D3)、离职证明、黑名单、信息存储 | 钉钉资源交接二期 |
| F08 | 兼岗管理 | FEAT-B1-04 | hr-org | org_ | 3 | 一人多兼岗记录、兼岗审批、通过自动同步 | 全量 |
| F09 | 合同台账 | FEAT-B1-08 | hr-contract | contract_ | 6 | 台账/类型自定义/模板(生成文本 D4)/审批(新签续签变更终止)/到期提醒 | 电子签二期(esign_stub 预留) |
| F10 | 流程审批 | FEAT-B1-01 | hr-flow | flow_ | 7 | 表单/流程/节点配置、审批角色、流转引擎、查询导出、打印；考勤流程桩位 | 薪酬/组合审批批次2 |
| F11 | 权限管理 | FEAT-B1-01 | hr-system | sys_ | 4 | 管理角色，人员范围(组织维度+花名册字段维度)，管理员管理 | 全量 |
| F12 | 操作日志 | FEAT-B1-01 | hr-system | sys_ | 4 | 全量写操作留痕、前后对比、时间/类型查询 | 全量 |
| F13 | 人事报表 | FEAT-B1-12 | hr-report | —（只读） | 6 | 花名册/入职/转正/调岗/离职五类分析，数据范围受控，可导出 | 全量 |
| F14 | 工作台 | FEAT-B1-09 | hr-system | sys_ | 5 | 员工/经理/管理员三工作台聚合 | 工资条/绩效/考勤桩位 |
| F15 | 员工服务与提醒 | FEAT-B1-09 | hr-system | sys_ | 5 | 生日周年关怀、政策、公告、多场景到期提醒(≥6类) | 站内消息优先，短信/邮件预留(D9) |
| F16 | 编制管理 | FEAT-B1-10 | hr-org | org_/headcount_ | 6 | 编制方案/占编范围/细分/超缺编状态/异动管控提醒/历史编制 | 全量（一期提醒不硬拦截） |
| F17 | 项目式组织 | FEAT-B1-11 | hr-org | org_ | 3 | 纵向部门×横向项目组组合、横向组织信息、横向职务体系 | 全量 |
合计：6+5+8+7+4+4+7+3+6+7+4+4+6+5+5+6+3 = 90 条可验收项（F01~F15 逐项输入/处理/输出见 iteration1-function-detail.md；F16/F17 按 SRS v3.1 §3.1 FEAT-B1-10/11 验收标准执行）。
2. 功能 → 模块 → 数据表落点
| 模块 | 功能 | 主要数据表 |
|---|---|---|
| hr-org | F01/F02/F04/F05/F06/F07/F08/F16/F17 | org_unit(+change/field_def/field_value)、org_job/position/sequence/grade_level/grade_rank、org_blacklist、org_contract_company、org_entry、org_regularization、org_transfer(+detail)、org_leave(+handover)、org_concurrent_post、org_headcount_scheme/headcount_item/headcount_snapshot、org_project/org_project_post（23 张） |
| 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, sys_openapp（8 张，末张为 API 开放预留） |
共 49 张业务表，详见 database-design.md。
3. 设计文档索引
| 文档 | 内容 |
|---|---|
| architecture.md | 系统架构、技术选型、模块划分与依赖、部署（9182/MariaDB hrs）、安全、非功能、降级项设计专章、API 开放规范 |
| database-design.md | ER、49 表结构、索引、数据字典、models JSON、staff-mgr 迁移 |
| api-design.md | dspy 端点清单（约 120 个）、通用约定、鉴权、错误码、典型调用链、降级桩端点汇总 |
| ui-design.md | 布局、路由表、页面组件树、核心交互流程、设计规范、页面-接口追溯 |
| iteration1-task-breakdown.md | 技术可行性、风险、开发任务拆解（T01~T27，约 92 人日，面向 develop 角色） |
4. 批次1范围外/降级项（既定）
- 范围外：钉钉同步（组织/人员/考勤/智能人事）、薪酬流程与组合审批（批次2）、招聘全部（批次3）、电子签、税局在线申报、短信网关、浏览器插件。
- 一期降级（SRS §9，设计落点见 architecture.md §10）：D1 身份证手工录入、D3 离职交接钉钉占位、D4 合同模板文本+esign_stub、D9 站内消息兜底、扫码入职内网登记链接/二维码、考勤/绩效/工资条工作台桩位。
- 以上均在一期做字段/桩端点/流程位预留，二期对接不改表结构主干。