meal_manager/jeesharp-business/business-mall

商城管理模块 (business-mall)

模块概述

商城管理模块为企业级 B2C/B2B2C 电商平台的核心业务模块，提供商品管理、订单交易、营销活动等完整电商能力，与会员模块（business-member）深度集成。

功能设计

详细功能设计请参阅：商城功能设计.md

功能模块概览

模块	核心功能
商品中心	商品分类、品牌、SPU/SKU、库存、评价
交易中心	购物车、收货地址、订单、支付、物流、售后
营销中心	优惠券（复用 member）、秒杀、拼团、满减
数据统计	销售报表、商品分析、订单分析

依赖关系

• business-member：会员、积分、优惠券（订单核销、积分抵扣、等级折扣）
• business-order-application：商城订单与全站统一单 biz_trade_order 对齐（M5 双写、读切换、影子核对等，见下节）

---

商城订单与统一交易单（M5）

商城垂直订单（mall_order 及地址、订单日志、首单配置等）的 Bean / Service / Application / Controller 均在本聚合工程 business-mall 下，包名仍为 com.jeesharp.business.modules.mall。

层级	Maven 模块	说明
Bean	business-mall-bean	MallOrder、MallOrderLog、MallMemberAddress、MallFirstOrderConfig 及 DTO/VO/Convert/枚举
领域与 Mapper	business-mall-service	MallOrderService 及实现、mapper/xml/MallOrderMapper.xml 等
应用服务	business-mall-application	MallOrderApplicationService（含统一单双写/读切换）、MallOrderLogApplicationService、MallMemberAddressApplicationService、MallFirstOrderConfigApplicationService、sync/MallTradeOrderShadowService
接口	business-mall-controller	后台 MallOrderController 等；路径仍为 ${jeesharp.web.adminPath}/manager/business/mall/...

Maven：business-mall-application 已依赖 business-order-application，用于调用 TradeOrderApplicationService（创建待支付统一单、markPaid 等）。

数据库：主表 DDL 见本模块 mall_schema.sql；为 mall_order 增加 unified_order_id 的增量脚本见
business-mall-service/src/main/resources/sql/m5_mall_order_unified.sql。

设计文档（与 business-order 文档同仓）：
../business-order/doc/M5-商城线统一订单接入.md

其他业务调用：同仓注入 MallOrderApplicationService 等即可；Maven 依赖 business-mall-application（或按需加 business-mall-bean）。

管理端 HTTP 路径（前缀均为 ${jeesharp.web.adminPath}，与 TravelWebFront 下 api/manager/business/mall/* 一致）：

能力	子路径示例
订单	/manager/business/mall/order/v1/info、/list、/save、/delete
订单日志	/manager/business/mall/orderLog/v1/...
会员地址	/manager/business/mall/memberAddress/v1/...
首单配置	/manager/business/mall/firstOrderConfig/v1/...

更多状态流转示例见 ../business-order/README.md 附录。