This commit is contained in:
Alex-larget
2026-03-24 18:45:32 +08:00
parent dcb7961945
commit f3d74ce94a
68 changed files with 2461 additions and 2535 deletions

View File

@@ -9,3 +9,8 @@
### 当前状态
- 2026-03-20 需求(提现、我的收益、推广设置等)已与实现对齐。
- 主需求、落地推进表已基本同步;项目索引已补齐至 2026-03-24。
## 需求与进度及三端闭环评审
- 区分「用户主路径闭环」与「规则/风控闭环」;后者缺口见《产品意图与功能闭环分析》,用清单驱动排期而非推翻里程碑。
- 待确认VIP 支付前是否强制完善头像昵称(与当前 vip.js 策略二选一)。

View File

@@ -15,3 +15,8 @@
### 待办
- router 补齐users/rfm、users/journey-stats、shensheshou 共 5 个。
- 确认 /api/admin/settings 是否支持 ossConfig。
## 需求与进度及三端闭环评审
- 三端路由分组未被破坏;缺口为业务校验:提现 wechat_id、CKBJoin investor 付费、MatchUsers 发起者资料。
- 失败响应需带 `needBindWechat` / `errorCode` 等稳定字段,配合小程序 `err.response` 约定(详见团队 evolution 与 meeting 纪要)。

View File

@@ -10,3 +10,13 @@
### 落地建议
- 各角色在完成功能开发或吸收经验时,主动更新项目索引。
- 橙子收尾时统一检查并补齐索引。
## 需求与进度及三端闭环评审(跨角色)
### 结论摘要
- **主业务闭环**:阅读/付费/代付/分销/提现主链路在文档与里程碑上成立;**规则闭环**有已知缺口,以《产品意图与功能闭环分析》《需求未补齐清单》为准。
- **三端配套**:小程序页面域与管理端路由域整体对齐;**miniprogram/admin/db 边界未被破坏**。
- **工程契约**:统一「失败时 body 可解析」约定(`err.response`),否则后端 errorCode 设计无法在前端落地。
### 详见
- `.cursor/meeting/2026-03-24_需求与进度及三端闭环评审.md`

View File

@@ -8,3 +8,16 @@
### 技术债
- 富文本渲染rich-text待实施需确认 DB 格式后再推进。
## 需求与进度及三端闭环评审
- `app.request` 在 success:false 时应在 reject 前挂载 `err.response = data`,否则 needBindWechat/errorCode 分支失效。
- 提现my 与 referral 需统一微信号预检与 catch 处理。
## 代码优化落地2026-03-24
- **已实现**`app.js` `_requestOnce``success:false` 与非 401 错误 `reject` 时挂载 `err.response``request` 外层 catch 重抛时保留 `response`
- **获客**`soulBridge.submitCkbLead` 支持 `targetMemberId`/`targetMemberName``read.js` @某人`member-detail` 全局/人物留资统一走 soulBridge`targetNickname` 全局留资允许空串。
- **分销**:阅读页余额/微信下单 `referralCode` 统一 `getReferralCodeForPay`
- **提现**`referral.js` / `my.js``catch` 中识别 `e.response.needBindWechat`(原 success:false 分支实际不可达)。
- **文档**`miniprogram-dev/SKILL.md` 已补充 `err.response` 说明。

View File

@@ -27,6 +27,7 @@ Soul 创业派对产品定位:面向创业者的社区/工具型小程序。
| 2026-03-18 | 文档归档整理:以《以界面定需求》为基准,重整需求口径/验收点/分享 singlePage 约束,写入产品经验库 | 已完成 |
| 2026-03-18 | 会议:超级个体开通后自动创建@人与支付前资料引导(头像+昵称) | 已完成 |
| 2026-03-24 | 会议:开发进度同步;项目索引补齐 2026-03-19/20 及之后记录;文档同步原则确认 | 已完成 |
| 2026-03-24 | 会议:需求与进度及三端闭环评审;规则/风控缺口清单化VIP 支付前资料规则待拍板 | 已完成 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置

View File

