SupplyLink 系统需求文档

阅读说明

本正文面向客户，以业务名称、操作场景和验收结果说明需求；内部需求、流程与开发任务编号集中放在文末技术对照中，不要求客户理解这些编号。本文的“第一期”和“第二期”表示交付范围，不代表相关能力已经完成验收。

常见业务术语如下；后文保留部分行业简称，便于与零售商和供应商材料对照：

文中术语	客户可理解的含义
EDI	电子数据交换：系统与零售商自动交换订单、订单确认、发货通知和发票
PO / POA / ASN / INVOIC	分别为采购订单、采购订单确认、预先发货通知和发票；零售商发给我方的采购订单，在我方系统中属于销售方向
CRM / FSM	客户关系管理 / 现场服务管理，后者涵盖派单、安装、维修及现场结果回传
Case / Work Order	售后服务案件 / 现场工单；一个案件可以无需上门，也可以关联多次安装或维修工单
RMA / NFF	退换修授权及索赔流程 / 未发现故障；未发现故障不代表自动确定责任方
SLA / KPI	服务时限约定 / 绩效指标；售后绩效仅统计 Voltura 负责的处理时段
OCR / POD	图片或文件中的文字智能识别 / 交货证明（签收凭证）
ABN / GTIN / SKU	澳大利亚商业编号 / 全球贸易项目代码 / 商品库存编号
GST / AUD	澳大利亚商品与服务税 / 澳元
API / RBAC / CSRF	系统接口 / 按角色授予权限 / 防止第三方伪造用户请求的安全校验
token / 幂等	安全凭证（邀请、密码恢复或登录使用，不能混用）/ 相同请求重复提交不重复写入，返回原处理结果
Phase 1 / Phase 2	第一期 / 第二期
canonical / mock / adapter / live	统一数据格式 / 模拟测试 / 渠道或服务接入适配器 / 实际外部服务联调；模拟通过不等于真实接入验收
outbox / 状态机	与业务数据一起保存的待发送通知记录 / 明确规定哪些状态变化可以或不可以发生的规则
ACL / CGA / Privacy Act	澳大利亚消费者法 / 新西兰消费者保障法 / 适用的隐私法要求，具体适用范围须经合规确认
PDD / OQ	产品定义文档 / 尚待客户或外部伙伴确认的问题；未确认问题可能阻止相关功能验收

已批增量：总部层级及后代用户管理

第 3.2 节的深圳家之宝总部沿用现有总部组织，不新建重复组织。 香港家之宝、PSS、Voltura 直接隶属深圳家之宝总部；正式数据迁移负责新数据库初始化与已有数据的缺失关系补齐， 发现组织关系冲突必须停止，部署前强制检查。顶层集团管理员沿用现有角色，不批量修改角色标识。 总部具有有效成员资格的集团管理员，无需另行加入子公司，即可通过独立的集团用户管理接口管理下属公司的用户； 范围仅列表/角色、新邀请/重发/撤销、角色替换和成员启停，不含跨组织全局账户禁用或已有账号绑定， 不授予子组织业务权限。用户与权限（Access，/admin/access）页面内的管理目标与 Header（全局顶栏）当前组织分离，写入与真实 HQ 操作者审计同事务。 验收场景、权限与异常处理要求参见“四组织层级与集团用户管理”详细设计及接口规范； 组织层级、集团用户管理接口和管理页面的实际验证结果由实施与验收计划记录；生产应用仍须单独授权。

2026-10-18 已批增量：忘记密码与本人修改密码

本轮用户明确批准忘记密码（邮件一次性重置链接）及本人验证旧密码后改密的本地完整实现。 仅允许本地测试邮件验收；禁止真实邮件投递、读取或修改真实凭据、操作生产环境、使用云或付费服务、部署或向远程仓库推送。 本增量替代历史“首版无密码重置”的排除项；邀请邮件发送服务已有实现，不再将历史“无真实邮件”描述作为当前技术事实。 用户随后批准一次限定范围的本地纠正：取消独立隔离的邮件实现，复用邀请邮件发送服务；配置齐备时启用密码恢复邮件，缺配置时禁用，测试专用配置优先，不新增环境配置项。 当前候选实现仍有阻塞：仅限制每次邮件服务器响应的等待时间，不能保证整个发送过程到期后停止。模拟测试显示，重置凭证撤销后连接未关闭，迟到的确认仍会触发邮件内容发送。 目前仅完成模拟邮件服务器验证，未读取真实凭据或投递真实邮件，禁止部署；此实现调整不改变下述接口、页面职责或安全验收要求，也不代表密码恢复、自助改密的后端与页面均已验收。 忘记密码（Forgot password，/forgot-password）与重置密码（Reset password，/reset-password）为无需登录、不显示后台导航的公开页； 账户安全（Account security，/account/security）为已登录且在当前组织具有有效成员资格的本人页面，不要求管理员角色，不改变组织权限规则。

无论邮箱对应的账户已激活、不存在、待激活或已禁用，密码恢复请求都返回相同的“已受理”响应，且响应正文为空，避免泄露账户是否存在。 每个请求来源及每个邮箱各限 15 分钟内 5 次请求，超限明确提示请求过于频繁；只有已激活账户可以产生邮件。 重置链接使用安全随机生成的 256 位一次性凭证，仅保存其 SHA-256 摘要（用于校验，不保存原文），有效期 15 分钟。 凭证只放在链接的井号后部分，浏览器读取后立即从地址栏删除；重发时撤销旧凭证。邮件发送失败仍返回“已受理”， 同时撤销本次凭证，允许用户在请求配额内重试；不得返回凭证或内部错误，也不得复用账户邀请凭证。 新密码须为 8–200 字符，两次输入一致；与当前密码相同、重置凭证无效以及旧密码错误，均须明确拒绝。本人改密须验证旧密码， Bearer + 当前活动组织 + CSRF；禁止指定其他 user。缺认证 401、foreign/inactive 403、 密码确认不一致或不符合策略时拒绝操作。具体接口状态码和错误标识见文末技术对照。 同一用户的并发修改按顺序处理，保证一次性凭证仅成功使用一次；成功时，密码校验值更新、凭证使用或撤销、 会话版本递增和脱敏审计在同一事务中完成（全部成功或全部回滚），失败时这些数据均不变。 全部旧登录及续期凭证在不同后端实现中立即失效；前端清理身份、组织和密码信息，要求重新登录。 重置凭证属于全局账户安全数据，不按组织对外暴露；审计不含邮箱、密码、凭证摘要或原文。

验收须覆盖：四类邮箱统一响应、请求限流、邮件失败后重试、15 分钟有效期边界、重发撤销、单次与并发使用； 旧密码错误、未产生变更、组织越权及防伪造请求校验失败时不得改写数据；旧会话在不同后端实现中失效，新密码可登录。 内存与数据库两种存储实现的行为须一致，真实 PostgreSQL 数据库的接口测试不得跳过； 管理后台须在 360、768、1280、1440 像素宽度下完成验证，并通过键盘操作和自动可访问性检查。 独立功能与安全审查后，再进行界面审查；后端和页面分别保存验收证据。现场服务移动应用尚未实现，仍属第二期。

1. 文档信息

项目	内容
项目名称	SupplyLink
文档名称	澳大利亚零售供应链需求文档
文档版本	v1.9
日期	2026-09-17
当前状态	上游业务需求来源与唯一契约来源；全量范围、Phase 1/Phase 2 划分与验收门禁由本文件定义，下游文档依赖本文件
系统主导方	深圳家之宝（中国大陆母公司）
关联公司	香港家之宝（香港分公司）、PSS（澳大利亚公司 A，负责 Bunnings 业务）、Voltura（澳大利亚公司 B，对接 Supercheap Auto）
EDI（Electronic Data Interchange，电子数据交换）确定接入渠道	Supercheap Auto、Bunnings
EDI 实施顺序	Bunnings EDI 优先，Supercheap Auto EDI 后置；Bunnings 安装/统一售后仍按 Phase 2 门禁推进
目标市场	澳大利亚

权威说明（2026-09-02，2026-09-11 更新）： 本文件是客户业务愿景、全量范围、Phase 1/Phase 2 划分、验收门禁与实现优先级的唯一上游契约来源，下游文档依赖本文件。Bunnings EDI 直连接入现为优先实现轨；Bunnings 销量报表、安装派单、电工端和安装关联售后仍为 Phase 2，不能因 EDI 入口优先而提前关闭相关验收。

修订说明（2026-09-04）： 用户决定取消中间商 PowerBay，Bunnings 渠道改为 SupplyLink 直接对接；本文件正文中“经 PowerBay 转发”类表述自 v1.4 起统一改为直连语义，Phase 1/Phase 2 划分与验收门禁不变。

修订说明（2026-09-10）： 客户新增材料《Voltura 售后运营系统产品定义文档》v1.0 草案（2026-09-07）与《01 公司及人员列表-系统开发.xlsx》确认：Voltura 为 BYD 交流充电桩澳新独家售后代理，引入客户关系与现场服务管理（资产、售后案件、维修工单、退换修索赔、免登录表单、售后计费、BYD 文件导入）。经用户确认（见第 10.1 节），售后域并入 SupplyLink、属第二期，第一期范围、契约与验收不变。

修订说明（2026-09-10，v1.6 依赖方向修正）： 本文件唯一上游依赖为《Voltura 售后运营系统产品定义文档》等客户材料；删除对下游产品需求、实施计划与客户材料差异文档的引用，交付期划分与客户确认决策在正文中完整说明（见第 10.1 节）。下游文档依赖本文件，方向不可逆。

依赖方向说明（2026-09-10，二次修订）： 本文件是开发链的契约权威与唯一上游需求来源，下游文档（04-selected-prd.md / 08-build-plan.md / openapi.yaml 等）依赖本文件，方向不可逆。同目录 supplylink-feature-checklist.md 为交付客户的核查清单（访谈历史 ID、报价与验收意图），不在开发输入链中：开发实现与验收不以该清单为依据。

修订说明（2026-09-10，v1.7 统一售后域）： 经用户确认（第 10.1 节第 9 项），PSS 与 Voltura 共用一套客户关系与现场服务售后系统（统一售后域）：Bunnings 安装/售后（PSS）与 Voltura BYD 充电桩售后（Voltura）共用同一套售后数据模型与三项共享能力（可配置状态流转、服务时限责任分段计时、免登录表单），业务场景按渠道和品牌配置流程模板；安装与维修统一采用现场工单，但仍按类型区分，不推翻原有区分要求；第一期范围、契约与验收不变。

