工作流全流程调整

📋 概述

目前工作流存在一些问题，主要原因包括：

平台配置调整的不足
用户对于工作流的理解不够

本文档旨在详细说明工作流的配置和使用方法，帮助用户更好地理解和使用审批流程。

⚠️ 注意：请仔细审核工作流程，流程的名称与过程还在调整中。

🔄 生产环境审批流程汇总

本系统目前配置了 19 个流程（18 个有效 + 1 个已废弃）：

有效流程：18 个
已废弃：1 个（SOP-501，已被 SOP-503/504 替代）
新增推荐：SOP-503 批量调整广告账户政策标签（需审批）✨
新增推荐：SOP-504 批量账户政策标签设置（无审批）✨ 推荐
新增：SOP-601 外采帐户充值审批 ✨
新增：SOP-602 外采端口入帐审批 ✨
新增：SOP-603 端口充值审批 ✨

1. 新政策标签

配置文件：policy_label_create_prod.yaml

发起申请 → 上级部门审批 → 抄送 → 生效

步骤	审批人
部门审批	连续多级部门负责人
抄送	媒介 + 财务 + 负责人

2. 新客政策报备

配置文件：add_policy_prod.yaml

发起申请 → 上级部门审批 → 抄送 → 生效

步骤	审批人
部门审批	连续多级部门负责人
抄送	媒介 + 财务

3. 批量调整政策标签 🚫 已废弃 (SOP-501)

已废弃：本流程已被 SOP-503：批量调整广告账户政策标签替代

配置文件：discount_adjust_prod.yaml（已废弃，请使用 503_batch_policy_label_adjust_prod.yaml）

发起申请 → 部门审批 → 财务审批 → 生效 → 抄送

步骤	审批人
部门审批	连续多级部门负责人
财务审批	指定2名财务
抄送	媒介 + 财务 + 负责人

废弃原因： - 旧版本采用 Excel 导入方式，操作复杂 - 新版本 SOP-503 提供直观的 UI 界面操作 - 新版本支持四种政策类型独立配置（折扣、后返、扣款、奖励）

4. 资金池垫款入账

配置文件：recharge_credit_prod.yaml

发起申请 → 部门审批 → 中台审批 → 生效 → 抄送

步骤	审批人
部门审批	连续多级部门负责人
中台审批	中台负责人
抄送	媒介 + 财务 + 负责人

5. 资金池挂帐入帐

配置文件：recharge_pending_prod.yaml

发起申请 → 媒介审批 → 生效

步骤	审批人
媒介审批	媒介 / 媒介经理

6. 资金池入账

配置文件：recharge_prod.yaml

发起申请 → 财务审批 → 生效

步骤	审批人
财务审批	财务

7. 资金池提现

配置文件：withdraw_prod.yaml

发起申请 → 部门审批 → 中台审批 → 财务审批 → 总部审批 → 抄送

步骤	审批人
部门审批	连续多级部门负责人
中台审批	中台
财务审批	财务
总部审批	尹博
抄送	媒介 + 财务

8. 钱包充值

配置文件：wallet_transfer_prod.yaml

发起申请 → 媒介审批 → 生效

步骤	审批人
媒介审批	媒介

9. 钱包充值退款

配置文件：wallet_refund_prod.yaml

发起申请 → 媒介审批 → 生效

步骤	审批人
媒介审批	媒介

10. 广告帐户充值

配置文件：transaction_prod.yaml

发起申请 → 媒介审批 → 生效 → 抄送

步骤	审批人
媒介审批	媒介 / 媒介经理
抄送	总负责人 + 部门负责人 + 媒介 + 财务

11. 广告帐户退款

配置文件：transfer_refund_prod.yaml

发起申请 → 媒介审批 → 生效 → 抄送

步骤	审批人
媒介审批	媒介 / 媒介经理
抄送	媒介 + 财务 + 负责人

12. 创建合同

配置文件：create_contact_prod.yaml

发起申请 → 人事审批 → 生效

步骤	审批人
人事审批	人事

13. 批量调整广告账户政策标签 (SOP-503)

配置文件：503_batch_policy_label_adjust_prod.yaml SOP 文档：SOP-503：批量调整广告账户政策标签 E2E 测试 功能路径：广告账户列表 → 批量选择 → 批量调整政策标签按钮 → 对话框配置 → 提交审批特点：需要审批流程

发起申请 → 部门审批 → 财务审批 → 生效 → 抄送

步骤	审批人
部门审批	连续多级部门负责人（`leader_depth: -1`）
财务审批	指定2名财务（往来会计、总账会计、税务会计、财务主管、财务总）
抄送	媒介 + 媒介经理 + 财务 + 部门领导

