业务架构 · 总览

_context-map

业务架构以代码为锚:改了本域代码,收尾当轮就报这份设计还没升版封版。

版本
0.10.3
真相源
true

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

arch Context Map(DDD 跨限界上下文关系图)

记录业务域(bounded context)之间的依赖方向与集成模式(防腐层 / 共享内核 / 顺从)。跨域数据流的单一真相源。
本文件为骨架,随各域 Stage 3 固化逐步补全。

跨域关系(已固化部分)

customer ──下单(skuId+quantity)──> ecommerce/order ──支付编排──> (pay-common 网关)
                        │
                        │  ① 客户预约触发(service 订单支付后:我的订单 › 待约 页签选址+期望时间;独立预约页 2026-08-15 已退役)
                        ├──dispatch-reserve-create 预建工单(R3-b:一次提交=一张工单挂 N 槽,可跨订单 → 派生 dispatching)──> service/dispatch
                        │        ※ ② settle 唯一受控反向回写四费(order-settle-update)
                        │           已随费用体系物理拆除整条消失(2026-08-14 裁定一) ⇒ order↔dispatch 现为纯单向
                        │
                        ├──③ order-self-read 两级 JOIN(order_item_node → dispatch_item_node 活明细 → dispatch_base 非关单) + 子查询读 dispatch_visit_node 6 态计数派生 fulfillStatus(只读)──> service/dispatch
                        │
                        ├──④ 客户自助取消:dispatch-self-cancel-update 本人守卫作废活工单(活跃三态 + supersededAt CAS)──> service/dispatch
                        │
                        ├──⑤ 下单锁券/核销/算抵扣 + 退款侧归还券(S3 全退返券 / S4 破门槛撤券,二者互斥)
                        │      (order 驱动锁定/核销/释放/退还;coupon 后台可发放与作废;前端永不直写)──> marketing/coupon
                        │
                        └──读──> ecommerce/{spu,sku}(商品快照与定价行;spu、sku 均已建档)

上门地址所有权:v0.3.0 从 order_base 迁 dispatch_base(customer_address_node ──reserve 预约冻结──> dispatch)

集成模式登记

