# 商城管理模块 (business-mall)

## 模块概述

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

## 功能设计

详细功能设计请参阅：[商城功能设计.md](商城功能设计.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](../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](../business-order/README.md) 附录。