Phase 0 后续执行计划

日期：2026-09-08
基线：V1_PLAN.md 第 13.3 节及本次 AUDIT.md、API_CONTRACT.md、DECISIONS.md
原则：只把有证据的能力标为完成；产品参数和环境参数未确认时保持待确认。

1. Phase 0 工作包状态

编号	状态	证据	遗留
P0-01	已完成	`AUDIT.md`：规则、Git、目录、启动说明和服务边界	上游 TTS 不在当前仓库，需授权联调
P0-02	已完成	`AUDIT.md`：框架、依赖、页面、接口、持久化和资产矩阵	所有业务模块均需新增
P0-03	已完成（接口未核实）	`API_CONTRACT.md`：事实/目标分离和适配边界	缺上游协议、凭据、音色、参数和失败样例
P0-04	已完成（资料有缺口）	`AUDIT.md`：品牌、网络拓扑和测试机条件	产品资料、域名、HTTPS、反向代理和服务未就绪
P0-05	已完成（版本待定）	`DECISIONS.md`：目录、数据归属、会话、任务、CMS 和代理决策	运行时/依赖版本需验证
P0-06	已完成（产品值待定）	本文件：配置清单、依赖和阶段入口	额度、并发、超时、保留期和备份策略需确认

2. Phase 1 入口条件

必须先满足

选择并锁定 Web/API/CMS/Worker 的兼容版本，提交不含秘密的示例配置和可复现安装方式。
提供至少一组真实产品资料：名称、型号、图片、规格、应用场景和可公开文案；没有资料时只能做结构骨架，不能声称内容上线。
确认公司联系方式、正式域名/测试入口和 HTTPS 方案。
明确测试机运行方式：安装 Node.js/Python 依赖，或提供经批准的容器运行时。当前 flym 的 sudo 需要交互密码，不能进行无授权安装。
明确测试数据、数据库、音频存储、备份位置和密钥注入方式，和生产隔离。

可并行推进

依据现有品牌参考建立设计令牌、色值、Logo 使用规则、字体回退和响应式断点。
建立公开官网页面骨架和本地结构化产品适配器，不伪造产品事实。
建立登录、注册、账户、TTS 和管理页面的加载/空/错误/禁用状态组件，但不把静态界面当成功能。
在上游信息到位后编写 TTS 适配器测试夹具，先验证请求映射和错误映射，再接入真实环境。

3. 后续阶段工作清单

Phase 1：视觉与官网骨架

P1-01 已完成：建立品牌色、灰阶、字体、间距、按钮、输入、焦点和响应式变量，见 app/globals.css 和 components/ui.tsx。
P1-02 已完成：建立当前 Web 骨架、导航、页脚、移动导航、通用容器和登录/账户入口。当前落点为仓库根目录 App Router，后续可迁入 apps/web，不改变组件边界。
P1-03 已完成：实现以蓝牙、音频和智能硬件为主体的首页；AI Lab/TTS 仅作轻量入口。
P1-04 已完成：实现产品列表、详情模板、关于和联系页面，使用 lib/content.ts 集中管理的开发占位数据。
P1-05 已完成（布局）：实现 TTS、认证、账户和管理页面状态结构；所有真实提交和操作均未启用，不显示假成功。
P1-06 已完成（静态/HTTP）：完成 SEO metadata、404、键盘焦点、减少动效、响应式源码检查、构建和路由冒烟。真实浏览器截图待测试环境具备浏览器或授权自动化工具后补充。

交付证据：可运行 Web 骨架、页面检查记录和 docs/phase-1-report.md。动态认证、CMS 发布和真实 TTS 仍不在本阶段宣称完成。最小 LAN HTTP 部署方案已写入 Phase 1 报告。

Phase 1 当前可在本地继续开发，也可在测试机仅部署官网骨架。测试机部署前需准备 Node.js、用户目录、TCP/3000 局域网访问和必要安装权限；数据库、TTS、CMS、正式域名和 HTTPS 不作为本阶段部署前置条件。

最小测试部署已完成：http://192.168.199.22:3000/ 可访问，部署结果和人工视觉验收清单见 docs/phase-1-report.md。当前未配置自动重启、Nginx/Caddy、HTTPS 或生产服务。

部署改进待办：下一次部署改为保留目录结构的统一打包部署，自动携带并核对构建提交号、关键源码哈希、.next 构建时间、监听进程工作目录和页面版本标识；禁止再次通过逐个文件传输更新生产/测试站。

Phase 2：认证与权益基础