功能特性： - ✅ 直观的UI界面操作，无需Excel文件 - ✅ 支持四种政策类型独立配置（折扣、后返、扣款、奖励） - ✅ 支持单选、多选、全选广告账户 - ✅ 每种政策可选择"不设置"选项 - ✅ 实时显示选中账户和数量 - ✅ 审批通过后自动批量生效 - ✅ 适用于需要严格审批的大规模调整

替代关系： - 本流程替代旧版 SOP-501：批量调整政策标签 - 旧版采用Excel导入方式，新版采用UI界面操作

超时设置：24小时自动驳回

14. 批量账户政策标签设置 (SOP-504) ✨ 推荐

SOP 文档：SOP-504：批量账户政策标签设置 功能路径：广告账户列表 → 批量选择 → 批量设置政策标签按钮 → 对话框配置 → 直接应用特点：无需审批，即时生效

graph LR
    A[选择账户] --> B[打开设置对话框]
    B --> C[选择政策标签]
    C --> D[直接应用]
    D --> E[即时生效]

功能特性： - ✅ 直观的UI界面操作 - ✅ 支持四种政策类型独立配置（折扣、后返、扣款、奖励） - ✅ 2列网格布局，文本自动截断 - ✅ 支持单选、多选、全选广告账户 - ✅ 每种政策可选择"不设置"选项 - ✅ 实时显示选中账户和数量 - ✅ 无需审批，直接应用 - ✅ 操作即时生效，效率高 - ✅ 适用于日常快速批量设置

与 SOP-503 的区别： - SOP-503：需要审批流程，适用于大规模调整 - SOP-504：无需审批，即时生效，适用于日常操作

技术实现： - 使用新的批量政策标签组件 - 自动获取客户政策标签（支持多客户交集） - 批量API调用优化 - 完善的错误处理和用户反馈

15. 外采帐户充值审批 (SOP-601) ✨ 新增

配置文件：external_recharge_prod.yaml SOP 文档：SOP-601：外采帐户充值审批 E2E 测试 功能路径：财务管理 → 充值管理 → 新建充值 → 选择外采帐户 → 提交审批 参考流程：SOP-401 广告账户充值审批

graph LR
    A[发起申请] --> B[媒介审批]
    B --> C[自动生效]
    C --> D[抄送通知]

步骤	审批人	审批模式	超时
媒介审批	媒介/媒介经理	任一人	24小时
抄送	总负责人 + 部门负责人 + 媒介 + 财务	-	-

功能特性： - ✅ 自动识别外采帐户 - ✅ 自动检查端口余额 - ✅ 审批通过后自动执行充值 - ✅ 实时更新帐户余额 - ✅ 支持附件上传（转账凭证） - ✅ 支持按金额分级审批（可选）

触发条件： - 目标帐户为外采帐户（provider = EXTERNAL） - 或充值请求勾选"使用外采"选项

审批事件：transOrder.external.recharge

15. 外采端口入帐审批 (SOP-602) ✨ 新增

配置文件：external_transfer_prod.yaml SOP 文档：SOP-602：外采端口入帐审批 E2E 测试 功能路径：财务管理 → 转账管理 → 新建转账 → 选择外采帐户 → 提交审批 参考流程：SOP-401 广告账户充值审批

graph LR
    A[发起申请] --> B[媒介审批]
    B --> C[自动生效]
    C --> D[抄送通知]

步骤	审批人	审批模式	超时
媒介审批	媒介/媒介经理	任一人	24小时
抄送	总负责人 + 部门负责人 + 媒介 + 财务	-	-

功能特性： - ✅ 自动识别外采端口 - ✅ 自动检查端口余额充足性 - ✅ 审批通过后自动执行入帐 - ✅ 自动扣减端口余额 - ✅ 自动应用政策标签 - ✅ 更新消费日报和资金流表 - ✅ 支持按金额分级审批（可选）

触发条件： - 目标帐户为外采帐户 - 使用外部端口余额进行转账

审批事件：transOrder.external.transfer

注意事项： - ⚠️ 需提前确认端口余额充足 - ⚠️ 需选择正确的政策标签（折扣/后返等） - ⚠️ 入帐会同时更新多个数据表，操作不可撤销

16. 端口充值审批 (SOP-603) ✨ 新增

配置文件：20260129_create_porter_recharge_review_template.sql SOP 文档：SOP-603：端口充值审批 功能路径：财务管理 → 广告账户 → 端口标签 → 外采端口充值 参考流程：直接端口充值（不涉及客户）

graph LR
    A[发起申请] --> B[财务审批]
    B --> C[自动生效]
    C --> D[更新端口余额]

