主题
商城(预留模块)
MALL-00 | Maven
pmforge-module-mall(聚合 product / promotion / trade / statistics)| 状态 ⏸ 预留(已纳入构建,未接入运行时)
商品、交易、营销、统计四个子模块组成的商城域,是仓库里代码量最大的预留部分。
1. 模块概览
| 项 | 值 |
|---|---|
| Maven 模块 | pmforge-module-mall(聚合 product / promotion / trade / statistics) |
| 控制器 | 72 |
| 接口 | 316 |
| 唯一权限点 | 128 |
| 数据对象(DO) | 49 |
| 已拆功能点 | 16 项 |
| 需求原件 | 06-01-商品管理 |
2. 能力清单
| 能力 | 优先级 | 状态 |
|---|---|---|
| 商品分类 | P0 | ⏸ 预留 |
| 商品品牌 | P1 | ⏸ 预留 |
| 商品属性(SKU) | P0 | ⏸ 预留 |
| 商品列表与编辑 | P0 | ⏸ 预留 |
| 商品评价 | P2 | ⏸ 预留 |
| 订单列表 | P0 | ⏸ 预留 |
| 订单详情 | P0 | ⏸ 预留 |
| 售后(退款 / 退货) | P1 | ⏸ 预留 |
| 优惠券 | P1 | ⏸ 预留 |
| 满减 | P1 | ⏸ 预留 |
| 秒杀 | P2 | ⏸ 预留 |
| 拼团 | P2 | ⏸ 预留 |
| 砍价 | P2 | ⏸ 预留 |
| 交易统计 | P1 | ⏸ 预留 |
| 会员统计 | P1 | ⏸ 预留 |
| 商品统计 | P1 | ⏸ 预留 |
共 16 项,与能力地图的统计口径一致;状态为「预留」:代码在库、已通过编译验证,尚未接入 server 运行时。
3. 控制器与接口
| Controller | 路径前缀 | 接口 | 权限点 | 代码位置 |
|---|---|---|---|---|
| AppTradeOrderController | /trade/order | 13 | 0 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/app/order/AppTradeOrderController.java#L60 |
| TradeOrderController | /trade/order | 11 | 3 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/admin/order/TradeOrderController.java#L52 |
| ProductSpuController | /product/spu | 10 | 5 | modules/mall/product/src/main/java/com/pmforge/module/product/controller/admin/spu/ProductSpuController.java#L46 |
| AfterSaleController | /trade/after-sale | 8 | 5 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/admin/aftersale/AfterSaleController.java#L57 |
| DeliveryPickUpStoreController | /trade/delivery/pick-up-store | 8 | 4 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/admin/delivery/DeliveryPickUpStoreController.java#L41 |
| DiyPageController | /promotion/diy-page | 8 | 4 | modules/mall/promotion/src/main/java/com/pmforge/module/promotion/controller/admin/diy/DiyPageController.java#L32 |
| DiyTemplateController | /promotion/diy-template | 8 | 5 | modules/mall/promotion/src/main/java/com/pmforge/module/promotion/controller/admin/diy/DiyTemplateController.java#L36 |
| SeckillConfigController | /promotion/seckill-config | 8 | 4 | modules/mall/promotion/src/main/java/com/pmforge/module/promotion/controller/admin/seckill/SeckillConfigController.java#L32 |
| AppBrokerageUserController | /trade/brokerage-user | 7 | 0 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/app/brokerage/AppBrokerageUserController.java#L56 |
| AppCartController | /trade/cart | 7 | 0 | modules/mall/trade/src/main/java/com/pmforge/module/trade/controller/app/cart/AppCartController.java#L32 |
| CombinationActivityController | /promotion/combination-activity | 7 | 5 | modules/mall/promotion/src/main/java/com/pmforge/module/promotion/controller/admin/combination/CombinationActivityController.java#L50 |
| CouponTemplateController | /promotion/coupon-template | 7 | 4 | modules/mall/promotion/src/main/java/com/pmforge/module/promotion/controller/admin/coupon/CouponTemplateController.java#L33 |
| … | 其余 60 个 | 见接口索引 |
4. 数据对象
| 表 | DO | 字段数 |
|---|---|---|
product_brand | ProductBrandDO | 0 |
product_browse_history | ProductBrowseHistoryDO | 0 |
product_category | ProductCategoryDO | 0 |
product_comment | ProductCommentDO | 0 |
product_favorite | ProductFavoriteDO | 0 |
product_property | ProductPropertyDO | 0 |
product_property_value | ProductPropertyValueDO | 0 |
product_sku | Property | 0 |
product_spu | ProductSpuDO | 0 |
product_statistics | ProductStatisticsDO | 0 |
promotion_article | ArticleDO | 0 |
promotion_article_category | ArticleCategoryDO | 0 |
promotion_banner | BannerDO | 0 |
promotion_bargain_activity | BargainActivityDO | 0 |
promotion_bargain_help | BargainHelpDO | 0 |
| … | 其余 34 个 DO |
主库脚本
sql/mysql/pmforge.sql只覆盖 system 与 infra,本模块的表结构以 DO 为准;启用前需自备 DDL(部分模块有测试脚本src/test/resources/sql/create_tables.sql)。
5. 启用前提
依赖:product 依赖 member;trade 依赖 pay 与 trade-api;promotion / statistics 依赖 product 与 trade-api。启用顺序:member → pay → mall。
- 根 pom 取消
pmforge-module-mall注释(聚合模块) - server 按注释块展开四个子模块依赖:product / promotion / trade / statistics
- 分别导入三个子模块的测试 DDL(product、trade、promotion)
trade-api是 API 包,由 trade 传递依赖,不要单独加到 server- 补菜单与权限点(
product:*、trade:*、promotion:*、statistics:*)
6. 风险与注意
- 只开聚合模块不开子模块依赖,编译期会找不到
pmforge-module-product等 artifact - 四个子模块各有自己的
dal/dataobject,表数量最多,DDL 分散在三份测试脚本里 - 统计模块的接口数量与前端图表强耦合,单独启用意义有限
7. 关联
- 相关页面:MOD-RSV-00
- 相关页面:PAY-00
- 相关页面:MBR-00
- 模块手册:/modules/reserved/
- 接口索引:/code/api/mall