产品概览：SupplyLink

文档控制

项目	值
版本	v1.8
日期	2026-09-11
来源	docs/product/supplylink/requirement/supplylink-requirements.md v1.8 (2026-09-11)
状态	产品规格基线
产品负责人	Shenzhen Jia Zhi Bao

一句话介绍

SupplyLink 是面向澳大利亚零售供应链的英语运营平台，连接采购、库存、零售订单、EDI（Electronic Data Interchange，电子数据交换）、履约和客户服务，同时不混淆 PSS（澳大利亚公司 A）与 Voltura（澳大利亚公司 B）的法律所有权。Phase 2 新增统一售后域（2026-09-10 决策 D-9）：PSS 与 Voltura 共用一套 CRM + FSM 售后系统——Bunnings 安装/售后与 Voltura BYD 充电桩售后共用同一套售后对象模型与三横切引擎（Case/Work Order 类型化/RMA/免登录表单，REQ-018..026），不分别建设两套系统。

愿景锚点

要素	定义
Core Promise	为集团及澳大利亚运营人员提供一条从供应商来源库存到零售商订单、发货、发票和异常的可追溯路径，同时确保每笔交易始终归属于正确的公司。
Must-Have Experience	获授权的 Voltura 操作员接收或导入 Supercheap Auto PO（Purchase Order，采购订单），解决校验问题、确认订单、记录发货包装，通过版本化 adapter 生成 POA（Purchase Order Acknowledgement，订单确认）、ASN（Advanced Shipping Notice，提前发货通知）、INVOIC（EDIFACT Invoice message，发票报文），并能将每项结果追溯到源文档和审计历史。
Wow Moment	操作员打开一个异常队列，就能准确看到哪个订单或 EDI 消息失败、失败原因、归属组织，以及获准的重试或补偿操作，无需搜索其他系统。
Anti-Goals	不是 BYD（比亚迪）采购门户的替代品；不是通用 ERP（Enterprise Resource Planning，企业资源计划）或会计账簿；当前优先做 Bunnings EDI 入口，但不提前提供安装派单、统一售后或现场 App；不是面向消费者的店铺；不是会根据不确定数据默默创建产品、订单或财务记录的自治系统。

目标用户

角色	描述	核心痛点	成功结果
集团管理员	具有跨集团范围的 Shenzhen 总部管理员	可见性分散且控制不一致	以可审计的访问权限管理用户、角色和所有组织
香港采购操作员	维护 BYD 供应商及镜像采购记录	采购信息位于 SupplyLink 之外	对账镜像 PO、收货和供应商发票，但不向供应商发出订单
澳大利亚销售操作员	管理客户、商机和报价	客户活动与订单相互割裂	将合格商机转为定价订单，并保留完整历史
订单/EDI 操作员	处理手工订单和零售商订单	订单重复且 EDI 失败原因不透明	解决异常，并可追溯地完成从 PO 到发票的流程
仓库操作员	接收库存并履行发货	所有权、分配和包装不明确	记录公司所有的库存移动和可用于 ASN 的发货数据
客服操作员	处理咨询、投诉、维修和保修案件	客户历史分散在各类记录中	从单一客户/订单视图解决案件
区域经理	负责 PSS 或 Voltura	无法信任跨公司报表	仅查看所分配组织及其运营 KPI
调度员/电工	Phase 2 统一售后域 Bunnings 安装场景用户	手工调度且现场证据不足	通过状态、照片和签名完成分配的安装（统一 Work Order，type=install）
Voltura 售后运营员	Phase 2 统一售后域 BYD 场景用户（客服/调度/技术/管理）	报修分散、责任追溯难、SLA 责任不清	以资产序列号为主轴，从 Case 到 RMA 结算全程可追溯（与 Bunnings 场景共用一套 CRM+FSM）
BYD（Principal）只读	Phase 2 品牌方用户	需要参与审批/技术争议但不得接触商业数据	只看不操作：工单/故障分类/RMA/资产/保修可见，商业数据隔离
认证安装商/技术员	Phase 2 现场施工方	澳洲本地配合度不确定	双通道：免登录表单回传（初期主通道）或账号接单

问题陈述

集团业务覆盖四个法律组织、一个澳大利亚供应商关系、两家零售商和外部集成服务商。手工交接造成订单重复、库存来源证明不足、履约延迟和责任不清。通用 CRM（Customer Relationship Management，客户关系管理）工具无法提供零售商 EDI 可观测性，而宽泛的 ERP 套件成本高，也无法直接表达 PSS/Voltura 渠道所有权或未来 Bunnings 直连安装路径。