步骤	审批人	审批模式	超时
财务审批	往来会计/总账会计/税务会计/财务主管/财务总监	任一人	24小时

功能特性： - ✅ 为外采端口直接充值（不关联客户） - ✅ 自动识别外采端口 - ✅ 审批通过后自动更新端口余额 - ✅ 支持充值凭证上传（最多3张） - ✅ 财务单步审批，流程简洁高效

触发条件： - 通过"外采端口充值"功能提交 - 订单类型：ORDER_TYPE_PORTER_RECHARGE - 触发事件：transOrder.porter.recharge

审批事件：transOrder.porter.recharge

与 SOP-601 的区别： - SOP-601：外采帐户充值 - 为客户的广告帐户充值（需关联客户） - SOP-603：端口充值 - 为外采端口本身充值（不关联客户）

余额更新：

新余额 = 原余额 + 充值金额

👥 部门审批机制

多级部门审批说明

CRM 系统会根据发起人所在的部门层级，逐级向上进行审批。

示例：部门层级结构

邓攀 → 符小兰 → 陈卓钰 → Soso

审批流程示例：

当邓攀发起流程时，审批顺序为：符小兰 → 陈卓钰 → Soso
当符小兰发起流程时，审批顺序为：陈卓钰 → Soso
以此类推...

测试前准备

在测试流程时，请注意：

账号准备：CRM 已同步企业微信的部门层级、岗位和领导关系
数据检查：如有缺失，请与技术沟通处理
账号获取：需要领导账号可访问账号文档
信息提供：如文档中没有所需账号，请提供姓名与部门给技术人员

验证方式

查看部门信息

进入 后台设置 → 部门
查看部门层级结构

查看用户信息

进入 后台设置 → 用户
检查以下信息：
✅ 岗位名称是否正确
✅ 部门是否正确
✅ 是否配置了上级领导

⚠️ 如发现错误，请联系技术人员处理

✨ 工作流功能调整

已完成的优化

1. 审批人显示优化

调整前：显示"审核人"
调整后：显示"待审批"，更清楚地表示哪些用户可以审批此流程

2. 操作按钮智能化

系统会根据当前用户的角色自动显示相应的操作按钮：

用户角色	显示的操作
审批人	批准、拒绝
发起人	撤销

3. 撤销功能

新增了撤销流程功能，发起人可以在流程未完成前撤销申请。

📊 流程详情增强

新增功能

1. 三个 Tab 页

流程详情页面现在包含以下三个标签页：

流程详情：显示流程的基本信息和当前状态
审核历史：显示审核过程的完整记录
评论：支持参与者进行文本讨论

2. 审核历史

完整展示审核过程的上下游关系
可通过历史记录对比流程是否完整正确

3. 评论功能

支持在流程中添加文本讨论
方便参与者进行沟通和记录

🚧 待完成工作

已知问题

部门领导显示问题
现状：上级部门的审核功能正常且正确
问题：一次会显示所有的部门领导
计划：优化显示逻辑，只显示当前环节的审批人
同岗位多人审核
现状：同岗位的多个人员审核功能还需要调整
计划：完善多人审核的逻辑和显示

🏢 外采审批流程专区

外采业务说明

外采（External Procurement）是指通过外部端口进行的广告投放业务，具有以下特点：

📌 使用外部供应商提供的广告端口
📌 需要独立的资金管理和审批流程
📌 涉及端口余额的管理和监控
📌 通常具有特殊的政策和折扣规则

外采审批流程对比

SOP编号	流程名称	审批级数	适用场景	配置文件
SOP-601	外采帐户充值	1级	所有金额	external_recharge_prod.yaml
SOP-601S	外采帐户充值（简化）	1级	测试环境	external_recharge_simple.yaml
SOP-601L	外采充值-小额	1级	< 5000元	external_recharge_low.yaml
SOP-601M	外采充值-中额	2级	5000-20000元	external_recharge_medium.yaml
SOP-601H	外采充值-大额	3级	≥ 20000元	external_recharge_high.yaml
SOP-602	外采端口入帐	1级	所有金额	external_transfer_prod.yaml
SOP-602S	外采端口入帐（简化）	1级	测试环境	external_transfer_simple.yaml
SOP-602L	外采入帐-小额	1级	< 10000元	external_transfer_low.yaml
SOP-602H	外采入帐-大额	2级	≥ 10000元	external_transfer_high.yaml
SOP-603	端口充值	1级	所有金额	20260129_create_porter_recharge_review_template.sql

资金流向图

