CRM 系统 SOP 文档

本目录包含 CRM 系统的标准操作流程（Standard Operating Procedures，SOP）文档，用于指导测试人员、QA 工程师和自动化测试脚本执行端到端（E2E）测试。

📋 编号体系

所有 SOP 文档采用统一编号：SOP-XXX

  • SOP-001 ~ 099：基础功能
  • SOP-101 ~ 199：政策与产品管理
  • SOP-201 ~ 299：资金管理
  • SOP-301 ~ 399：钱包管理
  • SOP-401 ~ 499：广告账户管理
  • SOP-501 ~ 599：其他流程
  • SOP-601 ~ 699：外采管理

📖 查看完整编号说明
📥 Excel 模板下载 - 下载所有 SOP 的 Excel 测试模板

📚 文档分类

📦 基础功能 SOP

以下是 CRM 系统基础功能的操作文档：

SOP-001：客户创建 E2E 测试 SOP

  • 编号：SOP-001
  • 适用场景：http://localhost:3000/crm/customer 客户管理界面
  • 相关接口：POST /api/v1/customers、GET /api/v1/customers
  • 测试范围：客户创建的完整流程验证

SOP-002：客户创建快速指南

  • 编号：SOP-002
  • 适用场景：快速参考客户创建流程
  • 特点：简化版操作指南

SOP-003：产品创建 E2E 测试 SOP

  • 编号：SOP-003
  • 适用场景：http://localhost:3000/crm/product 产品管理界面
  • 相关接口：POST /api/v1/products、GET /api/v1/products
  • 测试范围：产品创建的完整流程验证

🔄 工作流审批 SOP

以下是工作流审批流程的详细操作文档：

政策与产品管理

SOP-101：政策标签创建 E2E 测试 SOP

  • 编号：SOP-101
  • 适用场景：http://localhost:3000/crm/order 订单管理界面
  • 相关接口：POST /api/v1/orders、GET /api/v1/products、GET /api/v1/policy-labels
  • 创建方式：通过订单中的政策类产品创建政策标签
  • 审批流程：订单提交后自动触发审批工作流
  • 配置文件：policy_label_create_prod.yaml

SOP-102：创建产品标签 SOP

  • 编号：SOP-102
  • 流程：发起申请 → 部门审批 → 财务审批 → 生效 → 抄送
  • 关键审批人：部门领导、财务（2名）
  • 配置文件：add_policy_prod.yaml
  • 适用场景：为现有产品添加标签

SOP-105：服务费审批 SOP ✨

  • 编号：SOP-105
  • 流程：发起申请 → 逐级领导审批 → 财务审批 → 自动生效 → 更新客户余额
  • 关键审批人：逐级领导、往来会计/总账会计/税务会计/财务主管/财务总监
  • 配置文件：通过 SQL 创建（20260226_create_service_fee_review_template.sql）
  • 适用场景：服务费订单审批（技术服务费、广告服务费、视频服务费、代运营费用）
  • 功能特性：
  • ✅ 支持多种服务费类型（按 AccountType 区分）
  • ✅ 逐级领导审批 + 财务审批两步流程
  • ✅ 审批通过后自动扣减客户余额
  • ✅ 生成 DEDUCT 类型的 Transaction 记录
  • 订单类型：ORDER_TYPE_SERVICE_FEE
  • 审批事件：transOrder.serviceFee

资金管理

SOP-201：资金池入账 SOP

  • 编号：SOP-201
  • 流程：发起申请 → 财务审批 → 生效
  • 关键审批人：财务
  • 配置文件：recharge_prod.yaml
  • 适用场景：普通资金入账

SOP-202：资金池挂账入账 SOP

  • 编号：SOP-202
  • 流程：发起申请 → 媒介审批 → 生效
  • 关键审批人：媒介/媒介经理
  • 配置文件：recharge_pending_prod.yaml
  • 适用场景：挂账资金入账

SOP-203：资金池垫款入账 SOP

  • 编号：SOP-203
  • 流程：发起申请 → 部门审批 → 中台审批 → 生效 → 抄送
  • 关键审批人：部门领导、中台负责人
  • 配置文件：recharge_credit_prod.yaml
  • 适用场景：垫款资金入账到资金池

