7b1e9eee47008117d1bd0856898616d0b9311799
- 关联的业务提供项必须存在且属于当前品牌,非法 id 返回 400 而不是数据库外键错误 - targetType 由 offeringId 推导,允许传 null 改回品牌通用入口 - 业务被停用时在发布准备度里点名说明,避免静默卡住发布 - 发布清单条目改为中性描述,是否达标交给状态标签表达
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%