79 lines
2.9 KiB
Markdown
79 lines
2.9 KiB
Markdown
|
# 系统架构
|
|||
|
|
|
|||
|
|
**我是卡若。**
|
|||
|
|
|
|||
|
|
架构不是为了画图好看，是为了**省事**和**赚钱**。
|
|||
|
|
|
|||
|
|
我们的架构设计，核心围绕两个字：**分离**。
|
|||
|
|
- 内容和代码分离。
|
|||
|
|
- 前端和后端分离（已落地：soul-api + soul-admin + 小程序）。
|
|||
|
|
- 静态和动态分离。
|
|||
|
|
|
|||
|
|
## 1. 架构全景图（当前）
|
|||
|
|
|
|||
|
|
\`\`\`mermaid
|
|||
|
|
graph TD
|
|||
|
|
subgraph "内容生产 (Content)"
|
|||
|
|
Typora[本地写作] --> Git[Git 仓库]
|
|||
|
|
Git --> AutoSync[自动同步]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph "后端 (soul-api - Go)"
|
|||
|
|
API[Gin API /api/*]
|
|||
|
|
API --> GORM[GORM]
|
|||
|
|
GORM --> MySQL[(MySQL)]
|
|||
|
|
AutoSync --> FileSys[文件/配置]
|
|||
|
|
FileSys --> API
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph "前端"
|
|||
|
|
Admin[soul-admin React+Vite]
|
|||
|
|
Mini[微信小程序]
|
|||
|
|
Admin --> API
|
|||
|
|
Mini --> API
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph "用户触达"
|
|||
|
|
Mini --> Wechat[微信]
|
|||
|
|
Admin --> Browser[浏览器]
|
|||
|
|
end
|
|||
|
|
\`\`\`
|
|||
|
|
|
|||
|
|
## 2. 当前项目分工
|
|||
|
|
|
|||
|
|
| 层级 | 项目 | 技术 | 说明 |
|
|||
|
|
|------|------|------|------|
|
|||
|
|
| **后端** | soul-api | Go 1.25 + Gin + GORM + MySQL | 提供全部 `/api/*`，路径与现网一致，响应 camelCase |
|
|||
|
|
| **管理端** | soul-admin | React 18 + Vite 6 + TS + Tailwind + Radix UI | SPA，`VITE_API_BASE_URL` 指向 soul-api |
|
|||
|
|
| **C 端** | miniprogram | 微信小程序原生 | 阅读、购买、分销、提现，请求/响应 camelCase |
|
|||
|
|
| **备用** | next-project | Next.js | 原单体，可保留 app/api 过渡或逐步下线 |
|
|||
|
|
|
|||
|
|
## 3. 核心设计理念
|
|||
|
|
|
|||
|
|
### 3.1 “内容即产品”
|
|||
|
|
核心资产是内容（书籍章节、配置）。文章用 Markdown/数据库存，Git 或脚本同步，安全可控。
|
|||
|
|
|
|||
|
|
### 3.2 前后端已分离
|
|||
|
|
- **后端**：soul-api（Go）独立部署，可单独扩容、多端复用。
|
|||
|
|
- **管理端**：soul-admin 纯静态 SPA，部署到任意静态托管或 CDN。
|
|||
|
|
- **接口契约**：路径不变，请求/响应字段统一 **camelCase**，详见 [前后端架构分离策略](前后端架构分离策略.md)。
|
|||
|
|
|
|||
|
|
### 3.3 极简部署
|
|||
|
|
- 后端：Go 二进制 + 环境变量，或 Docker 单容器。
|
|||
|
|
- 管理端：`npm run build` 后部署到 Nginx/Vercel/OSS。
|
|||
|
|
- 小程序：微信后台发布。宝塔/Webhook 可按需做自动拉代码。
|
|||
|
|
|
|||
|
|
## 4. 关键约束
|
|||
|
|
|
|||
|
|
1. **API 字段统一**：对外一律 camelCase（如 `userId`、`createdAt`）；数据库列名保持 snake_case 仅在服务端使用。
|
|||
|
|
2. **本地优先**：写作与开发在本地，通过 soul-api 连接数据库。
|
|||
|
|
3. **单向流动**：数据流向 `内容/配置 -> API -> 前端`；订单、用户等由 API 写库。
|
|||
|
|
|
|||
|
|
## 5. 详细技术栈
|
|||
|
|
|
|||
|
|
详见：**[技术选型与全景图](技术选型与全景图.md)**、**[前后端架构分离策略](前后端架构分离策略.md)**。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
**总结：**
|
|||
|
|
当前已实现前后端分离：soul-api 负责接口与数据，soul-admin 负责管理后台，小程序负责 C 端。保持接口路径与字段规范统一，便于多端对接与扩展。
|