文档目录索引

Strategy

• strategy/memory.md：产品长期规划、商业判断和发展路径。

Planning

• planning/Phase1Plan.md：0-3 个月 MVP 产品设计与实施路线。

Implementation

• implementation/phase-1/Phase1_1_Implement.md：Phase 1.1，本地可编辑首页。
• implementation/phase-1/Phase1_2_Implement.md：Phase 1.2，统一数据结构与 Next.js 迁移。
• implementation/phase-1/Phase1_3_Implement.md：Phase 1.3，同步码跨设备同步；包含 Phase 1.3.1 之后的后续实施记录。
• implementation/phase-1/Phase1_4_Implement.md：Phase 1.4，前端展示页与编辑交互优化。
• implementation/phase-1/Phase1_5_Implement.md：Phase 1.5，账号登录与首页空间管理；包含完整实施记录、账号模型、数据库安全计划和 Phase 1.6 衔接。
• implementation/phase-1/Phase1_6_Implement.md：Phase 1.6，账号托管同步与 Beta 打磨；包含账号托管同步基础、账号托管空间创建、恢复默认同步保护、空白设备账号恢复、同步码迁移为账号托管、首页空间 CRUD、同步码入口降级、管理边界补强、全局偏好编辑、Beta 状态统一、数据导出、模板库 v1，以及浏览器收藏/标签导入移入 Phase 1.9 的阶段调整记录。
• implementation/phase-1/Phase1_7_Implement.md：Phase 1.7，组件开发；记录组件框架与 Widget Registry、组件面板增删排序、Todo List v1、日历/万年历 v1、组件布局与编辑体验和组件默认配置。
• implementation/phase-1/Phase1_8_Implement.md：Phase 1.8，主题与普通个性化；记录主题风格切换、空间级主题 preset、CSS token、Banner/背景图片 v1、Storage 上传、signed URL 渲染和个性化细节收口。
• implementation/phase-1/Phase1_9_Implement.md：Phase 1.9，页面布局与导入需求集实施计划；拆分前端页面布局和 UI/UX 优化、浏览器收藏/标签导入需求集，并记录触屏设备不能依赖 hover 的交互约束。
• implementation/phase-1/Phase1_9_5_BookmarkImportDesign.md：Phase 1.9.5，收藏/标签导入需求设计；记录普通网页权限边界、书签 HTML/URL 粘贴/浏览器扩展方案对比、导入草稿模型、隐私安全和 MVP 推荐路径。
• implementation/phase-1/Phase1_9_6_BulkImportExperienceDesign.md：Phase 1.9.6，大批量导入体验设计；记录 5 步导入向导、localStorage 草稿与撤销记录、分页预览、分组映射、批量选择、性能边界和 Phase 1.9.7 MVP 范围。
• implementation/phase-1/Phase1_10_Implement.md：Phase 1.10，正式推出前基础收口；记录数据包恢复、本地审计日志、本机状态、同步请求多标签协调，以及账号删除、只读分享链接、密码保护空间的高风险候选设计。
• implementation/phase-1/Phase1_11_Implement.md：Phase 1.11，数据保全与发布观测体系；记录文档分类、本地历史版本、数据恢复中心、危险写入保护、同步误覆盖防护、账号托管云端历史版本、账号托管可恢复模型收口、P0 回归演练、基础埋点和错误监控。
• implementation/phase-1/Phase1_12_Implement.md：Phase 1.12，组件设计优化；记录组件体验审计、Widget Shell、Todo/月历体验、配置入口、模板组件组合和后续组件候选设计。
• implementation/phase-1/Phase1_13_Implement.md：Phase 1.13，产品化体验收口；记录设置页信息架构 v2、折叠设置项、本机展开状态和数据恢复中心历史版本下拉。
• implementation/phase-1/Phase1_14_Implement.md：Phase 1.14，主域名准备；记录 Cloudflare Pages 主站迁移、GitHub Pages legacy 角色、根路径构建、Supabase 回调、安全基线和回滚演练。
• implementation/phase-1/Phase1_15_Implement.md：Phase 1.15，多语言支持 v1；记录语言数据模型、系统语言解析、Supabase locale 约束和后续 i18n 分层落地计划。
• implementation/phase-1/Phase1_16_Implement.md：Phase 1.16，低成本组件扩展；记录 Notes、Countdown、World Clock 的纯前端组件边界、数据模型、隐私约束和实施顺序。
• implementation/phase-1/Phase1_17_Implement.md：Phase 1.17，只读渲染与公开快照分享；记录公开投影、token/hash 合约、分享管理、/share/ 静态入口、权限边界和上线回归。
• implementation/phase-1/Phase1_18_Implement.md：Phase 1.18，受控服务端与只读后台 Dashboard v1；记录 Edge Function、管理员身份、管理员审计、跨用户只读查询、私有独立 Admin Pages、Cloudflare Access、快照预览、部署和回滚边界。
• implementation/phase-2/Phase2_2_RssWidgetDesign.md：Phase 2.2，RSS 组件设计；记录 rss.feed 组件交互、配置与数据边界、rss-proxy Edge Function 的抓取限制、共享缓存、限流、埋点和上线步骤（待确认，未实现）。

Tech Stack