修订说明（2026-09-11，v1.8 Bunnings 电子数据交换优先）： 客户已取得 Bunnings 入口对接，开发顺序调整为先完成 Bunnings 接入、统一数据格式映射、防重复处理、异常处理与测试联调，再推进 Supercheap Auto 接入。Bunnings 接入资料尚待确认，是实际渠道联调验收的阻塞项：客户与 Bunnings 集成负责人须在正式联调验收前提供并确认传输协议、报文与字段规范、代码列表、测试环境、样例、认证标准和生产凭据。资料确认前仅允许统一数据格式、模拟渠道接入、固定样例与异常处理验证，不得配置真实接入凭据或声称已通过实际渠道验收。安装及统一售后范围不随本次调整提前。

修订说明（2026-09-17，v1.9）： 6400Y109291559 Purchase_Order.pdf 仅作为 Bunnings PO 的字段结构与 EDI 映射样例；首期不提供 PDF 上传、文本识别或人工补录入口。正式 PO 仅通过 Bunnings 直连 EDI 接收。样例中的 Power Bay 是历史卖方信息，未来由 PSS（Power Source Supplier Pty Ltd）作为 Bunnings 供货主体，不构成系统供应商、渠道伙伴或导入条件。

修订说明（2026-10-30，采购单智能识别与供应商、商品匹配）： 经用户确认采购识别与资料创建方案，采购单智能识别导入对文件里出现的供应商（按澳大利亚商业编号）与商品（按全球贸易项目代码）执行「先检索→命中复用/未命中预填可编辑草稿→用户确认后才创建」。不自动创建任何实体；未确认草稿时阻断采购单创建并提示用户确认供应商/商品。客户与承运商不在采购单中，不触发。原「无法匹配时不得静默创建错误商品」扩展为「可经人工确认且可编辑后创建」，创建权始终在用户确认动作。

2. 产品定位

2026-10-12 已确认变更：可配置私有文件存储

用户先要求“既要支持本地储存，还要支持腾讯云、阿里云、aws s3 存储，允许后端灵活配置改变”，随后回复“继续，已确认”。新增首期文件存储基础设施范围：本地持久存储、腾讯云对象存储、阿里云对象存储、亚马逊云对象存储；应用运行环境与文件存储可独立选择，由后端运维配置控制，无需修改业务代码或前端，不增加管理后台配置页。

已确认的切换规则：修改配置后重启或逐步更新应用实例生效；新文件写入默认存储位置；旧文件按已保存且不可变的存储配置标识与文件定位信息读取，保留原存储、配置和凭据。切换不自动迁移或删除旧文件。本地可用于生产，但须有持久化存储、备份及恢复证据；临时容器目录不满足要求。普通业务用户和管理员不能修改配置或读取凭据；私有存储、组织权限、病毒扫描、文件完整性校验、保留规则和读取时再次鉴权均不放宽，不向浏览器暴露直接文件地址或服务器路径。

验收：四种存储均支持等价的上传、读取及获批清理；从存储位置 A 切换到 B 后，新文件写入 B，旧文件仍可从 A 读取；配置非法或缺失时启动失败，不自动回退；云服务拒绝或超时不得记录成功，也不得假装文件不存在；跨组织越权、成员资格失效或缺权限时须在访问文件前拒绝，且不改写数据；备份恢复后的文件数量、校验值和大小须零差异。模拟测试不得替代真实云服务与真实数据库证据。需求确认不等于独立需求或架构审查通过；真实迁移、生产部署、账号、付费、地域合规与密钥使用仍须单独批准。第二期复用该边界，不提前启动售后或移动应用，也不解除其他首期验收门槛。

2026-10-13 验收细化候选：同一存储配置标识不得改指其他文件位置，即使重启也须拒绝；仅允许轮换凭据。保留文件、未完成写入或补偿操作所需的存储配置缺失时，拒绝启动。超时或断连不代表写入未完成，迟到结果不得发布为成功；文件记录提交结果不明时，须按原位置及文件内容核对。交货证明上传、采购单识别、报价文件生成和表格导出各入口须分别验证权限、接口或异步任务结果及恢复，不得以总体需求完成或模拟测试替代独立证据。当时的识别受理条件、交货证明预览权限及公共错误返回尚待决；后续已批准方向见下一段。

用户后续已决定：采购单识别只有在隔离文件及实际处理任务均持久保存后才返回“已受理”，相同重复提交识别键须返回原任务，病毒扫描通过后才识别。交货证明增加独立的发货业务受控预览，须同时校验有效组织成员资格、发货查看权限及文件归属；采购文件预览仍需采购查看权限。同步存储拒绝、不可用或超时均返回“文件存储不可用”；完整性校验失败不得输出文件内容。报价生成保留既有错误返回；异步任务已受理后的失败只更新任务结果。采用数据库私有区域暂存最终文件内容，继承保留和冻结规则；首轮仅纠正和验证设计，独立复检后停止，不授权生产迁移、删除或部署。上述待决事项为历史状态，不要求重新批准这些方向；精确错误标识见文末技术对照。

SupplyLink 是由中国大陆母公司主导建设的澳大利亚零售供应链系统，统筹中国大陆母公司、香港分公司与两家澳大利亚运营公司之间的跨区域业务，连接上游货源（比亚迪澳洲分公司）、下游零售渠道（Supercheap Auto、Bunnings）、仓库履约环节以及自有或分包电工。Bunnings 渠道由 SupplyLink 直接对接：Bunnings 的账号入口、订单接收、销量等渠道数据直接与 SupplyLink 交换，不经中间服务商。

文件存储后续政策批准（2026-10-12 23:22）：允许优先在隔离测试目录纠正本地文件覆盖和路径风险，不部署生产或处理旧真实文件；人工上传的采购单与交货证明必须通过真实病毒扫描，扫描缺失或失败时继续隔离；受控服务器生成的报价文件和表格可按可信来源、类型及文件校验值验证，不接受任意外部内容或伪装扫描通过，旧文件无来源证据不得自动视为可信。该区分须经独立安全审查，并落实到内部数据及入口约束，不代表已通过验收。首轮云身份通过专用密钥配置注入，支持完整的长期或临时凭据，不要求亚马逊云自动分配应用身份；不授权真实密钥使用、采购、生产操作、迁移或风险豁免，非生产云验收另行批准。

系统不只是客户资料管理工具，而是覆盖以下完整业务链路：

客户与渠道管理
  → 商品与价格管理
  → 销售订单（手工创建或 EDI `PO`（采购订单）入站）
  → 订单确认、发货与发票
        ├── Supercheap Auto 渠道：供货完成（当前无安装与售后）
        └── Bunnings 渠道：供货完成后进入统一售后域（第二期）
  → 客户关系维护（全渠道）

统一售后域（第二期；PSS 与 Voltura 共用一套 CRM + FSM 售后系统）
  ├── Bunnings 场景（PSS）：从订单创建安装工单 → 派遣电工 → 现场安装
  │      → 安装凭证与订单履约 → 安装关联售后（Case 承载）
  └── Voltura BYD 场景（Principal = BYD）：终端客户报修（官网 / 电话 / 邮件 / 经销商多入口）
         → Case（案例）
         → 远程诊断（第一个分岔口）
              ├─ 远程可解决 → 关闭 Case（0 现场单）
              └─ 不能解决 → 现场维修工单（Work Order）或 RMA
                    → 免登录表单 / 账号双通道现场回传
                    → 根因责任矩阵判定 → 修复闭环 → 谁付钱 → 结算

Supercheap Auto 和 Bunnings 都是本项目确定要接入的零售渠道。渠道接入与供货履约阶段先完成共享的统一数据格式、待发送通知和异常处理能力，再优先推进 Bunnings 直连入口及独立渠道适配器，随后推进 Supercheap Auto 接入；两家渠道均属于产品正式范围。Bunnings 由 SupplyLink 直接对接，接收订单等渠道数据，不引入中间接入服务商；销量数据扩展仍属第二期。其他零售渠道暂不排期。

当前阶段不要求 SupplyLink 取得或管理 Bunnings 的生产系统账号。Bunnings 直连的传输协议、报文和字段规范、测试环境、样例、认证标准及生产凭据须由客户与渠道集成负责人确认；资料到位前可完成统一数据格式和模拟渠道适配器的设计与测试，但不得声称完成 Bunnings 实际渠道联调验收。系统应通过接入适配器边界隔离渠道差异，不改变 Bunnings 渠道的订单、安装和售后业务模型。

两家渠道在安装与售后上的责任不同：

• Bunnings 渠道：终端客户购买后，安装需求与售后服务由我方（PSS，澳大利亚公司 A）负责，因此该渠道需要完整的安装派单和售后能力；订单、销量等渠道数据由 SupplyLink 直接对接 Bunnings 交换。
• Supercheap Auto 渠道：当前安装与售后服务由 Supercheap Auto 负责，我方仅承担供货；系统需预留未来 Supercheap Auto 将安装售后交给我方时复用统一售后域能力的扩展位。
• 统一售后域（2026-09-10 用户确认，见第 10.1 节第 9 项）：PSS 的 Bunnings 安装/售后与 Voltura 的 BYD 充电桩售后共用一套客户关系与现场服务售后系统，不分别建设两套；共享客户、站点、资产、售后案件、工单、退换修索赔、安装商、备件和计费数据模型，以及可配置状态流转、服务时限责任分段计时、免登录表单三项能力；按渠道、品牌、安装或维修类型配置流程，数据仍按组织和品牌隔离。

3. 业务背景

3.1 业务模式

中国大陆母公司统筹全局并主导系统建设。香港分公司负责与比亚迪澳洲公司签订业务，获取货源；比亚迪澳洲公司的货交付到我方澳大利亚仓库，由两家澳大利亚公司分别对接下游零售渠道。

