张翔
37296b5717
改造概要（30项）： - 第一轮：Hero重构/Section差异化/SocialProof强化/CTA对比度/About架构 - 第二轮：字体优化/背景交替/Solutions差异化/Footer五列/MegaDropdown修复 - 第三轮：卡片交互/表单层级/CTA统一/时间线标记/连接线/三列布局/移动导航/Button微交互/SEO Schema - P3-2：template.tsx+Framer Motion页面过渡/loading.tsx加载状态 - 清理：删除未用组件/hooks，修复重复移动导航，清理冗余CSS
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
# 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
|