diff --git a/docs/管理员手册.md b/docs/管理员手册.md index bf4c946c..8eb7d828 100644 --- a/docs/管理员手册.md +++ b/docs/管理员手册.md @@ -26,6 +26,40 @@ - 按需开启:`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`。 - 建议保留备用:`payment_batch_v1`、`cutover_console_v1`、预算/AP/ERP/AI 相关开关。 +### 3.1 ORG8 组织账号与角色边界 + +OA 员工账号是权限、审批、业务数据和审计的主事实源;企业微信身份只作为入口、免登和通知辅助。管理员维护组织账号时,先保证员工主数据完整,再配置角色和企业微信绑定。 + +最小必填主数据: + +| 字段 | 用途 | 缺失影响 | +| --- | --- | --- | +| 员工账号和姓名 | 登录、单据归属、审批历史 | 无法稳定追踪责任人 | +| 部门和职位 | 列表筛选、组织展示、权限判断辅助 | 财务和负责人扫读困难 | +| 直属主管 | 请假、报销、采购等默认审批链 | 审批人缺失或错误回退 | +| 账号状态 | 登录、入口、通知和禁用拦截 | 离职或停用人员可能继续进入 | +| 业务角色 | 审批、财务、HR、系统管理入口 | 权限过大或无法处理待办 | +| 企业微信绑定状态 | 手机入口、免登、通知 deeplink | 企业微信入口无法直达或误绑定 | + +角色边界: + +| 角色 | 允许能力 | 禁止或高风险边界 | +| --- | --- | --- | +| 员工 | 提交本人报销、请假、采购,查看本人单据和通知 | 不得查看他人财务、审批待办或管理员入口 | +| 直属主管 / 审批人 | 处理分配给自己的审批待办,查看必要的单据摘要和历史 | 不得处理未分配给自己或超出角色范围的待办 | +| 财务 | 复核报销、处理付款标记、导出授权范围内财务数据 | 不默认拥有系统管理权限,不处理非财务系统配置 | +| 管理员 / HR | 维护员工、部门、角色、主管链、入口配置和绑定异常 | `admin` 不等于业务审批人,不应用管理员账号代批 | +| 系统管理员 | 维护部署、备份、配置、日志和企业微信应用密钥 | 不处理业务审批,不查看无关财务明细 | +| 老板 / 负责人 | 处理高风险或大额审批,查看授权管理摘要 | 不替代员工直属主管的日常组织配置 | + +不兼容或需确认的组合: + +- `admin-only` 账号不得作为报销、请假或采购的业务审批人。 +- 财务和系统管理员混授属于高风险组合,必须有人工确认、审计记录和可回退路径。 +- 直属主管、审批人或财务账号停用后,不得继续接收新待办;历史审批记录保留只读。 +- 新员工账号创建必须同时确认直属主管、初始角色、账号状态和企业微信绑定路径。 +- 离职或停用账号必须阻断登录、企业微信入口和新业务处理,但不得删除历史单据和审批记录。 + ## 4. 人员生命周期管理 ### 4.1 入职 1. 在 `人员管理` 创建员工账号。 diff --git a/issues/2026-05-13_18-23-51-org8-master-data-permission.csv b/issues/2026-05-13_18-23-51-org8-master-data-permission.csv index f3938bc7..a3642f5d 100644 --- a/issues/2026-05-13_18-23-51-org8-master-data-permission.csv +++ b/issues/2026-05-13_18-23-51-org8-master-data-permission.csv @@ -1,7 +1,7 @@ ID,Title,Description,Acceptance,Test_Method,Tools,Dev_Status,Review1_Status,Regression_Status,Files,Dependencies,Notes ORG8-0,ORG8 连续合同建档,"建立组织账号与权限主数据连续型合同,把组织、账号、主管、停用、角色、企业微信绑定和权限边界集中到同一 CSV。","1) 本 CSV 校验通过;2) 文档索引和状态矩阵指向本合同;3) 不改业务代码;4) 不绕过 R7E 人工确认;5) 后续组织权限问题优先进入本合同。","流程级验证:python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_18-23-51-org8-master-data-permission.csv;rg -n 'ORG8|组织账号|权限主数据' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。",python3|rg|manual,DONE,DONE,DONE,issues/2026-05-13_18-23-51-org8-master-data-permission.csv|docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md,[],CSV validator 和索引 rg 均通过;本次仅合同建档和入口登记,未改业务代码,后续实现行仍需方案批准。 -ORG8-1,组织账号需求规约更新,"把员工、主管、财务、管理员、停用和企业微信绑定的当前口径补入现有事实源或确认现有事实源已覆盖。","1) 组织账号主数据口径清楚;2) 不把管理员角色当作业务审批人;3) 企业微信只做身份和入口绑定;4) 冻结项不进入。","流程级验证:rg -n '组织|账号|直属主管|停用|角色|企业微信绑定|管理员' docs/管理员手册.md docs/需求-企业微信基础设施规约.md docs/海音达OA-MVP需求规格说明书.md。",rg|manual,TODO,TODO,TODO,docs/管理员手册.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md,"[""ORG8-0""]",先做事实源对齐;不足再补文档。 -ORG8-2,角色边界设计,"设计员工、直属主管、审批人、财务和管理员的边界,明确最小权限和不兼容角色组合。","1) 角色能力矩阵清楚;2) 财务与系统管理混授风险可识别;3) admin-only 不进入业务审批;4) 有回滚和审计口径。","流程级验证:人工审查角色矩阵;rg -n '员工|主管|审批人|财务|管理员|角色边界|最小权限' docs/管理员手册.md docs/开发交付与变更管理规约.md。",rg|manual,TODO,TODO,TODO,docs/管理员手册.md|docs/开发交付与变更管理规约.md,"[""ORG8-1""]",涉及权限模型实现前必须单独方案批准。 +ORG8-1,组织账号需求规约更新,"把员工、主管、财务、管理员、停用和企业微信绑定的当前口径补入现有事实源或确认现有事实源已覆盖。","1) 组织账号主数据口径清楚;2) 不把管理员角色当作业务审批人;3) 企业微信只做身份和入口绑定;4) 冻结项不进入。","流程级验证:rg -n '组织|账号|直属主管|停用|角色|企业微信绑定|管理员' docs/管理员手册.md docs/需求-企业微信基础设施规约.md docs/海音达OA-MVP需求规格说明书.md。",rg|manual,DONE,DONE,DONE,docs/管理员手册.md|docs/需求-企业微信基础设施规约.md|docs/海音达OA-MVP需求规格说明书.md,"[""ORG8-0""]",已在管理员手册补 ORG8 组织账号主数据口径;rg 复核管理员手册、企业微信规约和 PRD 通过;未执行账号数据变更。 +ORG8-2,角色边界设计,"设计员工、直属主管、审批人、财务和管理员的边界,明确最小权限和不兼容角色组合。","1) 角色能力矩阵清楚;2) 财务与系统管理混授风险可识别;3) admin-only 不进入业务审批;4) 有回滚和审计口径。","流程级验证:人工审查角色矩阵;rg -n '员工|主管|审批人|财务|管理员|角色边界|最小权限' docs/管理员手册.md docs/开发交付与变更管理规约.md。",rg|manual,DONE,DONE,DONE,docs/管理员手册.md|docs/开发交付与变更管理规约.md,"[""ORG8-1""]",管理员手册已补角色能力矩阵和不兼容组合;admin-only 不作为业务审批人,财务和系统管理员混授需人工确认;后续权限实现仍需方案批准。 ORG8-3,直属主管缺失审计,"建立直属主管缺失的只读审计口径,识别会影响审批链的员工账号。","1) 缺直属主管的员工可列出摘要;2) 不打印隐私和密码;3) 不直接写生产数据;4) 缺口进入修复分流。","流程级验证:在只读环境执行员工和主管关系核验;无环境时记录可复现 SQL 或脚本步骤。",manual|node,TODO,TODO,TODO,scripts/qa|server/prisma,"[""ORG8-2""]",生产核验必须遵守 audit-readonly 边界。 ORG8-4,主管停用影响审计,"识别直属主管被停用后对请假、报销、采购审批链的影响。","1) 停用主管关联员工可追溯;2) 受影响流程明确;3) 不自动改审批链;4) 有人工处理建议。","流程级验证:只读核验停用主管和下属关系;流程核对员工提交请假或报销时审批链是否可解释。",manual|node,TODO,TODO,TODO,scripts/qa|server/src,"[""ORG8-3""]",不在审计中修数据。 ORG8-5,审批人停用影响审计,"识别审批人停用后待办、历史记录和新流程分派的影响。","1) 待办不分配给停用审批人;2) 历史审批记录不丢失;3) 新流程有替代规则;4) 异常可追溯。","流程级验证:提交或模拟审批流 -> 停用审批人场景 -> 检查待办归属和历史记录。",manual|node,TODO,TODO,TODO,server/src|scripts/qa,"[""ORG8-4""]",涉及状态机或待办迁移时需 reviewer。