• PSS（澳大利亚公司 A） 负责 Bunnings 的业务往来，并承担该渠道的安装与售后服务；Bunnings 渠道由 SupplyLink 直接对接。
• Voltura（澳大利亚公司 B） 负责与 Supercheap Auto 的业务往来；当前安装与售后由 Supercheap Auto 自行承担，我方仅供货，未来可能转由我方负责。同时 Voltura 是 BYD 交流充电桩在澳新市场的独家售后代理（Exclusive After-Sales Agent），依据《BYD Voltura After-Sales Service Exclusive Agency Agreement》承接当地 BYD 充电桩售后（第二期统一售后域）。
• PSS 与 Voltura 共用一套售后系统（见第 10.1 节第 9 项）：两家澳大利亚公司的售后服务统一由同一套客户关系与现场服务售后系统承载，共享售后数据模型及状态流转、责任分段计时、免登录表单三项能力；Bunnings 安装/售后与 Voltura BYD 售后是其中两个业务场景，按渠道、品牌、工单类型配置流程，不分别建设两套系统。

因此，业务同时具备以下特征：

• 面向企业客户和零售渠道，而不是单一的个人消费者交易。
• 产品销售与安装服务在 Bunnings 渠道强关联，在 Supercheap Auto 渠道当前解耦。
• 零售渠道订单可能通过 EDI 自动进入系统。
• Bunnings 渠道的订单完成不仅包括发货，还包括安装任务闭环；Supercheap Auto 渠道当前只需完成供货。
• Voltura 的 BYD 充电桩售后以「资产序列号」为主轴：Customer（终端客户）→ Site（站点）→ Asset（资产/充电桩）→ Case（案例）→ Work Order（现场工单，1 Case → 0..N）全程可追溯（第二期）。
• 不同零售渠道拥有不同的 EDI 字段、代码、单据和联调要求。
• 安装服务需要记录地址、预约时间、安装要求、关联订单与产品、电工、派单与现场状态历史（含出发/到达时间）、现场备注与失败原因、照片和客户签名；详细字段以 6.9 为准。
• 运营人员需要处理 EDI 失败、订单异常、派单失败和售后问题。

3.2 组织关系与业务主体

本项目涉及中国大陆母公司、香港分公司、两家澳大利亚公司和比亚迪澳洲分公司五方法人，系统需要区分它们的法律、业务和系统角色：

深圳家之宝（中国大陆母公司，统筹全局，系统主导方）
  ├── 香港家之宝（香港分公司，与比亚迪澳洲公司签订业务）
  └── 澳大利亚两家运营公司
        ├── PSS（澳大利亚公司 A）── 负责 Bunnings 业务、安装与售后
        └── Voltura（澳大利亚公司 B）── 对接 Supercheap Auto

比亚迪澳洲公司（上游货源）
  → 货交付到我方澳大利亚仓库
  → 分别由澳大利亚公司 A / B 负责下游渠道业务

Bunnings 渠道数据
  Bunnings 系统 → SupplyLink（直接对接）

术语说明：本文「组织」指各法人主体（深圳家之宝、香港家之宝、PSS、Voltura）。系统为每个组织建立独立租户以实现数据隔离，因此「组织」与「租户」在本文等价：描述业务主体、归属与责任时用「组织」，强调数据隔离机制（如多租户隔离、安全隔离）时用「租户」。

主体	公司名称	在业务中的角色	在系统中的角色
中国大陆母公司	深圳家之宝	统筹全局，主导系统建设与运营，协调各区域公司	系统主导方；最高权限组织（租户）/管理组织，可查看和管理全集团数据
香港分公司	香港家之宝	与比亚迪澳洲公司签订业务，负责货源合同关系	业务组织；维护与比亚迪澳洲公司的货源合同和采购关系
澳大利亚公司 A	PSS	负责 Bunnings 业务往来，承担该渠道安装与售后	独立业务主体/组织（租户）；Bunnings 的业务、订单和安装售后责任主体；与 Bunnings 直接进行系统数据交换；统一售后域 Bunnings 场景运营主体
澳大利亚公司 B	Voltura	与 Supercheap Auto 业务往来；同时是 BYD 交流充电桩澳新独家售后代理	独立业务主体/组织（租户）；Supercheap Auto 的 EDI 交易主体和供货责任主体；BYD 充电桩售后运营主体（第二期统一售后域）
比亚迪澳洲公司（BYD）	比亚迪澳洲分公司	上游货源，货交付到我方澳大利亚仓库；同时是品牌方/主机厂（Principal），其售出充电桩的售后由 Voltura 承接	供应商/货源伙伴；售后域品牌方（principal_id 第二隔离维度，多品牌预留；仅做内部分层记录，暂不开账号）
Supercheap Auto、Bunnings	—	下游零售渠道客户、采购方和交易伙伴	零售客户账户及独立渠道；Bunnings 由 SupplyLink 直接对接

组织法定英文名（2026-09-09 客户材料确认）：深圳家之宝 = Shenzhen Gesibow Asia Supply Chain Limited；香港家之宝 = Hong Kong Gesibow Asia Supply Chain Limited；PSS = Power Source Supplier Pty Ltd；Voltura = Voltura Australia Pty Ltd。客户人员清单中的顶层管理员（集团负责人及运营负责人）并入深圳家之宝全局管理员角色，不新增第五个组织（见第 10.1 节第 6 项）。

关键责任边界如下：

• 中国大陆母公司统筹全局，系统由其主导；默认具备全集团数据可见性和管理权。
• 香港分公司负责与比亚迪澳洲公司的签约和货源关系，不直接作为零售商 EDI 交易主体。
• 澳大利亚公司 A 是 Bunnings 的业务、订单及安装售后责任主体；Bunnings 的系统数据交换由 SupplyLink 直接对接完成。
• 澳大利亚公司 B 是 Supercheap Auto 的 EDI 交易主体及供货责任主体；当前不承担安装售后。
• 比亚迪澳洲公司的货交付到我方澳大利亚仓库，由两家澳大利亚公司分别对接各自渠道。
• 商品需要能够追溯到比亚迪澳洲公司等上游货源，但上游货源信息不应改变零售商 EDI 交易主体。
• 两家澳大利亚公司必须作为独立租户隔离，EDI 凭据、订单、发票和安装数据不得跨渠道混淆。
• Bunnings 的订单、销量等渠道数据必须记录实际来源为 Bunnings 直连数据，并保留外部引用号、原始数据和处理日志。
• Voltura 的 BYD 售后业务与 Supercheap Auto 供货业务分属两个域：售后域以 principal_id（BYD）为第二隔离维度；BYD 只看不操作，商业数据（Voltura 成本、毛利、年费金额、安装商采购价、客户原始联系方式）对 BYD 不可见。

3.3 澳大利亚本地化要求

• 系统界面首期使用英文。
• 业务货币使用澳元（AUD，Australian Dollar）。
• GST（商品与服务税，Goods and Services Tax）默认税率为 10%。
• 订单、报价和发票需要明确区分含税金额与未税金额。
• 日期时间按实际经营州配置澳大利亚时区。
• 客户和供应商主数据需要支持 ABN（澳大利亚商业编号，Australian Business Number）等澳大利亚业务信息。

3.4 首期渠道策略与履约模式

渠道	负责主体	EDI 状态	安装与售后	说明
Bunnings	PSS（澳大利亚公司 A）	必须完成（渠道接入阶段第一优先级，直连对接）	安装与售后由我方负责，但仍属第二期	先完成共享统一数据格式，再接入订单电子交换；销量数据、安装派单与售后不随接入入口前移
Supercheap Auto	Voltura（澳大利亚公司 B）	必须完成（Bunnings 接入之后）	当前由 Supercheap Auto 负责，我方仅供货	在 Bunnings 电子数据交换优先轨后接入，预留未来承接安装售后的扩展能力
Voltura BYD 充电桩售后（第二期，统一售后域）	Voltura（澳大利亚公司 B）	第二期	由我方负责（BYD 澳新独家售后代理）	2026-09-09 客户材料新增范围；2026-09-10 确认与 PSS Bunnings 安装/售后共用一套售后系统；见第 5.6、6.13 节

4. 目标用户

系统的直接用户是跨区域组织的内部人员；系统的服务对象还包括通过零售渠道购买商品或服务的终端客户。

• 内部用户：中国大陆母公司、香港分公司、两家澳大利亚公司的销售、运营、仓储、调度、客服、电工和管理人员。
• 终端客户：从 Bunnings 或 Supercheap Auto 购买商品或服务的最终消费者。Bunnings 渠道的终端客户由我方负责安装售后；Supercheap Auto 渠道的终端客户当前由零售商负责安装售后。

4.1 内部销售人员

内部销售人员负责维护客户关系并推动交易完成。

主要工作：

• 查看和维护客户、联系人及客户地址。
• 记录线索、商机、电话、邮件、会议和跟进任务。
• 创建报价并跟踪报价状态。
• 查看客户历史订单、安装记录和售后记录。
• 跟进 Supercheap Auto、Bunnings 等零售渠道的订单和异常。
• 查看自己的销售业绩和待办事项。

核心诉求：客户资料集中、跟进不遗漏、订单状态清晰、能够快速判断下一步行动。

4.2 运营与订单处理人员

运营人员负责把销售订单或 EDI 订单推进到可交付状态。

主要工作：

• 处理手工订单和 EDI 入站订单。
• 检查商品、价格、库存、地址和交付日期。
• 处理订单确认、发货、ASN（预先发货通知，Advanced Shipping Notice）和发票相关流程。
• 处理 EDI 报文失败、重复报文和人工补偿。
• 关联订单与安装工单。
• 跟踪订单履约状态和异常原因。

核心诉求：订单不丢失、不重复，异常可追踪，人工补偿有记录。

4.3 客户服务人员

客户服务人员负责处理客户咨询、安装问题、投诉、保修和售后请求。

主要工作：

• 查询客户、订单和安装工单。
• 查看安装照片、签名和现场备注。
• 创建、分配和关闭售后服务单。
• 跟踪问题处理时限和解决结果。
• 向客户或内部人员发送状态通知。

核心诉求：能够从一个客户视图看到完整交易和服务历史，减少跨系统查询。

4.4 仓储与履约人员

仓储与履约人员负责备货、库存变更、发货及相关状态更新。

主要工作：

• 查看待履约订单。
• 检查库存和已分配库存。
• 记录出库、调整和其他库存流水。
• 更新发货信息。
• 触发或协助生成 ASN。

核心诉求：知道发什么、发给谁、何时发，以及库存变化可追溯。

4.5 调度人员

调度人员负责把现场任务（安装或维修）安排给合适的安装商/技术员（含电工）。该能力属统一售后域（第二期），覆盖 Bunnings 渠道安装场景与 Voltura BYD 售后维修场景的派单。

