更新小程序启动指南,添加本机安装路径说明及一键打开功能说明;更新编译脚本,优先使用D盘的微信开发者工具路径。

This commit is contained in:
乘风
2026-01-30 15:45:01 +08:00
parent 41bf3de992
commit e21837bf47
6 changed files with 3911 additions and 1 deletions

View File

@@ -8,8 +8,9 @@ Write-Host ""
# 设置项目路径
$ProjectPath = Split-Path -Parent $MyInvocation.MyCommand.Path
# 微信开发者工具可能的安装路径
# 微信开发者工具可能的安装路径(优先使用 D 盘)
$cliPaths = @(
"D:\微信web开发者工具\cli.bat",
"C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat",
"C:\Program Files\Tencent\微信web开发者工具\cli.bat",
"$env:LOCALAPPDATA\微信web开发者工具\cli.bat"

26
open-miniprogram.bat Normal file
View File

@@ -0,0 +1,26 @@
@echo off
chcp 65001 >nul
echo Opening WeChat DevTools...
echo Project: %~dp0miniprogram
echo.
set "TOOL_DIR=D:\微信web开发者工具"
set "PROJECT_DIR=%~dp0miniprogram"
if not exist "%TOOL_DIR%\cli.bat" (
echo [Error] Not found: %TOOL_DIR%\cli.bat
echo Please confirm WeChat DevTools is at D:\微信web开发者工具
pause
exit /b 1
)
start "" "%TOOL_DIR%\微信开发者工具.exe"
echo.
echo In WeChat DevTools:
echo 1. Click "Import project" or "+"
echo 2. Select: %PROJECT_DIR%
echo 3. AppID: wxb8bbb2b10dec74aa
echo 4. Click "Compile"
echo.
pause

View File

@@ -41,8 +41,13 @@ npm run dev
### 第2步打开微信开发者工具
**本机安装路径**: `D:\微信web开发者工具`
- **一键打开**:双击项目根目录下的 `打开小程序.bat`,会启动微信开发者工具,再在工具里导入项目目录即可。
1. **打开微信开发者工具**
- 如果没有安装请先下载https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
- 本机已安装在:`D:\微信web开发者工具`
2. **导入项目**
- 点击工具栏的 **"导入项目"** 或 **"+"** 按钮

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,114 @@
# 产研团队 第21场 20260129 — 当前项目 Bug 与优化清单
根据会议记录提取的、与 **Mycontent / 读书小程序 / 存客宝 / 数据中台** 相关的 bug 与待办优化。
---
## 一、已明确的 Bug需修复
### 1. 免费章节设置前端不生效
- **现象**:后台设置免费章节后,前端没有反应;后台变成 0但前端的不会变成免费。
- **责任**:永平
- **说明**:内容模块里「免费章节」配置与前端展示未同步,需修。
### 2. 交易中心缺少「绑定」数据统计
- **现象**:交易中心与用户管理里的「绑定」数据还没有做到交易中心统计;付款的有统计,绑定没有。
- **待办**:看接口问题,永平对一下,挑时间处理。
### 3. 用户中心 / 用户详情无接口导致报错
- **现象**:用户中心点击进去要看「全部生命轨迹」、底下有多少用户、用户看了什么章节,但目前没有对应接口,会出错。
- **待办**:接口能正常通后,这里就没问题;可按当前项目单独实现用户轨迹,不依赖中台那块。
### 4. 数据中心只有「查」没有「存」
- **现象**:目前只开放了查询接口;用户完善数据要「传进来」的接口没写,没法把小程序用户数据写入中台。
- **待办**:针对本项目做「存」的接口与格式,并和审社所/中台对接方式对齐。
### 5. 支付宝证书 / 验证码卡点
- **现象**:证书一直申请覆盖不了;有两三个证书快过期,再申请时登录发验证码一直卡;提示已成功但第二天看灰度为 0%。
- **待办**:排查原因,可再研究支付宝相关流程。
### 6. 找伙伴 / 匹配相关后端「漏了」
- **说明**:匹配逻辑、存客宝加好友等,后端有部分漏做;远志也要检查一遍。
- **待办**:后端补全,前后端一起检查。
### 7. 存客宝稳定性与权限
- **说明**:存客宝那边稳定性需要弄一下;权限要配置好,上线后会有很多问题,需提前准备。
---
## 二、接口与文档(需补齐)
### 1. 接口文档没有统一入口
- **现象**:接口文档不知道在哪查,没有统一链接或 API 文档地址。
- **待办**
- 部署一个接口文档地址(例如 Swagger/API Doc并把链接发群/固定位置;
- 团队统一用 API Doc 管理接口(如 Apifox 等),文档集中、可公开的放出去。
### 2. Key 管理与权限校验
- **说明**:数据中心有 API Key 管理;创建 key 后,请求时把 key 放到请求头做权限校验即可「查」和后续「存」。
- **待办**:部署好后,在文档中写清「在哪里创建 key、请求头怎么带」方便对接。
### 3. 数据中台「怎么用」说明缺失
- **现象**:数据中台的作用、怎么查、怎么存、怎么和业务对接,没有成文说明,对接方不知道如何操作。
- **待办**:写清中台使用方式(查/存/权限),并和本项目(读书小程序、存客宝)的对接流程对齐。
---
## 三、功能完善与优化(待做)
### 1. 标签体系:只支持查询,不支持存/更新
- **现象**:打标签、存标签这块还没弄完,目前只支持查询;碎片时间等要跟用户画像、打标签联动,需要「存」和「更新」。
- **待办**:做完标签的「存」和更新逻辑,并和审社所规划对齐。
### 2. 用户完善数据与中台同步
- **需求**:小程序用户数据要能「完善到数据中台」——既要有从中台拉数据完善小程序,也要有从小程序/业务侧把数据写入中台。
- **待办**:定好「用户完善」的字段与格式,提供写入中台的接口与文档。
### 3. 用户详情页 / 详情逻辑优化
- **说明**:详情页里有些逻辑可以再优化,能优化就优化一点;和用户管理、交易中心数据一致。
### 4. 自动分账对接
- **说明**:老王那边自动分账已有弄好,但还没完全接到当前后台;付完款后台要能立即知道,并和分账打通。
- **待办**:把分账接口对接到本项目后台。
### 5. 充值流程
- **结论**:先走线下——对方转给我们,我们打到运营账户,再从运营账户扣款;线上充值和手续费后续再说。
- **待办**:线下充值与运营户划拨流程要明确、可执行。
### 6. 提现流程
- **说明**:提现为云审查模式;名字点击跳主页、确定收款、确认收款等步骤要走通。
- **待办**:确保流程清晰、可演示。
---
## 四、文档与协作
### 1. 项目管理与文档统一
- **现象**:没有全景图/地图,规划与现有系统如何融合不清晰;文档东一块西一块。
- **待办**
- 项目管理上明确、清晰;
- 接口、中台、本项目逻辑都有统一文档管理(如 API Doc + 项目说明文档)。
### 2. 标签 / 源码说明文档
- **说明**:用「展开」等方式,把标签相关源码、数据库结构生成说明文档,给远志等看,对齐流程和结构。
- **待办**:做完后自己生成说明文档并检查一遍。
### 3. 少生产 Bug、多完整性
- **原则**:修 bug 可以快,但不要生产太多 bug避免东一块西一块漏强调完整性接口、文档、统计、前后端一致
---
## 五、优先级建议(按会议语境整理)
| 优先级 | 事项 |
|--------|------|
| P0 | 免费章节前端不生效;交易中心绑定统计;用户详情/轨迹接口 |
| P0 | 数据中心「存」接口 + 接口文档统一入口 + Key 与使用说明 |
| P1 | 标签的存/更新;用户完善与中台双向同步 |
| P1 | 自动分账对接;存客宝稳定性与权限 |
| P2 | 支付宝证书卡点;充值/提现流程细化与文档 |
| P2 | 详情页逻辑优化;文档与项目管理统一 |
---
*提取自:开发文档/产研团队 第21场 20260129 许永平.txt*

26
打开小程序.bat Normal file
View File

@@ -0,0 +1,26 @@
@echo off
chcp 65001 >nul
echo 正在打开微信开发者工具...
echo 项目目录: %~dp0miniprogram
echo.
set "TOOL_DIR=D:\微信web开发者工具"
set "PROJECT_DIR=%~dp0miniprogram"
if not exist "%TOOL_DIR%\cli.bat" (
echo [错误] 未找到: %TOOL_DIR%\cli.bat
echo 请确认微信开发者工具已安装在 D:\微信web开发者工具
pause
exit /b 1
)
start "" "%TOOL_DIR%\微信开发者工具.exe"
echo.
echo 请手动在微信开发者工具中:
echo 1. 点击 "导入项目""+"
echo 2. 选择目录: %PROJECT_DIR%
echo 3. AppID: wxb8bbb2b10dec74aa
echo 4. 点击 "编译"
echo.
pause