Files
persionalBrand/apps/taro
que01 44fe7a0142 fix: 打通小程序代码上传链路
小程序上传此前连续失败,根因分散在状态机、产物路径、模块导入、私钥解析和进程隔离上,逐项修复:

- 构建进度改用 updateBuild 只写 buildStatus/buildLogs,不再用 updateStatus 记录进度,避免状态机拒绝自我迁移而返回 409
- 产物目录锚定仓库根目录,不再随 API 进程工作目录变成 apps/api/apps/taro/dist
- miniprogram-ci 为 CommonJS 包,动态导入后从 default 归一化取 Project/upload,替换原有的类型断言
- 上传私钥统一还原成合法 PEM;输入框曾把换行吞成单行,导致 OpenSSL 解码失败,现保存时校验、上传时自动修复存量数据
- 上传改在独立子进程执行,miniprogram-ci 崩溃或超时不再终止 API 进程,失败返回 502 并保留微信原始错误
- 构建超过 MINIAPP_BUILD_STALE_MS 无进度即视为中断,允许重新上传,避免任务永久卡在 building
- 构建前校验请求地址与 AppID,请求地址支持在品牌配置中维护,环境变量仅作回落,避免再打出指向 localhost 的包
- 小程序 /media/ 按请求地址的 origin 解析,不再依赖网关剥离 /api 前缀

新增对应单测与集成断言,并更新部署说明。
2026-10-13 21:58:48 +08:00
..

Taro 模板双端工程

本目录在独立迁移分支提供 Web 和微信小程序共用的 React 页面。后台、Prisma 和发布 API 不变;当前原生模板构建仍保留。

启动 Web

在仓库根目录执行:

pnpm install
pnpm --filter @personal-brand/types build
pnpm --filter @personal-brand/taro dev:h5

默认餐饮模板、default-brand、API http://localhost:3001,Web http://localhost:3002。

林境模板:

TEMPLATE_KEY=linjing-editorial PREVIEW_PORT=3003 pnpm --filter @personal-brand/taro dev:h5

API 地址通过 API_BASE_URL 设置,品牌通过 BRAND_SLUG 设置。H5 也可在地址查询参数使用 ?brand=linjing-doors,但必须与构建模板匹配。环境变量通过命令环境传入;.env.example 是参数说明,不自动加载真实密钥。

构建

pnpm --filter @personal-brand/taro build:h5
pnpm --filter @personal-brand/taro build:weapp
TEMPLATE_KEY=linjing-editorial pnpm --filter @personal-brand/taro build:h5
TEMPLATE_KEY=linjing-editorial pnpm --filter @personal-brand/taro build:weapp

输出 apps/taro/dist/<templateKey>/h5 和 weapp。微信开发者工具导入对应 weapp 目录;构建时通过 API_BASE_URL 设置 API 地址,通过 WEAPP_APP_ID 或 TARO_APP_ID 设置小程序 AppID,并在微信公众平台配置请求合法域名。默认 touristappid 仅用于浏览,不含密钥。

页面结构和样式以 React 原型为参考,当前原生小程序用于校对字段、结构化来源、认证与提交行为。模板实现位于各 package 的 taro/;公共请求、表单、记录和状态位于此目录。新模板须提供 manifest、Taro 实现和验收用例,不新增全局 seed。

使用边界

Web 支持真实已发布内容、导航、餐品搜索/分类、咨询表单填写和校验。未接入 Web 身份登录,因此没有微信会话时不会提交,不生成假咨询或伪造成功。微信小程序采用 Taro.login 和原 customer/session/wechat 接口。令牌按品牌隔离;请求失败保留表单输入,401 清理会话。

Web 与小程序来自同一套源码,H5 排版检查不等同微信原生验收。原生微信登录、拨号、剪贴板及真机排版须在微信环境最终核验。

验证

pnpm --filter @personal-brand/taro typecheck
pnpm --filter @personal-brand/taro lint
pnpm --filter @personal-brand/taro test
pnpm --filter @personal-brand/taro test:browser

浏览器测试需要先启动 API 和餐饮 H5 预览。PREVIEW_URL 指定预览地址,CHROMIUM_PATH 指定本机 Chromium;测试只读取开发库,模拟错误响应用于失败路径,不写入真实数据。

回滚与切换

所有工作在 feat/taro-template-preview 独立 worktree。用户确认前不合并、不切换主工作区、不修改开发数据库或原 dist/miniapp。确认后另行切换默认构建;旧 template:dev 始终可用。

Taro 4.3 官方依赖树含部分旧依赖 deprecation 和 punycode 提示,跟进负责人为框架维护者;本项目固定版本并检查双端产物。Admin React 19 与 Taro React 18 在各 workspace 依赖边界独立,避免跨端插件 peer mismatch。