张翔
37296b5717
改造概要（30项）： - 第一轮：Hero重构/Section差异化/SocialProof强化/CTA对比度/About架构 - 第二轮：字体优化/背景交替/Solutions差异化/Footer五列/MegaDropdown修复 - 第三轮：卡片交互/表单层级/CTA统一/时间线标记/连接线/三列布局/移动导航/Button微交互/SEO Schema - P3-2：template.tsx+Framer Motion页面过渡/loading.tsx加载状态 - 清理：删除未用组件/hooks，修复重复移动导航，清理冗余CSS
1.6 KiB
1.6 KiB
ADR 0001: 重构路径选择——混合方案而非全站 web-design-engineer 替换
状态
已接受
上下文
Novalon 网站面临技术债务问题：24 个特效组件和 50+ UI 组件大部分未被首页使用，.impeccable.md 定义的设计系统未完全落地，globals.css 有 1200+ 行但大量未引用。需要决定重构路径。
决策
采用混合方案：web-design-engineer 仅用于 Hero 区原型验证，主体重构在现有 Next.js 架构内进行。
理由
为什么不用 web-design-engineer 全站替换？
- 架构不兼容：web-design-engineer 产出独立 HTML 文件，无法集成到 Next.js App Router + 静态导出架构中
- 丢失现有资产：50+ UI 组件（含测试）、SEO 优化、分析追踪、可访问性适配等将全部丢失
- 维护性倒退：单文件 HTML 无法支撑后续迭代（产品页、解决方案页等动态路由）
为什么用混合方案？
- Hero 视觉方向未定：当前 Hero 是纯白底+文字，与设计文档差距最大，需要原型对比来决策
- web-design-engineer 擅长快速视觉探索：2-3 个 Hero 变体可在单次会话中完成
- 主体工作在 Next.js 内更高效：清理死代码、激活设计系统、整合特效——这些都需要在代码库内操作
后果
- 正面：保留现有架构和资产，风险可控；Hero 原型可快速验证视觉方向
- 负面：Hero 原型需要"翻译"为 Next.js 组件，存在少量双工
- 风险：如果 Hero 原型方向与现有设计系统冲突，可能需要调整 .impeccable.md