• Frontend framework：Next.js 16 App Router。
• Language：TypeScript 6。
• UI runtime：React 19。
• Styling：原生 CSS，集中在 app/globals.css，不使用 Tailwind 或外部 UI 框架。
• Drag and drop：@dnd-kit/core、@dnd-kit/sortable、@dnd-kit/utilities。
• Persistence：浏览器 localStorage 保存本地首页文档、同步码绑定状态、UI 偏好缓存、最近一次恢复默认前备份、文档保护状态和本地历史快照；IndexedDB 缓存 Banner/背景图片 Blob，减少刷新后的重复下载。
• Cloud sync：Supabase JavaScript SDK 调用 Postgres RPC。
• Asset storage：Supabase Storage private bucket home-assets 保存登录用户的 Banner/背景图片；浏览器按项目、账号、资源与版本缓存图片，最多 20 项/50MB，签名 URL 不持久化。
• Client-side encryption：普通同步码空间由浏览器 Web Crypto 对首页文档加密后上传；账号托管空间采用账号可信托管模型，可保存有效用户首页的明文云端历史用于恢复和审计。
• Database：Supabase Postgres，核心表包括 sync_spaces、profiles、account_preferences、home_spaces、home_space_snapshots、home_space_audit_events、product_analytics_events、client_error_events、独立公开快照表 public_home_shares，以及 Phase 1.18 的 admin_users / admin_audit_events 受控服务端表，配合 RLS、权限收敛和 security definer RPC。
• Deployment：Next.js static export 输出到 out/；当前通过 GitHub Actions 部署到 GitHub Pages，Phase 1.14 迁移到 Cloudflare Pages 主站，GitHub Pages 转为 legacy 入口。
• CI checks：npm run lint、npm run typecheck、npm run build、npm run verify:export；Phase 1.18 新增本地 Supabase/Deno 门禁、远程部署配置校验，以及经 supabase-production Environment 审批的 migration dry-run/apply/verification 工作流。

Guides

• guides/GitHubPagesDeploy.md：GitHub Pages 部署说明。
• guides/MainDomainMigrationRunbook.md：Phase 1.14.0 主域名迁移方案与回滚预案，说明 Cloudflare Pages 主站、GitHub Pages legacy、用户数据迁移、切流检查和回滚路径。
• guides/SupabaseDomainMigrationChecklist.md：Phase 1.14.2 Supabase Auth、Storage 与回调 URL 迁移准备清单，说明 Redirect URLs、Site URL、Storage 回归、观测边界和回滚记录。
• guides/CloudflarePagesDeploy.md：Phase 1.14.3 Cloudflare Pages 主站部署说明，记录 Pages project、构建配置、环境变量、preview 验证和 Supabase Redirect URLs 回填。
• guides/CloudflareSecurityBaseline.md：Phase 1.14.4 Cloudflare 安全基线操作手册，记录静态安全响应头、Dashboard 手动配置、WAF/DNS/TLS/2FA、验证和回滚。
• guides/MainDomainCutoverRunbook.md：Phase 1.14.7 主域名正式切流与回滚演练，记录 Supabase Site URL 切换、主域名回归、fallback 和回滚路径。
• guides/SyncCodeUserGuide.md：同步码使用指南。
• guides/SupabaseMigrationChecklist.md：Supabase SQL 手动迁移执行清单。
• guides/DataPreservationP0RegressionDrill.md：Phase 1.11.7 P0 数据保全回归与事故演练指南。
• guides/ProductAnalyticsUsageGuide.md：Phase 1.11.8 基础埋点数据使用指南，说明可分析问题、禁采边界、常用 SQL、解读规则和保留策略。
• guides/ErrorMonitoringUsageGuide.md：Phase 1.11.9 错误监控数据使用指南，说明脱敏错误数据边界、常用 SQL、解读规则和上线检查。
• guides/WidgetExperienceDesignGuide.md：Phase 1.12.0 组件体验审计与设计规范，说明 Widget Shell、Todo、月历、配置入口、空状态、错误态、移动端和数据边界。
• guides/PublicHomeShareDatabaseRunbook.md：Phase 1.17 公开快照分享数据库上线手册，说明 017 基础 migration、018 发布 RPC 热修复、020/019 权限与 A-B 检查、前端 smoke test 和无损安全回滚。
• guides/AdminDashboardRunbook.md：Phase 1.18 管理员数据库运行手册，说明 019 migration、021 验证、首个 owner 初始化、停用/角色调整、A/B/C 检查和不删除审计的安全回滚。
• guides/SupabaseRemoteDeployment.md：Supabase 远程 migration/verification 自动化手册，说明 history 一次性对齐、GitHub Environment secrets、dry-run/verify/apply、SQL 白名单、审批和故障恢复。

Backlog

• backlog/SyncAutoRequestOptimization.md：同步请求优化备忘。
• backlog/AccountHomeSyncBacklog.md：账号系统、首页空间、同步码管理和未来会员权益 backlog。
• backlog/AccountManagedSyncBacklog.md：账号托管同步、空白设备恢复、同步码认领/迁移和未来密码保护空间 backlog。
• backlog/AdminDashboardBacklog.md：后台管理 dashboard 的原始候选依据；Phase 1.18.0 已转入实施计划，后续以 Phase1_18_Implement.md 为准。
• backlog/EncryptedFileCacheBacklog.md：轻量级端到端加密文件缓存组件候选，记录 Supabase Storage、密钥模型、数据表和风险边界。
• backlog/DataPreservationBacklog.md：Phase 1.11 数据保全与恢复体系 backlog，记录本地/云端快照、数据恢复中心、危险写入保护、同步误覆盖防护，以及后台 dashboard 延期到 Phase 1.18 的边界。
• backlog/WidgetCandidatesBacklog.md：Phase 1.12.6 后续组件候选设计，评估 Notes、倒计时、世界时钟、RSS、天气、GitHub 等候选的价值、数据边界、后端需求和实现优先级。
• backlog/CodeOptimizationBacklog.md：代码 review 发现的优化点，含 useSupabaseAuth 多订阅、SyncPanel 架构、round-trip 验证冗余等。