R524809
6.5 KiB
想法
直接使用view等原生代替canvas进行渲染，方便用户操作，只在最后导出图片时才渲染canvas。或者每次修改渲染隐藏canvas。 以此减少交互和适配成本。
公开预览图配置
预览图和固定字体的公开地址统一配置在 miniprogram/config/assets.ts：
publicDomain: 'https://cdn.joeyone.cn',
keyPrefix: 'doodle-assets/',
首页预拉取、旧 pageConfig 缓存、新后端动态兜底，以及年龄推荐、收藏、下载记录和内容管理页的旧预览图，展示前统一通过 resolvePreviewUrl 转成七牛地址。旧云存储临时链接也会转换并去掉旧签名；其他环境、外部图片、本地图片和头像不参与此次预览图替换。分类页继续使用新后端返回的七牛地址。重新编译小程序即可使用，无需手工清除 pageConfig 缓存。
cache/page-config.json 中的 34 处预览引用已替换。兼容逻辑不修改线上云数据库、云函数或已上传的配置 JSON；旧数据由客户端读取时转换。新的预览上传由管理员上传接口写入七牛，再以 ready 资产 ID 发布元数据。
运行预览图回归测试：npm run test:assets；分类页回归：npm run test:category。
新后端静默登录与鉴权
启动及回到前台时通过 utils/auth.ts 非阻塞预热：wx.login 取一次性 code，调用 POST /api/v1/auth/wechat/login。首次使用 start，已有会话续期和 401 恢复使用 resume；明确无效 code 最多重新取一次。JWT 与用户摘要按 AppID、包类型、环境名称和接口地址分开保存，凭证到期前 60 秒按需续登。不缓存角色或微信 OpenID，不记录凭证、code 或完整登录响应。
统一请求层 services/api-request.ts 默认要求登录并携带 Bearer；公开分类与题型接口显式指定 auth: 'none'，不携带凭证、不触发登录。受保护请求遇到可恢复 401 时最多重登并重发一次，并发请求合并登录，迟到的旧 401 不会清掉新凭证。恢复后身份变化时不补发原业务写入。403、限流、服务错误或网络失败不触发自动重登链。
import { apiRequest } from './services/api-request';
import { getUser, refreshUser } from './utils/auth';
// 获取新后端用户摘要；必要时静默登录。
const user = await getUser();
// 受保护的 GET /me，读取最新资料；不会先清掉有效凭证。
await refreshUser();
// 新增本人业务接口默认使用统一鉴权；公开接口显式 auth=none。
await apiRequest('/me');
账户不存在或禁用时停止自动恢复，不自动切回 start 重建账户；账户历史标记保留在同一个版本化缓存中。个人中心仅在需要用户主动重新开始时显示“开始使用账户”。登录失败不阻塞公开浏览、本地生成和导出。
用户资料、头像上传、收藏、下载记录和账户设置现已全部使用新后端及 globalData.user，旧登录兼容层已移除。界面保留少量 _id 展示字段映射，来源始终是新后端 ID，不再调用旧云业务。正式环境切换前仍需单独迁移历史用户及关联数据，线上 API 地址当前仍待配置。
验证：npm run test:auth；联合回归可执行 node --import tsx --test tests/auth-api.test.mjs tests/category-api.test.mjs tests/preview-assets.test.mjs。微信兑换在测试中使用模拟响应，真实一次性 code 需要在微信开发者工具或真机联调；没有加入绕过微信验证的测试登录接口。
业务接口切换
本地开发中的小程序运行代码已不再调用 wx.cloud；体验版与正式版首页继续使用 wx.getBackgroundFetchData 获取预拉取首屏，在后台使用新 /page-config 刷新。开发版跳过旧线上预拉取，使用所选接口环境自己的内容缓存及新后端；管理改动也会刷新首页。旧云端的预拉取地址、生成与发布链路、定时任务保持原样，新管理开关仅控制新后端的快照刷新任务。
当前已发布的线上版仍使用旧云开发接口。cloudfunctions/ 中全部旧云函数源码、云开发配置及线上服务均须保留；本地开发版切换接口不代表线上旧版本已停止调用。未经另行明确安排，不删除、停用旧云函数，不改变其接口契约，不清理旧云数据库或云存储，也不迁移现有预拉取模式。
用户接口由 services/member-api.ts 与 utils/auth.ts 管理，管理页由 services/admin-api.ts 适配具名 REST 路由。图片通过本站 multipart 上传接口进入七牛，不暴露 AK/SK；同一次上传恢复沿用 UUID uploadId。管理页只能由数据库中当前角色为 admin 的账户操作，开发版不会绕过权限。
服务端路由、权限与数据迁移说明见 doodle-store 的 docs/v3.5/小程序云接口迁移清单.md。旧云端用户、收藏与下载历史本次未自动导入，正式切换前需要另行核对迁移。
开发版接口环境切换
入口：个人中心 → Debug 工具 → 接口环境。develop 可切换 local / staging / production，选择保存在本机，切换后自动重建页面返回首页，无需重新编译。开发版导航栏显示当前环境。trial / release 固定使用 production，忽略本机调试选择，配置层与切换入口均有校验。
地址在 miniprogram/config/api.ts 集中配置：
localBaseUrl：本地开发接口。stagingBaseUrl：未来测试接口。productionBaseUrl：未来正式接口。
目前按要求，三个地址都暂填 http://127.0.0.1:8800/api/v1，客户端缓存和会话按环境隔离，但实际请求仍访问同一个本地后端和数据库。真机的 127.0.0.1 指向手机；调试时 local 需改为电脑局域网地址。部署时把 staging/production 占位地址改为对应 HTTPS 地址，不会因地址缺失自动回退 local。
切换会清空共享用户和内容状态，读取目标环境凭证，并强制从目标接口加载首页；原环境的缓存与会话保留。所有 API 响应按环境版本检查，即使快速 A→B→A，旧请求也不能覆盖当前数据。写请求（含登录等待及上传重试）未完成时禁止切换。目标接口不可用时提示连接失败并保留所选环境，不展示上一环境的内容。打印偏好继续共用。
本轮仅调整开发版数据来源；体验/正式包原预拉取模式、地址及全部旧云端服务保持原样。
环境切换回归：node --import tsx --test tests/environment-switch.test.mjs。