SurfSense/_bmad-output/planning-artifacts/prd.md

stepsCompleted	inputDocuments	workflowType
	_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	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.