SOP-204：资金池提现 SOP

  • 编号：SOP-204
  • 流程：发起申请 → 部门审批 → 中台审批 → 财务审批 → 总部审批 → 抄送
  • 关键审批人：中台负责人、财务、尹博（总部）
  • 配置文件：withdraw_prod.yaml
  • 适用场景：从资金池提现到银行账户
  • ⚠️ 注意：涉及真实资金，测试时需特别注意

钱包管理

SOP-301：钱包充值 SOP

  • 编号：SOP-301
  • 流程：发起申请 → 财务审批 → 生效
  • 关键审批人：财务
  • 配置文件：wallet_transfer_prod.yaml
  • 适用场景：客户钱包充值

SOP-302：钱包充值退款 SOP

  • 编号：SOP-302
  • 流程：发起申请 → 财务审批 → 生效
  • 关键审批人：财务
  • 配置文件：wallet_refund_prod.yaml
  • 适用场景：钱包充值退款处理

广告账户管理

SOP-401：广告账户充值 SOP

  • 编号：SOP-401
  • 流程：发起申请 → 媒介审批 → 生效 → 抄送
  • 关键审批人：媒介/媒介经理
  • 配置文件：transaction_prod.yaml
  • 适用场景：为广告账户充值

SOP-402：广告账户退款 SOP

  • 编号：SOP-402
  • 流程：发起申请 → 媒介审批 → 生效 → 抄送
  • 关键审批人：媒介/媒介经理
  • 配置文件：transfer_refund_prod.yaml
  • 适用场景：广告账户退款处理

其他流程

~~SOP-501：折扣比例调整 SOP~~ 🚫 已废弃

  • 编号：SOP-501
  • 流程：发起申请 → 部门审批 → 财务审批 → 生效 → 抄送
  • 关键审批人：部门领导、财务（2名）
  • 配置文件：discount_adjust_prod.yaml
  • 适用场景：通过Excel批量导入调整客户的政策标签折扣比例
  • ⚠️ 已废弃：请使用 SOP-503 替代
  • 废弃原因：新版本提供了更直观的UI界面操作方式

SOP-502：创建合同 SOP

  • 编号：SOP-502
  • 流程：发起申请 → 人事审批 → 生效
  • 关键审批人：人事
  • 配置文件：create_contact_prod.yaml
  • 适用场景：创建员工合同

SOP-503：批量调整广告账户政策标签 SOP

  • 编号：SOP-503
  • 流程：批量选择账户 → 设置政策标签 → 提交审批 → 多级审批 → 生效
  • 关键审批人：根据审批模板配置
  • 适用场景：需要审批的批量政策标签调整
  • 操作方式：表格多选 + 对话框配置 + 审批流程
  • 优势：
  • ✅ 直观的UI界面操作
  • ✅ 支持四种政策类型独立配置
  • ✅ 实时显示选中账户
  • ✅ 支持单选、多选、全选
  • ✅ 每种政策可选择"不设置"
  • ✅ 自动创建审批流程
  • 替代：替代 SOP-501 的Excel导入方式

SOP-504：批量账户政策标签设置 SOP ✨ 推荐

  • 编号：SOP-504
  • 流程：批量选择账户 → 设置政策标签 → 直接应用 → 即时生效
  • 关键审批人：无需审批
  • 适用场景：日常快速批量设置政策标签，无需审批流程
  • 操作方式：表格多选 + 对话框配置 + 直接应用
  • 优势：
  • ✅ 直观的UI界面操作
  • ✅ 支持四种政策类型独立配置
  • ✅ 2列网格布局，文本自动截断
  • ✅ 实时显示选中账户
  • ✅ 支持单选、多选、全选
  • ✅ 每种政策可选择"不设置"
  • ✅ 无需审批，即时生效
  • ✅ 操作简单，效率更高
  • 与 SOP-503 区别：无需审批流程，适合日常快速操作

外采管理

