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 + 主列表`
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
## 1. 你每周主要会用到什么
|
||||
- `Portal`：看公告、我的待办、我的资产、本周周报入口。
|
||||
- `审批`：处理分配给你的报销、请假、采购、差旅等审批。
|
||||
- `团队`：更新今天是在岗、居家、外出还是出差。
|
||||
- `请假`：提交并查看请假记录。
|
||||
- `报销`：继续提交和跟踪报销。
|
||||
@@ -32,8 +33,9 @@
|
||||
- 可填写优先级和截止日期。
|
||||
- 完成后及时点完成，避免 Portal 一直堆积。
|
||||
|
||||
## 6. 请假和报销
|
||||
- 继续按现有流程提交。
|
||||
## 6. 审批、请假和报销
|
||||
- 公司正式审批都在海音达工作台内完成，不在企业微信审批里处理。
|
||||
- 请假、补卡、外出、加班、报销、采购、差旅等申请都按 OA 页面提交。
|
||||
- 批准后的请假会自动反映到团队状态。
|
||||
- 报销状态仍可在系统内查看，不需要额外问行政。
|
||||
|
||||
@@ -46,14 +48,16 @@
|
||||
- 每周五提交周报
|
||||
- 状态有变化时及时更新 `团队`
|
||||
- 有通知先看站内消息，IM 只是补充提醒
|
||||
- 收到企业微信审批提醒时，点开后回到 OA 页面处理。
|
||||
|
||||
## 9. 从企业微信进入
|
||||
- 如果公司启用了企业微信工作台入口，优先从企业微信打开海音达工作台。
|
||||
- 企业微信只是入口和提醒，真正填写和修改仍在海音达工作台页面内完成。
|
||||
- 企业微信只是入口、免登和提醒，真正填写、审批和修改仍在海音达工作台页面内完成。
|
||||
- 企业微信打卡仍按公司要求使用；请假、补卡、外出、加班等修正申请在 OA 内提交。
|
||||
- 如果企业微信免登失败，直接回到账号密码登录即可。
|
||||
- 如果你第一次从企业微信进入但看到“尚未绑定”，请不要反复重试，先用账号密码登录，再到 `个人设置 -> 企业微信绑定` 完成绑定。
|
||||
- 如果看到“登录已失效 / 已超时”，重新从企业微信工作台进入即可。
|
||||
- 日常建议：在企业微信里打开海音达工作台，看 `Portal` 和通知；复杂填写、项目更新、报销与周报仍在工作台页面里完成。
|
||||
- 日常建议：手机从企业微信打开海音达工作台，PC 直接登录 OA；审批、项目更新、报销与周报都在工作台页面里完成。
|
||||
|
||||
## 10. 项目怎么用
|
||||
- 如果你是项目成员，优先在 `项目` 页面查看自己的里程碑、任务、风险和交付记录。
|
||||
|
||||
@@ -5,6 +5,22 @@
|
||||
|
||||
---
|
||||
|
||||
## 平台边界
|
||||
|
||||
### P0-1 OA 唯一审批中心
|
||||
- `hyb-oa` 是公司唯一业务主系统和唯一审批中心。
|
||||
- 报销、采购、费用、合同、请假、补卡、外出、加班、出差等正式审批，都必须在 OA 内提交、审批、留痕、归档。
|
||||
- 企业微信原生审批不作为公司正式审批入口；不得出现一部分审批在企业微信、一部分审批在 OA 的割裂口径。
|
||||
- 企业微信只作为基础设施：手机工作台入口、免登/绑定、通讯录身份、消息通知、打卡原始采集。
|
||||
|
||||
### P0-2 企业微信打卡与 OA 考勤口径
|
||||
- 企业微信打卡用于原始采集，保留其定位、人脸、Wi-Fi、规则与设备能力。
|
||||
- OA 后续可同步企业微信打卡原始记录，并结合 OA 内的请假、补卡、外出、加班审批形成正式考勤口径。
|
||||
- 请假、补卡、外出、加班等考勤修正审批仍在 OA 完成，不走企业微信审批。
|
||||
- 第一阶段不新增打卡 API 同步实现，先冻结边界，避免在审批中心收口时扩大战线。
|
||||
|
||||
---
|
||||
|
||||
## 请假模块
|
||||
|
||||
### L-1 团队日历可见性
|
||||
|
||||
@@ -9,6 +9,7 @@
|
||||
- 发票是报销凭证，附件是补充材料，二者不能混用。
|
||||
- 已经报销、他人已报销、重复上传的发票不能加入新的报销单。
|
||||
- 服务端必须强约束，前端只负责友好提示。
|
||||
- 报销审批必须在 OA 内完成，企业微信只发送提醒和 deeplink，不作为报销审批流或财务附件主库。
|
||||
|
||||
## 发票状态
|
||||
|
||||
|
||||
在新工单中引用
屏蔽一个用户