4d1cd8f3657eaae57f923888cfa252f5974be410
Traefik 把 wechat.app.que01.top 上除 /api、/media 以外的路径直接转发到 Admin 静态 服务器且没有鉴权,因此 /admin/assets/*.js 可以被任意下载。后台产物里的模板 renderer glob 路径(packages/template-*/taro/index.tsx)与按钮尺寸令牌(--taro-button-height) 同样暴露技术栈,此前只遮蔽了 Taro 双端产物。 - mask-taro.cjs 增加 admin 目标,覆盖 apps/admin/dist,接入根脚本 build:admin:preview; - deploy:package 在后台构建后校验 apps/admin/dist,命中指纹即中止打包; - 补充遮蔽目标测试与文档(ADR 0025、README、部署说明、交付清单)。 验证:后台产物遮蔽后 glob key 与运行时查找同步改名;未遮蔽/已遮蔽产物用生产静态 服务器跑同一套后台浏览器测试,失败内容逐字节一致(既有失败与本改动无关);H5 预览 11 项浏览器回归全部通过;admin 构建、lint、typecheck、deploy 与 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%