P2-01 建立 User、Session、PlanPolicy、MembershipGrant、QuotaAccount、UsageRecord、VerificationChallenge 和审计迁移。
P2-02 实现真实注册、登录、退出、当前用户、改密和可撤销会话。
P2-03 实现权限、账号禁用、CSRF、站内跳转校验和认证限流。
P2-04 实现有效 Plan、VIP 到期、额度周期和余额读取。
P2-05 完成账户页和真实空历史状态。
P2-06 实现验证服务抽象、开关、挑战过期和一次性消费；未接渠道返回未启用。
P2-07 建立受控管理员初始化及服务层管理、会员、额度调整能力。

Phase 3：TTS 与额度闭环

进入条件：Phase 2 认证/归属/权益可用，且获得真实上游联调权限和测试额度。

P3-01 依据 API_CONTRACT.md 建立音色、任务、音频模型和上游适配器。
P3-02 实现幂等、文本校验、限流、并发控制和额度冻结事务。
P3-03 实现 Worker 租约、超时、结果核对和有限重试。
P3-04 实现音频校验、私有存储、成功消费、失败释放和对账。
P3-05 接通工作台提交、轮询、结果和错误恢复。
P3-06 完成分页历史、详情、回放和下载，验证跨用户隔离。
P3-07 验证重复提交、额度争用、上游失败、存储失败、跨周期和重启恢复。

Phase 4：CMS 与管理后台

P4-01 配置 apps/cms、独立内容存储边界和受控 CMS 账号。
P4-02 实现 Product、Media、SiteSettings、HomeContent 及媒体/富文本安全限制。
P4-03 实现草稿、预览、发布、下架和缓存失效。
P4-04 实现用户查询、筛选、禁用/恢复和最后管理员保护。
P4-05 实现 VIP 授予/撤销、期限、额度调整和操作原因审计。
P4-06 实现 TTS 任务、使用汇总、失败信息和审计查看。
P4-07 完成产品发布及用户/VIP/额度/任务运营演练。

Phase 5：集成与上线准备

真实环境 HTTPS、反向代理、私网、持久卷和服务凭据。
外部验证 TTS、数据库、Redis、对象存储管理端和其他裸端口不可公开访问。
备份/恢复、Worker 重启、额度对账、音频恢复和回滚演练。
越权、CSRF、限流、敏感日志、草稿、音频授权、响应式、可访问性和 SEO 验收。
输出 DEPLOYMENT.md、OPERATIONS.md、ACCEPTANCE.md 和 Phase 5 报告。

4. 待定配置清单

未获得产品/上游/容量依据前，以下值不能写成默认无限或永久：

配置	当前值	依赖/负责人
Free 周期额度	待确认	产品负责人
VIP 周期额度	待确认	产品负责人
额度周期	规划默认 UTC 自然月	产品确认；实现前固定
单次最大文本长度	待确认	上游限制 + 产品负责人
计量函数	规划为 Unicode 码点数，待与上游核对	API/产品
Free/VIP 并发	待确认	上游容量 + 产品负责人
注册/登录/TTS 限流	待确认	安全基线 + 压测
上游连接/读取/任务超时	待确认	TTS 联调
最大重试次数	待确认	上游幂等和失败语义
音频保留期	待确认	产品/隐私/存储预算
原始文本保留期	待确认	产品/隐私
日志和审计保留期	待确认	运维/合规
Session 有效期	待确认	安全与体验
密码 Argon2id 成本	待部署压测	测试机资源
数据库/音频备份保留	待确认	运维负责人

5. 阻断项清单

优先级	阻断项	解除条件	影响阶段
P0	TTS 接口事实缺失	提供已授权上游地址、脱敏协议和联调凭据	Phase 2/3
P0	测试机未安装应用栈	明确运行方式并授权安装/提供预装环境	Phase 1 起部署验证
P0	HTTPS/域名未确定	提供测试域名或可信证书方案	Phase 2 认证测试、Phase 5
P1	产品资料缺失	提供真实图片、型号、规格、文案和联系方式	Phase 1/4/5
P1	备份位置和恢复责任未确定	指定隔离备份位置、保留期和负责人	Phase 5
P1	sudo 需要交互密码	由管理员执行系统变更或配置受控运维权限	依赖安装/代理/持久服务

6. Phase 1 进入判定

当前 Phase 0 已完成文档交付，但尚不满足测试服务器部署和真实 TTS 联调条件。在不修改服务器服务的前提下，可以进入本地 Phase 1 页面骨架和设计系统；若要求 Phase 1 同步部署到 192.168.199.22，必须先解除“应用栈未安装、HTTPS 入口未确定、部署权限未确定”三个阻断项。

9.1 KiB Raw Blame History Unescape Escape