主要工作：

• 查看待派遣安装工单。
• 根据服务区域、资质、时间和可用性筛选电工。
• 向电工派发任务并跟踪接受或拒绝结果。
• 调整预约时间和重新派单。
• 处理安装失败、改约和现场异常。

核心诉求：派单过程透明，任务状态及时，失败任务可以快速补救。

4.6 自有或分包电工

安装商/技术员（含电工）通过移动端执行现场任务。该能力属统一售后域（第二期），现场服务移动应用承载 Bunnings 安装工单与 Voltura BYD 维修工单两种任务视图；安装和维修是否复用同一移动应用，须在第二期需求验收前确认。

主要工作：

• 登录并查看自己的现场任务（安装或维修）。
• 接受或拒绝派单。
• 查看客户地址、产品/资产、安装/维修要求和预约时间。
• 更新出发、到达、进行中、完成或失败状态。
• 上传现场照片、结果和客户签名。
• 填写现场备注和失败原因。
• 维修场景按免登录表单（通道 A）或账号（通道 B）回传现场结果。

核心诉求：移动端操作简单，现场信息完整，弱网络或操作中断后不会丢失状态和凭证。

4.7 管理者与系统管理员

管理者负责业务配置、权限、渠道和运营监督，并分组织层级：

• 深圳家之宝（中国大陆母公司）：统筹全局，拥有全集团数据可见性和管理权，主导系统建设。
• 香港家之宝（香港分公司）：管理与比亚迪澳洲公司的货源合同关系（采购下单在比亚迪平台执行）。
• 澳大利亚公司 A / B：各自管理本公司的客户、订单、EDI、库存、安装和售后。
• 共享运营团队（可选）：澳大利亚公司 A / B 人员编制较少时，可由母公司或共享团队通过统一运营视图集中管理两家公司；数据仍按组织隔离，业务单据须落到具体公司。

主要工作：

• 管理用户、角色和数据权限。
• 管理零售渠道、商品、价格、税率和服务区域。
• 管理比亚迪澳洲公司货源关系和仓库入库。
• 查看销售、订单、安装和 EDI 报表。
• 查看审计日志和系统操作记录。
• 处理 EDI 凭据引用、映射版本和失败报文。
• 管理系统通知和后台任务。

核心诉求：系统可控、数据隔离、关键操作可审计、业务异常可观测。

4.8 售后运营人员（统一售后域，第二期）

PSS 与 Voltura 的客服、调度、技术与管理人员共用一套 CRM + FSM 售后系统（统一售后域）开展运营。主要工作：

• Bunnings 场景（PSS）：从订单创建安装工单、派单给电工、跟踪安装状态历史与现场凭证、处理安装关联售后（Case 承载）。
• Voltura BYD 场景（Voltura）：处理多入口报修（官网、电话、邮件、经销商）并生成 Case；
• 远程诊断：远程可解决则关闭 Case，否则升级现场维修工单或 RMA；
• 派单给认证安装商/技术员（双通道），跟踪现场状态历史（出发/到达/完工）；
• 根因责任矩阵判定（制造缺陷/软件固件云 → BYD；安装缺陷 → 安装商；现场电网网络/误用 → 客户；NFF 不自动归责）；
• RMA 索赔、报销与结算；SLA 责任分段计时查看与 BYD 索赔数据输出。

4.9 BYD（Principal，第二期）

BYD 作为甲方/上游品牌方，只看不操作：可查看工单、故障分类、RMA、资产序列号、保修记录，并执行「审批」「技术争议」等协议要求其参与的动作；不可见 Voltura 成本、毛利、年费金额、安装商采购价与客户原始联系方式。

4.10 认证安装商/技术员（第二期，双通道）

• 通道 A（低配合）——免登录表单：不注册账号，Voltura 代录工单，安装商通过专属表单链接（token + 有效期）填写到达时间、完工时间、故障现象、现场诊断、现场照片、所用备件、完工验收；上线初期主通道。
• 通道 B（高配合）——账号登录：开通账号自主接单、打卡、完工验收；随安装商接受度提升引导升级。

资质（执照字段 + 到期日）做「记录 + 提醒」，不做硬拦截。

4.11 终端客户（第二期）

BYD 充电桩的报修方，只看与自己相关的信息；客户类型字段支持个人/企业/车队及父子层级。

5. 核心业务流程

5.0 采购与入库流程

补货计划或采购需求
  → 在比亚迪平台下单采购（外部，不由 SupplyLink 发起）
  → 人工录入 / CSV 导入 / 图片或 PDF 智能识别采购订单到 SupplyLink（镜像记录，含比亚迪平台订单号）
  → 供应商发货（在比亚迪平台跟踪）
  → 货交付到我方澳大利亚仓库
  → 仓库收货与质检
  → 入库并记录来源批次
  → 供应商发票对账（三单核对）
  → 应付账款

采购下单在比亚迪平台完成，SupplyLink 不向供应商发单或确认；系统中的采购订单为比亚迪平台订单的镜像/回填记录。采购订单（我方下给供应商）与零售商下给我方的 EDI PO（销售方向）是两个不同方向的单据，系统需分别建模。

5.1 CRM（Customer Relationship Management，客户关系管理）销售流程

线索
  → 资格确认
  → 商机
  → 报价
  → 谈判
  → 成交或失败
  → 创建订单

系统需要保留客户、联系人、商机、报价、活动和订单之间的关联关系。

5.2 零售商 EDI 流程（供货）

零售商 PO 入站（Supercheap Auto；Bunnings 直连）
  → EDI 报文校验与记录
  → 创建或匹配销售订单
  → 运营人员处理异常
  → 按渠道接入配置返回 POA（采购订单确认）
  → 备货与发货
  → 返回 ASN 发货通知
  → 返回 INVOIC 发票

Bunnings 渠道在供货完成后，还需进入安装履约流程（见 5.3）；Supercheap Auto 渠道当前仅完成供货，不进入安装履约。

首期至少需要支持以下 EDI 文档：

• PO：采购订单，入站。
• POA：采购订单确认，出站。
• ASN：发货通知，出站。
• INVOIC：发票，出站。

Supercheap Auto 的具体字段、代码、必填项、格式、校验规则和传输方式，以其零售商及 EDI 网关提供的技术规范为准。Bunnings 由 SupplyLink 直接对接，订单、销量等渠道数据的具体字段、格式、传输方向和处理规则，以 Bunnings 提供的接口规范及双方确认的业务规则为准。

5.3 物流履约流程

订单确认需要发货
  → 创建发货单（可拆单/部分发货）
  → 交货预约
  → 选择承运商并分配运单号
  → 拣货打包（托盘/箱/件）
  → 生成 ASN 发货通知
  → 承运商揽收
  → 运输中
  → 送达并签收（记录交货证明 POD）
  → 异常：拒收/破损/退回 → 补发或退款

物流状态需要覆盖：待发货、已揽收、运输中、已送达、已签收、异常、已退回。

5.4 安装履约流程（统一售后域 · Bunnings 场景）

Bunnings 订单确认需要安装
  → 创建安装工单
  → 分配或派遣电工
  → 电工接受任务
  → 电工出发/到达
  → 安装进行中
  → 上传照片与客户签名
  → 安装完成或失败
  → 更新订单履约状态

Supercheap Auto 渠道当前不进入此流程；系统应支持按渠道配置是否启用安装履约，以便未来 Supercheap Auto 将安装售后交给我方时复用同一套能力。

5.5 售后服务流程（统一售后域 · Bunnings 场景）

客户提出问题
  → 创建 Case（统一售后域 Case，区分于 Phase 1 基础服务单）
  → 远程诊断分岔（可远程解决则关闭；否则升级安装工单/维修工单或 RMA）
  → 现场处理与证据回传
  → 责任判定（根因责任矩阵）
  → 修复闭环 → 谁付钱 → 结算

售后服务 Case 需要能够关联客户、订单、安装工单和相关文件，共用统一售后域对象模型与引擎。Supercheap Auto 渠道当前售后由零售商负责，我方暂不介入，未来承接时复用统一售后域能力。

5.6 Voltura BYD 充电桩售后流程（统一售后域 · BYD 场景，第二期）

客户报修（官网 / 电话 / 邮件 / 经销商多入口）
  → 自动生成 Case
  → 远程诊断（第一个分岔口）
        ├─ 远程可解决 → 关闭 Case（0 现场单）
        └─ 不能解决 → 升级
              ├─ 现场派单（生成免登录表单链接）→ 维修闭环
              └─ 或 RMA → 责任判定（根因责任矩阵）→ 谁付钱 → 发票 → 回款

责任矩阵：制造/产品缺陷与软件/固件/云故障归 BYD（走 RMA → BYD 报销）；安装缺陷归安装商；现场/电网/网络与客户误用归客户（出保收费）；NFF 不自动归责，按流程人工判定。SLA 时间不暂停，每时段打责任标签（Voltura 处理中/等 BYD/等备件/等客户/等现场），KPI 只算 Voltura 责任时段，全量时段留存用于向 BYD 索赔与成本归因（协议 Clause 6(k) Support Dependency）。

5.7 用户开通、授权与登录会话控制（首期补充范围）

范围决策（2026-09-13）： 用户与权限（Access，/admin/access）与激活账户（Activate your account，/activate-account）是首期用户管理必须交付的完整流程。首版只可读取和分配系统预置角色；不提供自定义角色界面。当时的范围不包含真实邮件接入、密码重置、多因素认证、单点登录、外部系统自动同步用户、用户冒充、批量跨组织操作或第二期安装商账号。其中密码重置的排除已被 2026-10-18 的本地增量批准替代，邀请邮件服务也已有实现，具体限制见文首。历史角色创建接口不属于本次补充范围，须以独立后续需求、任务和交付范围登记决定其保留或替换，用户与权限页不得暴露该能力。

状态与允许的变化：

• 全局账户状态：待激活、已激活、已禁用。仅允许“待激活→已激活”（成功激活）、“待激活→已禁用”、“已激活→已禁用”和“已禁用→已激活”。
• 组织成员资格：有效或停用，可以在合法条件下相互切换。
• 邀请状态：待使用、已使用、已撤销；达到或超过到期时间即视为已过期。待使用邀请只能变为已使用或已撤销；已使用、已撤销或已过期邀请不得恢复为待使用。
• 已禁用账户不得通过激活、重发邀请或更新角色恢复。其他非法状态变化均拒绝，且账户、成员资格、邀请、角色、会话版本、审计记录和待发送通知均不变。
• 只有已激活账户且在请求组织具有有效成员资格，才能登录、取得登录凭证或读取该组织数据。

