diff --git a/开发文档/10、项目管理/README.md b/开发文档/10、项目管理/README.md index 8d11dae6..fd029273 100644 --- a/开发文档/10、项目管理/README.md +++ b/开发文档/10、项目管理/README.md @@ -6,6 +6,8 @@ | 文件 | 用途 | |------|------| +| [一场soul创业实验_近期落地_20260406-0407.md](./一场soul创业实验_近期落地_20260406-0407.md) | **2026-04-06～07** 三端已落地功能与待排期对照 | +| [一场soul创业实验_近期落地_20260407-0408.md](./一场soul创业实验_近期落地_20260407-0408.md) | **2026-04-07～08** 需求沉淀与 Git 对齐说明、全站 plan / 用户管理待验收清单 | | [存客宝协作需求.md](./存客宝协作需求.md) | 存客宝协作相关需求 | | [项目管理提示词.md](./项目管理提示词.md) | 项目管理场景 AI 提示词 | diff --git a/开发文档/10、项目管理/一场soul创业实验_近期落地_20260406-0407.md b/开发文档/10、项目管理/一场soul创业实验_近期落地_20260406-0407.md new file mode 100644 index 00000000..ad4dc873 --- /dev/null +++ b/开发文档/10、项目管理/一场soul创业实验_近期落地_20260406-0407.md @@ -0,0 +1,127 @@ +# 一场 Soul 的创业实验 · 近期落地总览 + +> **时间范围**：2026-04-06 ～ 2026-04-07（以仓库提交 `6d11fb29`、`d48aba50`、`b787fa3a` 及关联改动为准） +> **仓库**：`一场soul的创业实验-永平`（小程序 `miniprogram/` + 管理端 `soul-admin/` + 后端 `soul-api/`） + +本文档把近两日已写入代码的**功能落地**与**仍待排期**的需求对照写清，便于项目管理与验收对齐。 + +--- + +## 一、总览 + +| 端 | 主题 | 状态 | +|----|------|------| +| 管理端 | 用户管理拆分、超级个体 Tab、首页入口配置 Tab、存客宝获客面板、分销/仪表盘/内容页瘦身 | 已落地主干 | +| 后端 | 小程序接口扩展、Person/VIP 字段与置顶链路、存客宝开放能力、超级个体统计、MBTI 头像管理接口、订单/礼物支付相关补丁 | 已落地主干 | +| 小程序 | 首页置顶/超级个体展示、打赏礼物与上麦配置消费、礼物 id 与排序对齐后台、多处业务页与 `app.js` 配置联动 | 已落地主干 | + +--- + +## 二、已落地功能（按产品模块） + +### 2.1 超级个体与用户管理 + +- **页面结构**：`UsersPage` 大拆分为独立模块；新增 **`SuperIndividualTab`**（超级个体列表与行内能力）。 +- **超级个体行内能力**（管理端已实现）： + - VIP 排序（拖拽/序号）、角色标签、与 **@的人（Person）** 关联、**置顶**切换。 + - **存客宝**：`planId` / `apiKey`、单行与批量 **计划连通检测**（`/api/admin/ckb/plan-check`）。 + - **获客**：按 `personToken` 拉取 **`/api/db/ckb-leads`** 并弹窗展示记录（与存客宝侧留资协同）。 + - **Webhook** 配置入口。 + - **用户详情**：可跳转打开 `UserDetailModal`，与「用户列表」数据绑定。 +- **首页入口配置并入超级个体**：每个超级个体可配置 **`homeEntryConfig`**（打赏文案、礼物列表、上麦时段等），不再单独占一项「选目录」式配置；全局默认仍可通过 **`HomeEntryConfigTab`** 维护 `mp_config` 基线。 + +**主要代码**：`soul-admin/src/pages/users/SuperIndividualTab.tsx`、`HomeEntryConfigTab.tsx`、`UsersPage.tsx`（拆分后） + +### 2.2 首页入口 · 打赏与上麦（后台可配 → 小程序生效） + +- **礼物行**：支持 `id`、`name`、`price`、`emoji`、`icon`、**`micOrder`**（上麦横排顺序）、**`iconScale`**、**`micFeatured`**（默认支付高亮档）。 +- **对齐逻辑**：后台与小程序均修复「无 id 时按下标套默认 id」导致的 **礼物与价格错配**（例如小心心误带人气票 id）；无 id 时优先按**名称**、再按 **`micOrder`** 对齐默认三档。 +- **上麦时段**：`micStart` / `micEnd`，支持跨午夜；小程序内 `isNowInMicWindow` 判断。 +- **其它文案**：入口按钮、弹窗标题/副标题、支付按钮、留资链接文案、支付成功 toast、上麦文案与支付后 webhook 等。 + +**主要代码**：`HomeEntryConfigTab.tsx`、`miniprogram/pages/index/index.js` + +### 2.3 小程序首页展示与体验 + +- **置顶人物（链接人与事）**：与后台 Person / 置顶 token 一致；无头像时用占位图或中文首字（避免圆内英文字母）。 +- **超级个体横滑**：与固定「卡若」获客位 **重名去重**（含历史误写「卡路」）。 +- **配置下发**：通过 `getApp().request` 拉取小程序侧配置（`mpUi.homePage` 等）驱动首页模块显隐与文案。 + +**主要代码**：`miniprogram/pages/index/index.js`、`index.wxml`、`index.wxss`、`miniprogram/app.js` + +### 2.4 Person（@的人）与置顶链路 + +- **模型/接口**：`person` 扩展（如 `avatar` 等字段）、`db_person` 处理调整；置顶人物返回时 **有 `user_id` 则 JOIN 用户昵称/头像**（与《链接人与事》设计一致）。 +- **小程序**：阅读页 @ 解析与 `read` 等页与配置协同（见 `app.js` 注释与相关页改动）。 + +**主要代码**：`soul-api/internal/model/person.go`、`internal/handler/db_person.go`、`internal/handler/miniprogram.go` +**设计参照**：`开发文档/1、需求/链接人与事-置顶与超级个体对应设计.md` + +### 2.5 MBTI 头像资源与管理端 + +- **静态资源**：`static/mbti-avatars-16personalities-male/`、`...-female/` 下 16 型 **SVG**（及 README 说明）。 +- **管理端**：`MbtiAvatarsManager` 与 **`admin_mbti_avatars`** 接口，支持后台维护头像方案与用户侧展示策略衔接。 + +**主要代码**：`soul-admin/src/components/modules/mbti/MbtiAvatarsManager.tsx`、`soul-api/internal/handler/admin_mbti_avatars.go` + +### 2.6 推广中心 · 存客宝获客面板 + +- **获客列表能力**以组件形式强化：**`CkbLeadsPanel`**（与推广/分销场景联动页面一并调整）。 + +**主要代码**：`soul-admin/src/components/modules/leads/CkbLeadsPanel.tsx`、`soul-admin/src/pages/distribution/DistributionPage.tsx` 等 + +### 2.7 找伙伴与其它管理端页面 + +- **找伙伴**：`FindPartnerPage` 调整，新增 **`MatchPoolTab`** 等标签结构。 +- **仪表盘 / 内容**：`DashboardPage`、`ContentPage` 等批量瘦身（与「数据概览 / 统计归类」需求方向一致，具体 UI 以现网为准）。 + +**主要代码**：`soul-admin/src/pages/find-partner/*`、`DashboardPage.tsx`、`ContentPage.tsx` + +### 2.8 后端其它补丁（同期提交） + +- **`miniprogram_super_stats`**：超级个体相关统计接口。 +- **`ckb_open.go`**：存客宝开放相关 handler（与小程序/外部回调衔接）。 +- **`admin_rfm`**、**`gift_pay`**、**`order_webhook`**、**`vip_members_admin`**、`internal/router/router.go` 路由注册等：与会员、礼物支付、订单回调、VIP 列表字段扩展配套。 +- **脚本**：小程序上传/发布脚本调整；章节图片下载、MBTI 头像拉取、部署校验等辅助脚本入库（见提交 `6d11fb29` 文件列表）。 + +--- + +## 三、需求文档对照（同一批次口头/截图需求） + +| 文档路径 | 与落地的关系 | +|----------|----------------| +| `开发文档/1、需求/修改/20260406用户管理-首页入口融合.md` | 首页入口并入超级个体、搜索/点击统计/获客与用户详情联动等：**主干已做**，细项以现网与 Tab 为准持续验收 | +| `开发文档/1、需求/修改/20260406用户管理-超级个体重构.md` | 购买状态/用户旅程、MBTI 头像、获客进推广中心等：**部分已落地**（头像资源、获客面板、超级个体行内配置），旅程总览大重构见下节待办 | +| `开发文档/1、需求/修改/20260406数据管理.plan.md` | 推广中心深度重构、找伙伴**可编辑算法**、用户旅程迁入数据概览、算法配置折叠展示等：**多列为后续迭代** | +| `开发文档/1、需求/已完成/20260406用户管理-首页入口融合.md` | 与「修改」目录文档内容同步归档时可对照，**以代码与本文「已落地」为准** | + +--- + +## 四、仍待排期 / 验收关注点（从需求表抽出） + +以下项在需求文档中仍出现完整描述，**尚未在本文「二、已落地」中承诺为完成**，建议单独排期或走测试用例验收： + +1. **推广中心**：目录级「深度重构」——谁获客多少、绑定多少、最佳推广人、收益与提现一站式（见 `20260406数据管理.plan.md` 截图描述）。 +2. **找伙伴匹配算法**：标签 / 旅程 / 行为 / MBTI 互补 / 性别 / 随机等多级策略，且 **算法可编辑**、入口与存客宝功能去重合并。 +3. **数据概览**：用户旅程总览迁入「数据概览」类 Tab，与统计标签体系统一（首页仅保留总用户数～转化率等顶层指标）。 +4. **小程序「我的」**：超级个体获客情况 / 热度独立弱入口页（需求文档功能五）。 +5. **购买状态模块**：凡收费项目统一进入「购买状态」视图，便于看收益（与 VIP 详情/订单列表的 product 维度需产品定稿）。 + +--- + +## 五、Git 锚点（便于溯源） + +```text +6d11fb29 feat: 同步本地三端改动并清理上传凭证风险 +d48aba50 chore: 以本地为准同步最新改动 +b787fa3a chore: 同步本地首页/用户管理/CKB 与小程序接口改动 +``` + +--- + +## 六、维护说明 + +- 后续每次迭代结束，可在本文件顶部**追加小节**或新建 `…_YYYYMMDD.md`，并在本目录 `README.md` 表格中登记链接。 +- 需求真源仍以 `开发文档/1、需求/` 为主；**落地状态以本仓库可运行代码为准**。 + +返回 [10、项目管理 README](./README.md) · [开发文档索引](../索引.md) diff --git a/开发文档/10、项目管理/一场soul创业实验_近期落地_20260407-0408.md b/开发文档/10、项目管理/一场soul创业实验_近期落地_20260407-0408.md new file mode 100644 index 00000000..16fc887d --- /dev/null +++ b/开发文档/10、项目管理/一场soul创业实验_近期落地_20260407-0408.md @@ -0,0 +1,94 @@ +# 一场 Soul 的创业实验 · 近期落地总览 + +> **时间范围**：2026-04-07 ～ 2026-04-08 +> **仓库**：`一场soul的创业实验-永平`（小程序 `miniprogram/` + 管理端 `soul-admin/` + 后端 `soul-api/`） + +--- + +## 〇、代码入库情况（与 Git 对齐） + +| 项 | 说明 | +|----|------| +| **当前仓库最新可见提交** | `b787fa3a`（2026-04-07 09:07 +0800）— 同步首页 / 用户管理 / CKB 与小程序接口等 | +| **4/7 午间之后 ～ 4/8** | **无新增 commit 记录**；若本机有未推送或未提交的改动，以实际 `git log` 与工作区为准，可在定稿迭代后在本节**追加 Git 锚点** | + +上一阶段落地总览见：[一场soul创业实验_近期落地_20260406-0407.md](./一场soul创业实验_近期落地_20260406-0407.md)。 + +--- + +## 一、本窗口期「需求已落地到文档」的清单 + +以下需求已写入 `开发文档/1、需求/修改/`，作为 **4/7～4/8 排期与验收的真源**；实现状态以**后续提交**或联调结果为准。 + +### 1.1 全站修改 `全站修改 20260407-1.plan.md` + +| 主题 | 要点（摘要） | +|------|----------------| +| **数据概览合并** | 找伙伴、推广中心侧「数据概览」迁入**统一「数据概览」标签**；与首页顶层数据区分；用户旅程页需更有参考意义、可重构 | +| **内容章节** | 内容页章节支持**折叠/展开**（小三角） | +| **用户界面** | 获客与点击等模块布局**横向排布**，避免挤在一起 | +| **推广中心重构** | 获客列表、订单/待付、提现审核分区；去重存客宝重复项；推广设置**减字、简洁**；不丢功能 | +| **系统设置 / 接口** | 接口功能测试区更清晰；支持通过 API 传文件、便于 AI 管理文章等 | +| **标签统计** | 章节级标签可辨；标签统计 + **分析表格/图形** | +| **内容排行榜** | 「内容展示规则」挪到内容管理侧，与排名算法相邻、**小标签点击展开**配置 | +| **推广排行 / 小程序** | 后端开关控制首页是否展示；首页位置在「最新新增」与「精选推荐」之间；前端展示**分享排行榜**（不叫「推广排行」）、**不展示收益**、能力分区间与算法（收入/小节/会员/活跃等合成倍数，**仅展示前五名**等，见原文） | + +### 1.2 全站修改 `全站修改 20260407-2.plan.md` + +| 主题 | 要点（摘要） | +|------|----------------| +| **标签统计** | 页面**不显示无意义英文**；明确「谁点了什么标签 / 哪一章」 | +| **章节折叠与点击** | 章节倒三角可见；文章维度展示点击次数；**谁点了**可下钻到用户及次数排行；文章点击排行并入**首页数据概览** | +| **内容排行榜** | 放入数据概览 | +| **数据概览结构** | 去掉找伙伴/推广中心内重复的数据概览块；顺序调整为：如**内容排行榜 → 标签点击 → 超级个体统计**等（见原文截图顺序） | +| **数据概览 / RFM** | 以**单用户行为与旅程**为核心；新增**高价值用户排行榜**；与 **RFM 估值**叠加；界面简洁一致 | +| **找伙伴导航** | 去掉其中重复的「数据概览」 | +| **头像 / MBTI** | 用户头像与 MBTI 资源一致、**PNG**、非空；性格填写与测试返回一致；支持批量补无头像用户；男女自动分配 | +| **用户详情** | 排版重构，功能不变 | +| **算法配置** | 权重可改；去掉「按 RFM 排序」等冗余小标签 | +| **书籍规则** | 单本书预览/显示百分比可配置 | +| **小程序朋友圈分享** | 分享落地页：付费解锁提示 + **右下角动态箭头**指向「前往小程序」/付费位置；箭头方向为**向下**（见原文强调） | + +### 1.3 全站修改 `全站修改 20260407-3.plan.md` + +| 主题 | 要点（摘要） | +|------|----------------| +| **错误修复** | 先修截图所示报错再继续 | +| **存客宝朋友圈 / 内容库** | 新章节或新注册会员可推送到存客宝内容库；**接口双向约定**（我方提供拉取或对方提供推送），文档写清操作路径 | +| **阅读规则** | 「看几章再弹 365」等规则**后台可配**；小程序侧规则与开通状态在后台可见、可配置 | +| **MBTI 头像源** | **仅使用** `static/` 下既定男女两套文件夹资源；去掉自生成 SVG/图；上传与展示路径与静态目录一致 | + +### 1.4 用户管理 `20260408用户管理—1—.md` + +| 主题 | 要点（摘要） | +|------|----------------| +| **用户详情** | 用户详情中的**旅程 / 轨迹**与列表用户不一致问题需排查修复 | +| **行为标签** | 标签改为**中文**且语义清晰（如具体点了谁的哪个按钮） | +| **找伙伴** | 「找伙伴 - 数据概览」**删除** | +| **推广中心** | **获客列表页重构** | +| **推广排行** | 排行表上可隐藏编辑入口、**去掉分数列**或按分数排序；支持**指定人参与排行**等（见原文） | + +--- + +## 二、与上一阶段落地的衔接关系 + +- **4/6～4/7 已交付**的超级个体 Tab、首页入口配置、Person 置顶、MBTI 静态资源、`CkbLeadsPanel` 等，在本阶段需求中被要求 **继续合并数据概览、重构推广中心、强化标签/旅程一致性**——属于**迭代加深**，需在开发时分模块回归，避免重复入口（文档已多处强调「去掉重复数据概览」）。 + +--- + +## 三、建议验收顺序（待开发完成后） + +1. **数据一致性**：用户详情 ↔ 旅程/轨迹 ↔ 列表用户为同一人（`20260408` 功能一）。 +2. **数据概览唯一入口**：找伙伴/推广中心内重复块已移除，首页与管理端「数据概览」指标可读（plan-1 / plan-2）。 +3. **推广中心**：分区清晰、字少、功能不丢（plan-1 功能三）。 +4. **排行榜**：小程序「分享排行榜」展示与后台开关、前五名与能力分规则（plan-1 功能六）。 +5. **MBTI 头像**：仅 static 目录 PNG、批量补头像（plan-2 功能三 + plan-3 功能三）。 + +--- + +## 四、维护说明 + +- 若有 **4/8 及以后** 的新提交，请在本文件 **§〇** 追加 commit hash 与一句说明，并把对应条目从「待开发」改为「已落地」。 +- 需求细节以 `开发文档/1、需求/修改/` 内 Markdown 与截图为准。 + +返回 [10、项目管理 README](./README.md) · [开发文档索引](../索引.md)