Feel.Trading — 前端重構設計 Briefing

提供給 AI 設計工具的完整情報文件(路由 · 按鈕 · 技術棧 · 設計規範 · 參考對象)

目錄

  1. 專案概述
  2. 技術棧與限制
  3. 頁面路由與功能對照
  4. 共用元件清單
  5. 重構要求
  6. 參考產品
  7. 交付物要求
  8. 可複製的 AI Prompt

1. 專案概述

Feel.Trading:人類直覺的量化驗證平台。用戶用口語描述交易感覺 → Claude AI 歸因分解 → 歷史回測驗證 → 自動執行簡擬交易。

2. 技術棧與限制

層級技術版本
框架Next.js (App Router)16.1.6
樣式Tailwind CSSv4
動畫Framer Motionlatest
圖表Recharts (K線另用 lightweight-charts)latest
狀態Zustand + React Querylatest
認證NextAuth v5beta
主題next-themes(已接 light/dark 切換)
i18nnext-intllatest
圖示lucide-reactlatest
路徑別名@/*./src/*

硬性限制(必須保留):

3. 頁面路由與功能對照

3.1 核心用戶頁面

/
公開
行銷落地頁
  • Hero 區塊 + 4 個示範「vibe」chip(點擊帶 prompt 跳 /chat)
  • 按鈕:「開始聊天」→ /chat
  • 按鈕:「免費模擬」→ /strategy
  • 底部 CTA 再次引導至 /chat
/login
公開
登入 / 註冊
  • 模式切換:登入 / 註冊
  • 表單:Email、密碼(含顯示切換)
  • 送出按鈕(含 loading spinner)
  • Google OAuth 按鈕
/chat
核心
AI 對話(平台核心頁面)
  • 三模式切換:教學 / 精簡 / 卡片
  • 輸入區:textarea、送出、停止(abort streaming)
  • 21 個建議 vibe chips(空狀態時)
  • 清除對話按鈕
  • 右側面板:最近回測、工具捷徑、模板庫按鈕(可摺疊)
  • 訊息內嵌互動:選項 chips、「確認回測」按鈕
  • 結果卡:BacktestCard / RealtimeCard / ScriptBacktestCard / ChainBacktestCard / MartingaleCard / EducationCard
  • 手機分頁 bar:對話 / 結果
  • 模態:StrategyTemplateModal(搜尋 + 分類 chips + 卡片清單)
/strategy
核心
策略管理中心
  • 左側列表(可摺疊):策略卡片(含狀態徽章 active/paused/stopped)
  • 右側詳情:4 個 Tab — 持倉 / 歷史 / 績效 / 設定
  • 複製策略按鈕(開 CloneStrategyModal:模式 + 資產選擇)
  • 設定 Tab 內:啟動 / 暫停 / 停止按鈕
  • 持倉列每行「平倉」按鈕
/scanner
核心
訊號掃描器(154 幣種即時掃描)
  • 時間框架:15m / 1h / 4h / 1d
  • 篩選預設 chips(橫滑,50+ 預設):RSI 超賣、MACD 金叉、BB 收口、放量、新高新低等
  • 排序欄位 + 方向:訊號數、24h 漲跌、RSI、成交量、ADX 等
  • 刷新按鈕、手機端篩選面板切換
  • 幣種行:點擊開抽屜顯示完整訊號分析
  • 幣種行「AI 回測」連結 → /chat?prompt=...
/scanner/[filter]
SEO
掃描器 SEO 靜態頁(7 種:oversold / macd-cross / funding-rate / fear-greed / new-high / volume-spike / bb-squeeze)
  • 頂 nav:Feel.Trading / Scanner / 麵包屑 / AI 回測連結
  • 快速篩選 chips(跳轉其他 filter 頁)
  • 幣種表 + 底部連結列表
/showcase
核心
策略排行榜
  • 排序下拉:總報酬 / 勝率 / 夏普 / 交易次數 / 獲利因子
  • 方向篩選下拉:全部 / 多 / 空
  • 分類 chips(橫滑)
  • 前 3 名頒獎台卡片
  • 排名卡列表,點擊 → /chat?template=...
/cycle
核心
週期指標儀表板
  • 宏觀/週期指標卡片群:BTC Dominance、Funding Rate、Fear & Greed、鏈上訊號、AHR999、彩虹圖、Pi Cycle 等
  • 每張卡附圖 + 當前值 + 歷史對照
/live
核心
實盤掛機監控
  • 摘要卡:總 PnL、今日 PnL、交易所、餘額、運行中策略數
  • Bot 執行列表(狀態 + 最近訊號 + 累積損益)
/backtest/[id]
核心
回測結果詳情
  • 返回連結 → /chat
  • 週期 Tab:1h / 4h / 1d
  • 投資模擬器:金額、槓桿、手續費滑桿
  • 關鍵指標卡:勝率圓環、發生次數、最佳持倉時間、平均報酬
  • 摘要卡:總淨利、每筆平均、最佳/最差交易、總手續費
  • 強平警告(條件顯示)
  • EducationCard 可展開區塊
/trade-chart
工具
交易圖表檢視
  • 資訊頭:幣種、週期、方向、進出場價、PnL%
  • 互動 K 線圖含進出場標記
/settings
核心
用戶設定
  • 外觀:主題切換(深/淺)、語言下拉
  • 交易所:10 個交易所格子按鈕(Binance、Bybit、MEXC、OKX、Bitget、KuCoin、Gate.io、Kraken、HTX、Coinbase),顯示已連線狀態
  • Testnet / Live API 切換
  • API Key / Secret / Passphrase(password input)
  • 儲存 API Keys 按鈕
  • 通知開關:策略觸發、每日報告
  • 危險區:重置帳號(含確認對話)
  • Toast 通知(自動消失)

3.2 Admin 後台頁面

Admin 使用獨立 AdminSidebar,不共用主要 Sidebar。

路由用途主要互動
/admin後台首頁6 個統計卡 + 近期審計日誌表
/admin/users用戶管理Email 搜尋 + 用戶表(角色徽章)
/admin/strategies全平台策略策略一覽表(狀態/模式/資產/勝率/PnL)
/admin/logs審計日誌最近 200 筆日誌表
/admin/wild-factors野生因子用戶輸入的原始口語 + AI 歸因 chips
/admin/analytics分析圖表圓餅(熱門幣)+ 長條(熱門週期)+ 折線(每日回測)
/admin/activity用戶活動監控Tab:時間線 / 對話列表;Email 搜尋;對話詳情抽屜(含 Tool Calls)

3.3 重導向/工具頁

/dashboardredirect → /strategy
/simulateredirect → /strategy
/logo-preview開發用:Logo 預覽
/test-strategies開發用:100+ 策略自動測試跑台

3.4 全站共用結構

主要 Sidebar(桌機固定 + 手機抽屜)

圖示 (lucide)標籤(i18n)路由
Homehome/
Trophyranking/showcase
ScanSearchscanner/scanner
MessageSquarechat/chat
BarChart3strategy/strategy
TrendingUpcycle/cycle
Botlive/live
Settingssettings/settings

Footer 區域:UserMenu(頭像下拉含 Admin 入口/登出)、ThemeToggle、LanguageSelector、摺疊切換按鈕。

手機 MobileHeader

漢堡選單 + Logo,點漢堡開左側抽屜式 Sidebar。

4. 共用元件清單

src/components/
├── common/           Sidebar, MobileHeader, UserMenu, ThemeToggle, LanguageSelector, QueryProvider, ThemeProvider
├── chat/             BacktestCard, RealtimeCard, ScriptBacktestCard, ChainBacktestCard, MartingaleCard,
│                     EducationCard, ChatBubble, ChatRightPanel, TradeChart, GlossaryPopover, TypingIndicator
├── wizard/           WizardBuilder (5-step), StepCoinConfig, StepSignals, StepExecution, StepExit, StepPreview,
│                     StrategyTemplateModal, ConditionCard, ChipAccordion, IndicatorDetailPanel
├── strategy/         StrategyList, StrategyDetail, PositionsTable, TradeHistoryTable, PerformancePanel,
│                     CloneStrategyModal
├── scanner/          ScannerDashboard(含 timeframe 切換、預設 chips、排序、幣種表、詳情抽屜)
├── dashboard/        CycleDashboard, PnLChart, StrategyCard
├── backtest/         WinRateChart, ReturnCurve, HoldPeriodTable, InvestmentSimulator, EnrichedOccurrencesTable
├── live/             DashboardCards, BotExecutionList, ExecutionLog
├── admin/            AdminSidebar, StatsCard
└── LogoMinimalWeb3   動畫 Logo

5. 重構要求

硬性規則

  1. 功能零損失:所有現有按鈕、連結、表單欄位、狀態都保留
  2. 視覺層次清晰:提升資訊密度的同時用 spacing / typography / color 做層次
  3. 手機優先響應式:斷點 sm:640px / md:768px / lg:1024px / xl:1280px,確保 iPhone SE (375px) 可用
  4. 動畫流暢克制:Framer Motion 做頁面切換、模態彈出、微互動 hover/press;避免過度裝飾(禁止 3D 翻轉、亂飛粒子、閃爍)
  5. 雙主題:Light 與 Dark 都要設計,透過 next-themesclass="dark" 切換,用 CSS variables 管理色彩
  6. a11y:所有互動元素含 focus-visible 樣式、aria-label、語意化 HTML
  7. 繁體中文優先:字體 stack 含 "PingFang TC", "Microsoft JhengHei"

色彩系統建議起點(可以改)

目前系統的語意色(可以重新定義,但保留這些語意概念):

6. 參考產品

TradingView
圖表工藝、資訊密度、工具列設計、dark mode 質感
Binance
金色系 CTA、密集資料表、幣種篩選器、手機版導航
CoinGecko
資訊結構清晰、幣種頁佈局、排行榜、light mode 範本
非小號 (Feixiaohao)
中文排版、數字格式化(四位加逗號)、亞洲市場習慣

其他可參考

7. 交付物要求

請 AI 針對每個提案交付:

  1. 色彩系統 JSON / CSS variables(light + dark 雙套)
  2. 字型與 typography scale
  3. 間距與圓角規範(spacing scale / radius scale)
  4. 核心元件示意:Button(primary/secondary/ghost/danger)、Card、Badge、Chip、Input、Modal、Tab、Toast
  5. 3 個關鍵頁面的 mockup(建議 /chat/scanner/strategy)— 可以是 HTML+Tailwind、Figma、或圖片
  6. 動畫規範:duration / easing / 何時用何種動畫
  7. 響應式斷點示意:桌機、平板、手機各一張

8. 可複製的 AI Prompt

以下區塊直接複製貼到 ChatGPT / Claude / v0.dev / Figma Make 等工具

你是資深產品設計師 + 前端工程師。請為「Feel.Trading」這個 AI 交易回測平台設計一套完整的前端視覺系統。

【專案定位】
人類直覺量化驗證平台,目標用戶是初中階加密貨幣/貴金屬交易者。
核心流程:口語描述交易感覺 → AI 歸因分解 → 歷史回測 → 自動執行。
語言:繁體中文為主。

【技術棧(不可更改)】
- Next.js 16 (App Router) + Tailwind CSS 4
- Framer Motion + Recharts + next-themes
- Zustand + React Query + NextAuth v5
- 圖示:lucide-react

【23 個路由頁面】
核心:/ /login /chat /strategy /scanner /scanner/[filter] /showcase /cycle /live /backtest/[id] /trade-chart /settings
Admin:/admin /admin/users /admin/strategies /admin/logs /admin/wild-factors /admin/analytics /admin/activity
工具:/dashboard /simulate /logo-preview /test-strategies

(每頁詳細按鈕清單見附件 DESIGN_BRIEF.html)

【硬性要求】
1. 保留所有現有功能與按鈕(不減少)
2. 提升視覺層次與資訊密度
3. 手機優先響應式(iPhone SE 375px 起)
4. 動畫流暢克制(禁止過度裝飾)
5. Light + Dark 雙主題,用 CSS variables
6. 多頭用藍色、空頭用紅色(亞洲市場 convention)
7. 主強調色延續金色/琥珀系

【參考產品】
- TradingView:圖表、資訊密度
- Binance:金色 CTA、資料表
- CoinGecko:Light mode 範本、排行榜
- 非小號 Feixiaohao:中文排版、數字格式

【請交付】
1. 色彩 tokens(light + dark CSS variables)
2. Typography scale + 字型 stack(含中文)
3. Spacing / Radius scale
4. 核心元件組:Button / Card / Badge / Chip / Input / Modal / Tab / Toast
5. 3 個關鍵頁面 mockup:/chat(核心 AI 對話)/scanner(154 幣掃描)/strategy(策略管理)
6. 動畫規範(duration / easing / 適用場景)
7. 響應式斷點示意(桌/平板/手機)

格式:用 HTML + Tailwind 輸出可直接預覽的 mockup,附 style guide 文件。

產出日期:2026-04-16 · Feel.Trading 設計重構 Briefing v1.0