de6466737b
- HANDOVER.md: 守印接手第一入口,全景+上手路径+文档地图 - backend/BACKEND_MAP.md: 后端接手地图(路由/模型/AI引擎/评分维度) - 路线图.md: 现状vs目标差距(三视角×双目标矩阵+7/15倒排冲刺) - .env.example x3: 补全 MODEL_VISION/CLAUDE_API_URL 及本地SSE示例 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Clover 客户交付运行说明
Clover 是北哥小红书产品内容生产系统，包含：
backend/：FastAPI + Celery + MySQL + MongoDB + Redisfrontend/：Next.js 运营端docker-compose.prod.yml：客户交付部署入口，数据库端口不暴露到宿主机
交付前必做
- 复制
.env.example为.env，填入客户环境专属密钥和域名。 - 生成新的
FERNET_KEY、JWT_SECRET、数据库密码，不复用开发环境值。 - 同域 nginx 部署时
NEXT_PUBLIC_API_BASE_URL和NEXT_PUBLIC_SSE_BASE_URL保持空；前后端分域时填公网 API 域名，修改后必须重新 build 前端镜像。 - 设置
CORS_ALLOW_ORIGINS为客户前端域名，多个域名用英文逗号分隔。 - 交付包不要包含任何真实
.env、.env.bak、node_modules、.next、verify_output、截图或本地日志。
生产启动
HTTP 内测：
docker compose -f docker-compose.prod.yml --env-file .env up -d --build
HTTPS 正式部署需先放置证书：
certs/fullchain.pem
certs/privkey.pem
然后使用 override：
docker compose -f docker-compose.prod.yml -f docker-compose.https.yml --env-file .env up -d --build
健康检查：
curl http://localhost/health
前端默认访问 nginx 入口：
http://localhost
本地验证
后端：
cd backend
python3 -m compileall -q app tests
python3 -m pytest
前端：
cd frontend
npm run lint
npm run build
已知交付边界
- 用户 API Key 通过前端设置页录入，后端只保存 Fernet 加密密文。
apiports图片编辑走/chat/completions多模态参考图路径；codeproxy图片编辑走/images/edits。- A/B/C 三套内容必须各选择一条文案，并且每套选满配置的图片数量后才能提交审核。