架构与部署蓝图
从平台底座到业务域的部署设计。本文保留架构与原则,完整端口表、仓库清单与内部编号不公开。
1. 分层视图
平台按“Web 接入 → 网关与授权 → 平台/业务服务 → 数据与中间件”分层,业务域不直接暴露给前端。
平台服务与业务服务共享基础设施,但各自拥有独立的数据边界。
2. 应用架构
服务分层
| 层 | 职责 | 说明 |
|---|---|---|
| Web 层 | 页面与静态资源 | Node 20 构建,Nginx 托管;按业务域拆分应用 |
| 接入层 | 统一入口与鉴权 | Gateway 负责路由,授权服务负责身份与权限 |
| 平台层 | 公共能力 | 监控、消息、WebSocket、导出、研发等能力下沉复用 |
| 业务层 | 领域逻辑 | 人力、办公、资产、项目、财务、客户、订单、仓储、物流 |
| 基础层 | 数据与中间件 | MySQL、Redis、RocketMQ、Nacos、Seata、MinIO |
服务边界
- 每个业务域由独立后端服务与 Web 应用组成,前后端分离,独立发布。
- 平台能力不重复下沉到业务域:授权、监控、消息、导出由平台统一提供。
- 同步调用走服务接口,异步解耦走消息;跨域事务使用 Seata 处理,避免业务代码自行拼装分布式事务。
- 服务注册与配置统一使用 Nacos,网关只做路由与入口治理,不承载业务逻辑。
3. 数据架构
一服务一库
每个服务拥有独立数据库,命名按服务域划分,例如 svc_<domain>。业务域之间不直接读写对方数据库。
| 数据类型 | 选型 | 用途 |
|---|---|---|
| 关系数据 | MySQL 8 | 业务主数据与事务数据 |
| 缓存 | Redis | 会话、热点数据、分布式锁 |
| 消息 | RocketMQ | 异步事件、削峰、最终一致性 |
| 对象存储 | MinIO | 文件、附件、导出产物 |
| 事务协调 | Seata | 跨服务事务边界 |
边界原则
- 数据归属服务:谁写入,谁负责模型与迁移。
- 跨域查询通过接口或消息,不在数据库层做跨库关联。
- 报表与数仓作为后续独立层建设,不反向侵入业务库。
- 分布式事务只覆盖必要的强一致场景,其余场景优先使用消息与补偿。
4. 技术架构
| 层次 | 选型 |
|---|---|
| 接入 | Nginx、Gateway |
| 应用 | Java 8、Spring Cloud Alibaba、Nacos、Seata |
| 消息 | RocketMQ |
| 数据 | MySQL 8、Redis、MinIO |
| 前端 | Node 20、Nginx |
| 交付 | Docker、Nexus 制品库、Torna 接口文档 |
选型原则:成熟优先于新潮,简单优先于复杂,开源优先于自研;版本保持收敛,避免同一能力引入多套组件。
5. 部署拓扑
部署按四组划分:
| 组 | 内容 |
|---|---|
| 基础服务 | MySQL、Redis、RocketMQ、Nacos、Seata、MinIO 及支撑服务 |
| 平台服务 | 网关、授权、监控、消息、WebSocket、导出、研发 |
| 业务服务 | 职能域与业务域后端服务 |
| Web 服务 | 各业务域前端应用,统一由 Nginx 托管 |
初期采用单节点 Docker 部署,降低环境与运维成本;端口按服务类型分段规划,前端使用相邻端口,便于部署与排查。实际规划中存在少量越界,后续需要收敛。
6. 关键取舍
| 决策 | 收益 | 代价 | 后续 |
|---|---|---|---|
| 单节点起步 | 成本低、上线快 | 可用性有限 | 按域扩展节点与高可用 |
| 一服务一库 | 边界清晰、故障隔离 | 跨域查询与事务复杂 | 接口、消息、独立报表层 |
| 平台能力下沉 | 复用、统一治理 | 平台成为关键路径 | 平台服务优先保障可用性 |
| 端口分段 | 部署直观、易排查 | 服务增多后容易越界 | 收敛端口规划 |
| 前后端分离 | 独立发布、职责清晰 | 部署单元增多 | 统一网关与静态托管 |
7. 公开边界
本文只保留解释架构所需的内容:
- 公开:分层、业务域、技术栈、部署拓扑、关键取舍、上线状态。
- 不公开:完整端口表、内部仓库清单、模块编号、环境配置与凭据、客户或前雇主信息。
完整的部署设计保留在内部参考资料中,用于其他项目复用;公开方案只做脱敏派生。