# 运营与变更（合并版）

> 合并自：运营数据与项目分析、派对每日数据汇总、soul-admin变更、永平版优化、近三日更新总览、5份更新详细说明、小程序接口申请

---

# 第一部分：运营数据与项目分析

## 一、项目与派对定位

| 维度 | 内容 |
|:---|:---|
| **项目名称** | 一场 SOUL 的创业实验场 |
| **核心目标** | 内容阅读 + 私域引流 + 知识变现 |
| **派对定位** | 晨间 6–9 点 Soul 语音派对，主题：谁在挣钱、怎么挣 |

## 二、运营报表数据（节选）

- 105 场、约 108 万推流、1.5 万+ 进房、约 144 小时
- 日度汇总见「派对每日数据汇总」表头与计算说明

## 三、派对每日数据汇总

| 表头 | 说明 |
|:---|:---|
| 时长、Soul推流、进房人数、人均时长、互动、礼物、灵魂力、增加关注、最高在线 | 按日相加 |

---

# 第二部分：soul-admin 与永平版变更

## soul-admin 变更

- 侧边栏：交易中心 → 推广中心（永平 2026-02 已落地）
- 内容管理：移除 5 按钮，仅保留「API 接口」按钮，点击打开 API 文档（永平 2026-02 源码改造已落地）
- 缓存：?v=2 强制刷新，修复 Failed to fetch

## 永平版优化对比

- 主项目 vs 永平版：单 Next vs 多服务（Go+Vue+Next）
- 已合并项：数据库、认证、后台登出等；可选合并：定时任务、提现记录、地址 API 等

---

# 第三部分：近三日更新（2026-02-21～24）

## Git 提交

9b410f2a 永平版上传 → e5e6ffd7 miniprogram 替换 → b038a042 超级个体 → afc2376e VIP/收益/排行 → e91a5d9f 精选推荐 → 7551840c 管理后台改造 → f6846b59/685b4767/74b1c339 soul-admin 修复

## 功能

VIP 会员、超级个体、我的收益、阅读量排序、提现记录、地址、协议隐私、图标系统

## 算法

精选推荐、热门章节、最新章节、权限校验、阅读追踪、VIP 排序

## 前端

soul-admin 管理后台改造、API TOKEN、缓存修复

## 后端

VIP 接口、章节推荐逻辑、数据库依赖

## 小程序

永平版替换、新增页面（地址/协议/隐私/提现记录/会员详情）、改版页面、组件与工具类

---

# 第四部分：小程序接口申请文案

用于微信公众平台 → 开发管理 → 接口设置 → 接口权限，每个理由 300 字以内：

- **wx.chooseAddress**：创业资源对接，用户匹配成功后需交换联系地址，一键选择微信收货地址
- **wx.getPhoneNumber**：付费阅读与分销提现，需手机号完成身份验证与提现到账
- **wx.chooseLocation / wx.choosePoi**：线下见面与资源对接，用户需选择见面地点

详见原「小程序接口申请文案」完整文案。

---

# 第五部分：永平落地（2026-02 依据 cursor_1_14）

- **soul-admin**：内容管理页仅保留「API 接口」按钮（源码方案）；侧栏与推广中心页「交易中心」→「推广中心」。
- **分销**：海报小程序码 scene 带用户 ID（ref=userId）；海报上去掉「邀请码」展示；我的页「待领收益」统一为「我的收益」。
- **个人/设置**：自动提现默认开启、一键获取手机/微信号已有；后台绑定有效期、自动提现等与 API 已对齐。
- **需求来源**：cursor_1_14.md 对话导出中的接口、分销、个人相关更新，已整理至《需求汇总》需求清单。

---

# 第六部分：近期讨论（2026-02-26 小橙同步）

## 文档整理（2026-02-26）

- 移除：Prisma ORM、Next.js 宝塔、Standalone、拆解计划、近3天更新文档、8部署历史修复说明（约 35 份）
- 新增：开发文档/README.md 索引
- 更新：部署总览（当前架构 soul-api + soul-admin + miniprogram）

## VIP 相关

