销售订单毛利权限与风险预警全链路总览 (Sale Margin & Risk)
对应开发 Issue：#219 P2-REQ-7 销售：订单毛利显示及查看权限 与 #220 P2-REQ-8 销售：低毛利风险提示
核心定制模块：3will_sale_margin
适用角色：一线销售业务员、销售主管/经理、财务风控、系统实施与 IT 管理员
1. 业务背景与核心痛点
在企业日常贸易与批发业务中，**“产品采购成本”与“销售毛利数据”**是企业极其敏感的经营核心机密。同时，业务实践中面临着两大尖锐冲突的难题：
┌─────────────────────────┐
│ 企业敏感经营数据管理痛点 │
└────────────┬────────────┘
│
┌───────────────────────┴───────────────────────┐
▼ ▼
【痛点 1：商业机密泄露风险】 【痛点 2：低价/赔本销售风险】
原生 Odoo 毛利权限宽泛，普通销售 一线销售因不知底价或疏忽，
通过列表列选择器或数据导出即 报出严重倒贴、亏本价格，
可窥探真实进货成本与利润。 事后订单难追责、难纠正。
- 原生系统的权限真空：原生 Odoo 安装
sale_margin后，仅依靠基础用户组控制，销售员可直接在单据右下角、明细行列表列选择器中勾选Cost/Margin列，甚至通过前端“导出”功能批量下载全部产品的底价与毛利率，造成进货成本完全透明泄密。 - “不知者不罪”带来的亏本漏洞：如果对普通销售实行简单粗暴的“直接隐藏成本”，销售人员在议价让利时无法感知底线，极易在无意中接下单价低于成本的亏损单据。
2. 解决方案与核心业务价值
为了同时兼顾**“数据严格保密”与“一线有效风控”**，我们深度研发了 3will_sale_margin 业务管控模块，建立起从权限隔离、智能脱敏预警到事后审计闭环的四重防线：
[防线 1：白名单字段级隔离] ──► 采购价、毛利额、毛利率彻底脱敏，普通销售查不到、导不出
│
▼
[防线 2：智能脱敏动态预警] ──► 系统在后台安全提权计算，订单顶部警示横幅 + 低毛利单行标红
│
▼
[防线 3：非阻塞二次确认拦截] ──► 确认订单时弹出风控向导提醒，知情后可继续确认，不卡业务流程
│
▼
[防线 4：去敏留痕与频道快照] ──► Chatter 记录去敏日志；OdooBot 向专属私密频道广播完整底价明细
核心收益与价值：
- 🛡️ 三层机密防护：在 Python 模型层注入字段权限，不仅隐藏 XML 界面视图，更在 ORM 读权限及 Excel 导出层物理阻断，彻底消除商业机密泄密隐患。
- ⚠️ 无感知安全风控：销售员虽然看不见具体的底价数字，但系统会通过视觉高亮（红色）和警告横幅明确告知“此商品价格过低”，实现脱敏风控。
- 🚀 敏捷非阻塞流程：第一阶段采用“强提醒、轻审批”，销售在知情并对价格负责的前提下可放行确认，绝不因系统审批流卡滞影响正常的急单发货。
- 📢 闭环事后追溯：强行放行后，单据时间轴记录无敏感数字的操作痕迹，同时管理层私密频道（
#低毛利风控预警）即刻收到图文快照通知，便于事后复核与绩效考核。
3. 多角色体验矩阵对比
| 业务场景 / 界面元素 | 普通销售人员（未分配毛利权限） | 销售主管 / 财务（已授权毛利权限组） |
|---|---|---|
| 单据明细行 Cost (采购成本) | ❌ 彻底不可见，列选择器无该选项 | ✅ 正常展开，显示准确产品进货单位成本 |
| 单据右下角 Margin (毛利/毛利率) | ❌ 完全隐藏，无占位空白 | ✅ 正常显示合计毛利金额与综合毛利率 |
| 低毛利单行展示效果 | 🔴 存在风险的明细行整行以红色字体高亮 | 🔴 同样以红色字体高亮，并可比对成本与售价 |
| 表单顶部风险横幅 | ⚠️ 显示警示横幅（黄色提示或红色告警） | ⚠️ 显示警示横幅，明确预警触发原因 |
| 确认订单时交互 (Confirm) | 🛑 弹出低毛利风险向导，提示并允许继续确认 | 🛑 同样弹出二次确认向导，作为最后复核检查 |
| 强行确认后 Chatter 留痕 | 📝 仅见去敏日志（如：“已被某销售在预警下确认”） | 📝 同样查阅去敏操作日志，单据历史不泄密 |
| Discuss 专属风控频道 | 🚫 无法搜索、查看或加入 #低毛利风控预警 频道 | 🔔 频道实时收到 OdooBot 推送的底价敏感快照卡片 |
| 数据导出 (Export Excel) | 🔒 导出字段列表搜索不到 Cost / Margin，物理防护 | 🔓 允许导出毛利分析数据，用于内部财务报表 |
4. 业务协同全景流程图 (Workflow)
5. 核心业务场景与界面实况
场景一：单行低于预警阈值（整单尚在盈利区间）
客户订购两款商品，其中一款因特惠促销单价接近底价（毛利率 5.13% < 10%），另一款正常销售，整单综合毛利率为 30.19%（高于整单 20% 阈值）。
- 一线销售视角：整单未税 $1225.00，行 1 呈现鲜红色警示，表单顶部呈现黄色警告横幅：
- 销售点击确认时的二次拦截弹窗：系统立即拦截，确保销售绝非无意疏忽：
场景二：整单毛利过低（出现全单亏损或极低毛利）
客户大批量压价，多项商品均以底价销售，导致整单综合毛利率严重低于 20% 预警线（甚至出现负毛利）。
- 整单告警横幅与红色粗体毛利：表单顶部升级为醒目的红色告警横幅；管理人员视角下，右下角毛利金额与百分比以红色加粗粗体配感叹号图标醒目预警：
毛利合计样式对比：
| 正常盈利状态（标准暗灰字色） | 整单低于阈值（鲜红加粗醒目告警） |
|---|---|
 |  |
场景三：事后闭环协同（Chatter 审计与 Discuss 私密频道推送）
当销售人员在向导中点击【继续确认】后，业务流程不被阻断，但系统自动触发多通道闭环：
- 单据 Chatter 去敏日志：仅记录警告事件与操作人员，任何人翻阅单据历史均不会看到底价泄密：
- 专属私密频道敏感快照：仅向管理员与指定风控主管广播，详细列出商品代码、规格、数量、单价、成本、毛利额、毛利率及未达标规则，并支持一键穿透直达订单详情页：
6. 本专题导读指引
本专题为您提供完整的全套角色操作规程与配置治理手册，请根据您的岗位指引查阅：
- 👉 系统管理员与实施配置 SOP (Admin Settings)：全局预警阈值设定、白名单权限分配、私密风控频道同步机制。
- 👉 销售人员防亏与确认操作 SOP (Salesperson Guide)：报价录入、脱敏红字与横幅识别、二次确认向导操作规范。
- 👉 销售主管与管理层风控审计 SOP (Manager Audit)：授权角色查阅成本与毛利、Discuss 频道快照处理、单据穿透复核。
- 👉 业务风控政策与常见问题排查 (Policy & FAQ)：多规则仲裁逻辑、非阻塞设计权衡、常见疑惑与排障清单。