chore: align local docker environment

This commit is contained in:
2026-05-19 13:40:25 +08:00
parent 7292bb2eaf
commit c49e1b3187
6 changed files with 117 additions and 5 deletions

View File

@@ -1,8 +1,9 @@
# AI玩具专利生成工作流
## 启动
- `cd ~/Projects/code/20260518-ai-toy-patent-workflow && npm run dev`端口 4560
- 推荐本地环境:`cd ~/Projects/code/20260518-ai-toy-patent-workflow && npm run docker:up` — Docker Compose端口 4560
- 浏览器打开 http://localhost:4560
- 备用非 Docker 开发:`npm run dev` — 端口 4560
- 首次依赖装好:`npm install --legacy-peer-deps`next 15 + react 19 有 peer 警告)
## 部署事实
@@ -11,7 +12,7 @@
- 服务名 / 容器名:`ai-toy-patent-workflow`
- 服务器路径:`/opt/ai-toy-patent-workflow`
- 主站 / 前端https://ai-toy.kang-kang.com
- 本地 devhttp://localhost:4560
- 本地 Dockerhttp://localhost:4560
- API / 后端:内置 Next.js API Route生产同域名
- 文档 / 解析:无
- 管理后台:无
@@ -22,6 +23,8 @@
## 元数据回写清单
- 改公网域名或迁移部署时,更新 `.project.json.urls` + 本节
- 数据持久化在 `data/`gitignored不入库上传原图在 `data/uploads/`
- 本地 Docker 使用 `docker-compose.yml`,挂载 `./data:/app/data`,读取 `.env.local`,并强制 `PUBLIC_APP_URL=http://localhost:4560`
- VPS 生产 Docker 使用 `docker-compose.prod.yml`,挂载 `./data:/app/data`,读取 `deploy/.env.production`,并强制 `PUBLIC_APP_URL=https://ai-toy.kang-kang.com`
- VPS 数据持久化在 `/opt/ai-toy-patent-workflow/data`
- VPS 生产环境变量在 `/opt/ai-toy-patent-workflow/deploy/.env.production`,不入库
@@ -35,6 +38,7 @@
- `SEEDANCE_API_BASE` — 默认 `https://ark.cn-beijing.volces.com/api/v3`
- `PUBLIC_APP_URL` — 生产填公网入口,用于把 `/api/img/...` 补成 Seedance 可访问的绝对 URL
- 配置位置:`.env.local`gitignored参考 `.env.local.example`
- 生产配置模板:`deploy/.env.production.example`;真实生产值只放 VPS 的 `/opt/ai-toy-patent-workflow/deploy/.env.production`
- 图片生成未配置 GPT Key 时回退 mockSVG 占位图),视频生成不 mock必须配置 Seedance Key
## 规则