8.8 KiB
8.8 KiB
运营与变更（合并版）
合并自：运营数据与项目分析、派对每日数据汇总、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-03-08 橙子同步）
业务规则（全角色必知）
| 规则 | 说明 |
|---|---|
| 非会员专属文章 | 免费，无需登录/付费；以管理端「系统设置 → 免费章节」配置为准 |
| VIP 会员 | 开通 VIP 后，所有文章免费阅读；check-purchased 按 is_vip=1 且 vip_expire_date>NOW 返回已购买 |
本次修复
- 问题：非会员专属文章出现付费墙，用户反馈「不是开通会员的不用付费」
- 根因：章节接口只返回 chapters 表
is_free/price，未合并system_config.free_chapters/chapter_config.freeChapters配置 - 修复：soul-api
internal/handler/book.go新增getFreeChapterIDs()，在findChapterAndRespond、BookAllChapters返回时优先按配置覆盖isFree=true、price=0 - 前端：无需改动，小程序仍按章节接口返回的
isFree/price判断
各角色注意
| 角色 | 注意点 |
|---|---|
| 管理端 | 确保「系统设置 → 免费章节」配置正确，写入 free_chapters 或 chapter_config.freeChapters |
| 后端 | 部署后重启 soul-api；章节接口逻辑见 book.go |
| 产品 | 上述业务规则作为正式规则，验收时按此执行 |
| 小程序 | 无变更，逻辑由后端统一保证 |
第七部分：开发进度同步（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