# 部署总览

> **当前生产架构**：soul-api（Go + Gin）+ soul-admin（React）+ miniprogram。next-project 仅预览。

---

## 一、核心部署

| 文档 | 说明 |
|------|------|
| [新分销逻辑-部署步骤](新分销逻辑-部署步骤.md) | 新分销上线：备份、迁移、部署、验证 |
| [新分销逻辑-宝塔操作清单](新分销逻辑-宝塔操作清单.md) | 宝塔侧具体操作 |
| [运行与部署](运行与部署.md) | 运行与部署说明 |

---

## 二、环境与配置

| 文档 | 说明 |
|------|------|
| [VIP功能-数据库迁移说明](VIP功能-数据库迁移说明.md) | VIP 排序、角色、vip_roles 表迁移（2026-02-26） |
| [MCP-MySQL配置说明](MCP-MySQL配置说明.md) | MCP 连接 MySQL |
| [Soul-MySQL-MCP配置说明](Soul-MySQL-MCP配置说明.md) | 本项目 MySQL MCP 配置 |
| [API接入说明](API接入说明.md) | 外部/小程序接入 API |
| [宝塔面板配置订单同步定时任务](宝塔面板配置订单同步定时任务.md) | 订单同步定时任务 |

---

## 三、设计与流程（必读）

| 文档 | 说明 |
|------|------|
| [新分销逻辑设计方案](新分销逻辑设计方案.md) | 动态绑定、佣金归属、30天自动解绑 |
| [邀请码分销规则说明](邀请码分销规则说明.md) | 邀请码与分成规则 |
| [分销与绑定流程图](分销与绑定流程图.md) | 分销与绑定流程 |
| [章节阅读付费标准流程设计](章节阅读付费标准流程设计.md) | 阅读页付费流程 |
| [阅读页标准流程改造说明](阅读页标准流程改造说明.md) | 阅读页改造要点 |
| [支付接口清单](支付接口清单.md) | 支付相关接口列表 |
| [提现功能完整技术文档](提现功能完整技术文档.md) | 微信支付商家转账到零钱 API 集成 |
| [分销提现流程图](分销提现流程图.md) | 提现业务流程图（申请→审核→打款→回调） |
| [订阅消息](订阅消息.md) | 提现成功订阅消息（PowerWeChat 示例） |
| [商家转账](商家转账.md) | PowerWeChat RequestTransferBills 调用示例 |

---

## 四、检查与诊断

| 文档 | 说明 |
|------|------|
| [代码逻辑和数据库最终检查清单](代码逻辑和数据库最终检查清单.md) | 上线前检查项 |
| [佣金计算逻辑检查](佣金计算逻辑检查.md) | 佣金逻辑校验 |
| [佣金问题-快速诊断和修复](佣金问题-快速诊断和修复.md) | 佣金问题排查 |