@@ -40,6 +40,7 @@ soul-apiGo + Gin + GORM + MySQL提供三组路由`/api/miniprogram/*`
| 2026-03-18 | 会议:超级个体开通后自动创建@人Person 绑定 userId 幂等)与资料完善 flags 方案 | 已完成 |
| 2026-03-20 | 提现审批逻辑修复、fail_reason/error_message 落库、referral_config withdrawFee/enableAutoWithdraw | 已完成 |
| 2026-03-24 | 会议开发进度同步项目索引补齐router/ossConfig 待确认 | 已完成 |
| 2026-03-24 | 会议:三端闭环评审;提现/CKB/匹配后端校验与 errorCode 为 P0/P1 | 已完成 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置

View File

@@ -31,9 +31,10 @@ Soul 创业派对全项目架构与约定路由隔离miniprogram/admin/db
| 2026-03-17 | 性能优化与 Redis 缓存方案落地Redis 容灾回退 DB、OSS 上传容灾;/health 返回 database/redis 状态 | 已完成 |
| 2026-03-18 | 吸收经验:分享进入链路需兼容朋友圈 singlePage单页模式不执行支付/自动领取等强动作并引导“前往小程序” | 已完成 |
| 2026-03-18 | 会议:超级个体开通后自动创建@人统一走 Person幂等键绑定 userId默认资料 flags 后端输出 | 已完成 |
| 2026-03-24 | 会议:需求与进度及三端闭环评审;主路径闭环成立、规则闭环待加固;失败响应与 err.response 契约 | 已完成 |
> **格式说明**:每次架构级讨论后在此追加一行,日期格式 YYYY-MM-DD
---
**最后更新**2026-03-18
**最后更新**2026-03-24

View File

@@ -44,6 +44,8 @@
| 2026-03-19 | 原生按钮覆盖定位cover-view经验入库 | 已完成 |
| 2026-03-20 | 手机号一键登录、login-modal 公用组件read/my/gift-pay 引入);我的收益取 availableEarnings | 已完成 |
| 2026-03-24 | 会议:开发进度同步;项目索引补齐;富文本 rich-text 技术债待续 | 已完成 |
| 2026-03-24 | 会议三端闭环评审app.request err.response提现双入口与后端契约对齐 | 已完成 |
| 2026-03-24 | 落地app.request 挂 err.responsesoulBridge 留资扩展;阅读页带码与 referral/my 提现 catch 对齐 | 已完成 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置

View File

@@ -33,6 +33,7 @@
| 2026-03-18 | 文档归档整理:按界面驱动口径统一验收;补充分享 singlePage 降级与引导为必测项 | 已完成 |
| 2026-03-18 | 会议新增用例资料默认阻断支付、Person 自动创建幂等、昵称变更同步回归) | 已完成 |
| 2026-03-24 | 会议:开发进度同步;项目索引补齐;提现/登录/收益/推广设置用例补充singlePage、getPhoneNumber 边界 | 已完成 |
| 2026-03-24 | 会议三端闭环评审API 绕过负例与双入口提现回归待契约落地后执行 | 已完成 |
---

View File

@@ -45,6 +45,7 @@
| 2026-03-18 | 会议:超级个体开通后自动创建@人;管理端可选展示 userId/来源以便排查重名 | 已完成 |
| 2026-03-20 | 提现审核备注列fail_reason/error_message、自动审批开关推广设置提现手续费 | 已完成 |
| 2026-03-24 | 会议开发进度同步项目索引补齐DistributionPage Order.description 待修 | 已完成 |
| 2026-03-24 | 会议:三端闭环评审;管理端与小程序配套整体齐全;类型债择机修 | 已完成 |
> **格式说明**:每次开发后在此追加一行,日期格式 YYYY-MM-DD状态用已完成 / 进行中 / 待续 / 搁置

View File

@@ -8,3 +8,8 @@
### 待办
- DistributionPage Order.description 类型错误待修(与本次迁移无关,有空即修)。
## 需求与进度及三端闭环评审
- 管理端路由域与小程序 Tab/子业务整体配套(审核、配置、导师、匹配、存客宝相关)。
- C 端绕过接口的风险主要靠后端 + 小程序请求层闭环,非管理端菜单能单独解决。

View File

@@ -6,3 +6,8 @@
- 提现审批、手机号登录、我的收益、推广设置、提现审核等新增功能需补充/更新用例。
- 边界必测singlePage 分享进入、getPhoneNumber 隐私协议同意流程。
- 下次回归前完成用例更新。
## 需求与进度及三端闭环评审
- 补齐「仅调 API、绕过前端」负例提现、CKBJoin、MatchUsers。
- 后端与 err.response 契约落地后,做双入口提现(我的 / 推广)回归。