技术体系与部署方式

CusMall 系统架构

基于 Java 与 Spring Cloud 的商城微服务架构,结合多端独立运行时与不可变交付,支持私有化部署、持续二次开发和长期升级。
查看部署架构
架构原则

减少兼容分支,保持边界与事实来源清晰

当前基线以新项目为前提,只维护一条框架、路由、数据和交付路径。

01

四套独立前端

四套独立前端

运营端、移动买家端、PC 买家端与商家工作台按各自运行时独立构建,通过 HTTP 契约保持业务一致。

02

领域微服务

领域微服务

Gateway、Auth、UPMS、Mall、Pay、Weixin 与 Live 等服务按业务所有权拆分。

03

租户与站点隔离

租户与站点隔离

租户上限、经营站点、Host 路由、用户与交易资源在服务端建立明确边界。

04

不可变交付

不可变交付

源码、镜像、迁移、素材、SBOM 与安装验证绑定同一提交和发布清单。

部署与交付

同一版本同时交付源码、数据与运行证据

01

数据与凭据自持

业务数据库、对象存储和实例凭据部署在客户确认的环境,真实配置不进入源码。

02

新装即最终状态

全新数据库直接表示当前结构,存量升级由带 checksum 的不可变迁移账本推进。

03

多端可独立演进

PC 采用 Nuxt 4 SSR,移动与商家端采用 uni-app,不以共享运行包牺牲渠道能力。

04

发布证据可追溯

运行制品记录版本、Git SHA、镜像摘要、组件版本、SBOM 与安装验收结果。

部署架构

从四套前端到领域服务与数据底座

标准部署运行八个常驻后端服务、PC Nitro 与 Nginx;codegen 和 monitor 按工具 profile 启用。

实施流程

从环境确认到验收交付

  1. 01

    需求确认

    确认网络、域名、证书与外部服务条件

  2. 02

    环境准备

    准备服务器、数据库、中间件与访问权限

  3. 03

    部署联调

    完成服务部署、接口配置与业务联调

  4. 04

    验收交付

    按确认清单完成验证、资料与源码交付

CusMall 当前 Vue 3 管理端菜单与权限界面
管理端与服务治理

界面、权限和服务端边界同步演进

运营管理端已经统一到 Vue 3、Vite、TypeScript 与 Quill 2;页面可见权限不能替代服务端鉴权和租户校验。

  • 角色导航、按钮权限与数据范围共同校验
  • 门户接口显式分类,未登记接口默认不公开
  • Actuator、Prometheus 与 OpenTelemetry 统一继承
  • 交易、支付与退款使用幂等状态迁移和可靠补偿
买家端运行时

PC SSR 与移动 uni-app 分别交付

PC 使用 Nuxt 4 与 Nitro 输出语义化公开路由和服务端首屏;移动端继续面向 H5、小程序与 App。两端共享 HTTP 契约,不共享运行包。

CusMall 当前 Nuxt 4 PC 商城界面
常见问答

关于部署与系统架构

是否支持私有化部署?

支持按项目进行私有化部署。部署拓扑、服务器规格、网络、域名、证书和外部服务条件需要结合实际业务确认。

系统可以部署在现有云环境吗?

可以评估。需要先确认操作系统、容器环境、数据库、中间件、网络访问与安全要求,再形成具体部署方案。

能否对接企业现有系统?

可以评估 ERP、WMS、财务、会员、支付、物流等系统接口,实施前需明确数据归属、同步方向、频率与异常处理方式。

是否保留 Spring Boot 3 或旧 PC 前端作为兜底?

不保留。CusMall 2.0 只维护 Java 21、Spring Boot 4 与 Nuxt 4 SSR 当前基线,不提供旧框架、旧路由或旧数据格式的双运行分支。

页面中的架构是否等同于最终容量方案?

页面展示当前标准产品拓扑。节点数量、资源规格、备份、可用性和外部服务仍需根据业务规模与验收目标设计。

结合现有基础设施确认部署方案

说明业务规模、现有系统、网络与运维要求,再评估具体拓扑和实施范围。