企业级微服务管理系统产品系统

在企业数字化转型与系统拆分过程中，大量中后台项目面临「多系统各自为政、接口不统一、鉴权分散、联调成本高、新服务接入规范不一」等痛点，尤其在零售、电商、政企信息化、SaaS 运营等场景中，订单、用户、商品、组织主数据往往分布在多个子系统，需要统一网关入口、标准认证与可观测的跨服务协作能力。本项目面向上述 微服务化建设与团队交付 背景，提供一套可快速落地的 Spring Cloud 技术底座与端到端演示环境：通过网关统一鉴权与路由，降低前后端与各服务对接复杂度；以完整下单链路示范「认证—查询—编排—落库—异步通知」的典型业务协作模式；并以公司、部门、用户、产品、订单、档案等模块演示主数据与文件类业务的增删改查，支持无数据库的轻量部署，便于 POC 验证、技术培训、架构评审与二次开发。因此，它适合作为企业微服务脚手架、投标/接单技术样例、新人上手工程，以及从单体向分布式演进前的方案验证平台，帮助团队缩短「搭环境、定规范、跑通链路」的周期，降低重复造轮子与联调排障成本。

本项目为 Spring Cloud 微服务演示与管理平台，按认证、网关、系统、业务分层建设，并提供前后端一体演示入口。 认证模块（cloud-auth） 提供演示登录与 JWT 签发，支撑全站统一鉴权。 网关模块（cloud-gateway） 承担统一入口、路由转发、跨域与 Token 校验，并托管登录页、管理后台与 API 联调页；同时提供档案管理，支持档案元数据维护及文件/图片上传、下载与预览，数据落盘至本地目录。 系统模块（cloud-system） 维护演示用户与商品（SKU）价格信息，为业务查询与 Feign 远程调用提供数据源。 业务模块（cloud-business） 实现跨服务下单链路（校验买家身份、聚合用户与商品价格、生成订单并异步通知），并提供公司、部门、用户、产品、订单等主数据的增删改查，演示数据以 JSON 文件持久化至项目目录，无需数据库即可运行。 公共模块（cloud-common） 统一封装返回体、异常处理、用户上下文、链路追踪与分层基类规范。整体支持单机直连与 Nacos 注册中心两种部署方式，适用于微服务架构学习、方案验证与二次开发脚手架。

本项目为基于 JDK 21、Spring Boot 3.3、Spring Cloud 2023 与 Spring Cloud Alibaba 的企业级微服务脚手架与联调演示平台，采用 Maven 多模块 拆分 cloud-common（统一返回体、全局异常、JWT、用户上下文、异步线程池）、cloud-gateway（Spring Cloud Gateway 路由转发、JWT 全局鉴权、CORS、链路头透传）、cloud-auth（登录签发 Token）、cloud-system（用户/商品数据源）、cloud-business（订单编排与主数据管理）五层架构。整体支持 单机直连固定端口 与 Nacos 注册中心 两种部署模式，业务侧通过 OpenFeign + LoadBalancer 跨服务调用，网关统一校验 JWT 并下发 X-Login-User-Id，配合 X-Trace-Id 与 Logback MDC 实现可追踪联调；接口层遵循 Controller → Service → Converter → Handler → Persistence 分层规范，Feign 与异步调用收口在 Handler，对象转换集中在 Converter，禁止 Lombok/MapStruct，强调可维护性与规范统一。

架构亮点在于：网关与业务解耦、公共能力下沉 common 模块；下单链路完整演示「网关鉴权 → 业务校验 → Feign 聚合用户与价格 → 转换落库 → 异步通知」的真实微服务协作；同时提供 前后端一体演示站（登录、管理后台、API 联调页），以及公司/部门/用户/产品/订单等 无数据库 JSON 文件持久化 CRUD、网关侧 档案文件上传下载，降低演示与环境搭建成本。Knife4j 文档、Actuator 健康检查、统一 Result 与业务异常码亦便于对