SOP-601：外采帐户充值审批 SOP ✨

  • 编号：SOP-601
  • 流程：发起申请 → 媒介审批 → 自动生效 → 抄送通知
  • 关键审批人：媒介/媒介经理
  • 配置文件：external_recharge_prod.yaml
  • 适用场景：为外采帐户充值（使用外部端口）
  • 功能特性：
  • ✅ 自动识别外采帐户
  • ✅ 自动检查端口余额
  • ✅ 审批通过后自动执行充值
  • ✅ 实时更新帐户余额
  • ✅ 支持附件上传（转账凭证）
  • ✅ 支持按金额分级审批（可选）
  • 触发条件：目标帐户为外采帐户（provider = EXTERNAL）
  • 审批事件：transOrder.external.recharge

SOP-602：外采端口入帐审批 SOP ✨

  • 编号：SOP-602
  • 流程：发起申请 → 媒介审批 → 自动生效 → 抄送通知
  • 关键审批人：媒介/媒介经理
  • 配置文件：external_transfer_prod.yaml
  • 适用场景：使用外采端口余额为广告帐户入帐
  • 功能特性：
  • ✅ 自动识别外采端口
  • ✅ 自动检查端口余额充足性
  • ✅ 审批通过后自动执行入帐
  • ✅ 自动扣减端口余额
  • ✅ 自动应用政策标签
  • ✅ 更新消费日报和资金流表
  • ✅ 支持按金额分级审批（可选）
  • 触发条件：目标帐户为外采帐户，使用外部端口余额进行转账
  • 审批事件：transOrder.external.transfer
  • ⚠️ 注意：
  • 需提前确认端口余额充足
  • 需选择正确的政策标签（折扣/后返等）
  • 入帐会同时更新多个数据表，操作不可撤销

SOP-603：端口充值审批 SOP ✨

  • 编号：SOP-603
  • 流程：发起申请 → 财务审批 → 自动生效 → 更新端口余额
  • 关键审批人：往来会计/总账会计/税务会计/财务主管/财务总监
  • 配置文件：通过 SQL 创建（20260129_create_porter_recharge_review_template.sql）
  • 适用场景：为外采端口直接充值（不关联客户）
  • 功能特性：
  • ✅ 为外采端口直接充值（不关联客户）
  • ✅ 自动识别外采端口
  • ✅ 审批通过后自动更新端口余额
  • ✅ 支持充值凭证上传（最多3张）
  • ✅ 财务单步审批，流程简洁高效
  • 触发条件：通过"外采端口充值"功能提交
  • 订单类型：ORDER_TYPE_PORTER_RECHARGE
  • 审批事件：transOrder.porter.recharge
  • 与 SOP-601 的区别：
  • SOP-601：外采帐户充值 - 为客户的广告帐户充值（需关联客户）
  • SOP-603：端口充值 - 为外采端口本身充值（不关联客户）

外采业务资金流向

外采业务的资金流转关系如下：

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

流程说明： - SOP-603：外部资金充值到端口余额（端口层面） - SOP-601：外部资金直接充值到广告帐户（客户层面） - SOP-602：使用端口余额为广告帐户入帐（端口→客户）

🛠️ Excel 报告生成工具

📥 下载 Excel 测试模板 - 所有 SOP 的 Excel 模板已预先生成，可直接下载使用

快速开始

使用 generate_excel.py 脚本可以自动从 Markdown 文档生成包含复选框、超链接和截图的 Excel 测试报告。

# 从 Markdown 文件自动生成（推荐）
python generate_excel.py --markdown sop-003-product-creation-e2e.md

# 使用默认参数
python generate_excel.py

# 自定义配置
python generate_excel.py \
  --markdown sop-003-product-creation-e2e.md \
  --output-prefix "产品测试报告" \
  --base-url "https://test.example.com/crm"

# 查看所有可用参数
python generate_excel.py --help

主要功能

  • 🎯 Markdown 自动解析：从 SOP markdown 文档自动提取任务表格（全自动化）
  • ✅ 可点击复选框：使用自定义格式实现真正的复选框（兼容 WPS/Excel/LibreOffice）
  • 🔗 智能超链接：任务间、步骤间可以点击跳转
  • 📝 简洁清单：默认生成 7 列表格，不包含截图列（更适合打印和分享）
  • 🖼️ 可选截图：使用 --with-screenshots 参数可启用截图列
  • ⚙️ 参数化配置：支持通过命令行参数自定义各项设置
  • 📋 批量生成：支持为多个 SOP 文档批量生成 Excel 报告

