chore: 完成 R17 小团队上线收口与默认配置

2026-03-21 20:32:00 +08:00
@@ -0,0 +1,76 @@
+# hyb-oa 管理员手册（10 人以下团队版）
+
+## 1. 适用范围
+- 适用于 `small_team_internal` 工作区模式。
+- 适用于单公司、少部门、全员账号密码登录的小团队。
+- 目标不是替代飞书/钉钉等 SaaS，而是把内部高频管理动作收口到一个系统。
+
+## 2. 管理员每周固定动作
+- 周一：查看 `Portal` 的团队状态、上周周报汇总、入离职待办、资产待归还。
+- 周中：处理公告、请假审批、员工档案更新、离职阻塞项。
+- 周五：催交周报、查看高优先级待办、确认下周请假和资产交接。
+
+## 3. 首次上线最小配置
+1. 进入 `工作区设置`，确认产品模式为 `small_team_internal`。
+2. 仅保留主导航：`Portal`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`。
+3. 将 `采购`、`差旅`、`预算`、`支付批次`、`AP 运营` 等模块降级为管理员备用。
+4. 在 `用户管理` 中按推荐预设配置：老板 / 管理员 / 主管 / 员工。
+5. 检查功能开关：
+   - 建议开启：`portal_home_v1`、`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`
+   - 建议保留备用：`payment_batch_v1`、`cutover_console_v1`
+
+## 4. 人员生命周期管理
+### 4.1 入职
+1. 在 `人员管理` 创建员工账号。
+2. 打开员工详情页，补齐部门、职位、直属上级、试用期结束日、工作地点、紧急联系人。
+3. 发起 `入职`，系统会自动生成 checklist：账号初始化、资产发放、制度确认。
+4. checklist 全部完成后，员工状态自动从 `onboarding` 进入 `probation`。
+
+### 4.2 转正 / 调岗
+- `转正`：记录事件并将员工状态改为 `active`。
+- `调岗`：记录部门、直属上级、职位调整，同时生成调岗交接 checklist。
+- 这两个动作只做管理留痕，不引入复杂审批流。
+
+### 4.3 离职
+1. 发起 `离职` 后，系统自动生成离职 checklist：资产归还、权限回收、费用与审批清理、交接说明。
+2. 若员工仍有名下资产或待处理审批任务，系统不会自动完成离职。
+3. checklist 完成且阻塞清零后，账号会被停用，主业务入口对该账号不可再用。
+
+## 5. 团队状态管理
+- 员工每天可在 `Portal` 或 `团队` 页更新状态：在岗 / 居家 / 外出 / 出差。
+- 已批准请假会自动覆盖当天状态为 `请假`。
+- 管理员只需要看当天分布，不做打卡、迟到、排班和月度统计。
+
+## 6. 周报与待办
+- 周报固定三段：本周完成 / 当前阻塞 / 下周计划。
+- 建议每周五下班前提交，周一老板看团队汇总。
+- 需要跟进的事项可从周报沉淀为待办。
+- 高优先级待办建议由老板或管理员统一看板跟进。
+
+## 7. 公告与 Portal 使用建议
+- 公告只发公司级通知、制度更新、假期提醒，不做复杂 CMS。
+- `Portal` 首屏建议重点看：
+  - 今日团队状态
+  - 未提交周报人数
+  - 需协助员工
+  - 入/离职待办
+  - 资产待归还
+  - 审批待办
+
+## 8. 备用模块治理
+- 采购、差旅、预算、支付批次、AP 运营保留代码和历史数据，但不作为全员主路径。
+- 若短期完全不用，保持管理员可见即可，不必删除。
+- 只有出现真实场景时，再恢复到主导航或单独扩展。
+
+## 9. 推荐上线顺序
+1. 先开 `Portal + 公告 + 团队状态`
+2. 再推 `周报 + 待办`
+3. 同步启用 `入职/离职/资产交接`
+4. 最后根据实际需要保留轻量报销与请假
+
+## 10. 试点验收口径
+- 全员都能登录并进入 `Portal`
+- 至少 1 次真实入职或模拟入职跑通
+- 至少 1 次真实离职或模拟离职跑通
+- 全员连续 4 周提交周报
+- 管理员不再额外维护“今日在岗表”或“离职交接表”
@@ -0,0 +1,47 @@
+# hyb-oa 员工快速上手（10 人以下团队版）
+
+## 1. 你每周主要会用到什么
+- `Portal`：看公告、我的待办、我的资产、本周周报入口。
+- `团队`：更新今天是在岗、居家、外出还是出差。
+- `请假`：提交并查看请假记录。
+- `报销`：继续提交和跟踪报销。
+- `周报`：每周写一次三段式周报。
+- `待办`：记录和跟进个人事项。
+
+## 2. 第一次登录后建议先做三件事
+1. 检查个人资料是否正确。
+2. 打开 `团队` 更新今天状态。
+3. 打开 `周报` 页面，熟悉本周周报入口。
+
+## 3. 今日状态怎么填
+- `在岗`：今天主要在办公室。
+- `居家`：今天远程办公。
+- `外出`：今天外勤、不在办公室。
+- `出差`：今天在外地差旅。
+- 如果你已经请假获批，系统会自动显示 `请假`，不用手工改。
+
+## 4. 周报怎么写
+- 本周完成：写已经完成的主要工作。
+- 当前阻塞：写你卡住的事、需要谁协助。
+- 下周计划：写下周打算做什么。
+- 如果确实需要支持，勾选“需要协助”。
+
+## 5. 待办怎么用
+- 记录自己要跟进的事项。
+- 可填写优先级和截止日期。
+- 完成后及时点完成，避免 Portal 一直堆积。
+
+## 6. 请假和报销
+- 继续按现有流程提交。
+- 批准后的请假会自动反映到团队状态。
+- 报销状态仍可在系统内查看，不需要额外问行政。
+
+## 7. 入职 / 离职时你会看到什么
+- 入职时会有账号初始化、资产发放、制度确认等事项。
+- 离职前需要归还资产并完成交接，系统会提示阻塞项。
+
+## 8. 使用建议
+- 每天登录先看 `Portal`
+- 每周五提交周报
+- 状态有变化时及时更新 `团队`
+- 有通知先看站内消息，IM 只是补充提醒
@@ -336,3 +336,13 @@
 | R11-3 | 请假采购资产规格补齐 | §4.7-§4.9，§13.2.7-§13.2.9 | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13 | DONE | manual | 规格书已按当前代码与完成合同补齐请假 / 采购 / 资产的范围、权限、状态机、核心对象与显式不做项 |
 | R11-4 | 差旅集成规格补齐与 cross-cutting 同步 | §4.10-§4.11，§13.2.10-§13.2.11，§15-§16 | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13 | DONE | manual | 规格书已补齐 TRAVEL-1~3、IM-1、ERP-1~3 的已实现边界，并同步数据模型概览与迭代计划 |
 | R11-5 | R11矩阵事实源与文档校验收口 | §16 迭代计划（执行合同收口） | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13_10-30-00-r11-contract-reconciliation-and-spec-refresh.csv | 2026-03-13 | DONE | CSV 校验 + validate-feature-matrix + git diff --check | Feature Matrix、事实源校验器、R11 合同与文档变更已同步收口，历史 TODO 清账口径可追溯 |
+
+## R13-R17 小团队内部管理增量（2026-03-21）
+
+- **事实源**：`issues/2026-03-21_12-00-00-r13-small-team-profile.csv`、`issues/2026-03-21_12-10-00-r14-people-lifecycle.csv`、`issues/2026-03-21_12-20-00-r15-team-presence.csv`、`issues/2026-03-21_12-30-00-r16-weekly-report-todo.csv`、`issues/2026-03-21_12-40-00-r17-small-team-go-live.csv`
+- **R13 小团队模式收敛**：新增 `WorkspaceSetting` 单例配置、`/api/system/workspace` 与 `/api/system/navigation`，默认主导航收敛为 `Portal / 团队 / 请假 / 报销 / 资产 / 周报 / 待办 / 公告`，采购/差旅/预算/AP 等模块降级为管理员备用入口。
+- **R14 入转离与资产闭环**：扩展 `Employee` 就业状态字段，新增 `EmployeeLifecycleEvent`、`EmployeeChecklistTask`，支持入职、转正、调岗、离职、资产阻塞校验与账号停用闭环。
+- **R15 团队状态**：新增 `EmployeePresence` 与团队在岗视图，支持员工手工更新今日状态，请假自动覆盖为 `leave`。
+- **R16 周报与待办**：新增 `WeeklyReport` 与 `TodoItem`，支持周报懒创建、提交、团队汇总、待办创建/完成/取消，并接入 `Portal` 与搜索。
+- **R17 真可用收口**：新增小团队管理员手册、员工快速上手文档、trialrun 运行手册与检查项补充，支持以 `small_team_internal` 为默认上线模式。
+- **默认上线建议**：开启 `portal_home_v1`、`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`；保留 `payment_batch_v1`、`cutover_console_v1` 为管理员备用能力。