chore: 上线前优化 — 清理调试日志/启用组件按需注入/补全组件声明
- 移除全项目 34 处调试 console.* 输出 - project.config.json: minified true、uploadWithSourceMap false、启用 lazyCodeLoading(requiredComponents 组件按需注入) - pages/records/records.json 补全 ui-skeleton 组件声明(此前漏声明,WXML 已使用) - 删除根目录残留 preview-buttons.html
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
# 平板支撑训练小程序 · 上线前审查报告
|
||||
|
||||
日期：2026-08-04 ｜ 审查范围：上线就绪（合规 / 包体 / 性能 / 云函数部署）
|
||||
|
||||
## 一、总体结论
|
||||
|
||||
代码质量高，主包仅 **540KB**（远低于 2MB 上限），网络请求**全部走云开发 `wx.cloud.*`**（免 request 合法域名白名单配置），隐私合规链路已在上架期验证可行。
|
||||
|
||||
**有 1 个上线阻断项（云函数部署）+ 1 个部署前置（tts 环境变量）必须处理**，其余为建议优化项。未发现功能性 bug、无合规硬伤。
|
||||
|
||||
---
|
||||
|
||||
## 二、🔴 阻断项（上线前必须完成）
|
||||
|
||||
### 1. 云函数必须重新部署（最关键）
|
||||
|
||||
> 注意：**git 提交 ≠ 云函数部署**。云函数代码要生效，必须在微信开发者工具里「上传并部署」。
|
||||
|
||||
| 云函数 | 近期状态 | 动作 |
|
||||
|---|---|---|
|
||||
| `leaderboard` | **本次 b52db87 改了 17 行**（含 totalDays / 全榜勋章逻辑） | **必须重新部署**，否则线上排行榜跑旧逻辑 |
|
||||
| `tts` | 8-03 改（循环训练语音播报） | 需部署 |
|
||||
| `getOpenid` | 基础服务，排行榜定位 + 云同步依赖 | 确认已部署 |
|
||||
| `admin-dedupe` | 一次性清理工具（文档注明部署一次后删除） | 可选 |
|
||||
|
||||
部署方式：微信开发者工具 → 右键云函数 → **「上传并部署：云端安装依赖」**（项目无本地 node_modules，需云端 `npm install`）。`tts` 依赖 `tencentcloud-sdk-nodejs` 体积较大，云端安装需等待。
|
||||
|
||||
### 2. tts 云函数环境变量必须配好（部署前置）
|
||||
|
||||
`cloudfunctions/tts/index.js` 从环境变量读取密钥：
|
||||
|
||||
```
|
||||
TTS_SECRET_ID / TTS_SECRET_KEY / TTS_REGION
|
||||
```
|
||||
|
||||
若未配置，语音合成直接失败（循环训练 / 语音播报失效）。
|
||||
确认路径：云开发控制台 → `tts` 云函数 → 环境变量；并确认腾讯云 **TTS 服务已开通、密钥有效**。
|
||||
|
||||
---
|
||||
|
||||
## 三、🟡 建议项（不阻断，建议上线前做）
|
||||
|
||||
1. **清理调试 `console.log`**：`utils/cloud.js` 14 处 + `storage.js` / `voice.js` / `app.js` / `leaderboard` 云函数等。上线应移除或降级（减小包体、避免泄露内部状态、减少日志噪声）。微信审核不强制。
|
||||
2. **`project.config.json` 上线开关**：`minified: false` → `true`；`uploadWithSourceMap: true` → `false`。防源码泄露、减小包体（开发者工具上传界面也有独立勾选，会覆盖此项）。
|
||||
3. **隐私授权自定义弹窗**：代码无 `wx.onNeedPrivacyAuthorize` 处理。当前能跑（微信自动弹系统默认隐私窗，且后台隐私协议已配、已上架运行一月），但建议加自定义弹窗以更合规、体验更佳。**非阻断**。
|
||||
4. **全局错误上报**：无 `wx.onError` / `onUnhandledRejection` / `onPageNotFound`。建议加全局异常捕获 + 轻量上报（云监控 / 自建），便于线上排查崩溃。
|
||||
5. **清理残留文件**：`cloudfunctions/shared/`（空死目录，重构遗留；`leaderboard` 实际引用 `./data`，不受影响）、根目录 `preview-buttons.html`、`.claude/` / `.codegraph/`（工具目录）。小程序只打包组成文件，不影响包体，但建议加 `packOptions.ignore` 或删除以免误传。
|
||||
6. **确认生产 env**：`utils/cloud.js` 硬编码 `ENV_ID=cloudbase-d1g56kl2q8f4f7d8a`，确认是生产环境（通常单一 env 即可）。
|
||||
|
||||
---
|
||||
|
||||
## 四、✅ 已核实合规 / 无风险项
|
||||
|
||||
- 主包 540KB << 2MB，无需分包
|
||||
- 无硬编码 `http://`，全走 `wx.cloud`（免 request 合法域名配置）
|
||||
- 隐私接口仅 `chooseAvatar`（button `open-type`，后台已声明「用户信息」）
|
||||
- `app.json` 无需 `requiredPrivateInfos`（`chooseAvatar` 不在此列）
|
||||
- `sitemap.json` 标准 allow
|
||||
- `tabBar` custom + `custom-tab-bar` 目录齐全
|
||||
- 云函数依赖声明齐全（`wx-server-sdk` / `tencentcloud-sdk-nodejs`）
|
||||
- 内容安全风险低（昵称 / 头像均为用户自身数据，无实时 UGC 发布链路）
|
||||
|
||||
---
|
||||
|
||||
## 五、上线 Checklist
|
||||
|
||||
- [ ] 部署 `leaderboard` / `tts` / `getOpenid` 云函数（云端安装依赖）
|
||||
- [ ] 配好 `tts` 环境变量并验证 TTS 可用
|
||||
- [ ] 开发者工具「上传」时勾选 **压缩** + **不上传 sourcemap**
|
||||
- [ ] 体验版真机回归：训练 → 记录 → 排行榜（含空榜 / 1-2 名虚拟台）→ 设置改头像
|
||||
- [ ] 确认 MP 后台类目（运动健身类）与隐私协议有效
|
||||
- [ ] 提交审核，准备测试说明（功能无需登录，排行榜可空榜展示）
|
||||
@@ -131,3 +131,22 @@
|
||||
- 用户要求前三名勋章一致大小(此前首名 34rpx 强调、2/3 名 30rpx)。
|
||||
- 改动:leaderboard.wxss `.podium-badge--first` 34→30rpx;配套 `.podium-name--first` line-height 34→30rpx(保持首名昵称与勋章等高盒对齐)。
|
||||
- 结果:领奖台前三名勋章统一 30rpx,与全局基准(列表 .rank-badge 30、设置页 .profile-badge 30、记录页 .badge-node-icon 30)完全一致。纯样式无语法风险。
|
||||
|
||||
## 提交与推送
|
||||
- commit `b52db87`（17 文件，+690/-67）包含今天整轮(虚拟领奖台+勋章对齐结构修复+全 app 勋章 30rpx 统一)。
|
||||
- 已推 `origin`(github.com/cnliucheng/wx_pbzc) + 新增远程 `soao`(https://git.soao.net/lc/wx_pbzc.git) 并推 `main`。两个远程同步于 b52db87。
|
||||
- 提醒:cloudfunctions/leaderboard 若含线上逻辑改动需开发者工具「上传并部署」才生效(本次主要改前端)。
|
||||
|
||||
## 上线前审查(launch readiness)
|
||||
- 主包 540KB(<<2MB,无需分包);网络全走 wx.cloud(免 request 域名白名单);无硬编码 http;隐私接口仅 chooseAvatar(后台已配)。**合规面干净**。
|
||||
- 🔴 阻断项:①云函数 git 提交≠部署——`leaderboard`(本次 b52db87 改 17 行 totalDays/全榜勋章)、`tts`(8-03 改)需重新部署;②`tts` 环境变量 TTS_SECRET_ID/KEY/REGION 须在云函数控制台配好(否则语音失败)。
|
||||
- 🟡 建议项:清理调试 console.log(cloud.js 14 处等)、project.config.json 上线开关(minified→true/uploadWithSourceMap→false)、加 wx.onNeedPrivacyAuthorize 自定义隐私弹窗、加全局错误上报、清理残留(cloudfunctions/shared 空死目录/根 preview-buttons.html/.claude/.codegraph)。
|
||||
- 核实:leaderboard 实际 require('./data') 非 '../shared',空 shared 目录无害;`data.js`/`cache.js` 同目录存在,部署含之;无分包;无 wx.onError。
|
||||
- 报告:.workbuddy/launch-readiness-review.md。
|
||||
|
||||
## 执行:上线前建议项清理(用户确认"需要")
|
||||
- 清调试 console.*:脚本 .workbuddy/clean-console.js 批量删(独立 console 行 + 箭头函数体 `=> console`→`=> {}`),删 34 处;漏 2 处 `if(){console.log();return}` 行内形式手动改;Grep 复扫全项目 *.js 已无 console.* 残留。涉及 cloud.js/storage.js/voice.js/theme.js/app.js/leaderboard.js/timer.js/settings.js/cloudfunctions/leaderboard/index.js,均 node --check 通过。
|
||||
- project.config.json:minified false→true、uploadWithSourceMap true→false(上线防源码泄露+减小包体)。
|
||||
- 清残留:删 preview-buttons.html + rmdir cloudfunctions/shared(空死目录,重构遗留);.claude/.codegraph 已被 packOptions.ignore 的 `.!*` 忽略,不动。
|
||||
- 未做:全局错误上报(wx.onError)、自定义隐私弹窗(用户仅确认做这三个清理项)。
|
||||
- 改动未提交(git status 显示 M/D 文件)。clean-console.js 为一性工具,留 .workbuddy 不进包。
|
||||
|
||||
Reference in New Issue
Block a user