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/customer | marketing/customer/ARCH.md | core | all |
| marketing/customer-behavior | marketing/customer-behavior/ARCH.md | core | all(关系域 · 两端是客户与自营 SKU(服务管理域的定价表):购物车 / 收藏 / 足迹三张关系表,商品一端另有一支指向京东商品编号) |
| marketing/coupon | marketing/coupon/ARCH.md | promotion | all |
| ecommerce/spu | ecommerce/spu/ARCH.md | core | all(client 侧 goods 源自 S15 起住业务域包 x-core/mobile/biz/goods,describes 已改指包源) |
| ecommerce/sku | ecommerce/sku/ARCH.md | core | 数据 + 服务端 + admin(关系域 · 两端是商品与服务提供者:6 张表的服务管理 —— 哪个提供者卖哪件商品、卖多少钱、上不上架 · 商城经商品核心域的读取云函数取定价、端代码属商品核心 · client null) |
| ecommerce/goods-flow | ecommerce/goods-flow/ARCH.md | core | client(商品数据链·端内流转层,商品本体归 spu;client 侧源自 S16 起住分包业务域包 x-core/mobile/biz/goods-lazy,describes 已改指包源) |
| ecommerce/order | ecommerce/order/ARCH.md | core | all |
| service/supplier | service/supplier/ARCH.md | core | all(client 无独立模块·供给方展示经 spu 派生) |
| service/dispatch | service/dispatch/ARCH.md | core | all(client 师傅端未建) |
| service/sop | service/sop/ARCH.md | core | 数据 + 服务端 + admin(关系域 · 两端是商品与服务提供者:16 张表的作业标准 · 师傅端不读它 · 步骤主表按现在的域划分写不出合规的上级,登记为数据模型缺陷、两条出路待拍板 · client null) |
| service/technician | service/technician/ARCH.md | core | admin(师傅账号主档 · 师傅端两个页面是空壳、不读本表 · client null 经实算确认) |
| randd/login | randd/login/ARCH.md | core | all |
| randd/account-cancellation | randd/account-cancellation/ARCH.md | core | all(设计态 · 四端零代码 · describes 四端全 null —— 这只说明没有描述面,不是「没有代码」的证据;开工写代码前必须先填回 describes) |
| randd/member | randd/member/ARCH.md | core | all(client 消费面归 login/mobile · client null) |
| randd/role-user | randd/role-user/ARCH.md | core | 数据 + 服务端(关系域 · 两端是角色与四类身份 —— 后台用户、访客、客户、师傅:1 张表的角色分配 · 界面是后台角色管理页展开区里的成员区块(标题随角色为「绑定用户关系」「绑定客户关系」等)与「关联成员」弹窗里的穿梭框、代码属成员权限域 · admin/client 均 null) |
| randd/menu | randd/menu/ARCH.md | core | admin(后台菜单树 + 公开页开关 · 移动端零消费 · client null —— 依据是全仓检索零引用,指纹为空本身不作依据) |
| randd/company | randd/company/ARCH.md | core | admin(单例配置表 · 移动端零消费 · client null 经实算确认) |
| randd/config | randd/config/ARCH.md | core | 数据 + 服务端(运营可改的系统参数 · 界面寄生在访客管理页、代码属 login 域 · admin/client 均 null) |
| randd/agreement | randd/agreement/ARCH.md | core | all |
| randd/avatar | randd/avatar/ARCH.md | core | all(client 无独占目录 · 消费面在 customer 的 user-panel/settings 内 · client null) |
| randd/mobile | randd/mobile/ARCH.md | core | client 类(多移动端 × 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 纳管)
按四大中心预定落位(建域时照此门牌,一出生就按架构设计模板的七个视图写):
- 营销中心:〔
marketing/customer-behavior已于 2026-09-23 建域,见上表〕 - 电商中心:〔
ecommerce/sku已于 2026-09-23 从商品核心拆出建域,见上表〕· 品类编进ecommerce/spu - 服务中心:〔
service/sop与service/technician均已于 2026-09-23 建域,见上表〕 - 研发中心:〔
randd/config已于 2026-09-23 建域;randd/role-user同日从成员权限拆出建域,见上表〕
注:RBAC 判定与路由守卫的技术契约是系统架构 = x-auth / x-route 的系统四件套,业务文档只引不复述;菜单表本身是业务数据,已固化为 randd/menu/ARCH.md;role/user/anonymous 的成员-角色-资源领域治理模型已固化为 randd/member/ARCH.md —— 治理模型入 arch,技术契约仍归系统四件套,两不复述。还没开发业务的:联盟电商(电商中心)、日志(研发中心),以及客服、知识、运营、职能四个中心(后台只有占位页或空目录,真开发时再登记中心与域)。
端专属域(非四端共有)在其文档 frontmatter 标 endScope: admin|client。