一、为什么按业务域拆,而不按技术层拆
按技术层拆(controller / service / dao 三层各一个模块)看起来整齐,但改一个业务需求要在三个模块间来回跳,模块边界与业务边界对不上,长期会变成一团。
按业务域拆的逻辑是:一个业务域的改动尽量落在一个模块里。商品的价格逻辑只在 goods 里,订单状态机只在 order 里,售后流转只在 aftersale 里。
二、模块怎么成对
每个业务域拆成两个模块:
zhimengdie-module-<域>-api:对外契约,只放接口、DTO、枚举、常量zhimengdie-module-<域>-server:实现,放 Mapper、Service、Controller
这样拆分的好处是依赖单向:其它模块只依赖 -api,不依赖 -server。编译期就能防止「为了省事直接调别人的实现类」,跨域调用必须走契约。
三、主要业务域
| 域 | 职责 | 规模(Java 文件数) |
|---|---|---|
goods | 商品 SPU/SKU、分类、品牌、规格属性 | 134 |
order | 订单状态机、下单、支付回调 | 101 |
member | 会员、等级、积分、余额 | 89 |
coupon | 券模板、发放、领取、核销 | 62 |
decorate | 页面装修模板、组件白名单、发布回滚 | 57 |
aftersale | 售后单流转、质检、退款 | 56 |
pay | 支付单、渠道适配、对账 | 53 |
logistics | 发货单、快递公司、物流轨迹 | 35 |
invoice | 开票申请、红冲、操作留痕 | 35 |
evaluate | 评价、评价标签、审核 | 27 |
stock | 库存扣减、回补、冻结、调拨 | 26 |
promo | 促销规则、限时购 | 23 |
cms | 运营位、专题、模板管理 | 15 |
supplier | 供应商入驻与档案(规划中 3/6) | 14 |
report | 销售报表、商品 TOP、会员报表 | 12 |
notify | 通知与消息模板 | 12 |
flash | 限时购场次 | 11 |
cart | 购物车 | 5 |
规模数字取自当前仓库实测,随代码演进会变;如果与最新仓库不一致,以仓库为准。
四、新增一个业务域要动哪几处
- 在根
pom.xml的<modules>里加两行(-api与-server) - 建两个模块目录,各自
pom.xml里声明父工程与依赖 -server的包路径遵循com.zhimengdie.<域>.{mapper,service,web}- 建表 SQL 落到
agents_workspace/sql/,并在执行日志里登记 - 管理端菜单与按钮权限点入库(
menu_scope必标) - 如果涉及租户,Mapper 层按多租户四步改造
不要做:把新业务塞进已有的域模块。域边界一旦模糊,成对拆分带来的隔离收益就没了。
五、分层约定
- Controller 只做参数校验与编排,不写业务判断
- 状态流转集中在 Service,不散落到 Controller
- Mapper 只做数据访问,不写业务规则
- 跨域调用只走
-api接口,不直接注入别人的 Service 实现