业务域 · 服务中心 · 变更历史

供给方

每版一节、新的在最上面。封过版的一节由封版命令写下设计指纹、内容指纹、测试指纹与改动清单,之后不能改;改了这个单元的任何原件,就要在最上面加新的一版并封版(三层同一份版本契约)。每一版「为了」哪条需求链到那条需求的履历。

当前版本
v0.3.8
条目
18
最早
2026-07-06
最近
2026-10-17
本版状态
已封版,与锁清单一致

真相源:.claude/arch/business/service/supplier/CHANGELOG.md · 本页是它的构建产物,改内容改那份文件、重新构建即更新

  1. v0.3.x
  2. 改图:绑定表改画数据表灰、人点的几步改人操作、两条并列的路、压字与箭头颜色

    设计指纹85681080内容指纹862e43a7测试指纹none

    改动设计 4 个(ARCH.md、architecture.html、data.html、flow.html);代码 0 个

    需求改图签字 168b已发布

    为了:改图 —— 业务架构 21 个域的图逐张重新分析后改画:画错的改对、挤出方块的字放回方块里、颜色归错类的方块改到该归的那一类、和线不同色的箭头改同色、和图对不上的正文改对。本域这一版改了 7 张图,设计内容不变。
    • 架构设计第 1 张「供给方域结构图:供应商与品牌两本主档、两张子表、一张绑定表,以及引用提供者编号的四处下游」:绑定表 supplier_brand_relation 是本域的表,由系统处理改成数据表;连线字「提供者编号 SUP… | BRD…」原来压着「商品绑供给方」下沿,挪到第一、第二个下游方块之间;品牌自连那根灰虚线配的是深灰箭头,换成和线同色的灰;图注第一格「深色块是两本主档」不是图例、颜色也说错了,换成「两本主档」的真图例;图例跟着改成「子表与绑定表」,删掉「绑定表」那一格。
    • 架构设计第 2 张「新增一家供应商并补全资料的泳道图」:① 到 ⑥ 五根一级一级走的台阶线原来最后一段只有 10、箭头挤在拐角(这张第一版写的是重看过、不改,走查时量出来,这一版还没封,一并改),改成从方块下沿(④→⑤ 从上沿)出、竖直到下一块的中线再横着进,每根从哪块到哪块不变;「没有事务」「五项必填靠默认或留空」两处橙色说的是真风险,留着。
    • 架构设计第 3 张「登记一个提供者时建供应商、建品牌还是挂父品牌的判定图」:「再去供应商详情「关联」」是人在本域的供应商详情页里接着做的一步,由外部改成人操作,进它的那根灰虚线跟着改成普通线 —— 灰虚线只给挂在流程旁边、不在这条流程里的别处;两个菱形各加宽 8,首行字离边多留一点,进出它们的线跟着改。
    • 流程设计第 1 张「新增供应商并补全资料的流程图」:「填全称、简称 → 确定」是人填完点确定,由系统处理改成人操作。
    • 流程设计第 2 张「给供应商关联品牌的流程图」:「挪到「已选」→ 确定」是人在穿梭框里挑完点确定,由系统处理改成人操作。
    • 流程设计第 3 张「维护品牌树与启停的流程图」:「行尾「+」图标」是人点的图标,由系统处理改成人操作;顶部「新增」与行尾「+」原来画成先后,改成两条并列的路 —— 顶部「新增」直接到「树上多一个节点」,起点另有一根到「行尾「+」」,同图注说的:顶部新增的父品牌下拉只列根品牌,要挂在子品牌下只能点行尾「+」;「确认切换状态 / 点「确认」」图里没另画人点确认的那一步,框后面直接接系统的结果,这一格兼着「人点了确认」,由系统处理改成人操作。
    • 数据设计第 1 张「供给方五张表与四处引用方的网状图」:绑定表由系统处理改成数据表;两张子表首行出框或贴边,加宽;「按 brandId」原来和「父品牌」叠在一起,挪到竖线左边;两句「按 supplierId」原来被竖线从字里穿过,挪到竖线正中;品牌自连那根灰虚线的箭头原来差 2 没够着方块,接上;图例补上「两本主档」一格,删掉「绑定表」一格。
    • 流程设计第 4 张:重看过,不改。
    • 回看:供应商、品牌两本主档仍是本域的核心,联系人、资质证照两张子表与绑定表仍画数据表灰。设计正文与代码都没变。域文档 ARCH.md 只把文档头的 version 改成本版,正文没动。升第三位。
    • 验到什么程度:本域 7 张图落仓后(架构设计第 1、2、3 张,流程设计第 1、2、3 张,数据设计第 1 张),视觉设计师走查,用的是 22:30 那一版共用样式表。机器验过的:架构页是 2026-10-17 00:01 +08:00 重新走查的,在本机 Edge 里以 1400 宽打开仓里的架构设计页,3 张都和改后抄件一字不差,落仓前留的底版里这 3 张都和改前抄件一字不差;整套尺子量下来 3 张都是 0 条(架构设计第 2 张五根台阶线最后一段都是 30);加粗字照样式表此刻的画法(14 像素、整行上提 1.5)共 2 行,左右最少余 63.2,离方块上沿 9.5,带下划线的表名放大看过不碰第二行;整页 id 不重,六种宽度下都不横向撑破;和底版、和上次提交比,图以外的正文一字不差。流程、数据两页沿用 2026-10-16 23:30 +08:00 那次走查的结论:4 张都和改后抄件一字不差,整套尺子量下来都是 0 条,没改的流程设计第 4 张也是 0 条;数据设计第 1 张加粗字 2 行,左右最少余 68.7,离方块上沿 9.5;流程页 820 宽撑出 7,数据页 390 宽撑出 16,都和落仓前那一版一模一样,是页里原有的示意表格、顶栏链接与长代码路径撑的;和底版、和上次提交比,没改的图与图以外的正文一字不差。7 张真页截图与抄件截图逐像素比,图本身都一样(数据设计第 1 张图注那一块差 1 像素,是截图取整)。人目视过的:7 张真页两倍截图逐张看过,架构设计第 2 张那五根台阶线放大看过;上一次走查目视看出这张箭头挤在拐角,业务架构专家定了要改,已改完并复查;这一次因此改的:零。机器和人都判不了、只能抽查的:画的是不是业务上那件事以设计为准,机器只核到和抄件一字不差;好不好看要人看;只量了本机 Edge(微软雅黑),苹果电脑上的字体没量。
  3. 订正:域总览里 parts/ 的目录链接改成普通字样(治理站点上是 404)

    设计指纹81f82ab7内容指纹862e43a7测试指纹none

    改动设计 1 个(ARCH.md);代码 0 个

    需求发布修补已发布

    为了:发布修补(需求 3)—— 治理站点 10-04 首次全量发布后,部署会话按页面引用抓线上,本域架构页正文「七个视图」那句里的 parts/ 链到一个目录,静态托管没有目录首页、404;构建器自检此前对目录也当「存在」、没报。源文档只去掉链接、措辞不变,升第三位。
    • ARCH.md 文首「七个视图」那句:parts/ 从指向目录的链接改成普通字样。
  4. 订正:测试设计页里的「重算」改成「封版」

    设计指纹a0884571内容指纹862e43a7测试指纹none

    改动设计 2 个(ARCH.md、test.html);代码 0 个

    • 测试设计页「整个域没有测试覆盖」一卡还写着已退役的「重算时测试指纹写 none」,改成「封版时」(第三轮审查;上一版漏掉了这个句式)。
    • 代码一行没改。设计内容没变,只订正说法,升第三位。
  5. 订正视图页里的旧叫法并重封(HARNESS v4.2.0)

    设计指纹91975ee2内容指纹862e43a7测试指纹none

    改动设计 2 个(ARCH.md、test.html);代码 158 个(index.ts、brand.tsx、brand.api.ts、brand.bff.ts、brand.constants.ts、brand.mock.ts、brand.types.ts、index.ts 等)

    • 视图页里把现行机制叫「保鲜」「重算指纹」「修改历史」的说法改成「代码锁步」「封版」「变更历史」(第二轮审查;历史叙述原样不动)。
    • 锁清单按 HARNESS v4.2.0 的契约重封:另记这一版到文件末尾的整段历史指纹(封过的一版与它下面的旧版一个字都不能改);按旧契约封的锁清单缺这一样。 HARNESS v4.2.0 的业务代码改为原文比(注释与空白也算),锁清单随之重算 —— 先用 v4.1.0 的口径核过:本域封版之后代码一行没改。
    • 设计内容没变,升第三位。
  6. 比对口径换了,按新口径重封

    设计指纹17d71922内容指纹34d74718测试指纹none

    改动设计 1 个(ARCH.md);代码 7 个(brand.tsx、supplier.tsx、brand_base.datasource.json、supplier_base.datasource.json、supplier_brand_relation.datasource.json、supplier_certificate_node.datasource.json、supplier_contact_node.datasource.json)

    • HARNESS v4.1.0 换了业务代码的比对视图(字符串与正则字面量里的 // 不再当注释去掉,.wxml 认 <!-- --> 与内联 <wxs>,数据表比完整结构),本域锁清单里的指纹随之作废,按新视图重封。代码一行没改:用旧视图核过,本域封版之后没有代码改动。
    • 同批订正:域文档里第七个视图的旧名「修改历史」与现行机制的旧叫法(srcHash、保鲜牙)改成「变更历史」「代码锁步」,历史叙述原样不动(2 行)。
    • 设计内容没变,升第三位。
  7. 迁入统一版本契约

    设计指纹2d5f78fe内容指纹33777711测试指纹none

    改动迁入统一版本契约,此前的版本没有锁清单(首次钉下 设计 7 个、代码 163 个)

    • 变更历史改成三层统一写法(文档头 title / unit / kind,标题行「## v主.次.补 · YYYY-MM-DD · 一句标题」,记录行设计指纹 · 内容指纹 · 测试指纹 · 改动),此前各版正文一字不动。
    • 设计文档头退掉 srcHash:代码锁步改由锁清单 version-lock.json 逐个文件记(本域的设计文件与它描述的代码,代码只改注释不算改),首次钉下的就是封版这一刻的代码。此后改了其中任何一个,都要在最上面加新的一版、回看设计并用统一封版命令封版(HARNESS v4.0.0 · 版本契约)。
    • 设计内容没变、只改写法与记账方式,升第三位。
  8. 加第七个视图「测试设计」

    旧·内容指纹data c852063e;server 20fcaa87;admin 292f270b;client null旧·测试指纹none

    改动统一之前的版本没有改动清单

    本版只改文档、代码未变:按《架构设计模板》新增第七个视图「测试设计」(parts/test.html)—— 谁在测本域的代码、每个云函数有没有自己的测试、哪里测不到、本视图的异常。页面上的事实从本文档头的 describes、测试面判定与部署门注册表派生:本域代码不在任何测试的被测范围里(28 个云函数都没有自己的测试)。

    回看结论:本域设计仍成立。「测不到的地方」是如实写出的覆盖缺口,不是这一版引入的;补测试归业务开发,走 /x-feature-dev。

  9. 子表写明上级与表文档订正

    旧·内容指纹data c852063e;server 20fcaa87;admin 292f270b;client null

    改动统一之前的版本没有改动清单

    上级与两端:联系人 supplier_contact_node、资质证照 supplier_certificate_node 两张子表的表文档写明上级 supplier_base,两张表的供应商编号说明从「引用」改成「关联 supplier_base.supplierId」;绑定表 supplier_brand_relation 写明两端 supplier_base × brand_base(两端同在本域)。

    表文档订正 34 处(5 张表,只改说明与示例,字段与线上结构不变;每张表的变更历史各记了一行):

    • supplier_base 5 处:企业介绍长度写明「数据源上限 4096;新建、编辑两个接口限 2000,导入接口不限长」(导入接口 supplier-import/controller.js:22 不限长,后台导入列含这一栏,经导入能写进超过 2000 的内容 —— 登记为代码缺口);示例说明的必填清单去掉可空的法定代表人,两个示例里法定代表人的注释改为选填;上下游段删掉不存在的工单表 order_order_info,「关联(后续)」改为现役下游,补上订单行、品牌关系、服务绑定、SKU 维护、服务标准五处引用。
    • supplier_brand_relation 6 处:示例里 4 处编号改成真实形态(供应商编号原先少一位,品牌前缀 BRND 改为 BRD);「插入前校验供应商存在」与「删除供应商前先查品牌绑定」两句各补注当前未实现(绑定只查重复不查存在,supplier-delete 不碰绑定表),登记为代码缺口。
    • supplier_contact_node 5 处:主键示例补足 32 位;两个示例的供应商编号前缀 SBAS 改为 SUP;主要联系人从 'yes'/'no' 改为布尔。
    • supplier_certificate_node 8 处:两个示例的供应商编号前缀 SPLR 改为 SUP;4 个日期改为毫秒时间戳;2 个附件改为 cloud:// 数组。
    • brand_base 10 处:品牌简介长度写明「数据源上限 4096、接口限 512」;示例里授权状态改为布尔(2 处)、品牌 Logo 与授权证书改为 cloud:// 数组(5 处)、授权到期日期改为毫秒时间戳(1 处);上下游段把现役下游写全(品牌关系表,以及服务绑定、SKU 维护、订单行、服务标准四处 BRD 引用),原来两条没落地的引用改标「未实现」。

    改正 3 条登记错误:

    • ARCH.md 第八节第 5 条与数据设计页原说绑定表数据源的 x-primary-column:"supplierId" 与表文档「主键 _id」矛盾 —— 上一版这条登记错了:x-primary-column 是控制台的「主列」(关联选择时显示的列),不是主键(x-data-dev/scripts/lib/system-fields.js:259-269,CloudBase 文档「主展示列配置」),主键仍是系统 _id,两者不矛盾;同形态还有 spu_supplier_relation、refund_item_relation。同条后半句「系统字段列名用下划线写法」属实,保留。
    • 边界 / 已知问题表第 7 条原把「品牌类型可多选、后台是单选」记成表文档错 —— 登记错了:数据契约就是多选(数据源是数组,brand-create/controller.js:20 收数组),只是后台表单只做了单选(brand.tsx:507-517)。
    • 架构设计页结构图与边界卡、服务设计页读本域的两行(spu-suppliers-bind、spu-suppliers-read)把商品绑供给方的绑定表与两个接口归到「商品域」—— 登记错了:spu_supplier_relation 与这两个接口都归服务管理域(ecommerce/sku 的 describes 认领 x-data/ecommerce/spu-supplier/** 与 x-server/admin/ecommerce/spu-supplier/**),已改为服务管理域;ARCH.md 第六节「供给方 → spu 商品核心」一行补注这张绑定表归服务管理域。小程序两个读接口(逛服务、服务详情)确实归商品域,保持原样。

    域文档改了 44 处(下面列的 34 处,加上核对引用行号时又改的 10 处:ARCH.md 两处 spu_base.md 行号 121 → 123、两处 spu_supplier_relation.md 附注区间 137-143 → 141-147、一处 order_base.md 行号 111 → 109 —— 三张表文档本轮加了行,原行号下移或上移;架构设计页一处同样的 order_base.md 行号;架构设计页与服务设计页边界表第 2、9 条各注明所引行号是订正前的、订正后在哪一行,4 处):ARCH.md 10 处(§一两处 brand_base.md 行号、§2.5 与 §八第 4 条两处 supplier_brand_relation / spu_supplier_relation 引用行号、§2.6 迁移史行号、§六「未落地下游」与「供给方 → sop」一行的引用行号、§六「供给方 → spu 商品核心」一行补注绑定表归属、§八第 5 条(含同形态补 role_user_relation)、第 6 条);架构设计页结构图一个框与边界卡一张的归属改正、边界表第 2、3、4、6、7、8、9 条改状态或改正登记(9 处,第 6 条把品牌简介与企业介绍分开写);服务设计页读本域两行的归属改正、F-04、概念一致性注与已知问题第 2、3、4、6、7、8、9 条(11 处,第 6 条同样分开写);数据设计页网状图图注补上三张表的上级 / 两端、「绑定表主键」卡(同形态补 role_user_relation)与「长度三处不一」卡(企业介绍导入不限长)、网状图 spu_supplier_relation 那个框的归属改为「服务管理域(ecommerce/sku)」(4 处),合计 34 处。第 3 条里接口把必填项放成可选、服务端给默认值,第 4 条绑定不查存在、删供应商不清绑定,第 6 条品牌名 64 与 100、企业介绍导入不限长,第 11 条日期字段两个入口两种类型 —— 这几处是代码缺陷或表文档本来如实,保持原样。页面骨架与各节编号不动。

    代码未变。

  10. 铺成六个视图并逐端审查

    旧·内容指纹data c852063e;server 20fcaa87;admin 292f270b;client null

    改动统一之前的版本没有改动清单

    做了什么:按《架构设计模板》把本域写成六个视图 —— 新建 parts/architecture.html、flow.html、frontend.html、service.html、data.html 五页,第六个「修改历史」即本文件;ARCH.md 升 0.3.0、lastReviewed 改 2026-09-23,定位说明之后加「〇、六个视图」索引与字段计数口径说明,并就地订正事实错误(见下)。同时做了本域第一次文档对四端代码的逐行核对,结论以代码为准。本域原本就没有旧模板形态(无 modules/、ARCH.html、CHANGELOG.html),无需删除。

    四端各读了什么:

    • data:x-data/supplier/{base,contact,certificate,brand}/ 与 x-data/brand/base/ 共 5 份表文档 + 5 份数据源,字段逐个数 —— 按「含主键、不含 8 个系统字段与部门字段」计:供应商 41 / 品牌 16 / 联系人 13 / 资质证照 14 / 绑定 2,合计 86;数据库必填 8 + 5 + 5 + 4 + 2 = 24;下拉字段 15、图片字段 4、地址三元组 2 组。另为核对下游读了 order_base.md、order_item_node.md、sku_maintenance_node.md、spu_supplier_relation.md、sop_step_node.md、spu_sku_node.md。
    • server:x-server/admin/supplier/**(21 个)与 x-server/admin/brand/**(7 个)共 28 个云函数,入口、参数、业务、数据四层与包配置逐个读过;公开访问与「登录即可调」全为否,列级过滤只在 supplier-read、supplier-contacts-read、supplier-certificates-read、brand-read 四个读上开。另为核对下游读了 spu-suppliers-bind、spu-suppliers-read、sku-maintenance-update、order-create、sop-steps-create、service-browse-read、sku-detail-read。
    • admin:x-admin/src/xModules/supplier/**(页面 805 行、21 个原子服务、聚合层、穿梭框组件)与 x-admin/src/xModules/brand/**(页面 1106 行、7 个原子服务、平铺聚合);配套读了 xComponents/{master-list,detail,curd,file}、两模块语言包、config/routes.ts、菜单树 menu-tree-data.json 与 menu-i18n.json;另读了服务管理、服务标准两个模块聚合层里对本域的借用。
    • client:describes.client 为 null,本域无移动端模块;只核了商品域两个小程序读接口如何按编号前缀取名字与图标。

    逐条出入(文档怎么说 → 代码实际怎样):

    1. 本域 ARCH.md §一、§六写订单引用在 order_base.supplierId「订单快照冻结」→ 订单头表 v2.0 已删该列,引用在订单行 order_item_node.supplierId(order_item_node.md:18),由 order-create/service.js:138 从 SKU 带出。已订正 ARCH.md;sop 同处的「工单域」一并订正为服务标准关系域。
    2. supplier_base.md:192 写 order_order_info.supplierId 引用本表 → 没有这张表。表文档不在本轮可写范围,未改。
    3. 数据源必填 8 项、supplier_base.md:69「禁止默认值」→ supplier-create/controller.js:21,35,37,38,44 五项可选,repo.js:50,55 给合作状态、派单优先级默认值,界面新增只收全称与简称(supplier.tsx:650-671)。运行时后果未核。表文档自身 :69 与 :95 列的必填项也不一致。
    4. supplier_brand_relation.md:31-32 要求插入前查供应商存在、删供应商前查绑定 → 绑定只查重不查存在,删供应商不删也不查绑定行(supplier-delete/service.js:16-18)。
    5. supplier_base.md:80-88 若干字段「仅管理员可见」→ 界面层成立(详情页按 supplier-read 的列权限藏字段,detail.tsx:86-88);接口层不成立:详情数据取自 supplier-info-read,它未开列级过滤,返回体带全部列。
    6. 长度:品牌名表 64、接口 100;品牌简介文档 2000 / 数据源 4096 / 接口 512;企业介绍文档 2000 / 数据源 4096(brand-create/controller.js:16,28 等)。
    7. brand_base.md:20 品牌类型可多选 → 后台三个表单单选(brand.tsx:507-517)。
    8. 表文档示例写 SBAS…、BRND…、'yes'(supplier_contact_node.md:76,82、supplier_brand_relation.md:53,66)→ 真实是 SUP、BRD、布尔值。
    9. sop_step_node.md:137 写提供者编号只关联供应商表 → 实为 SUP / BRD 多态(sop_step_node.md:15 自己的字段表也是多态)。spu_sku_node.md:16 同样这么写,但它是整表废弃、待清理的遗留表,不算现役出入。
    10. 本域 ARCH.md §五 supplier.tsx 锚点整体漂移十余行、「品牌字段 11 列」→ 实为 10 列;§二 品牌单列索引写 5 个 → 表文档列 6 个;§三「Detail 补全其余 40 业务字段」→ 详情页不含自有设备清单、品类明细两个字段。已订正 ARCH.md。
    11. 日期字段:新建接口收文本(supplier-create/controller.js:25,26,48),更新接口收数字(supplier-update/controller.js:25,26,48),品牌授权到期日期两处都收文本 —— 与数据库的日期数字不一。

    另登记代码自身的问题(本轮不改):四处下游都不看合作状态与品牌启用状态;详情保存逐个调接口无事务(supplier.bff.ts:107-185);导入的证照子项不收图片字段而证照整组替换、未知品牌名静默丢弃、导入收文件里的排序号;删品牌不动绑定行,brand-delete 只删传进来的编号(后台界面删父品牌会级联删整棵子树,直接调接口、导入里的删除、勾了父品牌又取消某个子品牌时,子品牌父编号悬空);编辑根品牌时父品牌下拉里有它自己、服务端不查自指与成环,读接口建树时这类节点整支消失(brand-read/repo.js:52-69);改联系人时供应商编号一并写回;品牌状态切换成功提示显示「商品上架状态切换成功」;左栏搜索只按全称。

    概念一致性结论:「供给方 = 提供者编号」在商品绑供给方、服务管理、订单行、服务标准四处引用方的用法一致(SUP / BRD 多态、显示名「品牌取品牌名、供应商取简称」),不一致的是校验强度(服务标准只查非空)与 sop_step_node 表文档的描述口径。

    代码没有改动:本版只动 ARCH.md、本文件与 parts/ 五页,四端代码一字未改;describes 与 srcHash 未动。

    诚实边界:没有实跑新增、导入、删除,没有查线上数据与索引;导入清空证照图、父品牌成环节点消失两条是读代码的推断。

    审查后订正:对抗审查逐条核对后,按代码改了这些(其余说法复核成立):

    • 列权限:原写「详情页的列权限不生效」不对 —— 详情页界面按 supplier-read 的列权限藏字段(detail.tsx:86-88、supplier.tsx:792),缺口只在接口层(supplier-info-read 返回体带全部列)。改了前端设计「权限面」卡、架构设计边界第 5 条、服务设计「列级过滤」卡与问题表第 5 条、本条逐条出入第 5 条。
    • 表的顺序:「关联品牌」是详情页第一张表(supplier.tsx:514-532),流程设计场景 2 节头原写「第三张」;前端设计编辑态示意改成 关联品牌 → 联系人 → 资质证照,补画资质证照。
    • 「关联品牌」表去掉「#」列(table.tsx:122-128,366-378,只有行编辑表有序号列);联系人、证照的「#」列在编辑态画成拖拽手柄。
    • 子表「操作」列原画成文字「删除」,改成图标:行编辑表是「+」与垃圾桶 / 撤销,关联表同样三种(table.tsx:270-357);流程设计场景 1 第 4 步补写行上「+」在当前行下插入一行、删除只打标记可撤销、保存才落库,场景 2 第 1 步补写关联表上的删除即解绑,并补画一行「已标删除」的示意。
    • 编辑态按钮顺序改为「保存」(主按钮)「取消」(detail-header.tsx:58-65);只读态「编辑」「删除」按真实样式画成主按钮与红色主按钮。
    • 面包屑:分隔符改为「·」,从内容区移到顶栏站点名右侧(breadcrumb-nav.tsx:58-61、runtime-layout.tsx:161,169-174),流程设计场景 1、3 与前端设计两屏共四处。
    • 左栏供应商列表去掉编出来的表头,画成大字简称、小字全称、左侧色条(master-list.tsx:285-293)。
    • 品牌表每行操作画成「+」、铅笔、垃圾桶三个图标(curd.tsx:872-888),步骤文字统一为「行尾的「+」图标」(流程设计场景 3 元信息、流程图节点、图注、第 2 步,架构设计判定图节点,前端设计代码结构表);品牌表补画勾选列。
    • 「数据统计」与「新增 删除 导入 导出」画在同一条工具栏里(curd.tsx:700-714)。
    • 补画品牌查询表单:品牌名称、品牌类型、品牌产地、授权状态、状态,加「查询」「重置」(curd.tsx:445-457,brand.tsx 列定义)。
    • 品牌表单按真实字段顺序画(brand.tsx:431-541、行尾「+」表单同序缺父品牌),省略项在原位标出;排序默认值画成 0。改了前端设计品牌弹窗与流程设计场景 3 第 2 步。
    • 删品牌限定场景:界面上删父品牌是级联删整棵子树(brand.tsx:614、curd.tsx:890-903),只有直接调 brand-delete、导入里的删除(brand.tsx:1073),或勾了父品牌又单独取消某个子品牌(delete.tsx 按勾选项提交,读代码推断)才会让子品牌父编号悬空。改了架构设计弱点表、服务设计全景表 brand-delete 行与问题 4、前端设计品牌屏图注、本条代码问题一句。
    • 父品牌:改成「编辑根品牌时下拉里包括它自己」,子品牌选不到自己;补一句下拉只在页面打开时读一次、之后不刷新(brand.tsx:66-86)。改了架构设计弱点表、前端设计弹窗图注、数据设计约束表、服务设计逻辑表与问题 5、流程设计场景 3 图注。
    • 架构设计边界表补第 11 条(日期字段新建收文本、更新收数字,品牌授权到期日期两处都收文本),与服务设计问题表对齐;ARCH.md 〇 节「十处」改「十一处」。
    • 边界 / 问题表第 9 条:spu_sku_node 注明整表废弃、待清理,只保留 sop_step_node.md:137 为现役出入;本条逐条出入第 9 条与概念一致性结论同步。
    • 前端设计代码结构表:详情聚合读改为「先读主档,再把三张子表的读并发发出」(supplier.bff.ts:57-65)。
    • 数据设计组合索引订正:联系人是「所属供应商 + 主要联系人」,证照是「所属供应商 + 证照类型」。
    • 流程设计场景 1 第 3 步下半区补上「经办人联系方式、区域经理」(supplier.tsx:210-212)。
    • ARCH.md 锚点:§三 ③ appendNextOrderNo 改 supplier-contacts-create/repo.js:36、supplier-certificates-create/repo.js:37;§四 文件生命周期改 supplier-create/repo.js:24、supplier-certificates-create/repo.js:32、brand-create/repo.js:29,31;自查另发现 §一、§三 ② 的 supplier-update/controller.js:26-31 应为 27-32,一并改。本轮把 §一 / §三 / §四 / §八 的服务端锚点与 supplier.bff.ts 锚点全部重核过,其余成立。
    • 新登记一个代码问题:品牌顶部新增表单的「授权状态」开关没有初始值(brand.tsx:500-506,行尾「+」表单在 :651 给了 false),不碰它时值为空、会被必填规则拦下。读代码推断,未实跑。写进流程设计场景 3 第 1 步、前端设计品牌弹窗图注 ④、服务设计问题 10。

    同日订正 · 反向读的归属:正文第 96、283、418 行把 spu-suppliers-read(及同目录的绑定、解绑两个函数)记在商品核心名下;同日服务管理域 ecommerce/sku 从商品核心拆出,这三个函数随 x-server/admin/ecommerce/spu-supplier/** 归服务管理域,三处已改。由服务管理拆分那一份审查顺带查出。代码未动。

  11. v0.2.x
  12. 改动统一之前的版本没有改动清单

    导入服务改归 x-api 管辖引起的 server 与 admin 两端 srcHash 重算(server cd3c0265 → 20fcaa87,admin 935a25f2 → 292f270b),双聚合根 / 生命周期 / CQRS 数据流 / 对外契约零变更。描述域内被改的文件共 4 个:

    • server 两个:supplier-import/service.js 与 brand-import/service.js。x-api V6.6.0 把导入服务收回服务写法闸的射程;两个服务原先挂的 x-file STD-SERVER-0006 导入标记所指的规则早已从判据删除(该规则号后来转给了导出仓储),现换成 x-api STD-SERVER-0003 的签名、返回、导出三段标记;成功数先算成局部变量 successCountValue 再填进返回值。行为等价:successCountValue 就是原先内联的 stats.create.success + stats.update.success,返回值仍是 { successCount, totalCount: 1, data: { id, stats } },在所有输入下逐字段同值。
    • admin 两个:brand.types.ts 的 BrandImportResult 字段 brandId 改为 id —— 只改类型:后端一直返回 id,SupplierImportResult 本来就是 id,全 admin 没有任何代码读这个字段,运行时零影响;这是导入服务挂上 x-api 标记后,x-api NS-COMMON-0033(前端结果类型必须是后端返回的子集)暴露出来的潜在契约错。brand.tsx 只在行级新增的两处上传块外加了 x-file STD-ADMIN-0002 P3 标记注释,代码一字未动。

    正文订正两处:

    ① §四 CQRS 表 supplier-import、brand-import 两行补点名「返回模板归 x-api STD-SERVER-0003」(与两个 export 行点名 STD-SERVER-0006 同口径,只点名、不复述模板)。两行锚点逐行核过仍成立:supplier-import 的品牌名反查到 importOne 在 service.js:7-14,brand-import 的 importOne 在 service.js:5。

    ② §三、§5.2 的 brand.tsx 锚点按现网逐个重核。本次新增的 8 行标记全在第 772 行之后,受它影响的两处(925-930、959-1006)移位后正好对准,不改;插入点之前的锚点是早已存在的漂移(v0.1.3 记过「±7 内微漂」但没订),其中 Curd 区间终点 1123 已超出文件末尾(现 1106 行),本次一并订正:§三 orderNo 521-527 → 518-524;§5.2 Curd 区间 347-1123 → 349-1101、树形三键 376-378 → 371-373、扁平统计 410-417 → 405-412、orderNo 三处 521-527/735-740 → 518-524/730-735(925-930 不变)、orderNo 列 329-335 → 326-333、状态 Switch 列 258-301 → 252-299、新增上传块 565-598 → 562-595(959-1006 不变)、brandType 单选转数组 510-520 → 507-517。每个新锚点所指内容与原描述逐条一致,设计描述句零改。

    data 端指纹未动(工作树内无该端描述域改动)。

    诚实边界:srcHash 只证「描述域代码被改过」,不证设计正确;本次没做真机验证,导入流程没有在后台实际跑一遍,两个函数的发布状态以部署会话为准、本次未核。admin 端只重核了 brand.tsx 与 brand.types.ts 的锚点;supplier.tsx / supplier.bff.ts / supplier.types.ts / supplier-brand-transfer.tsx 本次没有改动,锚点未逐点重核(v0.2.1 记下的 admin 正文复核债仍在)。

  13. 改动统一之前的版本没有改动清单

    零兜底存量整改引起的 server srcHash 重算(b7bc9cf8 → cd3c0265),双聚合根 / 生命周期 / CQRS 数据流 / 对外契约零变更。描述域内只有一个文件被改:supplier-export/repo.js —— 导出编排的子表分组由「先 reduce 建稀疏字典、取值处 dict[sid] ? dict[sid] : [] 逐个兜底」改为「按 supplierIds 父 ID 全集预建分组(无子记录即空数组,一对多的合法空态),取值处直取」,groupBy 更名 groupByParentIds(x-fallback 存量整改,判据未改动)。行为等价:改前每个 supplierId 取不到分组时得 [],改后取到的就是预建的 [],导出行的 contacts / certificates / brands 三字段在所有输入下逐字段同值。

    正文订正一处:§四 CQRS 表 supplier-export 行的证据锚 repo.js:57-99 → repo.js:62-104(本次改动在该函数之前净增 5 行所致,实测函数仍是 43 行,起止逐行核对过),并补一句分组口径。设计描述句全部成立、零改;data / admin 两端指纹一字未动(工作树内无这两端的描述域改动)。

    诚实边界:srcHash 只证「描述域代码被改过」,不证设计正确;本次未做真机与部署(发布归部署会话)。

  14. 改动统一之前的版本没有改动清单

    prose ARCH-SYNC(v0.2.1 漏订的 server 侧正文对齐·代码未变,srcHash 四端不动):v0.2.1 只记了 version-log 未逐点订正文,五处 server prose 仍写已退役 syncFileField(NS-SERVER-0014 已封禁、sys 原子已物理删除),本次逐条对齐现网真码——① §四 CQRS 表 supplier-create/update 行:updateMany 行号 repo.js:60→69-72(1:N 改造 repo 顶部新增 diffRemovedFiles/deleteFiles 后整体下移)+ syncFileField→x-file STD-SERVER-0007 三阶段(service.js:5-23 实证::13 READ diffRemovedFiles→:23 CLEANUP deleteFiles)② 同表 brand-create/update/delete 行:syncFileField 双字段→三阶段双字段(brand-update/service.js:5-27 实证::17 diffRemovedFiles→:27 deleteFiles)③ 文件生命周期 UPDATE 行改三阶段口径 ④⑤ §六/§七两张 spec 管辖表 x-file 行「resolveFileValue/syncFileField、三阶段删除」→「resolveFileValue/diffRemovedFiles、STD-SERVER-0002/0007 三阶段」;纯 prose 订正援 v0.2.0 先例,业务设计/双聚合/契约零变

  15. 改动统一之前的版本没有改动清单

    头像/证照存储 1:1→1:N 实现级 ARCH-SYNC:file-upload 同名覆盖机制全局废除,supplier-update(logo)/ supplier-certificates-update(attachmentUrl)/ brand-update(brandLogo+licenseImage)改 STD-SERVER-0007 三阶段差集清理(READ diffRemovedFiles → MUTATE → CLEANUP deleteFiles),brand-import 死端口清除;附带根治 supplier-certificates-update 先删后写数据破坏活体 bug(该函数已是 1:N,旧原子先删旧文件再写库=写库失败两头空);双聚合根/字段/对外契约零变,重算 server srcHash 41826f10→b7bc9cf8。附带基线同步 admin srcHash ed3510b7→45fa5f72(git status 实证 xModules/supplier+brand working-tree 干净 = 他会话已提交的描述域改动未随手 ARCH-SYNC 的基线债,非在途漂移,援 customer.md v0.1.2 附带基线同步先例;admin 端本 arch prose 未逐点复核,归下次 admin 域 ARCH-SYNC)

  16. 改动统一之前的版本没有改动清单

    prose ARCH-SYNC(正文与现网代码对齐·代码自 v0.1.2 未变,srcHash 不动):审计报 prose-gap 五处,设计契约成立、仅正文陈旧/漏列,逐条 file:行号复核现网真码后订正——① §八风险表 #1「delete 清理侧数组契约崩溃/泄漏(原标最高严重度·须走 x-feature-dev 修复)」标已闭环:三处 delete(supplier-delete/repo.js:29,52 · brand-delete/repo.js:23 · supplier-certificates-delete/repo.js:29)均已收敛 sys 原子 collectCloudUrls(records,[字段]),业务代码零裸 startsWith,与版本日志 v0.1.1「①已修」对齐(正文曾与 version-log 自相矛盾),§四 supplier-delete 行 + 文件生命周期 DELETE 注同步;② §四 CQRS 表 supplier-contacts-read/supplier-certificates-read 两行 + §八 #2 的 buildOrderBy「createdAt DESC」订正为「ORDER BY orderNo ASC」(现网两 repo.js:13-14/17-18 均 return orderNo ASC,拖拽序已生效),风险 #2 标闭环;③ §四 CQRS 表 + §1.2 全景图 SERVER 框补入 6 个漏列 live 云函数(describes.server glob 实有 28=supplier 21+brand 7,正文原仅列 22):supplier-info-read(读·mode:one·supplier_base 详情,即 §5.1 supplierDetailRead BFF 服务端)、supplier-import / supplier-export、brand-import / brand-export、brand-status-toggle(写·状态切换,即 §5.2 toggleStatus 服务端),均 controller/service 真实函数非空模板;④ §2.1(line 59/115/233)supplier_base「43 业务字段」订正为「40」(datasource.json 41 user 字段 − supplierId 主键 = 40,与 brand 15/contact 12/cert 13 同口径 user−PK 交叉验证,43 为 v0.1 原始残留);⑤ §2.1 line 129「枚举字段(11)」订正为「(9)」(json 内 x-option-name 恰 9 次,该行紧随其后自列 9 项)。属实现级已修 + 漏列补全 + 计数订正的 prose 同步,业务设计/双聚合/CQRS 契约零变,srcHash 四端保持(data c852063e / server 41826f10 / admin ed3510b7 / client null)

  17. v0.1.x
  18. 改动统一之前的版本没有改动清单

    admin 端 ARCH-SYNC(实现级漂移,只刷指纹):admin describes glob(supplier/ + brand/)代码变动致 srcHash 陈旧。逐点复核 supplier.tsx / supplier.bff.ts / supplier.types.ts / brand.tsx / brand.types.ts——双聚合结构、供给方生命周期、CQRS 读写二分、四端消费编排(MasterList+Detail 双栏 / contacts·certificates inline-edit 子表 / brands relation-select 穿梭框 / brand CURD 树形手工 orderNo 无拖拽 / 双地址 address-triple 三元组 / logo·attachmentUrl 单图 / brandLogo·licenseImage 双图 / brandType 多选)与类型契约(registeredRegion·officeRegion AreaSingleValue object / SupplierWithRelations / SupplierUpdateParams=Partial<SupplierBase>&{supplierId} / BrandItem string[]|null 文件字段)全部与现网代码逐点对齐、file:行号实证仍成立(行号 ±7 内微漂,如 brand.tsx 尾 1123→1116 / orderNo ProFormDigit 521→522,业务设计契约零变),属实现级同步非设计变更;重算 admin srcHash 10d0ffa2→ed3510b7(data c852063e / server 41826f10 / client null 三端未动)

  19. 改动统一之前的版本没有改动清单

    NS-SERVER-0006 迁移 ARCH-SYNC:server 端裸 throw new Error 类型化为 ServerBusinessError(不变量→SYS_500 / 业务错→Tier-2),异常架构设计不变——运行时行为一致(都落 SYS_500,controllerSystem catch 兜底),仅补类型化,双聚合/CQRS 数据流契约零变;重算 server srcHash 8bde713e→41826f10。附带 §八风险表 row3「bind 查重用裸 Error」措辞订正为已闭环(v0.1.1 已改 ServerBusinessError(BRAND_ALREADY_BOUND),supplier-brands-bind/service.js:12 实证;本次迁移后全域业务代码零裸 Error 保证),系措辞去陈旧非设计变更

  20. 改动统一之前的版本没有改动清单

    三处 server 风险修复闭环:① delete 文件清理数组契约(手搓 .startsWith(cloud://) on array 崩溃 → 收敛 sys 原子 collectCloudUrls + firstCloudUrl,NS-SERVER-0011 detector 强制,brand 补 licenseImage 泄露面)② 嵌套读 buildOrderBy createdAt DESC→orderNo ASC(拖拽序生效)③ supplier-brands-bind 裸 Error → ServerBusinessError(BRAND_ALREADY_BOUND);业务设计/字段/契约零变,仅实现修复,重算 server srcHash 8bde713e

  21. 改动统一之前的版本没有改动清单

    初次固化:5-agent 深读四端真实代码(DATA/SERVER/ADMIN + 边界·client·MCP·specRefs 核实)+ 双聚合根(supplier 主 / brand 次)DDD 合并为一个供给方限界上下文 + supplier_brand_relation 绑定层 + 双地址三元组 + SUP/BRD 多态下游锚点 + 三处 server 风险(delete 数组契约 / 嵌套读排序 / 裸 Error),全部 file:行号实证;client 无独立模块(供给方展示经 spu 商品核心 loadSupplierMap 派生)

改过本单元的需求