# DSP Bode Plot 專案進度總結 (2026-05-15)

## 1. 核心功能優化 (DSP & 定點數運算)
- **細部微調 (Fine-tuning)**：實施了基於 $\delta$ (Delta) 與 $r$ (Radius) 的參數化微調。
- **定點數精確度修正**：採用「兩倍值整數運算」邏輯，解決了 $0.5$ 步階在浮點數圓整時產生的「按鍵沒反應」Bug。
- **防止漂移 (Oscillation Logic)**：針對數位微調，實施了奇偶震盪平衡邏輯。當調整 $\delta$ 導致 $r$ 必須隨動時，採用震盪補償防止 $r$ 產生單向累積誤差。
- **參數連動策略**：在 $0.5$ 步階時，採取「優先滿足目標變動」原則。若調整 $\delta$，則 $r$ 隨動；反之亦然。

## 2. UI/UX 介面調整
- **側邊欄優化**：
    - 將 $r$ 與 $\delta$ 的調整區域改為**垂直堆疊**，適應 21rem 的窄邊欄。
    - 移除冗餘的 $a1, a2$ 預覽方塊，僅保留帶有數學公式標籤的 $r, \delta$ 預覽。
- **步階序列**：數位微調步階改為自訂序列：`[0.5, 1, 2, 4, 8, 32, 256, 1024, 4096, 16384, 65536]`。
- **微調量顯示**：統一使用 `±` 符號並帶空格（例如 `± 0.5`）。
- **智能禁用**：當數位步階為 $0.5$ 時，自動禁用 $r$ 的控制項，確保以 $\delta$ 為主導。

## 3. 繪圖系統 (Bode Plot)
- **幅值圖 (Magnitude)**：
    - 初始範圍：基於 $systemGain \times 3$，涵蓋 $70 \text{ dB}$。
    - 保留手動彈性：設定為 `fixedrange: false`，支援滑鼠縮放與 Auto Scale。
    - 狀態保持：使用 `uirevision`，確保微調參數時不會跳回初始縮放。
- **相位圖 (Phase)**：
    - 絕對鎖死：固定範圍為 $[-180^\circ, 180^\circ]$。
    - 禁止縮放：設定為 `fixedrange: true`，提供穩定的絕對參考。
- **座標軸連動**：幅值圖與相位圖的 **X 軸（頻率）已完全同步**。不論在哪一張圖進行橫向縮放，兩者都會連動。

## 4. 數學公式參考
- **理想空間**：
    - $a1 = -1 - r + \delta$
    - $a2 = r + \delta$
- **定點數空間 (Q14 為例)**：
    - $a0 = 2^{14} = 16384$
    - $a1 = -a0 - r + \delta$
    - $a2 = r + \delta$
    - $2\delta = a1 + a2 + a0$
    - $2r = a2 - a1 - a0$

## 5. 目前 Git 狀態
- **當前分支**：`dev-v2-rounding-fix-20260517` (已推送到 origin)。
- **同步說明**：此版本包含了 Rounding 功能、Vite proxy 修復與 production build。
- **同事試用指令**：
    ```bash
    git fetch
    git checkout dev-v2-rounding-fix-20260517
    ```

---
*Last Updated: 2026-05-15 17:47*

---

# DSP Bode Plot 專案進度更新 (2026-05-17)

## 6. 定點數 Rounding 模擬 (V2 Feature)
- **Round (+0.5 補償) 功能**：在 `integer_lfilter()` 中實作了硬體級四捨五入模擬，使用 `(acc + (1 << (shift - 1))) >> shift` 取代傳統的 `acc >> shift` (Floor)。
- **UI 控制**：於「定點數模擬設定」區塊新增 **Floor (SRA) / Round (+0.5)** 互斥按鈕（與「階數 Order」相同風格），放置於 Q_in / Q_out 同列。預設為 Round。
- **API 參數**：`/api/filter` 與 `/api/filter/download` 端點已支援 `use_round` 參數。
- **高精度狀態變數架構**：前饋 (Feed-forward) 不右移，保留完整 $Q_{in+b}$ 精度；僅回授 (Feedback) 與最終輸出做位移縮放。

## 7. Vite Proxy 修正
- **Bug 修正**：`vite.config.js` 的 proxy target 從 `https://` 修正為 `http://`，與 uvicorn 的實際 HTTP 協議一致。

---

## ⚠️ 踩雷紀錄 (Lessons Learned)

### 🔴 Production Build 未同步 (2026-05-17)
**症狀**：修改了 `src/app-options.js` 與 `src/App.vue` 後，UI 按鈕有出現但功能完全不生效（Round/Floor 切換後濾波器輸出完全沒變化）。花了大量時間除錯。

**根因**：使用者透過 `http://localhost:8000/ui/` 存取系統。FastAPI 直接 serve `static/build/app.js`，而該檔案停留在 5 月 15 日的舊版（距今超過一天）。所有前端修改都只存在於 `src/` 原始碼，從未被 `npm run build` 編譯輸出。

**解法**：修改 `src/` 後務必執行 `npm run build`，再 `Ctrl+Shift+R` 硬重新整理瀏覽器。

**預防措施**：
1. 開發時優先使用 `http://localhost:5173/` (Vite dev server，自動 HMR)。
2. 若使用 port 8000，每次修改前端程式碼後必須 build。
3. 詳見 `ARCHITECTURE.md` 的「Development Environment Notes」章節。

### 🟡 Vite Proxy https/http 不匹配 (2026-05-17)
**症狀**：Vite dev server 的 API 轉發全部失敗 (502)，uvicorn 日誌大量出現 `Invalid HTTP request received.`。

**根因**：`vite.config.js` 設定了 `target: 'https://127.0.0.1:8000'`，但 uvicorn 以 HTTP 模式啟動。Vite proxy 嘗試發送 TLS 握手封包到純 HTTP 伺服器。

**解法**：將 proxy target 改為 `http://127.0.0.1:8000`，移除 `secure: false`。

---
*Last Updated: 2026-05-17 00:43*