统一校验顺序： 修改数据前固定依次检查登录身份、当前组织及组织授权、用户管理权限、目标记录是否属于该组织、记录版本是否匹配（适用时）、输入格式与业务规则，全部通过后才执行修改或返回无变更结果。无权限或访问其他未获授权组织时，不得透露目标用户、邀请码、角色或成员资格是否存在，且不得产生成功审计或待发送通知。普通管理员仅操作当前组织；集团管理员跨组织管理时也必须逐组织提交，不提供批量跨组织修改。接口状态码及版本校验字段见文末技术对照。

用户操作	操作者、权限与范围	成功行为	失败时不得改写的数据	审计、通知与登录会话
查询用户	具有用户管理权限；已授权的当前组织	分页、搜索当前组织全部待激活、已激活和已禁用用户，查看其成员资格与预置角色摘要；不得返回密码、凭证摘要、原始凭证或其他组织详情	缺组织范围或权限时按统一顺序拒绝；查询、空结果和无匹配条件均不写业务数据、审计或待发送通知	仅记录访问监测信息，不影响登录会话
邀请、重发与撤销	具有用户管理权限；当前组织	提交规范化邮箱及至少一个预置角色；在同一事务中创建或复用待激活账户、有效成员资格、角色绑定、72 小时有效的待使用邀请及模拟发送通知。响应绝不返回原始凭证；仅模拟测试可读取激活链接	必须携带重复提交识别键；同一键用于不同请求时拒绝且不写入；邮箱重复、角色为空或未知、账户已禁用或角色超出可分配范围时明确拒绝，不创建邀请；相同键重试返回原成功结果	成功时恰好写一条用户邀请审计及一条脱敏待发送通知；失败或回滚不写成功记录，不创建登录会话
受邀用户激活账户	公开的激活账户页（Activate your account，/activate-account）；不使用已有登录身份或浏览器登录信息，仅提交不包含用户资料的一次性邀请凭证及密码、确认密码	从链接井号后部分取得凭证，仅放在提交请求正文中；验证邀请待使用且未过期后，在同一事务中写入密码校验值、激活账户、标记邀请已使用并递增会话版本；不自动登录	与登录使用同等请求限流；未知、过期、撤销或已使用的凭证统一提示邀请无效，不披露邮箱、用户或组织；密码不合规时邀请仍待使用；请求、日志、审计、通知和错误响应不得含原始凭证或密码	成功记录脱敏激活审计，不向邮件服务发送内容；失败不写成功审计或待发送通知；激活后须主动登录
替换角色与启停成员资格	具有用户管理权限；当前组织中的目标成员	版本匹配时整体替换至少一个预置角色，或合法启停成员资格；有效角色变更或停用后递增用户会话版本	目标不存在或属于其他组织、缺版本或版本过旧、角色为空或未知、对已禁用账户启用成员资格或非法状态变化时均拒绝；不更新角色、成员资格、版本、审计或通知	成功记录成员或角色审计；有效授权变更或停用成员后，在提交时撤销该用户全部登录及续期会话；无变更请求只返回现有结果，不写审计、通知或版本
禁用与恢复账户	具有用户管理权限；当前组织的目标用户	版本匹配时禁用已激活账户或恢复已禁用账户；禁用后立即拒绝旧登录及续期凭证，恢复后须重新登录	已禁用账户不能通过邀请激活或取得有效成员资格；目标不存在、属于其他组织、版本过旧或状态变化非法时均拒绝且不改写数据	禁用及恢复均记录审计、递增会话版本并在提交后撤销缓存会话；恢复不补发邀请、不自动登录

验收场景（前提、操作、预期结果）：

• 具有用户管理权限且选择有效组织的管理员邀请新邮箱并指定预置角色后，系统创建待激活账户、有效成员资格、角色绑定、72 小时有效邀请、脱敏审计及模拟待发送通知；接口响应、审计和普通日志均不含原始凭证或密码。
• 持有效且未过期邀请的受邀用户，在激活账户页提交合规密码后，账户变为已激活、邀请变为已使用，且必须随后主动登录；未知、过期、撤销或已使用凭证均提示邀请无效，不产生状态或审计变更。
• 当前组织中已激活用户的记录版本匹配时，管理员替换角色、停用成员资格或禁用账户后，角色或状态变化与会话版本递增须同时提交，旧登录及续期凭证立即失效；恢复后旧凭证仍不可使用。
• 用户无管理权限、未指定组织、访问未获授权的组织或不可见目标记录时，系统按统一顺序拒绝操作，不改变账户、成员资格、角色、邀请、会话、审计或待发送通知。

6. 功能需求

6.1 客户与联系人管理

系统应支持：

• 创建、编辑、查询和停用客户。
• 保存公司名称、法定名称、ABN、联系方式和付款条款。
• 管理多个客户地址，并区分账单、收货和安装地址。
• 管理多个联系人，并记录联系人职责和主要联系人标识。
• 通过标签、状态和负责人对客户分类。
• 查看客户关联的商机、报价、订单、安装工单、服务单和活动时间线。
• 识别潜在重复客户，并支持人工合并或标记。

6.2 线索、商机与跟进

系统应支持：

• 创建和分配销售线索。
• 记录线索来源、状态、预计金额和下次跟进时间。
• 将合格线索转化为客户和商机。
• 创建商机并记录销售阶段、预计金额、成交概率和预计成交日期。
• 记录电话、邮件、会议、备注和任务。
• 对逾期跟进和即将到期的任务进行提醒。
• 将商机转化为报价或订单。

6.3 报价管理

系统应支持：

• 创建报价及报价明细。
• 选择客户价格、产品、数量、折扣和安装费用。
• 计算 GST，并显示含税和未税金额。
• 设置报价有效期和付款条款。
• 跟踪草稿、已发送、已接受、已拒绝、已过期和已转订单状态。
• 保留报价转订单时的价格快照。
• 导出或生成报价文件。

6.4 商品、价格与库存

系统应支持：

• 管理 SKU（Stock Keeping Unit，库存量单位）、名称、分类、GTIN（Global Trade Item Number，全球贸易项目代码）/条码、单位和是否需要安装。
• 管理 GST 税类和默认税率。
• 管理仓库或其他库存地点。
• 查看现有库存、已分配库存和可用库存。
• 记录入库、出库和库存调整流水。
• 支持渠道或客户专属价格。
• 在订单处理中校验商品有效性和库存可用性。
• 记录商品的上游货源伙伴，首期支持关联比亚迪澳洲分公司。
• 记录供货批次、采购参考号或其他可用的来源追溯信息。
• 支持比亚迪澳洲公司的货交付到我方澳大利亚仓库的收货、质检与入库流程。
• 库存需区分所属澳大利亚公司（A / B）或支持共享仓配下的公司间调拨。

6.5 采购与供应商管理

系统应支持：

• 维护供应商主数据（名称、ABN、联系人、结算信息、付款账期）。
• 首期供应商为比亚迪澳洲公司，由香港家之宝负责货源合同关系；采购下单在比亚迪平台执行。
• 登记采购订单（镜像/回填）：人工录入或 CSV（Comma-Separated Values，逗号分隔值）导入在比亚迪平台下单的采购订单作为镜像记录，记录供应商、商品、数量、采购成本价、预计交货日期和比亚迪平台订单号。
• 采购订单图片智能识别导入：采购或运营人员可上传供应商采购订单的 JPG、PNG 或 PDF（Portable Document Format，便携式文档格式）文件，系统通过 OCR（Optical Character Recognition，光学字符识别）/AI 识别订单头信息和明细行，识别结果必须在创建订单前展示并允许人工校正。
• 智能识别字段至少包括采购订单号、供应商、收货仓库、订单日期、交货日期、币种、GTIN、供应商商品编号、商品描述、数量、包装数量、单位价格和未税金额；无法识别或置信度不足的字段必须明确标记。
• 识别结果确认后创建采购订单镜像记录；明细商品应支持通过 GTIN 或供应商商品编号匹配系统商品，无法匹配时可预填待创建草稿（SKU/名称/GTIN），由用户确认并校正后创建商品（非静默、非自动）；供应商应支持按 ABN 匹配系统供应商，无法匹配时可预填待创建草稿（名称/ABN），由用户确认并校正后创建供应商（非静默、非自动）。
• 图片识别导入需执行外部采购订单号重复校验；原始图片/PDF、识别结果、人工修改记录和导入操作日志需要保存并与采购订单关联。
• 采购订单状态：待收货、部分收货、已收货、已开票、已关闭、已取消。
• 管理商品采购成本价，与销售价、渠道价区分。
• 采购收货：按采购订单收货，支持部分收货和超收/短收记录。
• 三单对账：采购订单（镜像）、实际收货、供应商发票三者核对。
• 记录应付账款：供应商、金额、账期、付款状态。
• 补货计划：基于库存可用量和销售需求生成补货建议；补货建议生成后，下单在比亚迪平台执行。
• 采购订单与货源入库、库存流水、供应商发票关联。

首期不要求自动化补货预测，可先支持人工录入/CSV 导入/图片或 PDF 智能识别采购订单（镜像）和补货建议列表。

6.6 订单管理

系统应支持：

• 创建手工销售订单。
• 从 EDI PO 创建订单。
• 记录渠道、外部采购订单号、客户、交付日期和币种。
• 管理订单行、数量、单价、折扣、GST 和行金额。
• 区分含税和未税金额。
• 支持草稿、已确认、履约中、已发货、已完成、已开票和已取消等状态。
• 记录每次状态变更、操作者、时间和原因。
• 将订单与 EDI 文档、发货、发票、安装工单和服务单关联。
• 能查看订单对应的货源伙伴和供货状态，但不改变对应澳大利亚公司（A / B）作为零售商交易主体的关系。
• 防止同一外部采购订单重复创建。

6.7 物流与发货管理

系统应支持：