- **VIP 判断**：以 users 表为主（`is_vip=1` 且 `vip_expire_date>NOW`），orders 表兜底
- **VIP 设置**：支持手动设置（管理端用户详情弹窗）与支付设置（1980 会员支付回调）
- **VIP 日志**：手动设置输出 `[VIP] 设置方式=手动设置, userId=xxx, isVip=xxx, vipExpireDate=xxx`；支付设置输出 `[VIP] 设置方式=支付设置, userId=xxx, orderSn=xxx, 过期日=xxx`
- **管理端设置 VIP**：用户详情弹窗 → VIP 手动设置区块；开启 VIP 时必填到期日（前后端校验）

## 分润规则

- **内容订单**：好友优惠 5%（仅针对文章/内容，会员订单无优惠）；推广者 90%
- **会员订单**：推广者会员 20%、非会员 10%（**已实现**，computeOrderCommission；推广设置页可配置 vipOrderShareVip、vipOrderShareNonVip）

## 需求池

- **需求分析**：`临时需求池/需求分析-产品经理视角.md`
- **分润技术分析**：`临时需求池/分润需求-技术分析.md`
- **搁置**：打包购买引导、存客宝对接

---

## VIP 升级（2026-02-26 小橙同步）

### 功能变更

| 项目 | 说明 |
|------|------|
| **设置入口** | 用户列表每行新增「设置 VIP」按钮，独立 SetVipModal；UserDetailModal 移除 VIP 区块 |
| **排序** | `vip_activated_at`：付款=订单 pay_time，手动=now；`vip_sort` 手动排序；VipMembers 按「vip_sort 优先，否则 vip_activated_at DESC」 |
| **角色** | 新增 `vip_roles` 表；`users.vip_role` 存角色名；SetVipModal 下拉可选 +「其他」手动填写 |
| **管理端** | 新增「VIP 角色」页 `/vip-roles`，CRUD 预设角色 |

### 数据迁移

- `开发文档/8、部署/VIP功能-数据库迁移说明.md`
- 脚本：`soul-api/scripts/add-vip-activated-at.sql`、`add-vip-roles-and-fields.sql`

### Skills 升级

- SKILL-MySQL直接操作：§8 迁移脚本最佳实践
- SKILL-API开发：§3.2 新增表/字段完整流程
- SKILL-管理端开发：§4.1 表单弹窗与「可选择+可手动填写」
- SKILL-变更关联检查：VIP/超级个体三端分工表

---

# 第七部分：开发进度同步（2026-02-27 橙子）

## 三端开发进度汇报

| 角色 | 当前进度摘要 | 状态 |
|------|--------------|------|
| **产品** | 项目索引初始化、.cursor 规则优化完成；《分销规则》《规则说明》已讨论 | 已完成 |
| **小程序** | 永平落地已完成：海报 scene、我的收益、推广中心、VIP 相关；找伙伴、提现、阅读、分销核心功能已上线 | 已完成 |
| **管理端** | 内容管理仅 API 按钮、推广中心、SetVipModal、VIP 角色管理、推广设置会员分润配置、VIP 排序等均已落地 | 已完成 |
| **后端** | computeOrderCommission 会员分润差异化（20%/10%）已实现；vip_roles、vip_activated_at、referral_config 扩展；miniprogram/admin/db 三组路由就绪 | 已完成 |

## 下一阶段待办

| 责任角色 | 任务 | 优先级 |
|---------|------|--------|
| 产品经理 | 补充《规则说明》「资料不解锁」含义 | 中 |
| 产品经理 | 明确购买内容 ≥3 章弹窗触发与跳转逻辑 | 中 |
| 后端开发 | 提现、找伙伴接口增加资料完善校验（ERR_PROFILE_INCOMPLETE） | 中 |
| 小程序开发工程师 | 资料完善弹窗、≥3 章购买弹窗、找伙伴前置校验 | 中 |

## 文档更正与废除

- **需求分析-产品经理视角.md**：会员分润差异化由「未实现」更正为「已实现」（对应 soul-api referral_commission.go）
- **废除/搁置**：打包购买引导、存客宝对接（维持搁置，见第六部分）

## 会议纪要

- 开发进度同步会议纪要：`.cursor/会议记录/2026-02-27_开发进度同步会议.md`