--- stepsCompleted: [] inputDocuments: - _bmad-output/analysis/brainstorming-session-2026-02-01.md - _bmad-output/analysis/brainstorming_summary_vi.md - strategic_context_synthesis.md - strategic_recommendation.md - market_landscape_analysis.md - business_model_analysis.md - disruption_opportunities_analysis.md - crypto_copilot_implementation_roadmap.md - crypto_copilot_roadmap_vi.md - task.md workflowType: 'prd' --- # Tài liệu Yêu cầu Sản phẩm - SurfSense 2.0 (Crypto Co-Pilot) **Tác giả:** Luis & Antigravity **Ngày:** 2026-02-01 **Trạng thái:** DRAFT (Bản nháp) ## 1. Bối cảnh Chiến lược & Tầm nhìn ### 1.1. Bối cảnh SurfSense 2.0 đại diện cho một **bước chuyển mình sống còn ("Bet-the-Company" pivot)** từ một công cụ mã nguồn mở đa năng sang một **Nền tảng Crypto Intelligence ưu tiên AI (AI-First)** chuyên sâu. Quyết định này được thúc đẩy bởi "cửa sổ thị trường" độc nhất (Bull Run 2026) và cơ hội trong 6-12 tháng để xây dựng vị thế trước khi các đối thủ lớn bắt kịp. **Quyết định Chiến lược:** **CONDITIONAL GO** (Đã duyệt ngày 1/2/2026) cho chiến lược "AI-First MVP". ### 1.2. Tầm nhìn Xây dựng **AI Co-pilot dẫn đầu thị trường cho crypto traders**, giúp chuyển đổi dữ liệu thô thành thông tin tình báo chủ động, có thể hành động ngay. Chúng ta đang chuyển dịch từ "tổng hợp dữ liệu" (như DexTools/DexScreener) sang "Tình báo AI" (Dự đoán, Mô hình, Ngôn ngữ tự nhiên). **Giá trị Cốt lõi:** > *"AI Analyst của riêng bạn - tìm kiếm cơ hội, phát hiện lừa đảo (scams), và giải thích thị trường ngay cả khi bạn đang ngủ."* ### 1.3. Tiêu chí Thành công (Năm 1) * **User Traction:** 100-500 người dùng trả phí (tập trung vào tăng trưởng Organic). * **Doanh thu:** $5K-25K MRR ($60K-300K ARR). * **Sản phẩm:** Độ chính xác dự đoán >70%, time-to-insight <5 phút. * **Sự khác biệt:** Kiểm chứng được "AI Moat" (mô hình độc quyền/fine-tuned). --- ## 2. Vấn đề cần giải quyết (Jobs-to-be-Done) Traders hiện đang đối mặt với **Quá tải Thông tin** và **Quy trình làm việc thụ động**. 1. **Tìm kiếm Cơ hội:** "Giúp tôi tìm các giao dịch có lời trước khi chúng pump." (Hiện tại tốn >10 giờ/tuần để nghiên cứu thủ công). 2. **Tránh Lừa đảo:** "Bảo vệ tôi khỏi rug pulls." (Các công cụ phát hiện honeypot hiện tại quá thụ động và thiếu sót). 3. **Hiểu Thị trường:** "Giải thích tại sao token này đang biến động." (Công cụ hiện tại chỉ hiện biểu đồ mà thiếu ngữ cảnh). 4. **Quản lý Danh mục:** "Báo cho tôi khi nào nên bán." (Công cụ hiện tại quá tĩnh). --- ## 3. Phạm vi & Định nghĩa MVP (Enhanced Core) **Chiến lược:** AI-First MVP. **Thời gian:** 12 Tuần (Triển khai Tốc độ cao). **Ngân sách:** $18K (Tận dụng team hiện tại & các gói free tier). ### 3.1. Trong Phạm vi (In-Scope - MVP) * **Nguồn dữ liệu:** DexScreener (Giá/Volume), DefiLlama (TVL/Yields). * **Tính năng Thông minh (Intelligence):** * Smart Alerts (Cảnh báo dựa trên bất thường ML, không chỉ là ngưỡng cài đặt). * Natural Language Queries (Truy vấn ngôn ngữ tự nhiên: "Show me Solana tokens with heavy buying"). * Rug Pull Detection (So khớp mẫu chủ động). * **Giao diện Chính (Critical):** **Browser Extension (Chrome)** chạy overlay trực tiếp trên DexScreener. * **Mô hình thu phí:** Freemium + Gói Pro $49/tháng. ### 3.2. Ngoài Phạm vi (Out-of-Scope - V1) * Tích hợp QuickNode Premium (Dùng fallback tự host nếu cần). * Phân tích Cảm xúc Mạng xã hội (Social Sentiment Analysis) chuyên sâu (Sẽ bắt đầu đơn giản trước). * Native Mobile App (Chỉ làm Web bản đầu). * Mô hình Dự đoán Nâng cao (Dành cho Phase 2). --- ## 4. Tóm tắt Kế hoạch Triển khai * **Phase 1 (Tuần 1-2):** Nền tảng (Connectors + RAG Pipeline). * **Phase 2 (Tuần 3-4):** Trí tuệ (Intelligence: NLP + Alerts). * **Phase 3 (Tuần 5-6):** Đánh giá & Ra mắt Private Beta (20 Users). * **Phase 4 (Tuần 7-12):** Public Beta & Cải tiến (Iteration). --- ## 5. Lợi thế Cạnh tranh ("The Moat") | Đối thủ | Mô hình của họ | "Lợi thế Đặc biệt" của chúng ta (The Wedge) | | :--- | :--- | :--- | | **DexScreener / DexTools** | **Data Aggregators (Thụ động).** Tốt để xem biểu đồ, tệ ở câu hỏi "Tại sao?". Người dùng phải tự phân tích dữ liệu thô. | **Proactive Intelligence.** Chúng ta không chỉ hiện biểu đồ; chúng ta giải thích *tại sao* nó biến động (Tin tức + On-chain + Xã hội). "Analyst của bạn, không chỉ là Terminal." | | **GMGN.ai** | **"Degen Tooling" (Phức tạp).** UI quá tải, tập trung vào theo dõi ví thô. Khó sử dụng cho người mới. | **Sự đơn giản kiểu Apple.** Giao diện Ngôn ngữ Tự nhiên ("Token này có an toàn không?"). Bình dân hóa việc theo dõi "Smart Money" cho trader phổ thông. | | **Perplexity / ChatGPT** | **Generalists (Đa năng).** Tốt cho định nghĩa, tệ cho ứng dụng crypto thời gian thực. Hay bị ảo giác (hallucinations) về giá. | **Chuyên biệt hóa theo chiều dọc.** RAG pipeline được tinh chỉnh riêng cho Dữ liệu Crypto. Kiến trúc "Zero-hallucination" cho giá cả/chỉ số. | **Cốt lõi Moat của chúng ta:** **Khả năng Tiếp cận + Ngữ cảnh.** Mang phân tích "Tại sao" chuẩn tổ chức đến quy trình "Cái gì" của nhà đầu tư nhỏ lẻ. --- ## 6. Yêu cầu Chức năng ("Enhanced Core" MVP) ### 6.1. Lớp Trí tuệ (The Brain) * **[FR-INT-01] Truy vấn Ngôn ngữ Tự nhiên:** * Người dùng hỏi: "Show me trending Solana memes with >$10k liquidity created in the last hour." * Hệ thống dịch sang: DexScreener API filters + SQL Query. * **[FR-INT-02] Kiểm tra Rug Pull Cơ bản:** * Người dùng hỏi: "Is $TOKEN safe?" * Hệ thống kiểm tra: Trạng thái khóa LP, % Top 10 Holders, Mint Authority (qua API data). * **[FR-INT-03] Cảnh báo "Smart":** * Hệ thống đẩy thông báo cho các *bất thường*, không chỉ là chạm ngưỡng giá. * Ví dụ: "Phát hiện sự phân kỳ giữa Volume/Liquidity trên $TOKEN." ### 6.2. Lớp Dữ liệu (The Foundation) * **[FR-DAT-01] Tích hợp DexScreener:** * Giá Real-time, Volume, Liquidity, FDV, Tuổi Pair. * Hỗ trợ chuỗi Solana, Base, Ethereum (Phase 1). * **[FR-DAT-02] Tích hợp DefiLlama:** * Số liệu TVL cho các truy vấn về "Bối cảnh Vĩ mô" (Macro Context). ### 6.3. Lớp Giao diện (The Dashboard & Extension) #### Browser Extension - Chrome Side Panel > **UX Strategy:** "Extension for Quick Actions, Frontend for Management" > > Extension tập trung vào **quick & contextual** actions, tận dụng tối đa frontend hiện có cho management tasks. ##### Phase 1: Core Infrastructure (✅ COMPLETED) **[FR-EXT-01] Side Panel Architecture:** * Extension mở dưới dạng **Chrome Side Panel** (không phải popup nhỏ). * Chiều rộng mặc định: 400px, có thể resize từ 300-600px. * Luôn hiển thị bên phải màn hình, không che khuất nội dung chính. * Tự động mở khi click vào extension icon. **[FR-EXT-02] AI Chat Interface (Tái sử dụng Frontend UI):** * Tích hợp đầy đủ `@assistant-ui/react` Thread component từ frontend web. * Hỗ trợ streaming responses với thinking steps visualization. * Attachment handling (images, files, screenshots). * Tool UIs: Display images, link previews, webpage scraping. * Chat history persistence sử dụng Plasmo Storage + Backend API sync. **[FR-EXT-03] Page Context Detection:** * Tự động nhận diện loại trang đang xem: * DexScreener → Extract token data (address, price, volume, liquidity) * CoinGecko → Extract coin info * Twitter/X → Extract crypto discussions * Generic → Basic page info * Inject context vào chat: "You are viewing $TOKEN on Solana..." * Pre-populate relevant questions dựa trên page type. **[FR-EXT-04] DexScreener Smart Integration:** * **Token Info Card:** Hiển thị ở top của side panel khi detect DexScreener page: ``` ┌─────────────────────────────┐ │ 🪙 BULLA/SOL │ │ $0.0001 📈 +15% │ │ Vol: $10K | Liq: $5K │ │ [Safety Check] [Holders] │ └─────────────────────────────┘ ``` * **Quick Actions:** * "Is this token safe?" → Tự động check LP lock, mint authority, holder distribution * "Show top holders" → Query blockchain data * "Price prediction" → AI analysis dựa trên historical data * **Auto-context Chat:** Khi user hỏi "this token", AI tự hiểu là token đang xem. **[FR-EXT-05] Quick Capture:** * Giữ tính năng capture page hiện tại. * Sticky button ở bottom của side panel: "📸 Save Current Page" * Lưu vào search space đã chọn. * Hiển thị toast notification khi save thành công. **[FR-EXT-06] Settings Sync với Frontend:** * **Compact Settings Dropdown:** ``` ┌─────────────────────────────┐ │ ⚙️ Quick Settings │ ├─────────────────────────────┤ │ Model: GPT-5.1 [▼] │ ← Read-only, sync từ backend │ Search Space: My Space [▼] │ ← Read-only, sync từ backend │ │ │ [🔗 Manage Connectors] │ ← Open frontend tab │ [📚 View All Chats] │ ← Open frontend tab │ [⚙️ Full Settings] │ ← Open frontend tab └─────────────────────────────┘ ``` * **State Sync:** Extension ↔ Backend API ↔ Frontend * Model selection (read-only in extension) * Search space (read-only in extension) * Enabled connectors (read-only in extension) * Chat history (bidirectional sync) * **Deep Links:** "Manage X" buttons → Open frontend in new tab ##### Phase 2: Smart Monitoring & Alerts **[FR-EXT-07] Real-time Price Alerts:** * **Watchlist Management:** Quản lý danh sách token theo dõi ngay trong side panel. * **Alert Types:** * Price alerts: Above/Below/Change % * Volume spike alerts (unusual trading activity) * Liquidity change alerts * **Browser Notifications:** Gửi notification ngay cả khi tab đóng. * **Sound Alerts:** Có thể bật/tắt âm thanh cảnh báo. **[FR-EXT-08] Whale Activity Tracker:** * Monitor large transactions (> $10K, $50K, $100K). * Detect wallet clustering (same entity). * Track smart money wallets. * Alert on unusual whale activity. * Show transaction details in side panel. **[FR-EXT-09] Rug Pull Early Warning System:** * **Risk Indicators:** * Monitor LP removal * Track mint authority changes * Detect suspicious holder patterns * Check contract ownership * **Risk Score Display:** ``` ⚠️ RUG PULL WARNING 🔴 LP unlocked (High Risk) 🟡 Top holder owns 40% 🟢 Contract verified Risk Score: 7/10 (High) Recommendation: AVOID ``` ##### Phase 3: Trading Intelligence **[FR-EXT-10] One-Click Token Analysis:** * **Comprehensive Analysis:** * Contract analysis (verified, renounced, etc.) * Holder distribution * Liquidity analysis * Trading volume patterns * Price history & trends * Social sentiment (Twitter, Telegram) * **AI-Generated Summary:** Tóm tắt insights chính trong 2-3 câu. * **Quick Access:** Button "Analyze This Token" trên Token Info Card. **[FR-EXT-11] Smart Entry/Exit Suggestions:** * Support/Resistance levels * Fibonacci retracement * Volume profile analysis * AI-predicted price targets * Risk/Reward ratio calculation **[FR-EXT-12] Portfolio Tracker Integration:** * Connect wallet (MetaMask, Phantom, etc.) * Auto-detect holdings * Real-time P&L tracking * Performance analytics * **Side Panel Tab:** Dedicated "Portfolio" view ##### Phase 4: Content Creation & Productivity **[FR-EXT-13] Chart Screenshot with Annotations:** * One-click chart capture from DexScreener * Auto-add price, volume, indicators * Drawing tools (lines, arrows, text) * Template styles (Dark/Light/Neon) * Export to Twitter/Telegram format **[FR-EXT-14] AI Thread Generator:** * Analyze token data * Generate Twitter thread structure (5-10 tweets) * Include charts, stats, insights * Optimize for engagement * One-click copy to clipboard **[FR-EXT-15] Quick Actions Context Menu:** * Right-click on token address → Quick actions * "Add to Watchlist" * "Analyze Token" * "Check Safety" * "Copy Address" * "View on Explorer" **[FR-EXT-16] Smart Notifications Management:** * Notification priority levels (High/Medium/Low) * Quiet hours (no alerts during sleep) * Grouped notifications * Smart batching (5 alerts → 1 summary) * Per-token notification settings **[FR-EXT-17] Keyboard Shortcuts:** * `Cmd+Shift+S` → Open side panel * `Cmd+Shift+A` → Analyze current token * `Cmd+Shift+W` → Add to watchlist * `Cmd+Shift+C` → Capture chart * `Cmd+Shift+P` → Portfolio view ##### Feature Responsibility Matrix > **Strategy Update (2026-02-04):** Extension = Full Features > > Extension không chỉ là "Quick Actions" mà là **full-featured crypto co-pilot** với đầy đủ tính năng. > Web Dashboard là nơi quản lý settings và xem analytics chi tiết. | Feature | Extension | Frontend Dashboard | Sync Method | |---------|-----------|-------------------|-------------| | **Model Selection** | 📖 Read-only dropdown | ✏️ Full selector | Backend API | | **Search Space** | 📖 Read-only dropdown | ✏️ Full management | Backend API | | **Chat** | ✅ Full chat UI | ✅ Full chat UI | Backend API | | **Connectors** | 📖 Use only | ✏️ Setup & manage | Backend API | | **Documents** | 👁️ View in chat | ✏️ Full management | Backend API | | **Watchlist** | ✅ Full management | ✅ Full management | Backend API | | **Alerts** | ✅ Full management | ✅ Full management | Backend API | | **Token Analysis** | ✅ Full analysis | ✅ Full analysis (via AI chat) | Backend API | | **Whale Activity** | ✅ Full tracking | ✅ Full tracking (via AI chat) | Backend API | | **Trading Suggestions** | ✅ Full suggestions | ✅ Full suggestions (via AI chat) | Backend API | | **Portfolio Tracker** | ✅ Full tracking | ✅ Full tracking | Backend API | | **Chart Capture** | ✅ Full capture + annotations | ❌ N/A (Extension-only) | Local | | **Thread Generator** | ✅ Full generation | ❌ N/A (Extension-only) | Local | | **Context Detection** | ✅ Auto-detect tokens | ❌ N/A (Extension-only) | Local | | **Floating Button** | ✅ Quick access | ❌ N/A (Extension-only) | Local | | **Settings** | 📖 Quick settings | ✏️ Full settings | Backend API | | **Analytics** | 👁️ Basic stats | ✅ Full analytics | Backend API | **Legend:** - ✅ Full feature (create, edit, delete, view) - ✏️ Full control (create, edit, delete) - 📖 Read-only (view/select only) - 👁️ View only - ❌ N/A (Not applicable) **Extension-only Features:** - Chart Capture with Annotations (cần truy cập DOM của trang) - AI Thread Generator (tối ưu cho workflow trên browser) - Context Detection (cần content script) - Floating Quick Action Button (cần inject vào trang) **Web Dashboard Focus:** - Full Settings Management - Detailed Analytics & Reports - Connector Setup & Configuration - Document Management #### Web Dashboard (Secondary - Existing) * **[FR-UI-01] Chat Management:** Xem lịch sử chat, manage search spaces. * **[FR-UI-02] Settings:** API key, preferences, connector configs. * **[FR-UI-03] Analytics:** Usage stats, token watchlist. --- ## 7. User Stories (Quy trình của Trader) ### Story 1: Khám phá (Discover - "Morning Brew") > **Là một** Momentum Trader, > **Tôi muốn** hỏi "Có gì đang hot trên hệ Base ngay lúc này?" > **Để** tôi có thể tìm cơ hội mà không cần lướt thủ công qua 500+ token rác trên DexScreener. ### Story 2: Thẩm định (Vet - "Safety Check") > **Là một** Nhà đầu tư Thận trọng, > **Tôi muốn** dán địa chỉ contract và hỏi "Kiểm tra giúp các dấu hiệu cờ đỏ (red flags)," > **Để** tôi không mất tiền vào các vụ rug pulls rõ ràng (token cho phép mint thêm, LP chưa khóa) mà tôi có thể bỏ sót trong lúc vội. ### Story 3: Giám sát (Monitor - "Sleep Aid") > **Là một** Swing Trader bận rộn, > **Tôi muốn** đặt cảnh báo AI cho việc "Cá voi bán tháo lượng lớn" trên vị thế của tôi, > **Để** tôi có thể ngủ ngon mà không cần check điện thoại mỗi 5 phút, biết rằng AI đang canh chừng *hành vi*, chứ không chỉ là giá. --- ## 8. Kiến trúc Kỹ thuật (Cấp cao) * **Frontend (Extension):** **Plasmo Framework** (React/TypeScript). Tối ưu cho Chrome Extensions, dễ mở rộng. * **Frontend (Web/Mobile):** Next.js (Secondary - Dùng cho trang quản lý tài khoản/Landing page). * **Backend:** Python (FastAPI) - Quan trọng cho stack AI/Data. * **AI Engine:** * LLM: Gemini 1.5 Flash (Chi phí/Tốc độ) hoặc GPT-4o-mini. * RAG: Supabase (pgvector). * Agent Framework: LangGraph (cho suy luận đa bước). * **Data Ops:** * Dịch vụ Polling cho DexScreener API (Tuân thủ rate limits). * Redis để cache dữ liệu token nóng nhằm giảm chi phí API.