• 从已确认订单创建发货单，支持一个订单拆分为多个发货单，或部分发货。
• 管理承运商（物流公司名称、承运方式、跟踪查询入口）。
• 为每票发货记录运单号或物流跟踪号。
• 维护发货包装层级（托盘、箱、件）及各层数量，支持 SSCC（Serial Shipping Container Code，系列货运包装箱代码）或箱号。
• 记录发货地址（门店或配送中心）和收货方信息。
• 交货预约：记录预约交货日期和时间窗口，支持改约和逾期提醒。
• 物流状态跟踪：待发货、已揽收、运输中、已送达、已签收、异常、已退回。
• 记录签收信息：签收人、签收时间、交货证明（POD，Proof of Delivery）文件。
• 处理拒收、破损和退货回运，并关联补发或退款。
• 发货单的包装与承运信息作为 ASN 发货通知的数据来源，保证与实际发货一致。
• 物流异常可见：延误、拒收、破损、丢失可被运营人员识别并处理。

6.8 零售商 EDI

系统应支持：

• 配置 Supercheap Auto 交易伙伴及其 EDI 网关，并配置 Bunnings 渠道直连接入、凭据引用、数据类型和映射版本。
• 将 Supercheap Auto 的交易归属澳大利亚公司 B，Bunnings 的交易归属澳大利亚公司 A。
• 接收并处理直连的 Bunnings 订单、销量等渠道数据，记录 source_provider、原始数据、标准化结果、外部引用号和处理日志；销量数据不强制建模为销售订单或标准 EDI 单据。
• 安全保存外部凭据引用，不在业务日志中暴露敏感信息。
• 接收入站 PO 并保存原始报文、解析结果和外部引用号。
• 按渠道规则校验报文并将错误标记为可处理异常。
• 将有效 PO 幂等地创建或匹配销售订单。
• 生成并发送 POA、ASN 和 INVOIC。
• 保存每一份报文的状态、方向、类型、关联订单和错误信息。
• 对失败报文执行自动重试和人工重试。
• 记录每次处理尝试、结果、错误详情和映射版本。
• 支持运营人员查看、筛选和处理 EDI 异常。
• EDI 凭据、报文和订单严格按所属澳大利亚公司隔离，不得跨公司混淆。
• Supercheap Auto 和 Bunnings 的渠道规则相互独立，新增或调整任一渠道不应影响另一渠道。
• Bunnings 由 SupplyLink 直接对接；未来接入方式变化时，应只替换接入适配器和配置，不改变订单、安装、售后及组织隔离模型。6400Y109291559 Purchase_Order.pdf 仅作为字段结构、跨行表格解析和映射 golden fixture，不提供 PDF 上传、文本识别或人工补录入口。

6.9 安装工单与安装商管理（统一售后域 · Bunnings 场景；第二期/后续）

范围标识： 本节属于第二期或后续增项能力，不属于第一期固定范围、固定报价或第一期验收；第一期不启用 Bunnings 安装履约。

统一售后域（见第 10.1 节第 9 项）： 安装与维修均采用现场工单，按“安装”或“维修”类型区分，共享数据模型及可配置状态流转、服务时限责任分段计时、免登录表单三项能力，按场景配置流转规则；电工作为安装商或技术员资料中的一种类型，资质做“记录 + 提醒”，不因资质到期自动拦截操作。

系统应支持：

• 按渠道配置是否启用安装履约；第一期不启用 Bunnings 安装履约，待第二期或后续增项确认后启用。
• 从符合条件的 Bunnings 订单创建安装工单。
• 保存安装地址、预约时间、安装要求和关联订单。
• 管理电工姓名、账户、ABN、执照编号、服务区域和启用状态。
• 根据服务区域和可用性进行派单。
• 支持派单、接受、拒绝、重新派单和取消。
• 管理待派遣、已派遣、已接受、在途中、进行中、已完成和失败状态。
• 保存状态历史、备注、照片和客户签名。
• 向相关人员发送新任务、状态变更和异常通知。
• 预留 Supercheap Auto 未来启用安装履约的扩展能力，复用同一套安装能力。

6.10 售后服务（统一售后域 · Bunnings 场景）

统一售后域（见第 10.1 节第 9 项）： Bunnings 售后采用统一的售后案件记录，区别于第一期基础服务单，复用共享数据模型及三项共享能力；安装关联售后通过安装工单记录关联。

系统应支持：

• 创建客户服务 Case、维修 Case、投诉 Case 和保修问题（Case 类型可配置）。
• 设置优先级、负责人、状态和处理期限。
• 关联客户、订单、安装工单和文件。
• 记录问题描述、处理过程、解决方案和关闭时间。
• 支持 Case 状态历史和操作审计。

Supercheap Auto 渠道当前售后由零售商负责，我方暂不介入；系统预留未来启用该渠道售后时复用统一售后域能力的扩展位。

6.11 报表与仪表盘

首期应提供：

• 销售订单数量和金额。
• 按公司（澳大利亚公司 A / B）和渠道统计订单和履约情况。
• Supercheap Auto 与 Bunnings 各自的 EDI 成功率、失败数和待处理数。
• Bunnings 直连销量数据及其按时间、商品和订单维度的汇总；报表应标明数据来源和统计口径。
• 待确认、待发货和异常订单。
• 物流在途、已签收、拒收和退回数量。
• 安装工单数量、完成率、失败率和平均处理时间（Bunnings 渠道）。
• 售后服务统计：服务单数量、类型、优先级、处理时长和解决率（Bunnings 渠道）。
• 电工任务量和完成情况。
• 销售人员商机、报价和成交情况。
• 采购订单数量和金额、应付账款汇总。
• 库存报表：我方仓库库存（现有、可用、在途）与零售端库存，并结合库存和销售情况生成采购建议。
• 退货报表：按渠道和商品统计零售端退货明细（数量、金额、原因、关联订单）。
• GST、含税金额和未税金额汇总。
• 财务报表：销售、采购成本、毛利、应收/应付和 GST 的汇总与期间对比。
• 母公司全局视角可跨公司汇总，区域公司默认查看本公司数据。

6.12 权限、审计与通知

系统应支持：

• 基于角色的功能权限和数据权限。
• 销售、运营、客服、调度、电工和管理员等角色。
• 多租户隔离：中国大陆母公司（全局可见）、香港分公司、澳大利亚公司 A、澳大利亚公司 B 各自为独立组织，关键数据按组织隔离。
• 母公司可跨公司查看和管理全集团数据，区域公司默认只能访问本公司数据。
• 支持聚合角色：可新建组合多个职能权限的角色（如「共享运营员」聚合销售、订单处理、仓储、调度等权限），用于人员编制少时一人多岗。
• 支持一人多组织：同一用户账户可被授予多个组织作用域（澳大利亚公司 A / B 或全局），无需切换账号即可跨公司操作。
• 跨公司操作须明确业务归属：以共享角色操作时，业务单据仍须落到具体组织（A / B），数据隔离不因聚合角色或跨组织授权而放松。
• 记录客户、订单、价格、权限、EDI 和安装状态的关键操作。
• 通过后台通知、推送或邮件提醒相关人员。
• 后台任务支持轮询、重试和失败记录。
• 用户与权限（Access，/admin/access）用户管理闭环： 管理员可在当前组织查询用户、邀请用户、分配预置角色、启停成员关系及禁用/恢复账户；受邀用户仅通过激活账户页（Activate your account，/activate-account）的一次性邀请链接自助设密激活。操作规则、权限、状态变化、异常处理、审计、待发送通知和登录会话撤销以第 5.7 节为准，不得以“直接创建已激活用户”替代邀请和激活闭环。

6.13 统一售后域（第二期；PSS 与 Voltura 共用一套售后系统）

范围标识： 本节属第二期范围，不属于第一期固定范围、固定报价或第一期验收。

统一售后域原则（2026-09-10 用户确认，见第 10.1 节第 9 项）： PSS（Bunnings 安装/售后）与 Voltura（BYD 充电桩售后）共用一套客户关系与现场服务售后系统，不分别建设两套；共享客户、站点、资产、售后案件、工单、退换修索赔、安装商、备件及计费数据模型，以及可配置状态流转、服务时限责任分段计时、免登录表单三项能力；按渠道、品牌、安装或维修类型配置流程，仍按组织和品牌两层隔离数据。以下需求同时覆盖两个场景。

系统应支持：

• 资产主轴：以资产序列号作为唯一主键，资料允许为空并逐步补全；固件版本须独立记录及保留历史，以追溯固件相关故障率（对应协议附表 1 的批量故障条款）；资产有独立的已销售、已安装、使用中、故障、退换修、翻新状态；全程关联“客户→站点→资产→售后案件→现场工单”。
• 售后案件与现场工单分离：一个案件可不产生现场工单，远程解决后直接关闭；也可关联多次上门处理的工单。
• 统一现场工单类型（见第 10.1 节第 9 项）：Bunnings 安装与 Voltura BYD 维修共用现场工单记录及三项共享能力，按类型配置状态流转及字段要求；电工与认证安装商共用安装商或技术员资料，记录执照及到期日。
• 退换修与索赔独立记录：独立跟踪“草稿→已提交→审核中→批准或拒绝→已开票→已报销或关闭”；关联现场工单但单独管理处理过程；须明确“谁付钱→发票→回款”，现场照片是索赔证据必需项。
• 根因责任矩阵：制造缺陷/软件固件云 → BYD；安装缺陷 → 安装商；现场电网网络/客户误用 → 客户；NFF 不自动归责，人工复核。
• 免登录表单引擎：每现场维修工单（Voltura BYD 场景为主）自动生成专属表单链接（token + 有效期，可撤销重发）；表单字段由 RMA 证据需求反推（到达/完工时间、故障现象、现场诊断、照片、备件、完工验收），回填工单/资产；重复提交保留原结果。
• 安装商/技术员双通道：Voltura BYD 维修场景通道 A 免登录表单（上线初期主通道）+ 通道 B 账号登录；Bunnings 安装场景电工沿用账号登录模型；资质（执照 + 到期日）记录 + 提醒，不硬拦截。
• SLA 责任分段计时引擎：时间不暂停，每时段打责任标签；KPI 只算 Voltura 责任时段；全量留存用于向 BYD 索赔。
• 可配置状态机引擎：状态值、流转规则、字段要求、权限挂载、触发动作、时间戳埋点后台可配置，不改代码。
• BYD 文件导入：Excel/CSV 保修与主数据导入，序列号去重/对齐校验，无法匹配不得静默创建，预留 API。
• 售后计费：自销 vs BYD 渠道两套规则；基础计费 = 年费 + 事件费 + RMA 报销；延保（Schedule 6）预留扩展位。
• 备件/翻新件：RFID 卡、线缆、替换单元、翻新件；备件使用关联库存扣减与报销。
• BYD 权限：只看不操作；不可见成本/毛利/年费/安装商采购价/客户原始联系方式。
• 售后报表：服务时限达成情况（只算 Voltura 责任时段）、积压和故障率（按根因类别、产品线、固件版本）；阈值与绩效指标数值待与 BYD 确认。
• 客户产品定义尚待确认的范围（2026-09-10 子集核查）：经销商资料及归属标记、产品类别可配置字典（充电桩、户用储能、车辆向电网供电）、沟通记录与附件、诊断工具集成、后续版本资质自动校验共 5 项待确认；第二期需求验收前须逐项确认纳入或明确排除，确认前不得仅依据客户原材料自行实现。

