From 3035efcceb08a24a58c158853d87f92dd6eb3629 Mon Sep 17 00:00:00 2001 From: kang Date: Wed, 27 May 2026 15:06:31 +0800 Subject: [PATCH] docs: codify marketing product baseline --- AGENTS.md | 8 ++++++++ RULES.md | 7 +++++++ docs/source-analysis.html | 42 ++++++++++++++++++++++++++++++++++++++- 3 files changed, 56 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index c90e71d..22d1aa3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -17,6 +17,14 @@ - `.memory/worklog.json` 是辅助日志，不代替人工语义 commit 和 Gitea 远端记录 - 不能推送时，必须说明当前分支、本地领先/落后数量、最新未推送 commit 和失败原因 +## Product Baseline Contract + +- 最终产品基线是 `https://marketing.skg.com` 登录后的个人生成画布；本地开发和验收必须尽量复刻这套线上运行形态。 +- 根域名生产入口由 `web/canvas-app/` 的 Vue / Vite 画布产物承载；旧 React 首页、旧 TK 复刻工作台、Agent Cut 和详情页能力只能作为高级/兼容/回滚参考，不能当默认产品基线。 +- 之后所有升级、修复和产品判断，优先围绕根域名画布、当前 `/api`、Postgres 持久化、飞书登录和 owner 隔离展开。 +- 本地同构环境优先使用 Docker：`docker-compose.local.yml` + `deploy/.env.local` + `data-local/`；不要用本地 dev server 的偶然行为代替生产形态判断。 +- 遇到线上用户 bug，先只读确认生产事实：用户身份、owner、job、canvas project、generated asset、日志时间线；必要时把最小可复现数据拉到本地 Docker 环境复现和修复，不能直接在生产库里试错。 + ## Deployment Metadata Contract - 任何任务只要新增、删除或修改公网地址，必须在同一次任务里更新 `.project.json` diff --git a/RULES.md b/RULES.md index c7c2f17..4a43aff 100644 --- a/RULES.md +++ b/RULES.md @@ -12,6 +12,13 @@ - 注意：后端不要带 `--reload` 跑长下载 / 抽帧 / 音频任务；reload 会等待后台任务结束，导致 4291 端口占用但新请求卡住。 - 发布流程新规则（2026-05-26）：所有修改默认先在本地 Docker 跑通并验证，确认可用后只保留本地 commit；只有用户明确说“可以推送 / 上推 / 部署”时，才允许 `git push` 或执行生产部署。 +## 最终产品和排查基线 +- 最终产品入口固定为 `https://marketing.skg.com`；登录后根路径进入个人生成画布，之后所有升级和修复都以这套线上画布为主线。 +- 当前本地基线必须尽量和线上一致：优先用 `./scripts/start-local-docker.sh` 启动 Web/API/Postgres，用 `./scripts/verify-local-docker.sh` 验证；只在需要快速定位前端细节时才临时使用 `npm run dev` 或 `npm run dev:canvas`。 +- 旧 React 单对话框首页、旧 TK 复刻工作台、Agent Cut 和详情页功能保留为高级能力、兼容入口或代码参考；除非明确要求恢复，否则不要把它们当作新需求默认落点。 +- 用户线上 bug 的默认处理顺序：确认用户和时间线 → 只读查询生产 API 容器内 `DATABASE_URL` / Postgres 与相关 job state → 必要时复制最小可复现数据到本地 Docker → 本地修复和验证 → 本地 commit → 等用户确认后再推送或部署。 +- 排查线上数据时不要手动写生产库，不要覆盖服务器 `deploy/.env.production`、`data/`、`secrets/` 或 `/data/jobs`；需要恢复用户数据时先备份并给出影响范围。 + ## 立项决策快索引 - 详见 `CLAUDE.md` 立项决策段 + `.memory/plan.md` 七步管线拆解 - 风格：`04-Dark-Gallery-Ambient`（路径：`~/Projects/research/20260305-网页风格库/04-Dark-Gallery-Ambient.md`） diff --git a/docs/source-analysis.html b/docs/source-analysis.html index 8e19c9b..c28df97 100644 --- a/docs/source-analysis.html +++ b/docs/source-analysis.html @@ -461,6 +461,7 @@