df1856d793
- 产品编辑入口统一走 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>
1.8 KiB
1.8 KiB
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 三套内容必须各选择一条文案，并且每套选满配置的图片数量后才能提交审核。