docs: add research assets, screenshots and guides
Include supplementary documentation, research notes on Lexical/UX, and setup guides.
This commit is contained in:
195
screenshots/UX-Structure-Analysis-Report.md
Normal file
195
screenshots/UX-Structure-Analysis-Report.md
Normal file
@@ -0,0 +1,195 @@
|
||||
# Homepage Structure & Layout Analysis Report
|
||||
## 參考 HTML vs Localhost 結構差異深度分析
|
||||
|
||||
**Date:** 2026-02-10
|
||||
**Analyst:** UX Expert
|
||||
**Status:** Critical Issues Found
|
||||
|
||||
---
|
||||
|
||||
## 🚨 關鍵發現
|
||||
|
||||
### 結構差異總覽
|
||||
|
||||
| 項目 | 參考 HTML | Localhost | 影響等級 |
|
||||
|------|-----------|-----------|----------|
|
||||
| Body 背景色 | #f2f2f2 | #f2f2f2 (已修復) | ✅ |
|
||||
| Body 高度 | 3548px | 3835px (+287px) | ⚠️ |
|
||||
| Painpoint Section | 獨立 section | 獨立 section | ✅ |
|
||||
| Statistics Section | **獨立 H1 + section** | 合併在 Painpoint region 內 | ❌ CRITICAL |
|
||||
| Service Features | **在 Footer 中** | 獨立的 ServiceFeatures section | ❌ CRITICAL |
|
||||
| Client Cases | Carousel 輪播 | 靜態顯示 | ⚠️ |
|
||||
| CTA Section | 按鈕連結 heyform | 按鈕連結 /contact-us | ⚠️ |
|
||||
|
||||
---
|
||||
|
||||
## 1. Statistics Section 被合併問題 ❌ CRITICAL
|
||||
|
||||
### 參考 HTML 結構
|
||||
```
|
||||
body
|
||||
├── [Navigation]
|
||||
├── [Hero Banner]
|
||||
├── H1 "你可能會遇到的煩惱"
|
||||
├── [Tabs]
|
||||
├── [Tabpanel]
|
||||
├── H1 "數據會說話" ← 獨立的 H1
|
||||
├── P "Statistics reveal the truth"
|
||||
├── [Statistics Data: 0 至今協助商家數, 0.0% 提升成長率, ...]
|
||||
├── H1 "客戶案例" ← 獨立的 H1
|
||||
└── ...
|
||||
```
|
||||
|
||||
### Localhost 結構 (問題)
|
||||
```
|
||||
main
|
||||
├── [Hero]
|
||||
├── region "你可能會遇到的煩惱"
|
||||
│ ├── H2 "你可能會遇到的煩惱"
|
||||
│ ├── [Tabs]
|
||||
│ ├── [Tabpanel]
|
||||
│ ├── 0 + 服務客戶數 ← Statistics 被合併在這裡！
|
||||
│ ├── 0 %% 廣告投資報酬率
|
||||
│ ├── 0 + 年 行銷經驗
|
||||
│ └── 0 %% 客戶滿意度
|
||||
├── region "我們的服務"
|
||||
└── region
|
||||
├── P "客戶案例"
|
||||
└── ...
|
||||
```
|
||||
|
||||
### 問題描述
|
||||
**StatisticsSection.astro 的內容被錯誤地合併到 PainpointSection 的 `<main>` 區域內**
|
||||
|
||||
### 根本原因
|
||||
根據 Accessibility Tree 顯示，Statistics 的數據 (0+, 0%%, 0+年, 0%%) 出現在 `region "你可能會遇到的煩惱"` 內部，而不是作為一個獨立的 section。
|
||||
|
||||
### 預期修復
|
||||
檢查 `index.astro` 的組件順序，確保：
|
||||
1. `StatisticsSection` 是一個獨立的 `<section>` 元素
|
||||
2. 有自己的 H1 標題「數據會說話」
|
||||
3. 與 PainpointSection 完全分離
|
||||
|
||||
---
|
||||
|
||||
## 2. Service Features 位置錯誤 ❌ CRITICAL
|
||||
|
||||
### 參考 HTML 結構
|
||||
```
|
||||
[Footer]
|
||||
├── [Logo + Description]
|
||||
├── [Contact Info]
|
||||
├── H3 "聯絡我們"
|
||||
├── H3 "行銷方案" ← Services 在這裡！
|
||||
│ └── UL
|
||||
│ ├── LI Google 商家關鍵字
|
||||
│ ├── LI Google Ads
|
||||
│ ├── LI 社群代操
|
||||
│ ├── LI 論壇行銷
|
||||
│ ├── LI 網紅行銷
|
||||
│ └── LI 形象影片
|
||||
└── H3 "行銷放大鏡"
|
||||
└── UL [Blog Categories]
|
||||
```
|
||||
|
||||
### Localhost 結構 (問題)
|
||||
```
|
||||
main
|
||||
├── [Hero]
|
||||
├── [Painpoint + Statistics]
|
||||
├── section "我們的服務" ← 不應該在 main 內！
|
||||
│ ├── H2 "我們的服務"
|
||||
│ ├── P "提供全方位..."
|
||||
│ └── Grid [4 Service Cards]
|
||||
└── [Client Cases]
|
||||
```
|
||||
|
||||
### 問題描述
|
||||
**Localhost 創建了一個獨立的 `ServiceFeatures` section，但參考 HTML 中 Services 只是在 Footer 的連結列表！**
|
||||
|
||||
### 影響
|
||||
1. 頁面結構完全不同
|
||||
2. 用戶體驗差異巨大
|
||||
3. Localhost 多了一個不應該存在的主要內容區塊
|
||||
|
||||
### 預期修復
|
||||
從 `index.astro` 中**移除** `<ServiceFeatures />` 組件，Services 應該只在 Footer 中顯示為連結列表。
|
||||
|
||||
---
|
||||
|
||||
## 3. Client Cases Carousel 差異 ⚠️
|
||||
|
||||
### 參考 HTML
|
||||
- Carousel 輪播效果
|
||||
- 顯示 "Slide X of Y" 指示器
|
||||
- 上一頁/下一頁按鈕
|
||||
- 每個案例有 H2 標題
|
||||
|
||||
### Localhost
|
||||
- 靜態顯示 4 個客戶案例
|
||||
- 沒有 carousel 效果
|
||||
- 使用 H3 標題
|
||||
|
||||
### 預期修復
|
||||
更新 `ClientCasesSection.astro` 實作真正的 carousel 輪播功能。
|
||||
|
||||
---
|
||||
|
||||
## 4. Body 高度差異 ⚠️
|
||||
|
||||
| 指標 | 參考 HTML | Localhost | 差異 |
|
||||
|------|-----------|-----------|------|
|
||||
| 總高度 | 3548px | 3835px | +287px (+8%) |
|
||||
|
||||
### 可能原因
|
||||
1. Service Features section 額外增加的內容
|
||||
2. Padding/margin 設定差異
|
||||
3. 字體大小或間距差異
|
||||
|
||||
---
|
||||
|
||||
## 修復優先級與行動
|
||||
|
||||
### P0 - Critical (立即修復)
|
||||
|
||||
1. **移除 ServiceFeatures section**
|
||||
- 檔案: `apps/frontend/src/pages/index.astro`
|
||||
- 行動: 註解或移除 `<ServiceFeatures />` 組件
|
||||
|
||||
2. **分離 Statistics Section**
|
||||
- 檔案: `apps/frontend/src/pages/index.astro`
|
||||
- 確認: `StatisticsSection` 是獨立的 `<section>`
|
||||
- 確認: 有 H1 標題「數據會說話」
|
||||
|
||||
### P1 - High (優先修復)
|
||||
|
||||
3. **實作 Client Cases Carousel**
|
||||
- 檔案: `apps/frontend/src/sections/ClientCasesSection.astro`
|
||||
- 行動: 添加 carousel 輪播功能
|
||||
|
||||
4. **調整 Body 高度**
|
||||
- 檢查各 section 的 padding/margin
|
||||
- 確保與參考 HTML 一致
|
||||
|
||||
---
|
||||
|
||||
## 建議修復順序
|
||||
|
||||
1. ✅ 修復背景色 (已完成)
|
||||
2. ⏳ 移除 ServiceFeatures section
|
||||
3. ⏳ 驗證 Statistics Section 獨立性
|
||||
4. ⏳ 實作 Carousel
|
||||
5. ⏳ 重新截圖驗證
|
||||
|
||||
---
|
||||
|
||||
## 相關檔案清單
|
||||
|
||||
| 檔案 | 狀態 | 需要修改 |
|
||||
|------|------|----------|
|
||||
| `apps/frontend/src/pages/index.astro` | ❌ | 是 - 移除 ServiceFeatures |
|
||||
| `apps/frontend/src/sections/ServiceFeatures.astro` | ⚠️ | 保留但不在首頁使用 |
|
||||
| `apps/frontend/src/sections/PainpointSection.astro` | ✅ | 否 |
|
||||
| `apps/frontend/src/sections/StatisticsSection.astro` | ⚠️ | 驗證獨立性 |
|
||||
| `apps/frontend/src/sections/ClientCasesSection.astro` | ❌ | 是 - 添加 carousel |
|
||||
| `apps/frontend/src/sections/CTASection.astro` | ⚠️ | 驗證連結正確性 |
|
||||
Reference in New Issue
Block a user