# 部署指南
本页说明 G2rain 平台本身如何部署与交付。
# 平台部署思路
G2rain 的部署不是单纯把程序跑起来，而是要把平台、业务能力、前端主壳、子应用和工程化工具放到同一套交付逻辑里。
这样做的好处是：
- 入口统一，便于接入网关、鉴权和审计
- 初始化统一，便于租户和应用快速开通
- 更新统一，便于控制版本、配置和依赖
- 业务扩展独立，便于不同仓库按职责拆分
# 平台部署的组成部分
# 基础中间件
平台运行通常依赖数据库、缓存、消息队列、对象存储、注册中心等基础组件。具体选型会随环境而变化，但部署目标是一致的：让平台核心服务、业务扩展和前端交互都能稳定依赖这些基础设施。
# 平台核心模块
核心模块通常包含认证、权限、部门、审计、网关、平台配置等能力。它们更接近平台底座，优先保障可用性和可观测性。
# 前端主壳与子应用
前端通常采用主壳 + 子应用方式部署。主壳负责统一导航、权限和运行容器，子应用负责各自业务页面和交互流程。
# 业务扩展片段
业务扩展模块一般作为独立仓库演进，例如 CRM、CMS、部门能力、交付能力或其他领域业务。它们通过平台的应用、权限和资源体系接入，而不是重新造一套入口。
# 典型部署链路
# 1. 环境准备
先准备基础环境，再准备平台依赖组件。部署环境应尽量与目标租户的运行环境保持一致，避免开发环境和生产环境出现行为差异。
# 2. 平台初始化
初始化阶段通常包括数据库建表、基础字典、默认角色、默认应用、基础资源和初始配置。
# 3. 平台启动
平台启动后，先验证网关、鉴权、平台管理端和主壳能否正常联通，再逐步接入业务子应用。
# 4. 平台更新
更新时建议先更新基础能力，再更新业务能力，最后更新前端与页面资源。这样可以把影响范围控制在最小。
# 平台部署为什么要这样设计
因为 G2rain 的目标不是单纯交付一个系统，而是交付一套可持续演进的企业 SaaS 平台。
部署方式必须支持：
- 多租户环境下的统一治理
- 业务能力的按需启用和停用
- 前后端分离后的独立发布
- 平台能力和业务能力的边界清晰