44fe7a0142f48a9ce7b346f37299af4ff294281b
小程序上传此前连续失败,根因分散在状态机、产物路径、模块导入、私钥解析和进程隔离上,逐项修复: - 构建进度改用 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 前缀 新增对应单测与集成断言,并更新部署说明。
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。
Languages
TypeScript
65.1%
JavaScript
29.8%
CSS
4%
PLpgSQL
0.4%
Shell
0.3%
Other
0.4%