ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

mall-swarm 功能结构全解析:后台五大核心模块与前台商城系统源码级详解

mall-swarm 功能结构全解析:后台五大核心模块与前台商城系统源码级详解 后端电商微服务API网关【免费下载链接】mall-swarmmall-swarm是一套微服务商城系统采用了 Spring Cloud Alibaba、Spring Boot 3.5、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。项目地址https://gitcode.com/gh_mirrors/ma/mall-swarm点击查看免费下载导读本文以mall-swarm仓库中的功能结构说明文档document/reference/function.md为主线逐模块拆解这套微服务商城系统的完整功能地图后台管理系统涵盖商品、订单、促销、内容、用户五大管理域前台商城系统则面向 C 端用户提供首页、搜索、购物车、下单与会员服务。读完本文你将掌握每个功能域背后的 Controller 入口、核心业务能力与在仓库中的对应源码位置可直接对照 mall-admin 与 mall-portal 模块的代码进行二次开发或功能扩展。一、功能结构总览后台管业务、前台管交易mall-swarm在电商业务的基础上集成了注册中心、配置中心、监控中心、网关等微服务系统功能业务侧则严格划分为两个子系统详见 README.md 中的组织结构后台管理系统mall-admin服务面向运营与管理员负责商品、订单、促销、内容、用户等后台管理功能前端配套 Vue 项目mall-admin-web前台商城系统mall-portal服务面向消费者负责首页内容、商品检索、购物车、下单支付、会员中心等交易链路功能前端配套mall-app-web移动端项目。仓库中的 document/mind 目录存放了与各功能域一一对应的思维导图源文件pms.emmx商品、oms.emmx订单、sms.emmx促销、cms.emmx内容、ums.emmx用户、home.emmx首页、app.emmx前台应用完整展示了各模块的功能点树状结构而 document/sql/mall.sql 则提供了全量数据库表结构与下文各模块的 Mapper 模型一一对应。下面按照原文档的章节顺序对每个功能域进行源码级展开。二、后台管理系统商品管理商品管理是电商后台最核心的模块对应数据库表前缀pms_Product Management System所有后端能力集中在mall-admin模块下com.macro.mall.controller包的Pms*Controller系列中。商品 CRUD 与批量状态操作核心入口是 PmsProductController.java路由前缀/product围绕商品主数据提供功能点接口说明创建商品POST /product/create接收PmsProductParam一次写入商品主表、SKU、属性、阶梯价、满减等多张表商品编辑回显GET /product/updateInfo/{id}返回PmsProductResult聚合编辑信息更新商品POST /product/update/{id}全量更新商品及其关联数据分页查询GET /product/list支持PmsProductQueryParam组合条件默认每页 5 条模糊查询GET /product/simpleList按商品名称或货号模糊匹配批量审核POST /product/update/verifyStatus批量修改审核状态并记录审核意见批量上下架POST /product/update/publishStatus上架/下架控制批量推荐 / 新品POST /product/update/recommendStatus、POST /product/update/newStatus控制商品在首页的推荐位与新品位批量删除POST /product/update/deleteStatus逻辑删除修改删除状态其中商品创建/更新涉及的多表写入逻辑可在 PmsProductServiceImpl.java 中看到它对PmsProductAttributeValue、PmsSkuStock、PmsProductLadder、PmsProductFullReduction等模型见 mall-mbg 的model目录的协同操作。商品分类、品牌、属性与 SKU商品管理域还包括四个独立的管理入口分别对应数据库pms_brand、pms_product_category、pms_product_attribute、pms_sku_stock等表品牌管理PmsBrandController.java品牌增删改查、按首字母检索、批量上下架品牌推荐位商品分类管理PmsProductCategoryController.java支持父子层级分类parentId形成树形结构可配置分类属性筛选商品属性管理PmsProductAttributeController.java 与 PmsProductAttributeCategoryController.java管理属性类型规格参数/销售属性及属性分类前台 SKU 的生成依赖这套数据SKU 库存管理PmsSkuStockController.java按商品查询库存、批量修改库存数量、按 SKU 编码模糊查询。三、后台管理系统订单管理订单管理对应数据库表前缀oms_Order Management System核心入口是 OmsOrderController.java路由前缀/order功能点接口说明订单查询GET /order/list按OmsOrderQueryParam订单编号、收货人、订单状态等分页检索批量发货POST /order/update/delivery接收OmsOrderDeliveryParam列表批量填物流单号批量关闭订单POST /order/update/close关闭超时未支付等订单并附备注批量删除POST /order/delete逻辑删除订单订单详情GET /order/{id}返回OmsOrderDetail聚合订单信息、商品信息与操作记录修改收货人POST /order/update/receiverInfo修改收货地址信息修改费用POST /order/update/moneyInfo修改订单金额相关字段订单备注POST /order/update/note修改订单备注并记录操作日志订单域还包含三个配套管理模块退货申请处理OmsOrderReturnApplyController.java退货申请的分页查询、详情查看、审核同意/拒绝、确认收货等售后全流程退货原因设置OmsOrderReturnReasonController.java前台发起退货时可选原因的管理订单设置OmsOrderSettingController.java配置未支付订单超时时间、收货后超时时间等业务规则对应oms_order_setting表公司收货地址OmsCompanyAddressController.java管理发货地址库供订单发货时选用。与订单相关的查询聚合逻辑位于 OmsOrderServiceImpl.java其通过 OmsOrderDao.java 完成多表联查订单操作记录的写入则由 OmsOrderOperateHistoryDao.java 支撑。四、后台管理系统促销管理促销管理对应数据库表前缀sms_Sales Marketing System是 mall 系电商的特色模块覆盖优惠券、限时购、首页营销位三大块。优惠券体系优惠券管理SmsCouponController.java优惠券的创建SmsCouponParam支持关联适用商品或商品分类、删除、修改、按名称/类型分页查询优惠券领取记录SmsCouponHistoryController.java查询会员领取与使用历史可手动发放优惠券。优惠券的适用商品与分类关系分别落在sms_coupon_product_relation、sms_coupon_product_category_relation表对应 SmsCouponDao.java 中的聚合查询实现。限时购活动限时购活动SmsFlashPromotionController.java活动本身的增删改查与上下线控制限时购场次SmsFlashPromotionSessionController.java一天内多个秒杀场次如 10 点场、14 点场的管理限时购与商品关联SmsFlashPromotionProductRelationController.java配置每个场次参与秒杀的商品、秒杀价格与限购数量其查询结果通过 SmsFlashPromotionProductRelationDao.java 联查商品信息。首页营销位首页营销内容由 5 个SmsHome*Controller支撑分别管理轮播广告、品牌推荐、新品推荐、人气推荐与专题推荐SmsHomeAdvertiseController.java首页轮播广告位SmsHomeBrandController.java首页品牌推荐SmsHomeNewProductController.java新品推荐位SmsHomeRecommendProductController.java人气推荐位SmsHomeRecommendSubjectController.java专题推荐位。这些营销位数据正是前台首页各推荐列表的数据来源形成了后台配置、前台展示的闭环。五、后台管理系统内容管理内容管理对应数据库表前缀cms_Content Management System主要承载商城的内容运营素材商品专题管理CmsSubjectController.javaGET /subject/listAll获取全部专题、GET /subject/list按名称分页查询专题是前台首页内容聚合如HomeController的/home/subjectList与专题推荐位的数据源优选专区管理CmsPrefrenceAreaController.java管理优选专区内容专区与商品的关联通过cms_prefrence_area_product_relation表维护见 CmsPrefrenceAreaProductRelationDao.java。内容域对应的 Mapper 模型CmsSubject、CmsPrefrenceArea等可在 mall-mbg/src/main/java/com/macro/mall/model 中查看服务层实现位于 CmsSubjectServiceImpl.java 与 CmsPrefrenceAreaServiceImpl.java。六、后台管理系统用户管理用户管理对应数据库表前缀ums_User Management System涵盖管理员账号、角色权限与会员等级三大体系。后台账号与权限Sa-Token 鉴权核心入口是 UmsAdminController.java路由前缀/admin用户注册POST /admin/register、登录POST /admin/login返回 Sa-Token TokentokenHead前缀取自sa-token.token-prefix配置获取当前登录用户信息GET /admin/info返回用户名、菜单树roleService.getMenuList、角色列表与头像用户列表分页、增删改、修改密码区分参数不合法/用户不存在/旧密码错误等返回码帐号状态启停POST /admin/updateStatus/{id}用户-角色分配POST /admin/role/update与角色查询GET /admin/role/{adminId}。配套的权限基础设施包括角色管理UmsRoleController.java角色 CRUD 及角色-菜单、角色-资源分配菜单管理UmsMenuController.java动态菜单树的维护返回UmsMenuNode树结构前端据此渲染侧边栏资源管理UmsResourceController.java 与 UmsResourceCategoryController.java后台接口资源的登记与分类配合网关侧 StpInterfaceImpl.java 实现基于 Sa-Token 的接口级权限校验。会员等级UmsMemberLevelController.java 管理会员等级定义如普通会员、黄金会员等对应ums_member_level表是前台下单时积分/折扣计算的重要依据。七、前台商城系统前台商城系统对应mall-portal服务路由集中在com.macro.mall.portal.controller包面向消费者提供完整的购物链路。首页内容聚合HomeController.java 聚合了首页所需的全部分区数据GET /home/content一次性返回HomeContentResult含轮播广告、秒杀信息、新品、人气推荐、品牌推荐、专题推荐等聚合内容GET /home/recommendProductList分页获取推荐商品默认每页 4 条GET /home/productCateList/{parentId}按父分类获取商品分类列表GET /home/subjectList按分类获取专题GET /home/hotProductList/GET /home/newProductList人气与新品推荐默认每页 6 条。这些接口的数据源正是上文后台首页营销位模块配置的数据聚合逻辑在 HomeServiceImpl.java 中通过 HomeDao.java 完成多表联查。商品搜索与详情PmsPortalProductController.java 提供 C 端商品能力GET /product/search综合搜索、筛选与排序sort参数语义为0按相关度、1按新品、2按销量、3价格从低到高、4价格从高到低GET /product/categoryTreeList返回PmsProductCategoryNode树形商品分类GET /product/detail/{id}返回PmsPortalProductDetail聚合详情基本信息、属性、规格、促销信息等。购物车OmsCartItemController.java 以当前登录会员为维度管理购物车添加商品、获取购物车列表、获取含促销信息的购物车列表GET /cart/list/promotion返回CartPromotionItem计算满减/优惠券优惠、修改数量、重选规格GET /cart/getProduct/{productId}、删除与清空。促销计算的核心算法在 OmsPromotionServiceImpl.java 中实现。下单与支付订单提交OmsPortalOrderController.java确认订单OrderParam、生成订单含库存锁定与促销优惠计算、取消超时订单配合 CancelOrderReceiver.java 的 RabbitMQ 延时队列消息与 OrderTimeOutCancelTask.java 定时任务兜底支付宝支付AlipayController.java支付下单、支付结果异步回调处理退货申请OmsPortalOrderReturnApplyController.java消费者发起售后申请。会员中心与增值功能会员登录注册UmsMemberController.java手机验证码注册/登录GET /sso/getAuthCode、登录返回 Sa-Token Token、获取会员信息、修改密码收货地址UmsMemberReceiveAddressController.java地址簿的增删改查与默认地址设置会员优惠券UmsMemberCouponController.java领券、可用/已用/过期优惠券列表、下单时获取可用优惠券商品收藏MemberProductCollectionController.java 与品牌关注MemberAttentionController.java基于 MongoDBRepository 层见 repository实现收藏与关注浏览历史MemberReadHistoryController.java基于 MongoDB 记录商品浏览历史。前台商城还有独立的搜索服务mall-search基于 Elasticsearch 实现商品搜索EsProductController.java提供从数据库导入 ES、综合搜索按关键字/品牌/分类/价格区间/排序等功能是对mall-portal商品搜索的工程化替代方案。八、功能地图速查模块与服务对照功能域后台服务模块前台服务模块主要表前缀核心 Controller商品管理mall-adminmall-portal / mall-searchpms_PmsProductController 等订单管理mall-adminmall-portaloms_OmsOrderController、OmsPortalOrderController促销管理mall-adminmall-portalsms_SmsCouponController、SmsFlashPromotionController 等内容管理mall-adminmall-portalcms_CmsSubjectController、HomeController用户管理mall-adminmall-portalums_UmsAdminController、UmsMemberController会员增值—mall-portalMongoDB 集合MemberProductCollectionController 等由此可以看出mall-swarm的功能架构遵循后台配置mall-admin→ 前台消费mall-portal的清晰分层后台五大管理域负责业务数据的生产与运营配置前台商城系统负责将这些数据转化为 C 端购物体验。读者在定位任意功能时可按数据库表前缀 → mall-mbg 模型 → mall-admin/mall-portal Controller → Service 实现的四步路径快速溯源这也是基于本文功能地图进行二次开发的最实用方法。赞分享后端电商微服务API网关【免费下载链接】mall-swarmmall-swarm是一套微服务商城系统采用了 Spring Cloud Alibaba、Spring Boot 3.5、Sa-Token、MyBatis、Elasticsearch、Docker、Kubernetes等核心技术同时提供了基于Vue的管理后台方便快速搭建系统。mall-swarm在电商业务的基础集成了注册中心、配置中心、监控中心、网关等系统功能。项目地址https://gitcode.com/gh_mirrors/ma/mall-swarm点击查看免费下载相关推荐mall-swarm 微服务商城功能结构全解后台五大模块与前台商城系统功能清单mall swarm 微服务商城功能结构全解后台五大模块与前台商城系统功能清单 mall swarm 是基于 Spring Cloud Alibaba 的微服后端微服务电商API网关mall 电商系统功能结构全解后台管理系统与前台商城系统模块深度剖析mall 电商系统功能结构全解后台管理系统与前台商城系统模块深度剖析 本篇指南基于 mall 项目的 功能结构说明文档 https://link.gitcod后端电商认证鉴权搜索引擎mall 电商项目功能结构全解析后台管理系统与前台商城系统的模块化设计mall 电商项目功能结构全解析后台管理系统与前台商城系统的模块化设计 导读 本文以 mall 项目官方文档 function.md https://link后端电商搜索引擎创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表