7. 首期范围与非范围

7.1 项目确定范围

首期目标是交付可以实际运营的核心闭环：

1. 多组织（租户）管理：中国大陆母公司（全局）、香港分公司、澳大利亚公司 A、澳大利亚公司 B。
2. 客户、联系人和地址管理。
3. 商品、价格、库存、采购订单、供应商管理及比亚迪澳洲公司货源入库流程。
4. 手工销售订单以及两家零售渠道统一数据格式的电子订单能力；渠道接入阶段按 Bunnings 优先、Supercheap Auto 后置实施。
5. 优先完成 Bunnings 采购订单、订单确认、发货通知和发票的统一格式、模拟流程及独立渠道适配器；实际渠道认证须待接入资料确认后进行。
6. 两渠道相互隔离的报文日志、防重复处理、重试和异常处理；Supercheap Auto 实际接入在 Bunnings 优先轨之后推进。
7. 发货单、承运商、包装层级、运单跟踪与签收（支撑 ASN）。
8. 基础客户跟进、商机和活动记录。
9. RBAC（Role-Based Access Control，基于角色的访问控制）、审计、通知和基础报表。

第一期明确边界：Bunnings 电子数据交换入口的统一格式、模拟测试及独立渠道适配器属于渠道接入阶段优先范围；实际渠道联调验收仅在规范、样例、测试环境、认证和生产凭据齐备后完成。Bunnings 销量数据扩展、安装、电工端和现场售后仍不纳入第一期固定范围、固定报价或第一期验收，列入第二期或后续交付阶段。

第二期范围（2026-09-10 确认）：客户新增的 Voltura BYD 充电桩售后能力（资产、售后案件、维修工单、退换修索赔、免登录表单、售后计费、BYD 文件导入、工程师移动应用）不纳入第一期固定范围、报价或验收，列入第二期；客户追加确认，该能力与 PSS 的 Bunnings 安装/售后共用一套售后系统，不分别建设两套；依据见第 10.1 节。

7.2 暂不排期范围

• Bunnings 销量数据扩展及由此触发的安装、电工端和售后能力，第一期暂不排期；Bunnings 电子数据交换的实际联调验收，仍须接入资料确认齐备后方可完成。
• Voltura BYD 充电桩售后能力（资产、售后案件、维修工单、退换修索赔、免登录表单、售后计费、BYD 文件导入、工程师移动应用），第一期暂不排期；第二期通过相应验收门槛后实施，与 PSS 的 Bunnings 安装/售后共用一套售后系统（见第 10.1 节第 9 项）。
• 复杂营销自动化和邮件营销编排。
• 完整客户自助门户。
• 高级销售预测和复杂佣金结算。
• 多国家、多币种和复杂税务规则。
• 大规模仓储管理和运输路线优化。

8. 非功能需求

8.1 可靠性

• EDI 报文处理失败后不得静默丢失。
• 重复接收同一外部订单时不得生成重复订单。
• 状态变更和外部报文处理需要保留可追溯记录。
• 电工上传的照片和签名需要与安装工单可靠关联。
• 采购订单图片识别失败、字段无法匹配或重复订单时不得静默创建采购订单，必须保留错误原因并允许人工处理。

8.2 安全性

• 外部 EDI 凭据不得直接暴露在页面、普通日志或错误信息中。
• 中国大陆母公司、香港分公司、澳大利亚公司 A / B 之间的数据必须按组织隔离。
• 两家澳大利亚公司的 EDI 凭据、订单、发票和安装数据不得跨公司混淆。
• 关键业务操作必须经过权限校验。
• 管理员、订单、价格和 EDI 操作应有审计记录。

8.3 可维护性

• 各零售渠道的 EDI 规则应相互独立，新增渠道不应影响已有渠道。
• Supercheap Auto 和 Bunnings 的渠道规则应能与通用订单流程独立调整。
• 安装履约能力应按渠道启用或停用，Supercheap Auto 未来承接安装售后时应能复用现有能力。
• 业务规则和渠道规则变更不应破坏既有订单、EDI 和安装数据的完整性与可追溯性。

8.4 可用性

• Admin 后台适合销售和运营人员进行高频列表、筛选和批量处理。
• 电工端适合现场单手操作，关键状态和上传入口清晰。
• 关键异常需要明确展示原因和下一步处理动作。
• 金额、GST、日期时间和状态标签在全系统保持一致。

8.5 统一售后域非功能需求（第二期；2026-09-09 客户材料）

• 售后记录留存：协议明确要求 7 年记录留存，并满足 ACL/CGA 合规与 Privacy Act 要求。
• 免登录表单安全：专属 token + 有效期 + 可撤销；提交幂等（重复提交保留原结果）；token 只暴露本工单表单，不得泄露工单以外数据。
• BYD 商业数据隔离：BYD 不可见 Voltura 成本、毛利、年费金额、安装商采购价与客户原始联系方式。
• 现场工程师 App 离线能力：澳洲偏远地区弱网/断网下状态与凭证不丢失，网络恢复后可靠同步。

9. 首期验收标准

9.1 Bunnings 优先电子数据交换验收（澳大利亚公司 A，实际接入须先确认资料）

• Bunnings 接入资料未确认齐备时，统一格式和模拟渠道适配器测试可证明报文校验、防重复处理、重试、异常队列和订单归属；不得视为实际渠道联调验收。
• Bunnings 接入资料确认齐备后，能直连接收并记录 Bunnings 的真实或测试采购订单，并保留来源标识、原始数据和外部引用号。
• 有效 PO 能幂等地创建正确订单，且订单归属于澳大利亚公司 A。
• 订单确认 POA、发货后的 ASN 和发票 INVOIC 能按 Bunnings 已批准规范生成、发送并保留映射版本。
• 任一报文失败时，运营人员能查看错误并执行重试或人工补偿。
• 每个报文都能追溯到外部引用号、系统订单和处理日志。
• Bunnings EDI 数据与 Supercheap Auto 渠道完全隔离。

9.2 Supercheap Auto EDI 验收（澳大利亚公司 B，Bunnings 优先轨后）

• 能接收并记录 Supercheap Auto 的真实或测试 PO。
• 有效 PO 能幂等地创建正确订单，且订单归属于澳大利亚公司 B。
• 订单确认 POA、发货后的 ASN 和发票 INVOIC 能按 Supercheap Auto 已批准规范生成并发送。
• 任一报文失败时，运营人员能查看错误并执行重试或人工补偿。
• 每个报文都能追溯到外部引用号、系统订单和处理日志。
• Supercheap Auto 的 EDI 数据与 Bunnings 渠道完全隔离。

9.3 采购、货源入库与订单验收

• 能录入/导入在比亚迪平台下单的采购订单（镜像），记录供应商、商品、数量、采购成本价和比亚迪平台订单号。
• 采购订单能关联仓库收货、质检和入库；供应商发货在比亚迪平台跟踪。
• 三单对账能核对采购订单、实际收货和供应商发票。
• 应付账款能记录供应商、金额、账期和付款状态。
• 比亚迪澳洲公司的货能收货、质检并入库到我方澳大利亚仓库。
• 库存能正确关联货源伙伴和来源批次。
• 运营人员能够完成客户、商品和订单录入。
• 订单金额、GST、含税金额和未税金额计算正确。
• 可上传 Bunnings 等供应商的采购订单图片或 PDF，识别采购订单头信息和明细行；识别结果可人工校正，确认后生成正确的采购订单镜像记录。
• 图片识别导入能够保存原始文件、识别结果和人工修改记录；低置信度字段、商品匹配失败和重复订单均有明确提示。
• Supercheap Auto 渠道订单仅完成供货，不进入安装履约。

9.4 物流履约验收（第一期）

两渠道的供货履约和支撑预先发货通知的发货能力属于渠道接入与供货履约阶段；Bunnings 安装、退货/退款和现场售后仍延期到第二期。

• 已确认订单能创建发货单，支持拆单和部分发货。
• 每票发货能关联承运商、运单号和包装层级（托盘/箱/件）信息。
• ASN 发货通知所需字段能从发货单和包装信息生成，与物流实际一致。
• 物流状态从待发货到已签收能完整跟踪，签收人、签收时间和交货证明可追溯。
• Phase 2：拒收、破损和退货回运能被记录，并关联补发或退款。

9.5 安装履约验收（统一售后域 · Bunnings 场景；后续阶段）

本节对应 5.4 安装履约流程与 5.5 售后服务流程，不属于首阶段验收。

• Bunnings 订单能够创建安装工单（统一 Work Order，type=install）并派给电工。
• 电工能够在移动端接受任务并回传状态。
• 电工能够上传照片、签名和完成备注。
• 安装完成或失败后，后台能看到完整状态历史。
• 安装关联售后采用统一售后案件记录，与 Voltura BYD 售后共用数据模型及共享能力（见第 10.1 节第 9 项）。

9.6 权限与运营验收

• 不同角色只能执行授权操作。
• 中国大陆母公司可跨公司查看和管理全集团数据。
• 澳大利亚公司 A / B 默认只能访问各自公司数据，不得跨公司混淆。
• 客户、订单、EDI 和售后服务单关键操作具有审计记录。
• 运营人员能看到待处理的 EDI、订单和售后服务单异常。
• 独立的销售、订单、EDI 和安装报表列入后续阶段；首阶段提供必要的列表、筛选和异常查看。

9.7 基础售后服务单验收（首阶段）

• 能创建咨询、投诉、维修和保修服务单。
• 服务单能关联客户、订单和文件，记录负责人、优先级、状态、处理过程和解决方案。
• 服务单不包含安装工单、电工派单、照片/签名现场凭证或移动端能力。

