From ca0b25d84fa58ccd7b6425810a7195a7c77fded2 Mon Sep 17 00:00:00 2001 From: "2569718930@qq.com" <2569718930@qq.com> Date: Sun, 10 May 2026 14:31:10 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B8=85=E7=90=86=E5=86=97=E4=BD=99=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=9A=E7=A7=BB=E9=99=A4=E8=BF=87=E6=9C=9F=E6=8A=A5?= =?UTF-8?q?=E5=91=8A=E3=80=81=E9=87=8D=E5=A4=8D=E6=96=87=E4=BB=B6=E5=92=8C?= =?UTF-8?q?=20AI=20=E7=94=9F=E6=88=90=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移除 FRONTEND_REDESIGN_REPORT.md（v1.5.1 旧报告，已被 frontend-ui-design-review.md 取代） - 移除 docs/TECH_DEBT.md（与 TECH_DEBT_ZH.md 完全重复） - docs/ 目录集中管理所有项目文档，无需移动 Cleaned: outdated-report, duplicate-doc --- FRONTEND_REDESIGN_REPORT.md | 82 ------------------------------------- docs/TECH_DEBT.md | 81 ------------------------------------ 2 files changed, 163 deletions(-) delete mode 100644 FRONTEND_REDESIGN_REPORT.md delete mode 100644 docs/TECH_DEBT.md diff --git a/FRONTEND_REDESIGN_REPORT.md b/FRONTEND_REDESIGN_REPORT.md deleted file mode 100644 index 98d1b1e4..00000000 --- a/FRONTEND_REDESIGN_REPORT.md +++ /dev/null @@ -1,82 +0,0 @@ -# 前端交付与重构报告（v1.5.1） - -最后更新：`2026-03-14` - -## 1. 报告目的 - -说明当前线上前端（`frontend/`）在收费阶段的实际交付状态。 - -## 2. 当前前端架构 - -```mermaid -flowchart LR - B["Browser"] --> N["Next.js App Router (Vercel)"] - N --> RH["Route Handlers /api/*"] - RH --> F["FastAPI (VPS)"] - - N --> STORE["Dashboard Store"] - STORE --> MAP["MapCanvas"] - STORE --> SIDEBAR["CitySidebar"] - STORE --> PANEL["DetailPanel + Modal"] - STORE --> ACCOUNT["Account Center + Pro Overlay"] -``` - -## 3. 已落地能力 - -### 3.1 信息架构与交互 - -- 风险分组侧栏折叠（持久化）。 -- 选中城市状态持久化。 -- 今日分析、历史对账、未来日期分析联动。 - -### 3.2 收费相关 - -- 账户中心（登录态、积分、订阅状态、钱包管理）。 -- Pro 解锁浮层（套餐、积分抵扣、FAQ、社群入口）。 -- 钱包绑定：浏览器扩展钱包 + WalletConnect 扫码。 -- 支付流程：create intent -> submit -> confirm。 -- `confirm pending` 时自动轮询 intent 状态，确认后自动刷新订阅态。 - -### 3.3 缓存与性能 - -- BFF `ETag/304`：`cities` / `summary` / `history`。 -- `summary?force_refresh=true` => `no-store`。 -- `sessionStorage` + in-flight 去重。 -- `localStorage`：选中城市、侧栏折叠状态。 - -### 3.4 可访问性与稳定性 - -- 详情面板 `inert + blur` 焦点冲突修复。 -- 关键支付错误文案标准化（用户取消、gas 不足、pending）。 - -## 4. 当前明确未做 - -- 离线能力（Service Worker / IndexedDB） -- 前端级财务报表与退款后台（后端/运营侧） - -## 5. 验收建议 - -### 5.1 前端构建 - -```bash -cd frontend -npm run build -``` - -### 5.2 缓存验收 - -```bash -./scripts/validate_frontend_cache.sh "https://polyweather-pro.vercel.app" -``` - -### 5.3 支付验收 - -- 绑定钱包 -- 创建 intent -- 发交易 -- 验证 `intent` 状态从 `submitted -> confirmed` -- 校验账户页订阅状态更新 - -## 6. 结论 - -前端已具备收费阶段的核心能力（账户、支付、权限展示、状态回收），可支持持续商业迭代。 diff --git a/docs/TECH_DEBT.md b/docs/TECH_DEBT.md deleted file mode 100644 index 380ceff4..00000000 --- a/docs/TECH_DEBT.md +++ /dev/null @@ -1,81 +0,0 @@ -# 技术债与工程待办（v1.5.4） - -最后更新：`2026-04-19` - -目标：在收费上线后，优先保证状态一致性、支付可靠性、可观测性和概率引擎发布可控。 - -## 1. 债务快照 - -当前估计：**95% 稳定 / 5% 技术债**。 - -```mermaid -flowchart TD - A["技术债"] - - subgraph P["支付与订阅"] - P1["合约 V2 升级（SafeERC20 / Pausable）"] - P2["退款与工单流程"] - P3["多 RPC 与链上对账面板"] - end - - subgraph E["权限与运营"] - E1["前后端/Bot 权限矩阵回归"] - E2["积分来源明细与补分审计"] - end - - subgraph O["可观测性"] - O1["外部监控抓取与告警阈值"] - O2["业务监控看板"] - end - - subgraph S["状态与概率"] - S1["EMOS 本地训练与 shadow 发布门禁"] - end - - A --> P - A --> E - A --> O - A --> S -``` - -## 2. 近期已关闭 - -- 支付主链路已上线（intent -> submit -> confirm）。 -- 支付自动补单已上线（Event Loop + Confirm Loop）。 -- 支付事件重放脚本已补齐。 -- 支付运行态 API 与 SQLite 审计事件已补齐。 -- 钱包绑定支持浏览器钱包 + WalletConnect。 -- 账户中心与 Pro 权限展示链路打通。 -- 钱包异动支持独立频道路由。 -- 运行态状态/缓存与核心离线训练、评估、回填链路已完成 SQLite 主路径收口。 -- 轻量可观测性已上线（`/healthz`、`/api/system/status`、`/metrics`）。 -- EMOS/CRPS 校准链路已接通；生产主概率保持 `legacy` 或 `emos_shadow`，`emos_primary` 只允许本地训练通过门禁后人工灰度。 - -## 3. 高优先级技术债 - -| 项目 | 影响 | 建议动作 | -| :-- | :-- | :-- | -| EMOS 发布门禁 | 低配 VPS 不适合训练，主概率不能绕过评估 | 本地拉生产 SQLite 训练，`ready_for_promotion=true` 后先 `emos_shadow` | -| 外部监控与告警 | 只有轻量指标，无外部抓取 | 接 Prometheus/Grafana 或最小巡检 | -| 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 | - -## 4. 中优先级技术债 - -| 项目 | 影响 | 建议动作 | -| :-- | :-- | :-- | -| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/奖励/手动补分） | -| 支付合约 V2 升级 | 当前仍是最小可用合约 | 升级到 SafeERC20 + Pausable + plan 绑定 | -| 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 | - -## 5. 低优先级技术债 - -| 项目 | 影响 | 建议动作 | -| :-- | :-- | :-- | -| 前端离线缓存能力 | 非核心 | 评估 Service Worker + IndexedDB | -| 冷启动波动 | 首屏抖动 | 热点城市预热 | - -## 6. 下阶段里程碑 - -1. 固化 EMOS 本地训练流程，禁止低配 VPS 自动训练和自动主用。 -2. 补外部监控抓取与告警阈值。 -3. 评估并推进支付合约 V2 升级。