94 lines
3.6 KiB
Markdown
94 lines
3.6 KiB
Markdown
|
# 内容创建问题修复说明
|
|||
|
|
|
|||
|
|
> 问题：souladmin 添加内容后显示「创建成功」，但目录和数据库未增加，前端也未显示。
|
|||
|
|
|
|||
|
|
## 根因分析
|
|||
|
|
|
|||
|
|
1. **两套后台数据源不一致**
|
|||
|
|
- souladmin.quwanzhi.com 调用 soulapi.quwanzhi.com（Go API）
|
|||
|
|
- soul.quwanzhi.com/admin 使用 Next.js API，list 此前仅从 bookData（静态）读取
|
|||
|
|
- 新建章节写入数据库，但 list 不查库，导致新建内容不显示
|
|||
|
|
|
|||
|
|
2. **PUT 创建未完整支持 partId/chapterId**
|
|||
|
|
- 新建章节时 partId、chapterId、partTitle、chapterTitle 未正确写入数据库
|
|||
|
|
|
|||
|
|
## 已做修复
|
|||
|
|
|
|||
|
|
### 1. 修改 `/api/db/book` list 接口
|
|||
|
|
- **原逻辑**：仅从 bookData 读取
|
|||
|
|
- **现逻辑**：优先从数据库 chapters 表读取，再与 bookData 合并
|
|||
|
|
- **效果**：新建章节会立即出现在列表中
|
|||
|
|
|
|||
|
|
### 2. 修改 PUT 接口支持新建章节
|
|||
|
|
- 支持 body 传入 `partId`、`chapterId`、`partTitle`、`chapterTitle`、`isFree`
|
|||
|
|
- 新建章节能正确写入数据库
|
|||
|
|
|
|||
|
|
### 3. 在 book-data 中新增 9.15
|
|||
|
|
- 章节 ID: 9.15
|
|||
|
|
- 标题: 第102场｜今年第一个红包你发给谁
|
|||
|
|
- 文件: book/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/9.15 第102场｜今年第一个红包你发给谁.md
|
|||
|
|
|
|||
|
|
### 4. soul-admin 改用 soul.quwanzhi.com 作为 API
|
|||
|
|
- 修改 soul-admin 的 API 基址：soulapi → soul.quwanzhi.com
|
|||
|
|
- 在 Next.js 中为 souladmin.quwanzhi.com 配置 CORS
|
|||
|
|
|
|||
|
|
## 部署步骤
|
|||
|
|
|
|||
|
|
### 步骤 1：部署 soul 主站（小型宝塔）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
|
|||
|
|
# 按 .cursorrules 中的流程执行
|
|||
|
|
pnpm build
|
|||
|
|
# 然后执行部署脚本
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤 2：同步 9.15 到数据库
|
|||
|
|
|
|||
|
|
部署后访问 soul.quwanzhi.com/admin，在内容管理页面点击「同步到数据库」，将包含 9.15 的 bookData 同步进库。
|
|||
|
|
|
|||
|
|
### 步骤 3：部署修改后的 soul-admin（KR 宝塔）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 将 一场soul的创业实验-永平 中的 soul-admin/dist 上传到 KR 宝塔
|
|||
|
|
cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平
|
|||
|
|
tar -czf soul-admin-dist.tar.gz soul-admin/dist
|
|||
|
|
sshpass -p 'Zhiqun1984' scp -P 22022 soul-admin-dist.tar.gz root@43.139.27.93:/tmp/
|
|||
|
|
sshpass -p 'Zhiqun1984' ssh -p 22022 root@43.139.27.93 "
|
|||
|
|
cd /www/wwwroot/自营/soul-admin
|
|||
|
|
rm -rf dist.bak
|
|||
|
|
mv dist dist.bak 2>/dev/null || true
|
|||
|
|
tar -xzf /tmp/soul-admin-dist.tar.gz -C .
|
|||
|
|
rm /tmp/soul-admin-dist.tar.gz
|
|||
|
|
"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤 4：校验
|
|||
|
|
|
|||
|
|
1. 打开 souladmin.quwanzhi.com/content
|
|||
|
|
2. 新建章节，确认创建后列表中立即出现
|
|||
|
|
3. 刷新 soul.quwanzhi.com 主站，确认新章节可读
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- souladmin 现改为调用 soul.quwanzhi.com，不再调用 soulapi（Go），需确保 soul 主站可用
|
|||
|
|
- 若仍需使用 Go API，需在 soul-api 源码中修复 list/create 逻辑
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 内容上传 API（供科室/Skill 调用）
|
|||
|
|
|
|||
|
|
- **地址**：`POST /api/content/upload`
|
|||
|
|
- **Content-Type**：`application/json`
|
|||
|
|
- **Body 字段**：
|
|||
|
|
- `title`（必填）：节标题
|
|||
|
|
- `price`：定价，默认 1
|
|||
|
|
- `content`：正文（Markdown 或 HTML）
|
|||
|
|
- `format`：`markdown` | `html`，默认 `markdown`
|
|||
|
|
- `images`：图片 URL 数组；正文中可用 `{{image_0}}`、`{{image_1}}` 占位，会替换为对应图片的 Markdown 图链
|
|||
|
|
- `partId`、`partTitle`、`chapterId`、`chapterTitle`：归属篇/章，可选
|
|||
|
|
- `isFree`：是否免费，默认 false
|
|||
|
|
- `sectionId`：指定节 ID，不传则自动生成（如 `upload.标题slug.时间戳`）
|
|||
|
|
- **返回**：`{ success, id, message, title, price, isFree, wordCount }`
|
|||
|
|
- 写入数据库 `chapters` 表，list/目录会从库中读取并去重显示。
|