上游 → 下游模式说明
ecommerce/order → pay-common顺从(Conformist)订单顺从微信支付网关契约,snapshot 落库防漂移
ecommerce/order → service/dispatch顺从(Conformist)+ 客户预约触发service 订单支付后客户经 dispatch-reserve-create 预建工单(读 order paid+service+本人守卫),dispatch 顺从 order 快照。★反向通道已归零(2026-08-14 裁定一 · 费用体系物理拆除)★:原「唯一受控反向 = order-settle-update 回写四费」的云函数、admin 原子(dispatch.api.ts orderSettle)、四费 8 列全部物理删除 ⇒ dispatch 域对 order 既无 server 直写、也无 UI 层桥接写。机制真相源 = service/dispatch/ARCH.md §6.2 与 ecommerce/order/ARCH.md §2.1(本表只登记边的消失,不复述设计)
ecommerce/order → service/dispatch反向读(fulfillStatus 派生)已换轴(2026-08-14 B3-a):order-self-read 两级 LEFT JOIN(order_item_node → dispatch_item_node 活明细 supersededAt<=>NULL → dispatch_base 非关单)+ 相关子查询读 dispatch_visit_node 6 态计数(cntTotal/pending/serving/done/partsmissing/visitfailed)派生客户履约阶梯 fulfillStatus,只读不写;上门地址所有权 v0.3.0 迁 dispatch_base
ecommerce/order ↔ service/dispatch★v4 三层模型:集成边整体换轴(★2026-08-14 R3-b 已完成·现役★)★现役 = 一张工单含多 SKU 多数量且可跨订单 ⇒ JOIN 轴已由 dispatch_base.orderItemId 换至 dispatch_item_node(服务项 = 1 次服务 = 1 配额槽),订单归属由 FK 变为 JOIN 派生(dispatch_item_node.orderItemId → order_item_node → order_base),dispatch_base 与 order 自此无直接 FK(两旧列已停写、行锚已 DROP)。跨域影响三项均已落地:① 反向读族① 三家(order-self-read / order-stats-read / order-review-create)已 lockstep 换轴(B3-a);② 退款域 activeDispatchCount 三家闸 左半臂已改数活服务项(R3-b,与停写同窗;右半臂「已交付槽数」自 R2 起即在服务项表);③ 配额单位已由「订单行」改为「次」。仍未做(勿据本行推断全绿):族② 活跃态判据下沉(B3-b,读侧阶梯仍读 dispatch_base.supersededAt)/ admin 读侧 fan-out(代表明细过渡窗口已开)/ markItemsFulfilled 按槽精选(带电债)。机制真相源 = service/dispatch/ARCH.md §2.4/§2.5(本表只登记跨域边存在性,不复述设计)
ecommerce/order → service/dispatch运维自愈跨域写(非业务对接·三臂)order 域定时器 order-payment-reconcile-update(cron 5min)反向 UPDATE dispatch 两表:① F54 releaseOrphanSlot(close 崩溃窗补释放活跃槽);② ⑦-v4 healOrphanActiveItem(明细活而工单废);③ ⑦-v4b scanHeadlessDispatches/healHeadlessDispatch(2026-08-14 R3-b 新增:工单活而零活明细 = 无腿工单,5min 缓冲后作废;是旧锚 DROP 的硬前置——DROP 后 1062 兜底消失,本臂成唯一自愈通道)。三臂均不表达业务语义、不驱动状态机,只在崩溃窗后拉回一致;登记于此仅因物理上是跨域写(不登记 = 读 dispatch 文档者会误以为该表只由 dispatch 域自己写)。真相源 = service/dispatch/ARCH.md §6.2′
customer → service/dispatch客户自助反向触点客户经 dispatch-self-cancel-update 作废本人活工单:行级 authInfo.userId + 归属守卫 + 仅 orderStatus=paid 可撤 + supersededAt CAS 抢锁 + 连带作废活 visit(dispatch-self-cancel-update/service.js);订单回「待预约」桶可重新预约
ecommerce/order → marketing/coupon聚合根写守卫(order 驱动锁定 / 核销 / 释放 / 退款归还;代金券域自己的后台会发放(coupon-customers-bind 批量写入未使用的券)与作废(coupon-customers-update 只把未使用改成已作废,不能恢复);前端一律永不直写 —— ★2026-09-23 订正,此前写「order 为唯一驱动方、coupon 域自身永不直写」不成立;★2026-09-24 再订正:09-23 那次写成「可作废与恢复」,「恢复」不成立(coupon-customers-update/repo.js 只有 unused → revoked 一条路))正向(下单链路):order-preview-read 满门槛筛可用券 + 权威算价抵扣;order-create 锁券(lockCouponForOrder CAS)+建单+绑定 orderId+锁失败补偿(closeOrderById/COUPON_LOCK_FAILED)+免单即时核销(markOrderPaidFree+redeemCouponByOrder);reconcile 券结算兜底(scanLockedCoupons 按订单态 redeem/release)。反向(退款链路,v0.3.0 补):券归还有且仅有两条互斥路径——S3 全退返券(used→unused,整单退光) 与 S4 破门槛撤券(locked|used→unused,非全退且保留品跌破门槛,订单仍存活,2026-08-06 P5-B 新增),二者均落 applyRefundAggregationCore 三家(pay-common orderService ∥ order-item-refund-update ∥ reconcile)NS-SERVER-0139 字节等值共同段;券侧台账 couponRollback/couponRevoke 由 reconcile ⑪/⑮ 双向 NOT EXISTS 互斥补写。机制唯一真相源 = ecommerce/order/ARCH.md §4.8「S3 全退返券 / S4 破门槛撤券」,coupon 域只声明「券终态的系统级例外存在」并指针到此(I2 防第二真相源)。写 coupon_customer_node 状态 unused→locked→used/released,退款侧可从 locked/used 单向回 unused
ecommerce/order → ecommerce/{spu,sku}防腐层 ACL + 快照order-create JOIN 商品三表双上架校验 + 快照冻结(详见 ecommerce/order/ARCH.md §6.1)。2026-09-23 起 sku 是独立域(服务管理,从商品核心拆出):订单商品行 order_item_node.skuId 关联 sku_maintenance_pricing_leaf.skuId、offerId 关联 sku_maintenance_node.offerId(表文档第 15–16 行),读的是服务管理的定价行

本月新建与新拆的域(2026-09-23 补,09-24 订正四行并新增一行软引用)

上面的图与登记表以订单为中心,建于这些域出现之前。下面补上 2026-09 新建与新拆的域的跨域边;四个关系域的两端取自各自 ARCH.md 文档头的 relates,其余每条都写明依据。

