soul/开发文档/6、后端/内容创建问题修复说明.md

内容创建问题修复说明

问题：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 主站（小型宝塔）

cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
# 按 .cursorrules 中的流程执行
pnpm build
# 然后执行部署脚本

步骤 2：同步 9.15 到数据库

部署后访问 soul.quwanzhi.com/admin，在内容管理页面点击「同步到数据库」，将包含 9.15 的 bookData 同步进库。

步骤 3：部署修改后的 soul-admin（KR 宝塔）

# 将 一场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/目录会从库中读取并去重显示。