graph TD
    A[外部资金] --> B[SOP-603: 端口充值]
    A --> C[SOP-601: 帐户充值]
    B --> D[端口余额]
    C --> E[广告帐户余额]
    D --> F[SOP-602: 端口入帐]
    F --> E

    style B fill:#90EE90
    style C fill:#87CEEB
    style F fill:#FFD700

流程说明： - SOP-603（端口充值）：外部资金 → 端口余额 - SOP-601（帐户充值）：外部资金 → 广告帐户余额 - SOP-602（端口入帐）：端口余额 → 广告帐户余额

配置部署

步骤1: 选择方案并执行 SQL

# 进入 core 目录
cd /path/to/crm/core

# 执行对应的 SQL 文件（选择其中一个）
psql -U postgres -d your_database -f migrations/20260127_create_external_review_templates.sql

步骤2: 验证配置

-- 查询外采审批模板
SELECT sop_number, name, is_active
FROM review_templates
WHERE sop_number LIKE 'SOP-%-EXT-%'
ORDER BY sop_number;

步骤3: 配置角色

确保以下角色已创建并分配用户： - 财务主管 - 财务经理 - CFO - 运营主管 - 运营经理 - COO - 总经理 - CEO

步骤4: 测试流程

参考各 SOP 文档中的测试指南进行功能测试。

外采审批流程图示

外采充值审批流程

graph TB
    Start[用户发起外采充值] --> Check{系统检查}
    Check -->|外采帐户| Review[创建审批流程]
    Check -->|普通帐户| Direct[直接充值]

    Review --> Step1[Step1: 财务审核]
    Step1 -->|批准| Step2[Step2: 总经理审批]
    Step1 -->|驳回| Reject[充值失败]

    Step2 -->|批准| Execute[执行充值]
    Step2 -->|驳回| Reject

    Execute --> Update[更新帐户余额]
    Update --> Notify[发送通知]
    Notify --> End[完成]

    Reject --> NotifyReject[发送驳回通知]
    NotifyReject --> End

外采入帐审批流程

graph TB
    Start[用户发起外采入帐] --> CheckPort{检查端口余额}
    CheckPort -->|余额充足| Review[创建审批流程]
    CheckPort -->|余额不足| Error[提示错误]

    Review --> Step1[Step1: 运营审核]
    Step1 -->|批准| Step2[Step2: 财务审核]
    Step1 -->|驳回| Reject[入帐失败]

    Step2 -->|批准| Execute[执行入帐]
    Step2 -->|驳回| Reject

    Execute --> Deduct[扣减端口余额]
    Deduct --> Credit[增加帐户余额]
    Credit --> Policy[应用政策标签]
    Policy --> Update[更新日报和资金流]
    Update --> Notify[发送通知]
    Notify --> End[完成]

    Reject --> NotifyReject[发送驳回通知]
    NotifyReject --> End

监控和维护

端口余额监控

-- 查询端口余额告警
SELECT
    porter,
    balance,
    CASE
        WHEN balance < 10000 THEN '🔴 余额不足'
        WHEN balance < 50000 THEN '🟡 余额偏低'
        ELSE '🟢 余额充足'
    END AS status
FROM ext_corps
WHERE porter IS NOT NULL
ORDER BY balance;

审批效率统计

-- 外采审批流程效率统计
SELECT
    t.sop_number,
    t.name,
    COUNT(ri.id) AS total,
    AVG(EXTRACT(EPOCH FROM (ri.completed_at - ri.created_at))/3600) AS avg_hours,
    SUM(CASE WHEN ri.status = 'APPROVED' THEN 1 ELSE 0 END) AS approved,
    SUM(CASE WHEN ri.status = 'REJECTED' THEN 1 ELSE 0 END) AS rejected
FROM review_templates t
LEFT JOIN review_instances ri ON t.id = ri.template_id
WHERE t.sop_number LIKE 'SOP-%-EXT-%'
  AND ri.completed_at IS NOT NULL
GROUP BY t.sop_number, t.name
ORDER BY t.sop_number;

👥 部门审批机制

多级部门审批说明

CRM 系统会根据发起人所在的部门层级，逐级向上进行审批。

示例：部门层级结构

邓攀 → 符小兰 → 陈卓钰 → Soso

审批流程示例：

当邓攀发起流程时，审批顺序为：符小兰 → 陈卓钰 → Soso
当符小兰发起流程时，审批顺序为：陈卓钰 → Soso
以此类推...

测试前准备

在测试流程时，请注意：

账号准备：CRM 已同步企业微信的部门层级、岗位和领导关系
数据检查：如有缺失，请与技术沟通处理
账号获取：需要领导账号可访问账号文档
信息提供：如文档中没有所需账号，请提供姓名与部门给技术人员

