afc2376e96
- 后端: users表新增VIP字段, 4个VIP API (purchase/status/profile/members) - 后端: hot接口改按user_tracks阅读量排序 - 后端: orders表支持vip产品类型, migrate新增vip_fields迁移 - 小程序「我的」: 推广中心改为我的收益, 头像VIP标识, VIP入口卡片 - 小程序「我的」: 最近阅读显示真实章节名称 - 小程序首页: 去掉内容概览, 新增创业老板排行(4列网格) - 小程序首页: 精选推荐从hot接口获取, goToRead增加track记录 - 新增页面: VIP详情页, 会员详情页 - 开发文档精简为10个标准目录, 创建SKILL.md, 需求日志规范化 Co-authored-by: Cursor <cursoragent@cursor.com>
80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
# Soul 管理后台 (soul-admin) 变更记录 v2026-02
|
||
|
||
> 更新时间：2026-02-21
|
||
> 适用站点：souladmin.quwanzhi.com
|
||
> 部署路径：`/www/wwwroot/自营/soul-admin/dist/`
|
||
|
||
---
|
||
|
||
## 一、变更概览
|
||
|
||
| 模块 | 变更项 | 说明 |
|
||
|:---|:---|:---|
|
||
| 侧边栏 | 交易中心 → 推广中心 | 菜单及页面标题统一改为「推广中心」 |
|
||
| 内容管理 | 顶部 5 按钮移除 | 移除：初始化数据库、同步到数据库、导入、导出、同步飞书 |
|
||
| 内容管理 | 仅保留 API 接口 | 仅保留「API 接口」按钮，打开 API 文档面板 |
|
||
| 内容管理 | 删除按钮 | 删除按钮改为悬停才显示（与读取/编辑一致） |
|
||
| 内容管理 | 免费/付费 | 可点击切换免费 ↔ 付费 |
|
||
| 内容管理 | 小节加号 | 每小节旁增加「+」按钮，可在此小节下新建章节 |
|
||
|
||
---
|
||
|
||
## 二、部署说明
|
||
|
||
### 2.1 正确部署路径
|
||
|
||
nginx 实际指向：
|
||
|
||
```nginx
|
||
root /www/wwwroot/自营/soul-admin/dist;
|
||
```
|
||
|
||
**重要**：需将 `soul-admin/dist` 部署到上述目录，而非 `/www/wwwroot/souladmin.quwanzhi.com/`。
|
||
|
||
### 2.2 部署步骤
|
||
|
||
```bash
|
||
# 1. 本地打包
|
||
cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/soul-admin/dist
|
||
tar -czf /tmp/souladmin.tar.gz index.html assets/
|
||
|
||
# 2. 上传并解压到正确路径
|
||
scp -P 22022 /tmp/souladmin.tar.gz root@43.139.27.93:/tmp/
|
||
ssh -p 22022 root@43.139.27.93 'cd /www/wwwroot/自营/soul-admin/dist && tar -xzf /tmp/souladmin.tar.gz && chown -R www:www . && rm /tmp/souladmin.tar.gz'
|
||
```
|
||
|
||
### 2.3 缓存处理
|
||
|
||
- `index.html` 内引用 `index-CbOmKBRd.js?v=版本号`，每次发布建议递增版本号
|
||
- 建议在 `index.html` 中调整：`?v=3` 或更高
|
||
|
||
---
|
||
|
||
## 三、技术说明
|
||
|
||
### 3.1 修改文件
|
||
|
||
- `index.html`：内联注入脚本（按钮改造、删除 hover、免费切换、加号新建）
|
||
- `assets/index-CbOmKBRd.js`：侧边栏「交易中心」→「推广中心」
|
||
|
||
### 3.2 注入脚本触发条件
|
||
|
||
- 路径包含 `content`（如 `/content`）
|
||
- 页面上存在「初始化数据库」按钮（内容管理页加载完成）
|
||
|
||
### 3.3 免费/付费切换
|
||
|
||
- 调用 `POST /api/db/book`，传入 `{ id, isFree, price }`
|
||
- 需后端支持按 id 更新 isFree/price
|
||
|
||
---
|
||
|
||
## 四、问题排查
|
||
|
||
| 现象 | 可能原因 | 处理方式 |
|
||
|:---|:---|:---|
|
||
| 界面未变化 | 部署到错误目录 | 确认部署到 `/www/wwwroot/自营/soul-admin/dist/` |
|
||
| 界面未变化 | 浏览器/CDN 缓存 | 清除缓存或使用无痕模式，或增加 `?v=` 版本号 |
|
||
| 内容管理注入不生效 | 路由为 hash 模式 | 检查 `location.pathname` 是否包含 `content`，必要时改用 `location.hash` |
|
||
| 免费切换失败 | 后端未实现更新 | 检查 soul-api 是否支持 `POST /api/db/book` 的更新逻辑 |
|