9.8 统一售后域验收意图（第二期，不属于第一期验收）

本节仅定义 Phase 2 的未来验收意图，不属于 Phase 1 固定范围、报价、实现或验收。

• 多入口报修能自动生成 Case；远程诊断可关闭（0 现场单）或升级现场工单/RMA。
• 维修工单支持待派遣、已派遣、已接单、在途、到达、维修中、完成、失败等状态；不允许的状态变化须明确拒绝。
• 免登录表单使用专属安全凭证及有效期，允许查看和提交，不允许重复提交；凭证过期、撤销或未知时须分别提示“链接已过期”“链接已撤销”或“链接无效”。
• 退换修及索赔独立跟踪状态；责任判定须记录根因类别与责任方；未发现故障时不自动归责；完成责任判定后才能进入已报销或已关闭状态。精确错误标识见文末技术对照。
• SLA 责任分段计时完整留存，KPI 只统计 Voltura 责任时段。
• BYD 文件导入完成序列号去重/对齐校验；无法匹配的行保留复核草稿，不静默创建。
• BYD 角色只看不操作，且不可见商业敏感字段。

10. 关键业务决策

1. 深圳家之宝（中国大陆母公司）统筹全局并主导系统建设，拥有全集团数据可见性和管理权。
2. 香港家之宝（香港分公司）负责与比亚迪澳洲公司的签约和货源关系。
3. 澳大利亚公司 A 对接 Bunnings 并承担安装售后；澳大利亚公司 B 对接 Supercheap Auto，当前仅供货。
4. Supercheap Auto 和 Bunnings 都是确定接入的零售商。
5. Bunnings 渠道需启用安装履约和售后；Supercheap Auto 渠道当前不启用，系统预留未来承接能力。
6. 两家澳大利亚公司必须作为独立租户隔离，EDI 凭据、订单、发票和安装数据不得跨渠道混淆。
7. 系统以订单履约和安装闭环为核心，CRM 销售功能先实现支撑日常运营所需的最小集合。
8. Voltura 同时承担 Supercheap Auto 供货与 BYD 充电桩澳新独家售后代理双重业务；售后域为第二期范围（2026-09-10 用户确认，见第 10.1 节）。
9. 售后以资产序列号为主轴，关联客户、站点、资产、售后案件与现场工单；案件与工单分离，一个案件可不产生工单，也可关联多个工单；售后案件独立于第一期基础服务单。
10. 售后数据先按组织、再按品牌隔离；BYD 只看不操作且商业数据隔离；安装商采用免登录表单与账号登录双通道，初期以表单为主，随接受度提升升级。
11. 统一售后域（2026-09-10 用户确认，见第 10.1 节第 9 项）：PSS 与 Voltura 共用一套客户关系与现场服务售后系统；Bunnings 安装/售后与 Voltura BYD 充电桩售后共用数据模型及状态流转、责任分段计时、免登录表单三项能力，按渠道、品牌、安装或维修类型配置流程；不分别建设两套系统，不放松数据隔离；Supercheap Auto 未来承接安装售后时复用该能力。

10.1 客户确认的售后业务决策（2026-09-10，含追加确认）

客户对《Voltura 售后运营系统产品定义文档》引入的 BYD 充电桩售后域逐项确认如下（按推荐方案）：

序号	决策点	确认结果
1	Voltura BYD 售后系统归属	并入 SupplyLink，共享组织、角色权限、审计与仓库
2	交付期归属	属第二期；第一期契约、里程碑与任务不变，售后新增范围在接口规范中统一标记为第二期
3	按客户产品定义更新 Voltura 与 BYD 角色	Voltura 同时承担 Supercheap Auto 供货与 BYD 充电桩澳新独家售后代理；BYD 同时为上游货源和品牌方
4	售后案件与现场工单区分	售后案件独立记录；维修工单与安装工单明确区分；工程师移动应用复用评估须在第二期需求验收前完成
5	跨公司售后权限随售后范围生效	在角色权限矩阵和接口规范中明确授权，按交付期标注，不提前开放第二期权限
6	顶层管理员所属层级	并入深圳家之宝母公司角色，不新增第五个组织；客户人员清单中的顶层管理员映射为深圳家之宝全局管理员
7	数据隔离维度	先按组织隔离，再按售后品牌隔离，预留多品牌能力
8	尚待确认问题登记	BYD 文件格式、协议条款、Xero 财务系统对接、留存期等共 8 项作为验收阻塞问题登记，相关范围须确认后推进
9	统一售后域（2026-09-10 追加确认）	PSS 与 Voltura 共用一套客户关系与现场服务售后系统；共享数据模型、可配置状态流转、服务时限责任分段计时和免登录表单，按渠道、品牌、安装或维修类型配置流程；保持案件与工单区分、安装与维修类型区分及组织和品牌数据隔离；Supercheap Auto 未来承接安装售后时复用该能力

附录：供开发与验收人员使用的技术对照

本附录仅用于关联内部设计、任务和接口测试，不新增业务范围，不改变正文要求，客户阅读正文时可略过。

内部编号与业务内容

业务内容或正文位置	内部标识
用户身份、角色与组织权限（文首及第 5.7、6.12 节）	REQ-001
采购单智能识别及供应商、商品匹配（第 6.5 节）	REQ-008；采购识别与资料创建方案的决策 D1..D11
可配置私有文件存储（第 2 节）	REQ-027；存储细化批准 C04
用户开通、授权与登录会话控制（第 5.7 节）	FLOW-190
忘记密码及本人修改密码（文首增量）	FLOW-191
组织层级、集团用户管理接口及管理页面	T-003-L、T-003-M、T-003-M-B
查询、邀请、激活、成员角色及账户会话操作（第 5.7 节表格顺序）	J-190-user-query、J-191-invite、J-192-activate、J-193-membership-role、J-194-account-session
渠道接入与供货履约阶段；文件存储所在首期阶段	M4；M6
Bunnings 接入资料确认；实际联调验收任务	OQ-BUNNINGS-EDI；T-020-B
售后指标及阈值确认；现场移动应用复用评估	OQ-AFS-003；OQ-AFS-008
售后初始待确认问题；后续五项客户材料缺口	OQ-AFS-001..008；OQ-AFS-009..013
第 10.1 节九项客户确认决策，按表格序号对应	D-1、D-2、D-3、D-4、D-5、D-6、D-7、D-8、D-9；历史前八项范围记为 D-1..D-8，含追加确认的范围记为 D-1..D-9
“前提、操作、预期结果”验收场景格式	GWT（Given-When-Then）
深圳家之宝总部及三个下属组织；集团管理员角色	HQ（等价于 SHENZHEN_HQ）；HONG_KONG、PSS_AU、VOLTURA_AU；g_admin

接口字段、状态与错误返回

以下为精确技术约束的保留对照，错误标识与接口状态码分别使用，不要求客户记忆。

业务含义	技术约束
账户待激活、已激活、已禁用	user：invited、active、disabled
组织成员资格有效、停用	membership：active、inactive
邀请待使用、已使用、已撤销、已过期	invitation：pending、consumed、revoked；expires_at <= now() 时派生 expired
当前组织、用户管理权限、记录版本、重复提交识别键	X-Org-Id、identity:manage、If-Match、Idempotency-Key
邀请通知、审计及会话吊销	identity.invitation.requested outbox；成功事务写审计；session_version 递增，撤销 access/refresh sessions
固定校验顺序与拒绝返回（第 5.7 节）	authentication 401 → scope 400/403 → permission 403 → resource lookup 404 → If-Match 428/409（适用时）→ validation 422 → mutation/no-op
非法身份状态变化	HTTP 409，IDENTITY_TRANSITION_INVALID
同一重复提交识别键用于不同请求	HTTP 409，IDEMPOTENCY_KEY_REUSED
邀请凭证未知、过期、撤销或已使用	统一 HTTP 400，INVITATION_INVALID
邀请激活密码不合规	HTTP 422，PASSWORD_POLICY_INVALID；邀请仍 pending
激活账户公开请求	不带 bearer/cookie，仅 opaque invitation token 与 password/confirmation；凭证从 URL fragment 读取，仅通过 POST body 上传
替换角色与启停成员资格的拒绝返回	目标不存在或 foreign membership：404；缺/旧 If-Match：428/409；空/未知角色、对 disabled user 启用 membership：422；非法状态：IDENTITY_TRANSITION_INVALID
邀请邮箱重复、角色为空或未知、账户已禁用、角色超出可分配范围	按具体输入返回 HTTP 409/422，不创建邀请
密码恢复统一受理、频率超限	HTTP 202 空体；HTTP 429
新密码与当前密码相同	HTTP 409，PASSWORD_UNCHANGED
重置凭证无效、过期、撤销或已使用	统一 HTTP 400，PASSWORD_RESET_INVALID
本人改密旧密码错误	HTTP 403，CURRENT_PASSWORD_INVALID
本人改密缺认证、组织越权或成员资格失效、密码确认或策略错误	HTTP 401；HTTP 403；HTTP 422；活动组织与 CSRF 校验必需
交货证明、采购文件预览权限	active membership、org、shipment:read、文件归属；采购预览仍为 purchasing:read
采购识别文件与任务保存后受理、扫描通过后识别	持久化隔离文件及真实 job 后返回 HTTP 202；同幂等身份返回原 job；扫描状态 passed
同步存储拒绝、不可用或超时；完整性失败	HTTP 503，FILE_STORAGE_UNAVAILABLE；HTTP 500，且不得输出字节
报价生成失败；异步任务受理后失败	保持 QUOTE_EXPORT_FAILED 兼容；已返回 HTTP 202 的任务失败只更新 job
售后数据隔离、安装工单类型与关联字段	org_id、principal_id；work_order_type=install/repair；install_job_id 引用统一 Work Order
退换修及索赔状态（第 6.13 节）	draft→submitted→under_review→approved/rejected→invoiced→reimbursed/closed
维修工单非法状态变化（第二期）	WORK_ORDER_TRANSITION_INVALID
免登录表单凭证过期、撤销、未知（第二期）	FORM_TOKEN_EXPIRED、FORM_TOKEN_REVOKED、FORM_TOKEN_UNKNOWN
索赔报销或关闭前缺责任判定（第二期）	LIABILITY_DECISION_REQUIRED