网站模块集成说明（servers 分支）
适用读者
需要把 门户网站 / CMS 与 管理端 放在同一套 servers 分支工程里联调时使用本文。
与主仓对齐（扩展工作区）
门户网站 / 全端对外 API 默认为双进程：mms/mms-admin（8080） + mms-open-api.jar（8060，mms-plugin-open-api），共享 mms.plugin.root-dir，见 version/v2.0.19-管理端与8060开放API双进程路线A.md（v2.0.16 为历史备忘）。历史 mms-api-unxt 已删除。若仍使用 servers 老布局，门户网站后台 Java 可能在 mms-servers/mms-cms；管理端 mms-admin 通过依赖 mms-cms 引入网站后台能力。
脚手架精简版主仓
若你本地的 mms 根 pom.xml 只有 mms-admin / mms-modules / mms-zoom（无 mms-servers），则属于 管理端脚手架 布局，无需按本文集成网站后台；请从 项目简介、项目导入与启动 入门。
文档/前端子模块
在线文档在子模块 mms-doc；管理端前端 mms-ui；门户网站 PC 端前端 在子模块 mms-unxt（仅前端，与已移除的 Java 模块 mms-api-unxt 不同）；全端开放接口 默认在 mms-open-api.jar（8060）（与 mms-unix 移动端子模块联调）。
一、获取代码
- 克隆主仓
servers分支
git clone -b servers --single-branch https://gitee.com/mmsAdmin/mms.git
cd mms- 初始化子模块（含文档、mms-ui、mms-unxt 等）
git submodule update --init --recursive按需强制同步远程子模块引用时，可使用：
git submodule update --init --recursive --force[Git命令扩展]
-b 是 --branch 的简写，指定要克隆的分支名称为 doc，不指定默认检出 主分支 master/main
--single-branch 只克隆指定的单个分支，减少克隆时间和磁盘空间占用
-c credential.helper= 时禁用 Git 的凭证存储功能
=后为空表示清空该配置，不使用任何凭证助手。--remote 直接拉取子模块远程仓库的最新提交 (
.gitmodules中指定的分支仓库)--recursive 递归更新所有嵌套子模块（子模块内的子模块）
git submodule init 子模块初始化
git submodule init mms-docs 初始化特定子模块（如 mms-docs）
git submodule update 拉取/更新子模块
git submodule update --init 初始化+拉取一步完成
git submodule update mms-docs 拉取特定子模块
git submodule update --remote 跟踪 .gitmodules中指定的分支仓库拉取
git submodule update --init --recursive 处理嵌套子模块
git branch 查看当前分支
git remote -v 查看远程连接
git fetch --all 获取所有分支信息（不下载内容）
git checkout master 切换到新分支（如 master）
git pull origin <分支名> 默认分支可以省略origin <分支名>
git status 查看文件状态
git add mms-docs 添加暂存区 git add ./*
git commit -m "更新子模块" 提交到本地仓库
git push [远程仓库] [本地分支]:[远程分支] 提交到远程仓库
git push origin dev 推送当前分支到远程的dev分支
git push --force origin dev 强制覆盖远程 dev 分支
二、主工程模块（与旧版对比）
标准 servers 主仓 不再使用 独立目录 mms-websites，也不在父 pom.xml 中增加 mms-website-admin / mms-website-api 依赖。对应关系如下：
| 历史名称 | 当前（servers） |
|---|---|
mms-website-admin | mms-servers → mms-cms |
mms-website-api / mms-websites | mms-plus：mms-admin（8080） + mms-plugin-open-api（8060），见 v2.0.19；老仓 mms-servers + mms-cms 以各自主 pom 为准 |
| 网站 PC 前端（原多仓之一） | 子模块 mms-unxt |
mms-plus 根工程顶层常见仅有 mms-plugins（开放 API 构建物为 mms-plugin-open-api）；含 mms-servers 的老主仓以各自 modules 为准。
三、管理端引入网站后台能力
网站后台已与 CMS 合并进 mms-cms。聚合后台 mms-admin 的 pom.xml 中已包含对 mms-cms 的依赖，拉取主仓并刷新 Maven 后即可；若你在自有裁剪主工程中手工接入，可参考：
<dependency>
<groupId>com.sxpcwlkj</groupId>
<artifactId>mms-cms</artifactId>
<version>${revision}</version>
</dependency>（需先在父工程 dependencyManagement 中管理 mms-servers 子模块各 artifact 的版本，与官方主 pom.xml 保持一致。）
四、IDEA 中识别 Maven 工程
将 mms 与（若使用插件 / C 端）mms-plus 一并导入 Maven，确保 mms-admin、mms-modules 及 mms-plugins/* 等模块均被识别；无需再将某个 mms-websites 文件夹单独标为 Maven 模块。
示例：
