persionalBrand/README.md

Personal Brand Miniapp

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

工程结构

apps/miniapp    # 原生微信小程序
apps/admin      # 管理后台
apps/api        # API 服务
packages/types  # 共享类型
packages/api-client
packages/validation
packages/config
prisma/
docs/
prototype/

环境要求

• Node.js >= 20.18
• pnpm 9.15
• PostgreSQL（进入 API/数据库开发阶段时需要）

corepack enable
pnpm install
pnpm check

本地数据库

在有 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。