69 lines
1.2 KiB
Markdown
69 lines
1.2 KiB
Markdown
# Personal Brand Miniapp
|
||
|
||
面向个体经营者的个人品牌小程序试点项目。当前首个试点为餐饮摊主与私厨服务。
|
||
|
||
## 工程结构
|
||
|
||
```text
|
||
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/数据库开发阶段时需要）
|
||
|
||
```bash
|
||
corepack enable
|
||
pnpm install
|
||
pnpm check
|
||
```
|
||
|
||
## 本地数据库
|
||
|
||
在有 Docker 的机器上执行：
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
docker compose up -d postgres
|
||
docker compose ps
|
||
pnpm db:migrate
|
||
pnpm db:seed
|
||
```
|
||
|
||
确认数据库健康后，再启动 API：
|
||
|
||
```bash
|
||
pnpm --filter @personal-brand/api dev
|
||
```
|
||
|
||
停止数据库但保留数据：
|
||
|
||
```bash
|
||
docker compose stop postgres
|
||
```
|
||
|
||
停止并删除容器但保留数据卷：
|
||
|
||
```bash
|
||
docker compose down
|
||
```
|
||
|
||
删除容器和本地数据库数据（不可恢复）：
|
||
|
||
```bash
|
||
docker compose down -v
|
||
```
|
||
|
||
`DATABASE_URL` 用于宿主机运行 API 时连接 `localhost`。如果以后把 API 也放进 Compose，连接地址应改为服务名 `postgres`，不能继续使用 `localhost`。
|