docs: codify marketing product baseline

This commit is contained in:
2026-05-27 15:06:31 +08:00
parent f3c0500b60
commit 3035efcceb
3 changed files with 56 additions and 1 deletions

View File

@@ -461,6 +461,7 @@
<nav aria-label="页面目录">
<a href="#purpose">为什么有这页</a>
<a href="#how-to-use">怎么用它描述需求</a>
<a href="#product-baseline">最终产品基线</a>
<a href="#runtime">运行与入口</a>
<a href="#pipeline">业务管线</a>
<a href="#source-map">源码结构地图</a>
@@ -486,10 +487,12 @@
<p>
它把“你看到的界面、你想改的功能、实际要动的源码、可能影响的数据和接口”放在同一个地方。
后续描述需求时,可以直接说“改素材输入列 / 音频解析结果 / 分镜工作台 / 候选视频预览下载 / 某个接口行为”,这样改动范围会更准,也更容易追踪每次变更带来的影响。
当前最终产品基线是 <code>https://marketing.skg.com</code> 登录后的个人生成画布;旧版本能力只作为高级入口、兼容入口或源码参考。
</p>
<div class="meta-grid">
<div class="meta"><b>项目路径</b><span>/Users/kangwan/Projects/business/20260512-20260512-skg-tk-二创验证</span></div>
<div class="meta"><b>前端</b><span>Next.js 16 · 端口 4290 · web/app/page.tsx</span></div>
<div class="meta"><b>最终产品</b><span>https://marketing.skg.com · 登录后根路径个人生成画布</span></div>
<div class="meta"><b>前端</b><span>Vue / Vite 画布为生产首屏 · Next.js 16 保留登录/详情/旧能力</span></div>
<div class="meta"><b>后端</b><span>FastAPI · 端口 4291 · api/main.py</span></div>
<div class="meta"><b>本文档位置</b><span>docs/source-analysis.html · 独立文件,不接入应用</span></div>
</div>
@@ -516,6 +519,31 @@
</div>
</section>
<section id="product-baseline" data-search>
<h2>最终产品基线</h2>
<div class="callout good" style="margin-bottom:14px">
<p><strong>以后所有升级默认指向:</strong><code>https://marketing.skg.com</code> 登录后的个人生成画布。这个画布是员工真实使用的最终产品,不是旧 React 首页,也不是早期 TK 复刻工作台。</p>
</div>
<div class="grid-3">
<div class="card">
<h3>线上基线</h3>
<p>生产入口是根域名 <code>/</code>,由 <code>web/canvas-app/</code> 构建产物承载;<code>/canvas/</code> 只做旧链接兼容跳转。飞书登录、owner 隔离、Postgres 画布项目、个人工作流和当前 <code>/api</code> 是默认产品上下文。</p>
</div>
<div class="card">
<h3>本地同构</h3>
<p>本地排查和验收优先用 <code>./scripts/start-local-docker.sh</code> 启动 Web / API / Postgres<code>./scripts/verify-local-docker.sh</code> 验证。临时 dev server 只能帮助定位细节,不能替代生产形态判断。</p>
</div>
<div class="card">
<h3>旧版定位</h3>
<p>旧 React 单对话框首页、旧 TK 复刻工作台、Agent Cut 和详情页仍可作为高级能力、兼容入口、回滚点或代码参考;除非明确说恢复,否则新需求不要默认落到这些旧版本。</p>
</div>
</div>
<div class="card" style="margin-top:14px">
<h3>用户 bug 拉取和修复口径</h3>
<p>遇到线上用户问题时先按只读方式确认用户、时间、URL、job、canvas project、generated asset 和日志时间线;生产数据库优先从 <code>skg-marketing-api</code> 容器读取现有 <code>DATABASE_URL</code> 查询,避免猜测连接方式。需要复现时,只复制最小必要状态到本地 Docker 环境,不在生产库里试错。修复完成后先本地 Docker 验证和本地 commit只有用户明确确认后才推送或部署生产。</p>
</div>
</section>
<section id="runtime" data-search>
<h2>运行与入口</h2>
<table>
@@ -1277,6 +1305,18 @@ ProductRefStateItem {
<h2>变更记录</h2>
<p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
<div class="changelog">
<article class="change">
<header>
<h3>2026-05-27 · 固化最终产品和本地同构排查基线</h3>
<span class="tag violet">Product</span>
<span class="tag green">Ops</span>
</header>
<div class="body">
<p><strong>问题:</strong>项目经历过 React 单对话框、TK 复刻工作台、根域名画布、Postgres 持久化等多个版本,后续修复如果不先锁定主线,容易把旧入口或旧工作流误当成当前最终产品。</p>
<p><strong>改动:</strong>本页新增“最终产品基线”,明确后续升级默认针对 <code>https://marketing.skg.com</code> 登录后的个人生成画布;<code>AGENTS.md</code><code>RULES.md</code> 同步增加产品基线、本地 Docker 同构环境和线上用户 bug 只读排查 / 本地复现流程。</p>
<p><strong>影响:</strong>以后处理用户 bug 时先确认线上用户、时间线、job、画布项目和资产状态必要时把最小可复现数据拉到本地 Docker 修复。旧 React 首页、TK 复刻工作台、Agent Cut 和详情页只作为高级能力、兼容入口或源码参考。</p>
</div>
</article>
<article class="change">
<header>
<h3>2026-05-27 · 视频完成后自动回填画布节点</h3>