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
2026-09-21 13:47:18 +08:00
2026-09-18 15:00:48 +08:00

Personal Brand Miniapp

面向个体经营者的个人品牌小程序试点项目。当前首个试点为餐饮摊主与私厨服务。

工程结构

apps/miniapp    # 原生微信小程序
apps/admin      # 管理后台
apps/api        # API 服务
packages/types  # 共享类型
packages/api-client
packages/validation
packages/config
packages/template-compiler       # 构建时叠加 runtime、capability、template
packages/template-<key>          # 独立行业 / 视觉模板包
packages/capability-<key>        # 可选业务流程能力包
prisma/
docs/
prototype/

环境要求

  • Node.js >= 20.18
  • pnpm 9.15
  • PostgreSQL(进入 API/数据库开发阶段时需要)
corepack enable
pnpm install
pnpm check

生成小程序模板

apps/miniapp 是运行时壳,不能直接作为完整小程序打开。使用模板编译器生成产物:

pnpm template:dev acheng-campus-food --brand default-brand
pnpm template:dev linjing-editorial --brand linjing-doors

产物位于 dist/miniapp/<brand>/,可直接用微信开发者工具打开。生产构建需额外提供 --appid、--api https://... 和 --env prod。

本地数据库

在有 Docker 的机器上执行:

cp .env.example .env
docker compose up -d postgres
docker compose ps
pnpm db:migrate
pnpm db:seed

确认数据库健康后,再启动 API:

pnpm --filter @personal-brand/api dev

停止数据库但保留数据:

docker compose stop postgres

停止并删除容器但保留数据卷:

docker compose down

删除容器和本地数据库数据(不可恢复):

docker compose down -v

DATABASE_URL 用于宿主机运行 API 时连接 localhost。如果以后把 API 也放进 Compose,连接地址应改为服务名 postgres,不能继续使用 localhost。

S
Description
No description provided
Readme
12 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 65.1%
JavaScript 29.8%
CSS 4%
PLpgSQL 0.4%
Shell 0.3%
Other 0.4%