上游 → 下游关系说明与依据
marketing/customer ↔ ecommerce/sku关系域 marketing/customer-behavior购物车、收藏、足迹三张关系表,两端是客户(customer_base)与自营 SKU(服务管理域的定价表 sku_maintenance_pricing_leaf,真 SKU 住在那里);商品一端还有一支指向京东商品编号,外部标识、不是本仓的表。8 个快照列只有购物车的自营行不写(读时实时查 SKU 主表族),收藏与足迹不分平台都写。字段说明里写的快照来源(商品名取自供给单元、类型取自商品)只是提及、不是关联,不算关系的一端(x-arch V1.18.0 起判据按此判)
ecommerce/spu ↔ service/supplier关系域 ecommerce/sku服务管理:哪个服务提供者卖哪件商品、卖多少钱、上不上架(6 张表、6 个云函数)。商城经商品核心的读取云函数取定价,端代码属商品核心。绑定关系 spu_supplier_relation 的服务提供者一端按编号前缀多态(SUP 供应商 / BRD 品牌方,两张表都在供应商域),表文档写明三端;供给单元挂在绑定关系下面,一对组合一条
ecommerce/spu ↔ service/supplier关系域 service/sop服务标准:师傅上门按什么步骤做(16 张表)。编好了没人照着做 —— 师傅端不读它。数据模型缺陷(2026-09-23 登记):步骤主表 sop_step_node 按服务 + 服务提供者挂在这对组合下,本表字段关联的四张表(服务、供应商、品牌方、服务 × 服务提供者绑定关系)全在别的域,而子表必须与上级同域 —— 按现在的域划分写不出合规的上级,它是业务结构名册里唯一还没写上级的表;15 张步骤子表的上级(步骤主表)已写明。两条出路待拍板:① 不改数据,把服务标准并进服务管理域、上级写绑定关系(判据上 0 违规,但与按后台菜单定的业务分类冲突 —— 服务标准在服务中心,服务管理在电商中心);② 先定作业标准按服务定、按组合定还是做成可复用模板,再给服务标准建一张有自己身份的主档、步骤挂在它下面(改线上数据结构,服务标准域要随之去掉关系域身份)
randd/member ↔ randd/login · marketing/customer · service/technician关系域 randd/role-user角色分配:哪个身份有哪个角色(1 张表、4 个云函数),界面寄生在后台角色管理页展开区的成员区块与「关联成员」弹窗里。成员一端按编号前缀多态,四类身份都会写进来:后台用户 USER 与访客 ANON(登录域)、客户 CUS(客户域)、师傅 TEC(师傅域)—— 2026-09-24 照代码核实(x-core/server/sys/utils/auth/authentication/channel-config.js 的客户与师傅登录通道、访客登录、后台成员绑定;同日线上只读查询 32 行里四类前缀都有),表文档写明四端、relates 扩成四个域
randd/member → randd/menu软引用(按字符串,无外键)角色授权表 role_resource_relation 里后台页面(与带路径的目录)的菜单权限码是 menu: 加路由路径,按字符串对接 menu_base.path;分组目录、移动端页面、端节点三类的权限码对不上菜单表。它不算关系的一端,所以这张表的上级只写角色。改菜单路径时授权不跟着改,已授给旧路径的人侧栏入口无声消失 —— 登记为架构缺陷(菜单域审查已查出同一现象)
service/dispatch → service/technician弱引用(无外键、不校验)上门记录 dispatch_visit_node.technicianId 必填,写明关联 technician_base.technicianId(表文档第 15 行),二次上门可换师傅;数据库没有外键,服务端也不校验这个师傅是否存在、是否在用
randd/login → randd/config读配置各端是否强制登录的开关值住在系统配置表,由登录域的公开函数读(缺行报「配置缺失」、值不认识报「配置非法」,不兜底);开关的界面寄生在访客管理页
randd/avatar → marketing/customer公开读(两域互不锚定)小程序个人面板与设置页经免登录函数 avatar-public-read 取默认头像;取数代码与缓存键在客户域、公开接口在头像域 —— 一边改了,另一边的代码锁步都不会报(头像域审查 2026-09-23 复核仍成立)
ecommerce/goods-flow → ecommerce/spu端内流转商品数据链没有自己的表与云函数,只有移动端两族组件;它调用的云函数属商品核心等域,逐个标在它的服务设计页
更多关系随域固化补入。已知仍不在任何域认领范围里的代码(权限、用户、访客几组云函数与后台模块等)不画边,登记在建档看板。