价值主张

• 客户、产品、采购镜像、库存、销售订单、发货、发票和服务案件共享一条运营记录。
• 每份业务文档都必须包含组织范围，并在查询、命令和审计边界强制执行。
• 零售商集成围绕稳定的规范模型采用版本化 adapter，因此 Supercheap Auto 和 Bunnings 的映射可以独立演进。
• 异常是具有重试历史、所有权和补偿机制的一等工作项，而不是隐藏的日志条目。

市场定位

SupplyLink 是一个私有的、面向特定零售商的供应链运营系统，定位介于轻量级库存/CRM 产品和企业级 ERP/EDI 套件之间。其切入点是精确的集团公司所有权模型，以及面向澳大利亚零售运营的受监管 EDI 异常工作流。

市场与区域设置

属性	值
主要市场	Australia
主要 UI 语言	英语（en-AU，Australian English，澳大利亚英语）
规格语言	中文，使用规范的英文字段/状态标识
货币	Phase 1 仅支持 AUD（Australian Dollar，澳元）；金额以整数分存储
税	GST（Goods and Services Tax，商品及服务税）默认为 10%；每个明细行保留税类别和快照
日期/时间	以 UTC（Coordinated Universal Time，协调世界时）存储；按组织/站点配置的澳大利亚 IANA（Internet Assigned Numbers Authority，互联网号码分配机构）时区显示
数字/地址	en-AU；支持澳大利亚地址和 ABN（Australian Business Number，澳大利亚商业号码）
无障碍	WCAG（Web Content Accessibility Guidelines，网页内容无障碍指南）2.2 AA，支持键盘和屏幕阅读器

规模假设

维度	规划基线
已命名内部用户	初始 50 人，3 年内达到 200 人
并发用户	峰值 30 人
销售订单	100,000/年
EDI 文档	500,000/年，包括尝试和确认
SKU（Stock Keeping Unit，库存量单位）	20,000
库存移动	1,000,000/年
文件对象	3 年内达到 250 GB
可用性目标	每月 99.9%，不包括已公告的维护

合规检查清单

法规/标准	是否适用？	所需行动
Australian Privacy Act 1988 / APPs（Australian Privacy Principles，澳大利亚隐私原则）	是	最小化客户/联系人数据；落实访问控制、泄露处理流程、保留和删除政策
Notifiable Data Breaches scheme	是	在生产前完成事件分类、证据和通知 runbook
Australian tax record retention	是	财务负责人确认记录类别和法定保留期限；在法律签字确认前，税务相关记录默认保留七年
Privacy Act 1988 reform status	发布前核实	在达到生产就绪状态时进行法律审查；不要编码未经核实的法律结论
PIPL（Personal Information Protection Law，《中华人民共和国个人信息保护法》）	可能	确认中国大陆员工是否访问个人数据，以及是否适用跨境传输义务
Hong Kong PDPO（Personal Data (Privacy) Ordinance，《个人资料（私隐）条例》）	可能	确认香港的访问和处理角色
GDPR（General Data Protection Regulation，《通用数据保护条例》）/ CCPA（California Consumer Privacy Act，《加州消费者隐私法案》）/ COPPA（Children's Online Privacy Protection Act，《儿童在线隐私保护法》）	在当前范围内不适用	如果市场或用户发生变化则重新评估；不提供儿童服务
WCAG 2.2 AA	是，产品标准	自动化 axe 检查，加键盘/人工审查
PCI-DSS（Payment Card Industry Data Security Standard，支付卡行业数据安全标准）	否	范围内不包含卡片采集或支付处理

已确认决策

