业务架构 · 总览

_index

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

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

arch 业务架构注册表(声明式 · 单一真相源)

本文件是 .claude/arch/business/ 业务架构层的注册表 + 三层分类图例。声明式登记「四大中心」与「已固化业务域 → 架构文档」。
registry opt-in:只登记已建文档的域;未登记域不受存在性闸约束(避免 big-bang 考古洪水,存量域走 Stage 3 逐个纳管)。反过来,磁盘上每个域目录都必须在这里登记(x-arch NS-COMMON-0001)。
三层架构分类:
- 框架架构 = .claude/harness-engineering.md(单文件真相源,L0–L5 控制系统)
- 系统架构 = .claude/arch/system/ + 规则书 + 规范(系统四件套:设计、条款、判据、执法;检测器逐字比对代码)
- 业务架构 = 本目录(DDD bounded context,业务设计真相)。目录两层:中心/域。中心就是后台菜单的第一层,同名同序;代码目录(x-data / x-server / x-admin / x-client)不跟着分类搬,每个域在自己 ARCH.md 的 describes 里认领代码(2026-09-23 · ADR-59)

四大中心

一张单从左往右走完前三个中心:营销把客户招来、给他优惠 → 电商让他选好服务、下单付款 → 服务派单给师傅、按标准上门做完;研发中心在下面托着这三条流,只给内部人员用。代号取后台菜单 localeKey 的第一段(menu.marketing 等)。判断一个域归哪个中心,看它在哪条业务流里被维护:围着客户转的进营销,从选购到下单的进电商,从派单到上门的进服务,系统本身、不对外开放的进研发。

中心代号管哪条流一句话
营销中心marketing客户流营销跟着客户走:客户是谁、做了什么、给他什么优惠
电商中心ecommerce订单流从选购到下单:卖什么、卖多少钱、怎么下单付款退款
服务中心service工单流从派单到上门:谁来做、按什么标准做、派给哪个师傅
研发中心randd系统系统本身、不对外开放:谁能登录、能看到什么、系统参数、公司是谁、各端怎么承载

已固化业务域(registry)

按中心分组,组内按业务流的先后排;站点导航的顺序就取本表的行序。

业务域架构文档子域端范围
marketing/customermarketing/customer/ARCH.mdcoreall
marketing/customer-behaviormarketing/customer-behavior/ARCH.mdcoreall(关系域 · 两端是客户与自营 SKU(服务管理域的定价表):购物车 / 收藏 / 足迹三张关系表,商品一端另有一支指向京东商品编号)
marketing/couponmarketing/coupon/ARCH.mdpromotionall
ecommerce/spuecommerce/spu/ARCH.mdcoreall(client 侧 goods 源自 S15 起住业务域包 x-core/mobile/biz/goods,describes 已改指包源)
ecommerce/skuecommerce/sku/ARCH.mdcore数据 + 服务端 + admin(关系域 · 两端是商品与服务提供者:6 张表的服务管理 —— 哪个提供者卖哪件商品、卖多少钱、上不上架 · 商城经商品核心域的读取云函数取定价、端代码属商品核心 · client null)
ecommerce/goods-flowecommerce/goods-flow/ARCH.mdcoreclient(商品数据链·端内流转层,商品本体归 spu;client 侧源自 S16 起住分包业务域包 x-core/mobile/biz/goods-lazy,describes 已改指包源)
ecommerce/orderecommerce/order/ARCH.mdcoreall
service/supplierservice/supplier/ARCH.mdcoreall(client 无独立模块·供给方展示经 spu 派生)
service/dispatchservice/dispatch/ARCH.mdcoreall(client 师傅端未建)
service/sopservice/sop/ARCH.mdcore数据 + 服务端 + admin(关系域 · 两端是商品与服务提供者:16 张表的作业标准 · 师傅端不读它 · 步骤主表按现在的域划分写不出合规的上级,登记为数据模型缺陷、两条出路待拍板 · client null)
service/technicianservice/technician/ARCH.mdcoreadmin(师傅账号主档 · 师傅端两个页面是空壳、不读本表 · client null 经实算确认)
randd/loginrandd/login/ARCH.mdcoreall
randd/account-cancellationrandd/account-cancellation/ARCH.mdcoreall(设计态 · 四端零代码 · describes 四端全 null —— 这只说明没有描述面,不是「没有代码」的证据;开工写代码前必须先填回 describes)
randd/memberrandd/member/ARCH.mdcoreall(client 消费面归 login/mobile · client null)
randd/role-userrandd/role-user/ARCH.mdcore数据 + 服务端(关系域 · 两端是角色与四类身份 —— 后台用户、访客、客户、师傅:1 张表的角色分配 · 界面是后台角色管理页展开区里的成员区块(标题随角色为「绑定用户关系」「绑定客户关系」等)与「关联成员」弹窗里的穿梭框、代码属成员权限域 · admin/client 均 null)
randd/menurandd/menu/ARCH.mdcoreadmin(后台菜单树 + 公开页开关 · 移动端零消费 · client null —— 依据是全仓检索零引用,指纹为空本身不作依据)
randd/companyrandd/company/ARCH.mdcoreadmin(单例配置表 · 移动端零消费 · client null 经实算确认)
randd/configrandd/config/ARCH.mdcore数据 + 服务端(运营可改的系统参数 · 界面寄生在访客管理页、代码属 login 域 · admin/client 均 null)
randd/agreementrandd/agreement/ARCH.mdcoreall
randd/avatarrandd/avatar/ARCH.mdcoreall(client 无独占目录 · 消费面在 customer 的 user-panel/settings 内 · client null)
randd/mobilerandd/mobile/ARCH.mdcoreclient 类(多移动端 × backend 轴:微信 / Donut / H5,系统层母本 x-core/mobile/core + backend 层 x-core/mobile/backends 入 describes;业务域包不入本域 —— x-core/mobile/biz/* 归各业务域(S15/S16 已改指);系统工具包 x-core/mobile/kits/** 自 v0.15.0 入本域 describes · 其余端 null)

待固化业务域(未登记 · Stage 3 考古逐个 opt-in 纳管)

按四大中心预定落位(建域时照此门牌,一出生就按架构设计模板的七个视图写):

注:RBAC 判定与路由守卫的技术契约是系统架构 = x-auth / x-route 的系统四件套,业务文档只引不复述;菜单表本身是业务数据,已固化为 randd/menu/ARCH.md;role/user/anonymous 的成员-角色-资源领域治理模型已固化为 randd/member/ARCH.md —— 治理模型入 arch,技术契约仍归系统四件套,两不复述。还没开发业务的:联盟电商(电商中心)、日志(研发中心),以及客服、知识、运营、职能四个中心(后台只有占位页或空目录,真开发时再登记中心与域)。

端专属域(非四端共有)在其文档 frontmatter 标 endScope: admin|client。