可配置参数

参数类型 参数 说明
基础配置 --output-prefix 输出文件名前缀
--base-url 测试系统 URL
--screenshot-dir 截图目录路径
样式配置 --header-color 表头背景色
--title-font-size 标题字体大小
--checkbox-font-size 复选框字体大小
图片配置 --image-scale-x/y 图片缩放比例
--row-height 行高设置

📖 详细使用说明：参考 USAGE.md

📋 SOP 文档结构

每个 SOP 文档包含以下标准章节：

  1. 文档元数据 - 文档类型、适用场景、配置文件
  2. 流程图 - Mermaid 格式的可视化流程
  3. 审批角色 - 各环节审批人说明
  4. 前置条件 - 执行前的必要准备
  5. 任务矩阵 - 详细的操作步骤清单（支持复制到 Excel）
  6. 异常场景测试 - 常见异常情况处理
  7. 进度采集模板 - 测试进度跟踪表
  8. 注意事项 - 重要提示和警告
  9. 相关文档 - 关联文档链接

🎯 使用指南

测试前准备

  1. 环境检查
  2. 确保测试环境正常运行
  3. 验证数据库连接正常

  4. 检查相关服务状态

  5. 账号准备

  6. 准备测试账号（发起人、各级审批人）
  7. 参考：账号文档

  8. 如需新账号，联系技术人员

  9. 数据准备

  10. 检查部门层级配置（后台设置 → 部门）
  11. 验证用户岗位和上级配置（后台设置 → 用户）
  12. 准备测试数据（如：资金池余额、产品信息等）

执行测试

  1. 选择对应的 SOP 文档
  2. 按照任务矩阵顺序执行
  3. 记录每个步骤的结果和截图
  4. 标记完成状态 [ ] → [x]
  5. 填写进度采集模板

问题处理

  • 遇到异常：参考 SOP 中的"异常场景测试"章节
  • 流程卡住：检查审批人配置和权限
  • 数据异常：联系技术团队排查

🔍 部门审批机制

多级部门审批说明

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

示例：部门层级结构

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

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

验证方式

  1. 查看部门信息：后台设置 → 部门
  2. 查看用户信息：后台设置 → 用户
  3. ✅ 岗位名称是否正确
  4. ✅ 部门是否正确
  5. ✅ 是否配置了上级领导

✨ 工作流系统功能

流程详情页面

包含三个标签页：

  1. 流程详情 - 显示流程基本信息和当前状态
  2. 审核历史 - 显示完整的审批链路和时间线
  3. 评论 - 支持参与者进行文本讨论和沟通

操作按钮

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

用户角色 可用操作
审批人 批准、拒绝
发起人 撤销（流程未完成时）
抄送人 查看（只读）

📊 测试报告模板

测试完成后，可以使用以下模板生成报告：

测试概览

  • 测试工作流：[工作流名称]
  • 测试环境：[开发/测试/生产]
  • 测试日期：YYYY-MM-DD
  • 测试人员：[姓名]
  • 总体结果：✅ 通过 / ❌ 失败

测试结果

Task ID Task Name Status Issues Notes
T1 ... ✅ — —
T2 ... ✅ — —
T3 ... ❌ 审批按钮无响应 已报告给开发

发现的问题

  1. 问题描述
  2. 重现步骤
  3. 预期结果
  4. 实际结果
  5. 截图证据

🚧 已知问题

  1. 部门领导显示
  2. 现状：一次会显示所有的部门领导

  3. 计划：优化显示逻辑，只显示当前环节的审批人

  4. 同岗位多人审核

  5. 现状：同岗位的多个人员审核功能还需要调整
  6. 计划：完善多人审核的逻辑和显示

📞 技术支持

  • 文档问题：联系 QA 团队
  • 系统问题：联系技术团队
  • 账号问题：联系管理员

🔗 相关资源

💡 提示：本文档会持续更新，请关注最新版本。如发现文档问题或需要补充内容，请及时反馈。