# ADR 0001: 重构路径选择——混合方案而非全站 web-design-engineer 替换 ## 状态 已接受 ## 上下文 Novalon 网站面临技术债务问题:24 个特效组件和 50+ UI 组件大部分未被首页使用,.impeccable.md 定义的设计系统未完全落地,globals.css 有 1200+ 行但大量未引用。需要决定重构路径。 ## 决策 采用**混合方案**:web-design-engineer 仅用于 Hero 区原型验证,主体重构在现有 Next.js 架构内进行。 ## 理由 ### 为什么不用 web-design-engineer 全站替换? 1. **架构不兼容**:web-design-engineer 产出独立 HTML 文件,无法集成到 Next.js App Router + 静态导出架构中 2. **丢失现有资产**:50+ UI 组件(含测试)、SEO 优化、分析追踪、可访问性适配等将全部丢失 3. **维护性倒退**:单文件 HTML 无法支撑后续迭代(产品页、解决方案页等动态路由) ### 为什么用混合方案? 1. **Hero 视觉方向未定**:当前 Hero 是纯白底+文字,与设计文档差距最大,需要原型对比来决策 2. **web-design-engineer 擅长快速视觉探索**:2-3 个 Hero 变体可在单次会话中完成 3. **主体工作在 Next.js 内更高效**:清理死代码、激活设计系统、整合特效——这些都需要在代码库内操作 ## 后果 - 正面:保留现有架构和资产,风险可控;Hero 原型可快速验证视觉方向 - 负面:Hero 原型需要"翻译"为 Next.js 组件,存在少量双工 - 风险:如果 Hero 原型方向与现有设计系统冲突,可能需要调整 .impeccable.md