决策	确认情况	日期
产品计划	保留原定完整 Phase 1 范围	用户已确认
交付约束	1-2 名开发人员，8-12 周	用户已确认
风险态势	用户明确接受延期、深度降低或范围不完整的高风险	用户已确认
EDI 实施顺序	M4 共享 canonical EDI 能力后先 Bunnings T-020-B，再 Supercheap Auto T-020；安装、售后、销量数据扩展仍为 Phase 2	用户已确认
Bunnings 接入方式	取消中间商 PowerBay，改为 SupplyLink 直接对接 Bunnings	用户已确认
外部集成	使用 Adapter 加 mock；在规格和测试访问权限到位前，真实映射/传输任务处于阻塞状态	用户已确认
技术栈（2026-09-02 架构 pivot）	Dart + Shelf 模块化单体后端 / Vue3 + Element Plus Admin / Flutter 现场服务 App（Phase 2；统一售后域电工/工程师双任务视图）/ PostgreSQL + RLS（Row Level Security，行级安全）/ JWT（JSON Web Token）；原 Next.js + NestJS + OIDC（OpenID Connect，开放式身份认证协议）+ Azure 方案作废，见 06-architecture.md ADR-000（Architecture Decision Record，架构决策记录）	用户已确认
Voltura BYD 售后域（D-1..D-8）	售后 CRM+FSM 域并入 SupplyLink、Phase 2（Phase 1 范围与契约不变）；Case 独立实体、维修工单与安装工单区分；Top Administrator 并入深圳家之宝全局管理员；org_id 主维度 + principal_id 第二维度；OQ-AFS-001..008 登记	用户已确认（按推荐）
统一售后域（D-9）	PSS 与 Voltura 共用一套 CRM+FSM 售后系统：Bunnings 安装/售后与 Voltura BYD 售后共用统一售后对象模型与三横切引擎，按渠道/品牌/工单类型（install/repair）配置流程；维修工单与安装工单统一为 Work Order 类型区分（D-4 区分保持）；不分别建设两套系统	用户已确认
Bunnings live 门禁	传输/报文规范、测试环境、样例、认证标准和生产凭据到位前，Bunnings 仅可完成 canonical/mock adapter 验证，不得声明 live 验收	用户已确认

假设

• 一个用户可以拥有多个组织成员身份；每个请求都有一个明确的活动组织范围。
• Shenzhen 集团范围允许跨组织报表和管理，但创建的业务文档仍会指定一个所属组织。
• BYD 采购仍在外部进行；SupplyLink 存储镜像，绝不会向 BYD 发送或确认采购。
• 部署云厂商/区域选择和生产 tenant 配置仍属于部署决策，并置于 auth adapter 之后（见 OQ-INFRA-001）。
• Phase 1 客户服务覆盖基础案件，但不包括安装调度和现场证据。
• Phase 2 售后域以资产序列号为主轴；BYD 保修/主数据当前仅文件导入；SLA 阈值、KPI、计费费率与状态集待 BYD/商务确认（OQ-AFS-001..004），确认前 Phase 2 相关实现保持 blocked。
• Phase 2 统一售后域（决策 D-9）：PSS 与 Voltura 共用一套 CRM+FSM 售后系统；安装工单（install）与维修工单（repair）统一为 Work Order 实体按类型区分；电工与认证安装商统一为 Installer/Technician 实体；数据隔离（org_id + principal_id）不因共用系统而放松。

开放问题

ID	问题	严重性	负责人 / 截止门禁	解决前的默认方案
OQ-001	Supercheap Auto 的传输方式、消息格式、字段映射、代码列表和认证用例是什么？	真实 EDI 的阻塞项	集成负责人 / M4（Milestone 4，里程碑 4）之前	使用 Mock adapter；真实发送/接收受阻
OQ-002	哪个 OCR（Optical Character Recognition，光学字符识别）provider、数据驻留区域和置信度阈值获得批准？	生产 OCR 的阻塞项	产品/安全 / M3 之前	使用确定性的 mock 提取；生产 OCR 受阻
OQ-EDI-GATEWAY	Supercheap Auto live EDI 使用 MessageXchange 还是 Stedi？	T-020 live 网关接入与认证验收阻塞项	集成负责人 / M4 live 门禁前	保持 gateway adapter 接口并使用 mock/test transport；不得配置 live credentials 或声称 live 验收
OQ-RETAIL-DATA	Supercheap Auto 的零售端库存与退货数据通过哪种已批准来源提供（新 EDI 文档类型、批量文件或人工导入）？	零售库存/退货报表与补货输入的 live 验收阻塞项	零售商集成负责人 / M5 报表实现前	仅使用我方仓库库存和带来源标签的测试 fixture；不得把缺失的零售数据计为 0 或纳入 live totals
OQ-INFRA-001	哪个云厂商/区域和生产支持联系人获得批准？（架构 pivot 后原 Azure/OIDC 假设作废）	部署的阻塞项	IT 负责人 / 阶段 6 之前	仅使用本地/test adapters
OQ-004	每类记录的法定保留期限和跨境访问限制是什么？	生产的阻塞项	法律/隐私 / M6 开始前；在签字前生产发布仍受阻	税务记录保留七年；不自动硬删除
OQ-AFS-001..004	售后域 Phase 2 门禁：PDD 待定清单（各对象状态集/字段清单、SLA 阈值与 KPI、计费费率）何时由 BYD/商务确认？	Phase 2 售后实现的阻塞项	售后负责人 / Phase 2 需求门禁前	售后域保持 x-phase: 2 契约与 mock adapter；不得提前实现或声称 live 验收
OQ-AFS-005..008	BYD 文件格式与样本；根因责任矩阵协议细节（Clause 6(k)、Schedule 1/6）；Xero 集成范围；统一现场服务 App 复用评估（D-9 口径：一套 App 承载电工/工程师两种任务视图）	Phase 2 售后实现的阻塞项	集成/法务/财务 / Phase 2 门禁前	文件导入用 mock fixture；Xero 用 mock adapter；App 复用评估列入 Phase 2 门禁
OQ-AFS-009..013	PDD 未承接项（2026-09-10 子集核查）：Dealer 实体与归属标记；产品类别字典（充电桩/户储/V2G）；售后域 Communication/Attachment 实体；诊断工具集成范围；V2 资质自动校验	Phase 2 售后实现的阻塞项（EP-08）	售后负责人 / Phase 2 需求门禁前逐项确认「承接 / 显式排除」	无 REQ 落点前不得按 PDD 原文隐性实现；x-phase: 2 路径保持不启动

