A1-A7 收口OA统一审批中心与企微基础设施路线
这个提交包含在：
+15
-8
@@ -3,7 +3,7 @@
|
||||
## 1. 适用范围
|
||||
- 适用于 `small_team_internal` 工作区模式。
|
||||
- 适用于单公司、少部门、全员账号密码登录的小团队。
|
||||
- 目标不是替代飞书/钉钉等 SaaS，而是把内部高频管理动作收口到一个系统。
|
||||
- 目标是把内部高频管理动作收口到 `hyb-oa`；企业微信只作为入口、身份、通知和打卡底座。
|
||||
|
||||
## 2. 管理员每周固定动作
|
||||
- 周一：查看 `Portal` 的团队状态、上周周报汇总、入离职待办、资产待归还。
|
||||
@@ -12,8 +12,8 @@
|
||||
|
||||
## 3. 首次上线最小配置
|
||||
1. 进入 `工作区设置`，确认产品模式为 `small_team_internal`。
|
||||
2. 仅保留主导航：`Portal`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`、`项目`。
|
||||
3. 将 `考勤`、`采购`、`差旅`、`预算`、`支付批次`、`AP 运营`、`ERP`、`AI` 等模块降级为隐藏或管理员备用。
|
||||
2. 仅保留主导航：`Portal`、`审批待办`、`团队`、`请假`、`报销`、`资产`、`周报`、`待办`、`公告`、`项目`。
|
||||
3. 将 `考勤`、`采购`、`差旅`、`预算`、`支付批次`、`AP 运营`、`ERP`、`AI` 等模块按真实启用情况保留为主路径或管理员备用；审批动作统一留在 OA。
|
||||
4. 在 `用户管理` 中按推荐预设配置：老板 / 管理员 / 主管 / 员工。
|
||||
5. 检查功能开关：
|
||||
- 建议开启：`portal_home_v1`、`announcements_v1`、`presence_board_v1`、`weekly_report_v1`、`employee_lifecycle_v1`、`todo_board_v1`、`global_search_v1`
|
||||
@@ -36,10 +36,12 @@
|
||||
2. 若员工仍有名下资产或待处理审批任务，系统不会自动完成离职。
|
||||
3. checklist 完成且阻塞清零后，账号会被停用，主业务入口对该账号不可再用。
|
||||
|
||||
## 5. 团队状态管理
|
||||
## 5. 团队状态与考勤口径
|
||||
- 员工每天可在 `Portal` 或 `团队` 页更新状态：在岗 / 居家 / 外出 / 出差。
|
||||
- 已批准请假会自动覆盖当天状态为 `请假`。
|
||||
- 管理员只需要看当天分布，不做打卡、迟到、排班和月度统计。
|
||||
- 企业微信打卡只作为原始采集工具；定位、人脸、Wi-Fi 和排班规则不在 OA 内重造。
|
||||
- OA 后续同步企业微信打卡数据后，应结合 OA 请假、补卡、外出、加班审批形成正式考勤口径。
|
||||
- 请假、补卡、外出、加班等审批仍在 OA 内完成，不使用企业微信原生审批。
|
||||
|
||||
## 6. 周报与待办
|
||||
- 周报固定三段：本周完成 / 当前阻塞 / 下周计划。
|
||||
@@ -84,13 +86,15 @@
|
||||
4. 连续 4 周都达到预期后，再将 R66 试点验收关单并形成最终验收结论。
|
||||
|
||||
## 12. 企业微信入口与登录策略
|
||||
- 建议把企业微信定位为 `入口 + 提醒 + 可选免登`，不要在企业微信里再维护第二套审批或项目录入路径。
|
||||
- 企业微信定位为 `入口 + 免登 + 通知 + 打卡原始采集`，不承载公司正式审批流。
|
||||
- 公司只维护一个企业微信自建应用，建议命名为 `海音达工作台`。
|
||||
- 默认工作台入口在企业微信手机端落到 `/mobile`；桌面浏览器和账号密码登录仍进入 `/portal`。员工真正操作仍在 `hyb-oa` 内完成。
|
||||
- 所有报销、采购、费用、合同、请假、补卡、外出、加班、出差审批都在 OA 内提交和审批；企业微信消息只负责提醒并 deeplink 回 OA。
|
||||
- 企微免登建议先完成账号绑定，再逐步在试点部门开启；任何时候都保留账号密码回退。
|
||||
- 若 OA 部署到公网，生产建议同时满足：`HTTPS`、`COOKIE_SECURE=true`、登录失败锁定、限流、审计开启。
|
||||
|
||||
### 正式接入最小步骤
|
||||
1. 在企业微信管理后台创建或编辑自建应用。
|
||||
1. 在企业微信管理后台创建或编辑唯一自建应用：`海音达工作台`。
|
||||
2. 将工作台入口配置为：`https://oa.hyinda.com/api/auth/wecom/login?returnTo=%2Fmobile`。
|
||||
3. 将 OAuth 回调地址配置为：`https://oa.hyinda.com/api/auth/wecom/callback`。
|
||||
4. 在 `deploy/trialrun/.env` 中补齐并开启：
|
||||
@@ -103,12 +107,14 @@
|
||||
- `WECOM_REDIRECT_URI=https://oa.hyinda.com/api/auth/wecom/callback`
|
||||
- `WECOM_ALLOWED_RETURN_HOSTS=oa.hyinda.com`
|
||||
5. 先让管理员用账号密码登录，在 `个人设置` 完成一次绑定，再测试企业微信工作台直达；已绑定用户从手机企业微信进入时应直接看到移动工作台。
|
||||
6. 不配置企业微信原生审批模板作为正式流程；审批提醒使用企业微信消息，审批动作回到 OA 页面完成。
|
||||
|
||||
### 员工会看到的典型状态
|
||||
- 未绑定：登录页会提示“当前企业微信账号尚未绑定”，回退到账号密码登录。
|
||||
- 已绑定：从企业微信工作台进入后直接落到 `/mobile`，桌面或普通浏览器场景仍可进入 `Portal`。
|
||||
- 入口未开放：个人设置仍可绑定，但登录页不会把企业微信作为正式入口展示。
|
||||
- 配置不完整：个人设置会明确提示缺少 `CorpID / AgentID / 回调地址` 等原因。
|
||||
- 收到审批提醒：点击后进入 OA 审批页，在 OA 中同意、驳回、退回或转审。
|
||||
|
||||
## 13. 轻项目管理使用建议
|
||||
- 项目主档只做轻量管理：成员、里程碑、任务、风险、交付记录、合同台账与资料引用。
|
||||
@@ -124,6 +130,7 @@
|
||||
- `hyb-oa` 只记录涉密合同或资料的元数据：编号、责任人、密级、归档位置、离线档案号。
|
||||
- 涉密正文、涉密附件、详细报价/成本/毛利、敏感客户资料不进入公网 OA。
|
||||
- 企业微信通知不得发送涉密正文，只保留最小必要信息和 deeplink。
|
||||
- 企业微信审批不作为涉密或财务审批载体，正式审批记录以 OA 审批历史和审计日志为准。
|
||||
- 如项目被标记为涉密，管理员应要求正文继续保存在内网文件盘、NAS 或离线档案中。
|
||||
|
||||
## 15. 初始化与导入建议
|
||||
@@ -176,7 +183,7 @@
|
||||
## 19. R29 设计与工作台治理口径
|
||||
- 首页不再做“模块超市”，而是先告诉员工今天该做什么。
|
||||
- 管理员不要把备用模块重新平铺到主导航，避免系统再次变成模块拼盘。
|
||||
- 员工入口默认认知应保持为：`企业微信进入 -> Portal 查看今日动作 -> 进入具体模块处理`。
|
||||
- 员工入口默认认知应保持为：`企业微信进入 -> OA 移动工作台 -> 进入审批/报销/请假等模块处理`；PC 用户可直接登录 OA。
|
||||
- 如果未来新增页面，请优先复用统一骨架：
|
||||
- 首页：`WorkbenchHero + MetricCard + SectionPanel`
|
||||
- 列表页：`PageHeader + FilterBar + 主列表`
|
||||
|
||||
在新工单中引用
屏蔽一个用户