高频通用业务模块
独立·自包含·可组合
每个模块是一个完整、自包含的项目，可根据实际业务需求自由选择、灵活组合。
模块间通过标准化接口通信，既能独立运行，也能按需集成。
MODULE OVERVIEW
18+ 个高频通用业务模块一览
涵盖权限认证、会员体系、商品交易、支付管理、商户运营、基础数据等全场景能力
完整的RBAC权限体系，员工、角色、权限资源管理，JWT认证
C端用户全生命周期管理，微信生态原生集成，资产体系
会员等级与付费套餐管理，智能差异化定价，自动续期
SPU/SKU模型，分布式库存安全，购物车，多规格支持
纯编排层设计，资源预占与回滚，防重复下单
订单全生命周期，四种配送方式，完整售后流程
统一支付入口，微信支付四种方式，预支付缓存+异步回调
商户档案、LBS地理信息、独立部署服务
线下提货网络，多对多商户关联，LBS位置查询
智能货柜信息管理，商户绑定，与订单模块协同
广告位运营管理，多维投放，四种跳转方式
品牌基础数据管理，唯一约束，模糊搜索
多级树形分类体系，分组归属，编码与名称唯一约束
通用分组配置，编码与名称唯一约束，灵活分组维度
业务标签管理，多租户数据隔离，模糊搜索
系统级字典数据管理，键值对选项，避免硬编码
统一多媒体资源管理，图片/视频，灵活关联任意业务对象
跨模块共享的枚举、常量与值对象，统一业务语义
更多高频业务模块正在迭代，敬请期待...
CORE MODULES
核心模块详解
每个核心模块的功能说明、设计特点与亮点一览
Auth — 权限与组织管理模块
解决“谁能登录、谁能看到什么、谁能操作什么”的问题
功能说明
• 员工管理：账号创建、编辑、启用/禁用，支持关联部门与角色 • 部门管理：组织架构的灵活配置，支持部门层级划分 • 角色管理：角色的增删改查，支持角色分配权限资源 • 权限资源：基于 RBAC 模型，支持菜单级、按钮级细粒度控制 • 登录认证：账号密码、钉钉登录、JWT 令牌机制 • 安全策略：密码 30 天过期策略，强制定期修改
设计特点
✨ 亮点
任何需要后台管理权限控制的系统均可直接引入本模块，开箱即用的 RBAC 权限体系，省去权限系统的重复开发。
User — 会员管理模块
C端用户（会员）的全生命周期管理能力
功能说明
• 多方式登录：微信小程序登录、H5授权登录、手机号登录 • 会员信息：基础信息与详细档案分层管理 • 收货地址：增删改查，支持省市区与经纬度 • 会员资产：积分、余额、经验值三大资产体系 • 资产日志：每笔变动自动记录，确保可追溯 • 后台管理：BMS端支持分页查询、编辑、启用/禁用
设计特点
✨ 亮点
深度对接微信生态，开箱即用的小程序登录与公众号授权；完整的会员资产体系，可直接支撑积分商城、余额充值等业务。
VIP — 会员等级模块
提供会员等级与付费套餐的管理能力
功能说明
• VIP 等级：自定义会员等级（等级编码、名称、权益介绍） • 套餐管理：每个等级可配置多个套餐，支持原价、首购价、活动价 • VIP 订单：VIP 购买与续费的订单记录 • 自动续期：支付成功后自动延长有效期，支持永久会员
设计特点
✨ 亮点
灵活的差异化定价策略，有效提升新用户首购转化率与老用户续费率；VIP有效期智能累加，续费时在当前到期时间基础上叠加。
Goods — 商品管理模块
提供商品信息管理与库存管控能力
功能说明
• 商品信息：支持 SPU/SKU 模型，基础信息、规格参数、详情描述独立编辑 • 上下架：一键控制商品的销售状态 • 库存管理：单规格/多规格库存，锁定、扣减、释放、归还四种操作 • 购物车：加购、改数量、移除、清空、选择商品 • SPU 配置：按分类维度配置商品规格模板 • 媒体关联：与 Media 模块集成，管理商品轮播图、封面图
设计特点
✨ 亮点
高并发安全的库存管理方案，适合秒杀、抢购等场景；购物车开箱即用，可直接对接交易模块完成下单流程。
Trading - 交易模块
交易聚合层，协调多个业务模块完成下单与支付流程
功能说明
- 商城交易：单商品下单、多商品下单、购物车结算 - 预结算：实时计算商品价格、运费、优惠券抵扣 - 确认下单：锁定库存 > 冻结积分 > 锁定优惠券 > 创建订单 - 快捷交易：积分充值、余额充值、VIP开通/续费 - 超时关单：RocketMQ延时消息自动取消并释放资源 - 支付回调：统一接收支付通知，按类型分发处理
设计特点
✨ 亮点
纯编排层设计，不绑定任何数据存储，可灵活对接不同的订单和商品实现；完整的资源预占回滚机制，是电商下单流程的最佳实践。
Order - 订单管理模块
管理订单从创建到售后的完整生命周期
功能说明
- 订单状态流转：待支付 > 已取消 / 待发货 > 待收货 > 已收货 - 四种配送方式：快递配送、到店自提、送货上门、货柜自取 - 发货管理：支持物流发货与自配送，关联物流单号 - 自提管理：提货码生成，对接线下提货点 - 货柜配送：对接智能货柜，记录货柜 ID 与格子号 - 退款售后：申请 > 审核 > 退货物流 > 确认收货 > 退款 - 用户订单：订单列表、详情、全量详情（含商品明细、金额、支付）
设计特点
✨ 亮点
四种配送方式灵活组合，适配便利店自提、社区配送、智能货柜等多种零售场景；完善的退款售后流程，覆盖仅退款与退货退款两种模式。
Payment - 支付模块
提供统一的支付能力，对接第三方支付渠道
功能说明
- 微信支付：JSAPI、APP、H5、NATIVE扫码四种支付方式 - 多业务支付：商城下单、积分充值、余额充值、会员续费 - 支付回调：接收微信支付通知，异步更新状态 - 退款：按订单号与金额发起微信退款 - 支付记录：完整的支付/退款流水记录与查询
设计特点
✨ 亮点
统一支付入口设计，新增支付渠道无需改动上层业务代码；预支付缓存 + 异步回调，兼顾用户支付体验与系统可靠性。
ARCHITECTURE
模块通用架构特点
所有模块在架构设计上遵循统一规范，具备以下 10 大共同特点
01 标准化分层结构
每个模块均由 4 层子模块组成：api（接口契约）、server（业务核心）、remote（远程暴露）、prd（应用接入）。内部采用 Repository > Server > Remote > Controller 四层代码组织。
02 三种架构模式自由切换
单体架构（本地调用）、微服务架构（Feign）、分布式架构（Dubbo RPC）。通过 @ConditionalOnMissingBean 自动选择实现，一套代码适配三种架构。
03 双端接口分离
prd 下分为 client（C端）和 bms（后台管理端）两个独立子模块，接口独立设计、可独立部署。
04 SaaS 多租户支持
内置 agentId、merchantId 字段，通过统一数据过滤工具自动按租户维度隔离数据。
05 声明式权限控制
BMS 端接口通过 @AuthResource 和 @ResourceController 注解声明菜单与操作权限，与 Auth 模块配合实现完整 RBAC。
06 DDD 领域驱动模型
采用统一的请求参数封装体系：DTO（数据传输）、Param（查询参数）、Request（写操作入参）、Response（结构化返回）。
07 多种 ORM 框架自由选择
支持 MyBatis-Plus、MyBatis-Flex、Hibernate 三种主流 ORM，框架切换仅需调整持久化层，业务层不受影响。
08 通用基础 CRUD 引擎
内置基础增删改查、唯一字段校验、组合唯一校验、SaaS 数据过滤，大幅减少重复代码。
09 自定义二次开发
支持继承扩展、配置覆盖、接口扩展、插件机制（SPI/事件监听）。模块即是成品也是半成品，保留充分定制空间。
10 AI 驱动开发
规范化代码结构、模板化开发模式、清晰接口契约、低耦合模块设计。结合 AI 编程能力，新模块开发效率提升数倍。