变更日志

日期	版本	变更	影响
2026-09-01	v1.0	将客户基线转换为产品规格；解决 Bunnings 矛盾；记录高风险接受情况和技术栈	建立实现基线和阻塞项
2026-09-02	v1.1	架构 pivot：技术栈改为 Dart+Shelf/Vue3+Element Plus/Flutter；OQ-003 更名为 OQ-INFRA-001（不再假设 Azure）	01-08 全套 + openapi.yaml 同步改写，见 08-build-plan.md 架构 Pivot 记录
2026-09-02	v1.2	正式登记 OQ-RETAIL-DATA 与 OQ-EDI-GATEWAY，并同步负责人、默认方案、截止门禁和受阻任务	关闭开放问题权威清单缺口；live 集成/报表仍按 OQ 阻塞
2026-09-03	v1.3	首次出现的英文简称补齐全称与中文翻译（EDI、PO、POA、ASN、INVOIC、BYD、ERP、CRM、en-AU、AUD、GST、UTC、IANA、ABN、WCAG、SKU、APPs、PIPL、PDPO、GDPR、CCPA、COPPA、PCI-DSS、RLS、JWT、OIDC、ADR、OCR、M4），并标注 PSS/Voltura 的组织含义	提升开发可读性；不改变任何规格内容
2026-09-04	v1.4	需求调整：取消中间商 PowerBay，Bunnings 改为 SupplyLink 直接对接；删除 01-08 与 openapi.yaml 中的 PowerBay 表述	Phase 1/Phase 2 范围划分与 REQ/NFR 编号不变；Bunnings 仍为 Phase 2，仅接入方式由经 PowerBay 转发改为直连
2026-09-10	v1.5	客户新增材料《Voltura 售后运营系统产品定义文档》与《01 公司及人员列表-系统开发.xlsx》；确认 D-1..D-8：Voltura BYD 售后域并入 Phase 2，新增 REQ-018..026、NFR-015..018、x-phase: 2 契约、OQ-AFS-001..008	Phase 1 范围与契约不变；组织法定英文名与角色权限矩阵作为 B-01/B-02 种子数据输入
2026-09-10	v1.6	PDD 子集核查：5 项未承接内容补登 OQ-AFS-009..013（Dealer/类别字典/沟通附件/诊断工具/资质自动校验）；12-client-materials-diff.md 升 v1.3 增 §4.5/§8 承接对照表	Phase 1 范围与契约不变；Phase 2 门禁增加 PDD 承接三态复核
2026-09-10	v1.7	用户追加确认决策 D-9（统一售后域）：PSS 与 Voltura 共用一套 CRM+FSM 售后系统；requirements v1.7 / architecture v2.0 / 12-diff v1.5 / 13-gate 同步，本文件与 04/06/07/08、openapi.yaml 全链路对齐	Phase 1 范围与契约不变；Bunnings 安装/售后与 Voltura BYD 售后不再分别建模两套