验证方式

查看部门信息

进入 后台设置 → 部门
查看部门层级结构

查看用户信息

进入 后台设置 → 用户
检查以下信息：
✅ 岗位名称是否正确
✅ 部门是否正确
✅ 是否配置了上级领导

⚠️ 如发现错误，请联系技术人员处理

✨ 工作流功能调整

已完成的优化

1. 审批人显示优化

调整前：显示"审核人"
调整后：显示"待审批"，更清楚地表示哪些用户可以审批此流程

2. 操作按钮智能化

系统会根据当前用户的角色自动显示相应的操作按钮：

用户角色	显示的操作
审批人	批准、拒绝
发起人	撤销

3. 撤销功能

新增了撤销流程功能，发起人可以在流程未完成前撤销申请。

📊 流程详情增强

新增功能

1. 三个 Tab 页

流程详情页面现在包含以下三个标签页：

流程详情：显示流程的基本信息和当前状态
审核历史：显示审核过程的完整记录
评论：支持参与者进行文本讨论

2. 审核历史

完整展示审核过程的上下游关系
可通过历史记录对比流程是否完整正确

3. 评论功能

支持在流程中添加文本讨论
方便参与者进行沟通和记录

🚧 待完成工作

已知问题

部门领导显示问题
现状：上级部门的审核功能正常且正确
问题：一次会显示所有的部门领导
计划：优化显示逻辑，只显示当前环节的审批人
同岗位多人审核
现状：同岗位的多个人员审核功能还需要调整
计划：完善多人审核的逻辑和显示

📚 外采审批流程文档索引

SOP 文档

技术文档

SQL 文件

文件	说明	适用场景
`20260127_create_external_review_templates.sql`	标准版（SOP-601, SOP-602）	生产环境
`20260127_create_external_review_templates_simple.sql`	简化版（1级审批）	测试/小团队
`20260127_create_external_review_templates_by_amount.sql`	分级版（1-3级）	大型企业
`20260129_create_porter_recharge_review_template.sql`	端口充值（SOP-603）	所有环境
`20260127_rollback_external_review_templates.sql`	回滚脚本	删除/禁用

📞 技术支持

联系方式

如有任何问题或需要帮助，请联系：

技术支持：tech-support@example.com
运营咨询：operations@example.com
财务咨询：finance@example.com
流程管理：process@example.com

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search

工作流全流程调整

📋 概述

🔄 生产环境审批流程汇总

1. 新政策标签

2. 新客政策报备

3. ~~批量调整政策标签~~ 🚫 已废弃 (SOP-501)

4. 资金池垫款入账

5. 资金池挂帐入帐

6. 资金池入账

7. 资金池提现

8. 钱包充值

9. 钱包充值退款

10. 广告帐户充值

11. 广告帐户退款

12. 创建合同

13. 批量调整广告账户政策标签 (SOP-503)

14. 批量账户政策标签设置 (SOP-504) ✨ 推荐

15. 外采帐户充值审批 (SOP-601) ✨ 新增

15. 外采端口入帐审批 (SOP-602) ✨ 新增

16. 端口充值审批 (SOP-603) ✨ 新增

👥 部门审批机制

多级部门审批说明

示例：部门层级结构

测试前准备

验证方式

查看部门信息

查看用户信息

✨ 工作流功能调整

已完成的优化

1. 审批人显示优化

2. 操作按钮智能化

3. 撤销功能

📊 流程详情增强

新增功能

1. 三个 Tab 页

2. 审核历史

3. 评论功能

🚧 待完成工作

已知问题

🏢 外采审批流程专区

外采业务说明

外采审批流程对比

资金流向图

推荐配置方案

方案1：标准方案（推荐大多数企业）

方案2：简化方案（推荐小团队/测试环境）

方案3：分级方案（推荐大型企业）

配置部署

步骤1: 选择方案并执行 SQL

步骤2: 验证配置

步骤3: 配置角色

步骤4: 测试流程

外采审批流程图示

外采充值审批流程

外采入帐审批流程

监控和维护

端口余额监控

审批效率统计

👥 部门审批机制

多级部门审批说明

示例：部门层级结构

测试前准备

验证方式

查看部门信息

查看用户信息

✨ 工作流功能调整

已完成的优化

1. 审批人显示优化

2. 操作按钮智能化

3. 撤销功能

📊 流程详情增强

新增功能

1. 三个 Tab 页

2. 审核历史

3. 评论功能

🚧 待完成工作

已知问题

📚 外采审批流程文档索引

SOP 文档

技术文档

3. 批量调整政策标签 🚫 已废弃 (SOP-501)