把边界写在明处
多数报价系统的失败来自过度承诺：演示时什么都答应，上线时才发现规则没有来源、接口没有凭据、数据只是样例。 代价总是由业务侧承担——报价不敢用，就退回 Excel。
本项目不做这件事。我们把边界写在明处，并且区分三类不同性质的"没有"： 还没有做（功能未实现，需要排期）、 还没有联调（契约与逻辑已就绪，缺真实凭据与厂商环境）、 只是演示数据（用于跑通链路，不能进入正式报价）。 每一条都给出原因，以及补齐它还需要什么。
这些限制不是免责声明，而是验收清单的入口。它们会在实施过程中逐条关闭， 关闭一条就在第 8 节的材料表中留一条签认记录。
判定口径见 docs/Oracle三级菜单逐项核对.md；外部系统见第 2 节。数字逐行取自核对文档，未做归并。
数据类边界
首期基准数据来自客户提供的 CPQ配置示例模拟数据.xlsx、CPQ截图.xlsx、Oracle CPQ功能矩阵.xlsx。
这三份附件决定了本节每一条边界：凡是附件里没有的，系统一律不代为生成。
| 边界项 | 事实 | 为什么不这么处理 |
|---|---|---|
| 附件没有 LP、成本 | 初次初始化为"待定价"。演示价目是显式启用的测试补充，不是海克斯康真实价格。 | 没有价格来源就不能造价格。缺价保留"待定价"状态，避免演示值被当成目录价进入正式报价。 |
| 审批阈值是字母占位符 | 原表值为 A/B/C/D/E/F 等非数字字符。本版提供五个数字上限配置，演示值 5/10/15/20/30% 不代表海克斯康授权；12% 减免按 A→B→C 逐级审批是本地验证策略。 | 字母到数值的映射属于客户的授权口径，不是技术推断。在拿到书面授权前，只提供可配置的占位与本地验证路径。 |
| 12 个组合缺失 BOM 映射 | 6.6.6 与 8.8.8 下 Scan + HH-5-T 各 6 个组合。原表允许选型，但映射表无记录。系统显式提示缺失并阻止报价，绝不借用 Touch 编码或臆造零件。 |
借用相邻配置的编码会产出错误 BOM、错误成本和错误交期。宁可拦截，不可猜测。 |
| 只有测座有动态零件映射 | 主机、测头、软件、服务等继承"完整清单示例"的固定项，可调整、可取消。不能把这些固定行宣称为所有配置的真实完整 BOM。 | 附件只提供测座维度的映射规则。其余页签的固定项用于演示链路完整性，不作为任意配置的物料结论。 |
| 原始数据页只有文件名 | 精度 PDF 数据页仅有拼接文件名，无实体文件；管理员可上传 PDF 并设置加载条件。 | 附件未包含 PDF 实体。系统保留加载位与条件规则，等客户正式文件到位后由管理员上传。 |
| 英文描述原表未提供 | 英文输出明确标注缺失，需逐行补充。 | 自动翻译会引入未经客户确认的技术表述。缺失必须显式可见，不能由系统补写。 |
| 税率初值 13% | 可修改的测试参数，非税务结论。 | 税率与计税组由财务口径确定。系统只提供参数位与快照记录，不替财务做判断。 |
| 模拟编码 vs 真实型号 | 没有对应关系。不得擅自补齐真实商品性能、价格或官方物料编码。 | 样例编码属于附件数据。对齐真实物料编码需要官方主数据授权，不属于本项目可推断范围。 |
| 产品图片 | 取自 CPQ截图.xlsx，明确标注"品类参考图"，不冒充具体 SKU 图片。 |
截图用于界面实现参考。把界面截图当作产品图会误导选型，因此页面保留品类参考标识。 |
docs/ 中数据类边界记录。凡标注"演示""测试补充""占位"的取值，都需要客户正式数据或授权后才能进入生产报价。外部系统边界
系统内置 3 类外部连接类型（CloudCC / ERP / 电子签）与 22 个可映射源字段，集成任务状态机共 11 态。 但"契约已实现"与"厂商已联调"是两件事，下表把它们分开写。
| 系统 | 当前状态 | 还缺什么 |
|---|---|---|
| CloudCC 未实连 |
未实连。已确认 CloudCC One 中国区，组织 org0720f814430017229；
组织网关发现返回 HTTP 200 与 https://ap6.apis.cloudcc.cn/lightningapi。
|
连接应用 clientId / secretKey 未配置；API 认证与会话验证未执行；CRM 业务写入未执行。 需要客户在 CloudCC 组织中创建连接应用并授权。 |
| ERP 仅本机验证 |
仅本机 HTTP 接收器验证报文、字段映射、幂等请求与响应回执。任务标记 local_validated + externalDelivery: false。
|
真实 ERP 未实连。需要真实接口地址、凭据、字段终稿与联调环境。 |
| 电子签 契约已实现 | 契约已实现：客户 PDF 出站 + 状态回执。 | 无内置特定厂商的签署人身份认证、短信、签章或多步骤信封流程；无真实厂商联调。需要选定厂商并确认签署流程。 |
| 邮件 替身校验 | SMTP SSL / STARTTLS 分支通过测试替身校验。 | 实际邮件服务和入站网关尚未提供，未完成外部端到端邮件验收。需要可用的发信服务与入站网关地址。 |
| 共享文件（S3） 仿真验证 | 协议层用 Moto 仿真验证 put/get、租户隔离、生成物清理。 | 实际对象存储厂商仍须联调。需要确认厂商、地域、凭据与生命周期策略。 |
| SSO / 企业身份 未实现 | 未实现，仅本机账号：PBKDF2 + 独立盐，会话最长 8 小时。 | 企业身份源、协议与映射规则均未确定。需要客户 IT 给出接入方式后单独设计与排期。 |
| 三环境发布 / 迁移 客户要求暂缓 | 客户明确要求暂缓（功能矩阵第 1～3 项）。 | 不作为首期范围。若后续恢复，需重新论证环境拓扑、发布流程与迁移口径。 |
逐个系统的可用位置
CloudCC 未实连
已确认区服、组织与网关地址；连接应用尚未创建。可用到"地址与组织已确认"，不能用于 CRM 写入。
ERP 仅本机验证
报文、字段映射、幂等与回执已在本机接收器上验证。可用到"接口契约可评审"，不能作为已对接。
电子签 契约已实现
客户 PDF 出站与状态回执已实现。可用到"出站契约评审"，不含厂商身份认证、短信与签章流程。
邮件 替身校验
SSL / STARTTLS 两个分支通过测试替身。可用到"代码分支验证"，未完成外部端到端验收。
共享文件 仿真验证
put/get、租户隔离与清理用 Moto 仿真验证。可用到"协议层验证"，实际厂商仍须联调。
SSO / 企业身份 未实现
仅本机账号可用，PBKDF2 + 独立盐，会话最长 8 小时。企业身份接入需另行设计。
三环境发布 / 迁移 暂缓
客户明确要求暂缓，对应功能矩阵第 1～3 项。首期不实施，也不计入验收。
连接方必须支持幂等键，否则不能承诺"只执行一次"。重试、并发与网络重放都会造成重复写入，这一条属于接入前置条件，不是配置项。
Oracle 能力对照真相
原"105 项已完成"口径已被正式撤回。本节数字以 docs/Oracle三级菜单逐项核对.md 的逐项判定为准。
该文档对 241 个官方主题逐项判定，分布如下。判定类别沿用原文措辞，未做归并或改名。
| 判定 | 数量 | 说明 |
|---|---|---|
| 部分覆盖 | 131 | 已实现可用子集，官方复杂能力未完成 |
| 未实现 | 33 | 本版未提供对应能力 |
| 未实现 / 外部对接待设计 | 29 | 依赖真实外部系统，方案尚未设计 |
| 未实现完整官方能力 | 12 | 仅有简化实现 |
| 未实现官方管理能力 | 9 | 缺少官方对应的管理端维护能力 |
| 未实现 Oracle API 兼容层 | 9 | 不提供 Oracle API 兼容接口 |
| 未实现完整定价平台 | 6 | 定价平台能力不完整 |
| 技术方案不同 | 4 | 实现方式与官方不同，功能目标已达成 |
| 部分覆盖 / 待实连 | 3 | 本机已测，外部实连后才有完整意义 |
| 暂缓 / 平台迁移 | 3 | 客户要求暂缓，属平台迁移类 |
这是本页最关键的一句。131 项"部分覆盖"指已实现官方能力的一个可用子集，不等于官方能力已完成。
明确未实现
- 三环境发布 / 迁移
- 完整角色权限体系
- SSO 与企业身份接入
- 真实 CloudCC 与 ERP 连接
- 多币种汇率（仅 CNY 汇率表可用）
- 价格批次有效期
- 邮件、短信、企业微信外发
- 电子签章
- 真实订单传输
- 历史 Oracle 交易批量迁移
- 规则版本回滚
- 复杂 BML 脚本
- 用户自定义任意产品模型
- 通用报表平台
- 可视化文档模板设计器
部分覆盖：官方复杂能力未完成
功能矩阵 108 项中，下列行号被标记为"部分覆盖（官方复杂能力未完成）"。
| 矩阵行号 | 能力 | 未完成的部分 |
|---|---|---|
| 22–24 | 报价 / 技术协议 / 加载文档模板 | 模板加载与组合的官方复杂用法未覆盖 |
| 25–28 | 约束 / 默认 / 隐藏 / 零件号条件表规则 | 条件表规则的表达能力与官方不一致 |
| 31 | 复杂 BOM（Oracle 原生五表结构） | 本版 BOM 模型与原生五表不同 |
| 46–51 | 按条件加载 PDF 数据页 / 精度 / 验收 / 服务 / 公司简介 / 付款条款 | 依赖实体 PDF 与加载条件配置，实体文件尚未提供 |
本机 / 联调已测，外部待验
| 矩阵行号 | 能力 | 已测到哪一步 | 还缺什么 |
|---|---|---|---|
| 74 | 审批状态邮件通知 | 本机与联调环境已触发并校验 | 实际邮件服务未提供，端到端未验收 |
| 84 | 邮件 Approve / Reject 回复 | 回复解析与状态回流已校验 | 入站网关未提供 |
| 108 | BOM 一键导入 ERP | 本机接收器验证报文与回执 | 真实 ERP 未实连 |
docs/功能矩阵实施台账.md 记录 499 项后端完整回归、37 项前端逻辑测试通过，
但原文明确 "不能据此宣称全部 Oracle 功能已完成"。
回归覆盖的是本版已实现的行为，不是官方能力清单。
平台级边界
| 项 | 事实 | 对部署与验收的影响 |
|---|---|---|
| 租户隔离 | 由应用请求上下文实施，未使用 PostgreSQL RLS。 | 合同要求数据库级隔离的客户，须使用独立数据库 + 独立应用实例。 |
| 自助开通与计费 | 未实现自助开通，未实现 SaaS 计费。 | 企业开通与计费走线下流程，不作为自助能力验收。 |
| RPO / RTO | RPO 24 小时 / RTO 4 小时仍是部署演练目标，不是已达成的 SLA。 | 需在部署演练中实测并确认，达标后才能写入验收条件。 |
| 高可用 | Compose 是单主机参考部署。 | 不宣称主机级高可用；跨主机容灾需另行设计。 |
| 账号与会话 | 仅本机账号，PBKDF2 + 独立盐，会话最长 8 小时；会话按完整服务源地址摘要分文件存储（~/.config/cloudcc-cpq/sessions/，权限 0600）。 |
企业身份接入是独立议题，见第 2 节。 |
| 幂等要求 | 连接方必须支持幂等键。 | 否则不能承诺只执行一次。 |
| 已知缺陷 | 销售选配页缺少"搜索结果批量加入方案"；501 行报价靠 API 构造。 | 不能证明人工逐项选配的录入效率。 |
明确未测的场景
- 中国办公网络环境下的真实访问延迟
- 上班时段的同时登录突发
- SSO 登录链路
- 跨地域数据库部署
- 真实外围系统（CRM / ERP / 邮件 / 对象存储）的调用耗时
- 300 人同时批量生成 PDF
以上场景未测，因此不对它们的表现作任何承诺。需要承诺的，必须先补测。
本项目的代码仓库与文档中，不存在国产化、信创、跨境、数据出境相关的说明或验证结论。因此：
- 不能在未经确认的情况下，给出国产操作系统、国产数据库、国产芯片或"信创全栈"的兼容结论；
- 不能笼统认定所有报价数据禁止出境，也不能笼统认定全部可直接出境；
- 相关要求需由客户责任部门确认后，作为明确的验收项加入实施范围，并在环境就绪后实测。
十一家客户仿真包的免责
docs/十一家客户适配与仿真验收.md 记录了 11 个客户业务产品线、22 个可配置产品模型与 132 张已保存报价。
它是演示系统跨行业适配能力的最主要资产，同时也是最容易被误读的资产。免责原文照引如下。
SIM11 的型号、尺寸边界、价格、成本、税率、兼容关系、交期、付款及审批阈值全部是人工构造的仿真， 不是这些企业的真实产品规格或商务政策。
- 页面、产品说明、条款和 PDF 均带仿真标识；
- 本包不是十一家企业独立租户的投产部署；
- "较适合／部分匹配"是依据本轮模型及系统行为的适配判断，不是客户确认或产品认证结论；
- 每家只覆盖两个代表性产品家族，不能外推为整家公司全部业务覆盖。
页面上保留提示："仿真报价 · 产品价格、税率和交付范围需按实际业务核对。"
仿真账号 sim11-sales（仅授权本包产品线）、sim11-manager、sim11-finance、sim11-engineer 均无发布权限。
定价口径与计算护栏
本节是 PRD 定义的产品口径，不是对客户业务的承诺。 它规定系统"怎么算"，不规定企业的价格政策、税率与授权阈值由谁定。
| 护栏 | 规则 |
|---|---|
| 定点计算 | 金额使用十进制定点计算；内部单价与分摊保留足够精度，人民币展示到分。 |
| 尾差处理 | 以分为单位按最大余数法处理，并以固定行 ID 打破并列，保证分摊合计精确等于整单优惠；行分摊后不得小于零。 |
| 缺价 | 缺价不是零价；不能以零成本计算虚高毛利。 |
| 规则冲突 | 同一层级多个价格规则冲突必须阻断并交价格管理员处理，不静默取最低价。 |
| 开票 | CPQ 输出报价用税额及开票建议字段，实际开票与申报由下游财务系统负责。 |
推荐计算顺序（10 步）
验证上下文
确认客户、法人、币种、日期与适用政策版本。
选择唯一基础价格
按优先级命中唯一价格来源；多命中即冲突。
应用数量 / 周期政策
整体阶梯、分段阶梯与期限算法在此生效。
可叠加行级优惠
仅作用于可折扣项，不可折扣项跳过。
分摊整单优惠
按最大余数法分摊，固定行 ID 打破并列。
加入收费服务 / 费用
服务、运输、培训与费用项并入行集。
计税
按财务确认的计税组计税，不按行猜测税率。
汇总含税金额
未税、税额、含税三项同时落库，互为校验。
计算管理毛利
成本版本与价格版本必须对应；缺成本不按零计。
判断审批
依据审批矩阵与授权阈值路由，不跳过节点。
每一步保留输入、输出和政策版本。报价快照至少包含： 目录版本、规则版本、价格政策及特价依据、成本版本、税务版本、报价汇率、周期算法、舍入口径、审批矩阵、模板版本和输入上下文。
PRD 验收样例
仅用于产品验收，不是海克斯康真实价格。
| 项目 | 数量 | 未税单价 | 行减免 | 未税净额 | 税率 | 税额 | 含税金额 | 内部预计成本 |
|---|---|---|---|---|---|---|---|---|
| 标准测量设备包 | 1 | 500,000.00 | 10% | 450,000.00 | 13% | 58,500.00 | 508,500.00 | 320,000.00 |
| 独立服务项 | 1 | 20,000.00 | 0% | 20,000.00 | 6% | 1,200.00 | 21,200.00 | 12,000.00 |
| 合计 | — | — | — | 470,000.00 | — | 59,700.00 | 529,700.00 | 332,000.00 |
追加"仅设备行参与"的 10,000 元整单优惠后：整单未税 460,000、税额 58,400、含税 518,400， 毛利 128,000、毛利率约 27.83%。
实施阶段（PRD 第 20 节）
分五个阶段推进。每个阶段有明确的范围与产物，也有明确的退出条件——未达到退出条件，不进入下一阶段。
| 阶段 | 范围与产物 | 退出条件 |
|---|---|---|
| G0 需求与基线 | 确认首批产品 / 法人；现有能力映射；性能基线；金标准样本；价格 / 税务 / 权限政策；CloudCC 集成可行性验证 | 范围、样本、关键待确认项与责任人签认 |
| G1 完整链路试点 | 选一个有代表性的产品族，打通商机 → 配置 → 定价 → 审批 → 文档 → 接受 → 交单（含设备＋软件＋服务） | 试点不依赖线下修改金额补洞；对照计算、权限、集成和性能用例通过 |
| G2 首批正式替换 | 扩展至签认首期全部产品族及在用能力；补齐渠道 / 续费 / 非标 / 投标；迁移与培训 | 全部上线门禁通过；切换 / 回退演练完成 |
| G3 稳定运行与优化 | 观察至少一个完整报价至交单周期，处理缺陷，优化模板与规则管理 | 无严重遗留问题；运营责任移交 |
| G4 后续扩展 | 其他业务线、渠道自助、配置可视化、辅助推荐及更丰富分析 | 单独论证价值；不延迟首批国产替代 |
上线门禁
- 范围内关键链路和金额计算全部通过；
- 关键配置 / 授权 / 税价 / 审批 / 交单 / 权限问题全部关闭；
- 无未处理阻断或严重缺陷；
- 性能与恢复目标达标；
- 配置、销售、财务、商务和 IT 责任人分别签认。
需要客户补充与签认的材料
下表取自 PRD 第 23 节。按"什么时候必须拿到"分组： 冻结范围前决定做什么，设计冻结前决定怎么做， 上线方案前决定部署在哪，切换前决定怎么切。
| 材料 / 问题 | 建议提供方 | 决定什么 |
|---|---|---|
| 冻结范围前 | ||
| 首期法人实体与产品族范围 | 客户业务 / 产品负责人、项目组 | 首期配置模型、目录装载与验收边界 |
| Salesforce 托管包名与 Oracle CPQ 版本实例信息 | 客户 IT | 能力承接基线与差异清单 |
| 在用功能清单与样本报价（含近一年真实报价） | 销售运营 | 哪些能力必须一期具备，哪些可后置 |
| 慢点操作清单与峰值并发场景 | 销售 + IT | 性能验收用例与基线 |
| 中国可售目录与兼容矩阵 | 产品管理 | 目录、可选项与配置规则的唯一来源 |
| 设计冻结前 | ||
| 价格来源、优先级与税务分类 | 财务 + 价格管理 | 基础价格唯一性与计税组归属 |
| 许可与维保权益政策 | 产品 / 商务 | 周期算法、续费与权益计算口径 |
| 审批矩阵与折扣授权 | 商务负责人 | 审批路径、节点与授权阈值（含字母阈值的数值化授权） |
| 付款、保修与验收条款模板 | 法务 + 商务 | 文档模板与条款库 |
| CloudCC 版本、测试租户与连接应用授权 | 客户 CRM 管理员 | CRM 集成可行性与联调排期 |
| 上线方案前 | ||
| 国产化清单与部署约束 | 客户 IT / 合规责任部门 | 运行环境与相关验收项是否成立（仓库中暂无任何依据） |
| SSO 与企业身份接入方式 | 客户 IT | 登录方案与账号迁移方式 |
| 性能与恢复目标（RPO / RTO） | IT + 业务 | 部署演练目标是否写入验收条件 |
| 数据保留与备份策略 | 客户 IT | 备份窗口与恢复演练安排 |
| 切换前 | ||
| 历史报价保留范围与迁移口径 | 销售运营 + IT | 迁移数据量与迁移方式（批量迁移能力目前未实现） |
| 切换窗口与回退条件 | 项目负责人 | 切换日安排与回滚触发点 |
| 培训与责任人签认 | 配置 / 销售 / 财务 / 商务 / IT | 上线门禁的分别签认 |