上线版: 产品表单统一+form嵌套修复+用户管理+部署+三套叙事
- 产品编辑入口统一走 ProductFormFull(卖点/风格/人群/品牌词全字段); 修复开任务页 <form> 套 <form> 致"编辑产品"报错、改不了、跳回首个产品 - dashboard 入口卡片对齐实际路由: 系统管理(/config) 与 工作配置(/settings) 分开; settings ?tab=products 直达改用挂载后读 URL, 消除 hydration mismatch - 新增用户管理(users API/admin service/改密页) + alembic 022/023/024 - 上线部署: Dockerfile / docker-compose.prod+https / nginx https / .env.example - A8 三套正交叙事(痛点/场景/成分背书) + beige 调色去AI化 + 飞轮 text_import 高权重信号 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
52
docs/ops/troubleshooting.md
Normal file
52
docs/ops/troubleshooting.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# Clover 排障手册
|
||||
|
||||
## 服务不可访问
|
||||
|
||||
```bash
|
||||
docker compose -f docker-compose.prod.yml ps
|
||||
docker compose -f docker-compose.prod.yml logs --tail=100 nginx
|
||||
curl -I http://127.0.0.1/
|
||||
```
|
||||
|
||||
## 后端异常
|
||||
|
||||
```bash
|
||||
curl http://127.0.0.1/health
|
||||
docker compose -f docker-compose.prod.yml logs --tail=200 api
|
||||
docker compose -f docker-compose.prod.yml logs --tail=200 worker
|
||||
```
|
||||
|
||||
## SSE 没有实时进度
|
||||
|
||||
检查 nginx 是否关闭缓冲:
|
||||
|
||||
```bash
|
||||
curl -N -H "Accept: text/event-stream" "http://127.0.0.1/api/v1/tasks/<task_id>/stream?ticket=<ticket>"
|
||||
```
|
||||
|
||||
应能持续收到 named event。nginx 配置必须包含 `proxy_buffering off` 和 `X-Accel-Buffering: no`。
|
||||
|
||||
## 图片显示 404
|
||||
|
||||
```bash
|
||||
docker compose -f docker-compose.prod.yml exec api ls -lah /app/uploads
|
||||
docker compose -f docker-compose.prod.yml exec worker ls -lah /app/uploads
|
||||
curl -I http://127.0.0.1/uploads/<path>
|
||||
```
|
||||
|
||||
api 和 worker 必须共享同一个 `uploads` volume。
|
||||
|
||||
## 生成失败
|
||||
|
||||
常见原因:
|
||||
|
||||
- 客户未录入 API Key。
|
||||
- provider key 余额不足或无权限。
|
||||
- 上游中转站 429/503。
|
||||
- 产品入镜但未上传产品图。
|
||||
|
||||
查看 worker 日志:
|
||||
|
||||
```bash
|
||||
docker compose -f docker-compose.prod.yml logs --tail=200 worker
|
||||
```
|
||||
Reference in New Issue
Block a user