From f21e1a5b58167d957aef78f7a6a6987f6b8ba4e0 Mon Sep 17 00:00:00 2001 From: API Test Bot Date: Sun, 1 Feb 2026 21:43:15 +0700 Subject: [PATCH] docs: create epics and user stories for SurfSense 2.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Created 4 comprehensive epics with 15 user stories total: Epic 1: Extension Core Infrastructure (Phase 1) - βœ… COMPLETED - 6 stories covering side panel, chat, context detection, DexScreener integration Epic 2: Smart Monitoring & Alerts (Phase 2) - πŸ“‹ PLANNED - 3 stories covering price alerts, whale tracking, rug pull detection Epic 3: Trading Intelligence (Phase 3) - πŸ“‹ PLANNED - 3 stories covering token analysis, entry/exit suggestions, portfolio tracking Epic 4: Content Creation & Productivity (Phase 4) - πŸ“‹ PLANNED - 3 stories covering chart capture, AI thread generation, productivity features Each story includes: - User story format (As a... I want... So that...) - Detailed acceptance criteria - Technical implementation notes - UI mockups and code examples - API endpoints needed - Files to create/modify - Testing strategy Total timeline: 8 weeks (2 weeks per phase) --- _bmad-epics/README.md | 225 ++++++++ .../epic-1-extension-core-infrastructure.md | 302 +++++++++++ _bmad-epics/epic-2-smart-monitoring-alerts.md | 392 ++++++++++++++ _bmad-epics/epic-3-trading-intelligence.md | 490 ++++++++++++++++++ .../epic-4-content-creation-productivity.md | 451 ++++++++++++++++ 5 files changed, 1860 insertions(+) create mode 100644 _bmad-epics/README.md create mode 100644 _bmad-epics/epic-1-extension-core-infrastructure.md create mode 100644 _bmad-epics/epic-2-smart-monitoring-alerts.md create mode 100644 _bmad-epics/epic-3-trading-intelligence.md create mode 100644 _bmad-epics/epic-4-content-creation-productivity.md diff --git a/_bmad-epics/README.md b/_bmad-epics/README.md new file mode 100644 index 000000000..4f9058840 --- /dev/null +++ b/_bmad-epics/README.md @@ -0,0 +1,225 @@ +# SurfSense 2.0 - Epics & Stories + +**Project:** SurfSense Crypto Co-Pilot +**Created:** 2026-02-01 +**Status:** Planning Complete + +--- + +## Overview + +TΓ i liệu nΓ y tα»• chα»©c tαΊ₯t cαΊ£ epics vΓ  user stories cho SurfSense 2.0, được chia thΓ nh 4 phases dα»±a trΓͺn PRD. + +--- + +## Epic Summary + +| Epic | Phase | Stories | Status | Priority | Duration | +|------|-------|---------|--------|----------|----------| +| [Epic 1: Extension Core Infrastructure](./epic-1-extension-core-infrastructure.md) | Phase 1 | 6 | βœ… COMPLETED | P0 | 2 weeks | +| [Epic 2: Smart Monitoring & Alerts](./epic-2-smart-monitoring-alerts.md) | Phase 2 | 3 | πŸ“‹ PLANNED | P0 | 2 weeks | +| [Epic 3: Trading Intelligence](./epic-3-trading-intelligence.md) | Phase 3 | 3 | πŸ“‹ PLANNED | P1 | 2 weeks | +| [Epic 4: Content Creation & Productivity](./epic-4-content-creation-productivity.md) | Phase 4 | 3 | πŸ“‹ PLANNED | P2 | 2 weeks | + +**Total:** 4 epics, 15 user stories, 8 weeks + +--- + +## Phase 1: Extension Core Infrastructure βœ… + +**Epic 1** - Foundation cho tαΊ₯t cαΊ£ features + +### Stories: +1. **Story 1.1:** Side Panel Architecture (FR-EXT-01) +2. **Story 1.2:** AI Chat Interface Integration (FR-EXT-02) +3. **Story 1.3:** Page Context Detection (FR-EXT-03) +4. **Story 1.4:** DexScreener Smart Integration (FR-EXT-04) +5. **Story 1.5:** Quick Capture (FR-EXT-05) +6. **Story 1.6:** Settings Sync vα»›i Frontend (FR-EXT-06) + +**Key Deliverables:** +- βœ… Chrome Side Panel working +- βœ… AI chat interface integrated +- βœ… Context detection for DexScreener +- βœ… Token info card +- βœ… Quick capture button +- βœ… Settings sync infrastructure + +--- + +## Phase 2: Smart Monitoring & Alerts πŸ“‹ + +**Epic 2** - Risk protection & opportunity alerts + +### Stories: +1. **Story 2.1:** Real-time Price Alerts (FR-EXT-07) +2. **Story 2.2:** Whale Activity Tracker (FR-EXT-08) +3. **Story 2.3:** Rug Pull Early Warning System (FR-EXT-09) + +**Key Deliverables:** +- Watchlist management +- Price/volume/liquidity alerts +- Browser notifications +- Whale transaction monitoring +- Rug pull risk assessment +- Risk score display + +**Business Value:** Risk protection = User trust + +--- + +## Phase 3: Trading Intelligence πŸ“‹ + +**Epic 3** - AI-powered trading insights + +### Stories: +1. **Story 3.1:** One-Click Token Analysis (FR-EXT-10) +2. **Story 3.2:** Smart Entry/Exit Suggestions (FR-EXT-11) +3. **Story 3.3:** Portfolio Tracker Integration (FR-EXT-12) + +**Key Deliverables:** +- Comprehensive token analysis +- AI-generated summaries +- Entry/exit suggestions +- Risk/reward calculations +- Wallet connection +- Portfolio tracking +- P&L analytics + +**Business Value:** Better decisions = Better results = Happy users + +--- + +## Phase 4: Content Creation & Productivity πŸ“‹ + +**Epic 4** - Tools for creators & power users + +### Stories: +1. **Story 4.1:** Chart Screenshot with Annotations (FR-EXT-13) +2. **Story 4.2:** AI Thread Generator (FR-EXT-14) +3. **Story 4.3:** Quick Actions & Productivity (FR-EXT-15, 16, 17) + +**Key Deliverables:** +- Chart capture & annotation +- Drawing tools +- AI thread generation +- Context menu quick actions +- Smart notifications +- Keyboard shortcuts + +**Business Value:** Content creation = Viral marketing + +--- + +## Implementation Roadmap + +### Week 1-2: Phase 1 βœ… +- [x] Side panel architecture +- [x] Chat interface +- [x] Context detection +- [x] DexScreener integration +- [x] Quick capture +- [x] Settings sync + +### Week 3-4: Phase 2 (Next) +- [ ] Watchlist & alerts +- [ ] Whale tracker +- [ ] Rug pull detection + +### Week 5-6: Phase 3 +- [ ] Token analysis +- [ ] Trading suggestions +- [ ] Portfolio tracker + +### Week 7-8: Phase 4 +- [ ] Chart capture +- [ ] Thread generator +- [ ] Productivity features + +--- + +## Feature Responsibility Matrix + +| Feature | Extension | Frontend | Sync | +|---------|-----------|----------|------| +| Model Selection | πŸ“– Read-only | ✏️ Full control | API | +| Search Space | πŸ“– Read-only | ✏️ Full control | API | +| Chat | βœ… Full UI | βœ… Full UI | API | +| Connectors | πŸ“– Use only | ✏️ Setup | API | +| Documents | πŸ‘οΈ View | ✏️ Manage | API | +| Watchlist | ✏️ Add/Remove | ✏️ Full | Storage + API | +| Alerts | ✏️ Basic | ✏️ Full | API | +| Settings | πŸ“– Quick | ✏️ Full | API | + +**Legend:** +- βœ… Full feature +- ✏️ Full control +- πŸ“– Read-only +- πŸ‘οΈ View only + +--- + +## Technical Stack + +### Frontend (Extension) +- **Framework:** Plasmo (React + TypeScript) +- **UI:** @assistant-ui/react, shadcn/ui +- **State:** Plasmo Storage, React Context +- **APIs:** Chrome Extension APIs + +### Backend +- **Framework:** FastAPI (Python) +- **AI:** Gemini 1.5 Flash / GPT-4o-mini +- **RAG:** Supabase (pgvector) +- **Cache:** Redis + +### Data Sources +- DexScreener API +- DefiLlama API +- Helius (Solana) +- Alchemy (Ethereum) +- RugCheck API +- Token Sniffer + +--- + +## Success Metrics + +### Phase 1 (βœ… COMPLETED) +- [x] Extension installable +- [x] Chat works +- [x] Context detection works +- [x] Token card displays + +### Phase 2 (Target) +- [ ] 100+ tokens in watchlists +- [ ] 1000+ alerts set +- [ ] 0 false positive rug pull warnings + +### Phase 3 (Target) +- [ ] 500+ token analyses +- [ ] 80%+ suggestion accuracy +- [ ] 50+ wallets connected + +### Phase 4 (Target) +- [ ] 100+ charts captured +- [ ] 50+ threads generated +- [ ] 200+ daily shortcut uses + +--- + +## Next Steps + +1. βœ… **Epic 1 Complete** - Phase 1 infrastructure done +2. 🎯 **Start Epic 2** - Begin Phase 2 implementation +3. πŸ“ **Create Stories** - Break down Epic 2 into individual story files +4. πŸš€ **Sprint Planning** - Plan 2-week sprint for Phase 2 + +--- + +## Related Documents + +- [PRD](../_bmad-output/planning-artifacts/prd.md) +- [Extension UX Strategy](../.gemini/antigravity/brain/02a071c7-57fc-4f43-a2e8-516ac511579a/extension-ux-integration-strategy.md) +- [Extension Technical Spec](../.gemini/antigravity/brain/02a071c7-57fc-4f43-a2e8-516ac511579a/extension-sidepanel-technical-spec.md) +- [Feature Brainstorming](../.gemini/antigravity/brain/02a071c7-57fc-4f43-a2e8-516ac511579a/extension-features-brainstorming.md) diff --git a/_bmad-epics/epic-1-extension-core-infrastructure.md b/_bmad-epics/epic-1-extension-core-infrastructure.md new file mode 100644 index 000000000..368aae647 --- /dev/null +++ b/_bmad-epics/epic-1-extension-core-infrastructure.md @@ -0,0 +1,302 @@ +# Epic 1: Extension Core Infrastructure + +**Status:** βœ… COMPLETED +**Phase:** Phase 1 +**Duration:** 2 weeks +**Priority:** P0 (Critical) + +--- + +## Epic Overview + +XΓ’y dα»±ng nền tαΊ£ng cΖ‘ bαΊ£n cho Chrome Extension vα»›i Side Panel architecture, tΓ­ch hợp AI chat interface tα»« frontend, vΓ  context detection cho cΓ‘c trang crypto. + +**Business Value:** +- Cho phΓ©p users chat vα»›i AI ngay trong browser +- Tα»± Δ‘α»™ng detect vΓ  extract thΓ΄ng tin token tα»« DexScreener +- TΓ‘i sα»­ dα»₯ng tα»‘i Δ‘a frontend components (giαΊ£m development time) +- Foundation cho tαΊ₯t cαΊ£ features sau nΓ y + +--- + +## User Stories + +### Story 1.1: Side Panel Architecture +**[FR-EXT-01]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** mở AI assistant dΖ°α»›i dαΊ‘ng side panel (khΓ΄ng phαΊ£i popup nhỏ), +**Để** tΓ΄i cΓ³ thể chat vα»›i AI trong khi vαΊ«n xem được DexScreener chart. + +**Acceptance Criteria:** +- [ ] Extension icon click β†’ Mở side panel bΓͺn phαΊ£i mΓ n hΓ¬nh +- [ ] Side panel width: 400px (default), resizable 300-600px +- [ ] Side panel khΓ΄ng che khuαΊ₯t nα»™i dung chΓ­nh +- [ ] Side panel persist khi switch tabs +- [ ] Manifest cΓ³ permission `sidePanel` + +**Technical Notes:** +```typescript +// background/index.ts +chrome.sidePanel + .setPanelBehavior({ openPanelOnActionClick: true }) + .catch((error) => console.error("Failed to set side panel behavior:", error)); +``` + +**Files:** +- `surfsense_browser_extension/sidepanel.tsx` βœ… +- `surfsense_browser_extension/package.json` (add sidePanel permission) βœ… + +--- + +### Story 1.2: AI Chat Interface Integration +**[FR-EXT-02]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** chat vα»›i AI trong extension giα»‘ng nhΖ° trΓͺn web dashboard, +**Để** tΓ΄i cΓ³ trαΊ£i nghiệm nhαΊ₯t quΓ‘n vΓ  Δ‘αΊ§y đủ tΓ­nh nΔƒng. + +**Acceptance Criteria:** +- [ ] TΓ­ch hợp `@assistant-ui/react` Thread component +- [ ] Streaming responses hoαΊ‘t Δ‘α»™ng +- [ ] Thinking steps visualization hiển thα»‹ +- [ ] Tool UIs render Δ‘ΓΊng (images, links, scraping) +- [ ] Attachment handling (upload files/images) +- [ ] Chat history lΖ°u vΓ o Plasmo Storage +- [ ] Chat history sync vα»›i backend API + +**Component Reuse:** +```typescript +// From frontend +import { Thread } from "@/components/assistant-ui/thread"; +import { DisplayImageToolUI } from "@/components/tool-ui/display-image"; +import { LinkPreviewToolUI } from "@/components/tool-ui/link-preview"; +import { ScrapeWebpageToolUI } from "@/components/tool-ui/scrape-webpage"; +``` + +**Files:** +- `sidepanel/chat/ChatInterface.tsx` βœ… +- `sidepanel/chat/ChatMessages.tsx` βœ… +- `sidepanel/chat/ChatInput.tsx` βœ… +- `sidepanel/chat/ChatHeader.tsx` βœ… + +--- + +### Story 1.3: Page Context Detection +**[FR-EXT-03]** + +**LΓ  mα»™t** crypto trader Δ‘ang xem DexScreener, +**TΓ΄i muα»‘n** AI tα»± Δ‘α»™ng hiểu tΓ΄i Δ‘ang xem token nΓ o, +**Để** tΓ΄i khΓ΄ng cαΊ§n copy/paste token address mα»—i lαΊ§n. + +**Acceptance Criteria:** +- [ ] Content script detect page type: + - DexScreener β†’ Extract token data + - CoinGecko β†’ Extract coin info + - Twitter/X β†’ Extract crypto discussions + - Generic β†’ Basic page info +- [ ] Token data extracted: + - Token address + - Chain (Solana, Ethereum, Base) + - Price, volume, liquidity + - Pair info +- [ ] Context injected vΓ o chat: "You are viewing $TOKEN on Solana..." +- [ ] Context updates khi user navigate to different token + +**Technical Implementation:** +```typescript +// content.ts +function detectPageType(): PageType { + const hostname = window.location.hostname; + if (hostname.includes('dexscreener.com')) return 'dexscreener'; + if (hostname.includes('coingecko.com')) return 'coingecko'; + if (hostname.includes('twitter.com') || hostname.includes('x.com')) return 'twitter'; + return 'generic'; +} + +function extractDexScreenerData(): TokenData { + // Extract from URL: /solana/address + // Or from page DOM +} +``` + +**Files:** +- `content.ts` βœ… +- `sidepanel/context/PageContextProvider.tsx` βœ… + +--- + +### Story 1.4: DexScreener Smart Integration +**[FR-EXT-04]** + +**LΓ  mα»™t** crypto trader trΓͺn DexScreener, +**TΓ΄i muα»‘n** thαΊ₯y token info card ở top của side panel, +**Để** tΓ΄i cΓ³ thể nhanh chΓ³ng check safety hoαΊ·c xem holders. + +**Acceptance Criteria:** +- [ ] Token Info Card hiển thα»‹ khi detect DexScreener page +- [ ] Card shows: + - Token symbol/name + - Current price + - 24h change (%) + - Volume 24h + - Liquidity +- [ ] Quick action buttons: + - "Is this token safe?" β†’ Trigger safety check + - "Show top holders" β†’ Query blockchain + - "Price prediction" β†’ AI analysis +- [ ] Buttons trigger chat with pre-filled context +- [ ] Auto-context: "this token" = token Δ‘ang xem + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸͺ™ BULLA/SOL β”‚ +β”‚ $0.0001 πŸ“ˆ +15% β”‚ +β”‚ Vol: $10K | Liq: $5K β”‚ +β”‚ [Safety Check] [Holders] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Files:** +- `sidepanel/dexscreener/TokenInfoCard.tsx` βœ… +- `sidepanel/chat/ChatInterface.tsx` (integrate card) βœ… + +--- + +### Story 1.5: Quick Capture +**[FR-EXT-05]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** save current page vΓ o search space, +**Để** tΓ΄i cΓ³ thể reference lαΊ‘i sau. + +**Acceptance Criteria:** +- [ ] "πŸ“Έ Save Current Page" button ở bottom của side panel +- [ ] Button sticky (luΓ΄n visible) +- [ ] Click β†’ Capture page content +- [ ] Save vΓ o selected search space +- [ ] Toast notification: "Page saved successfully" +- [ ] Reuse existing capture functionality + +**Files:** +- `sidepanel/chat/QuickCapture.tsx` βœ… + +--- + +### Story 1.6: Settings Sync vα»›i Frontend +**[FR-EXT-06]** + +**LΓ  mα»™t** SurfSense user, +**TΓ΄i muα»‘n** extension sα»­ dα»₯ng cΓΉng model vΓ  search space nhΖ° web dashboard, +**Để** tΓ΄i khΓ΄ng phαΊ£i config lαΊ‘i. + +**Acceptance Criteria:** +- [ ] Settings dropdown trong extension header +- [ ] Dropdown shows: + - Current model (read-only) + - Current search space (read-only) + - Links to frontend management +- [ ] Links: + - "Manage Connectors" β†’ Open frontend /settings/connectors + - "View All Chats" β†’ Open frontend /chats + - "Full Settings" β†’ Open frontend /settings +- [ ] State sync: + - Extension reads from backend API + - Model selection synced + - Search space synced + - Enabled connectors synced (read-only) + - Chat history bidirectional sync + +**API Endpoints Needed:** +```typescript +GET /api/user/settings +POST /api/user/settings +GET /api/models/available +GET /api/search-spaces +GET /api/connectors/enabled +``` + +**Plasmo Storage Structure:** +```typescript +interface ExtensionStorage { + settings: { + selectedModel: string; + searchSpaceId: string; + apiKey: string; + }; + cachedSettings: UserSettings; + lastSync: number; +} +``` + +**Files:** +- `sidepanel/chat/ChatHeader.tsx` (add settings dropdown) +- `lib/api/settings-sync.ts` (new) + +--- + +## Technical Dependencies + +### Frontend Components to Reuse +- `@assistant-ui/react` Thread +- Tool UIs (images, links, scraping) +- Thinking steps visualization +- Chat utilities + +### Backend APIs Needed +- `/api/user/settings` - Get/update user settings +- `/api/models/available` - List available models +- `/api/search-spaces` - List search spaces +- `/api/connectors/enabled` - List enabled connectors +- `/api/chat/stream` - Chat streaming (existing) + +### Chrome APIs Used +- `chrome.sidePanel` - Side panel management +- `chrome.storage` - Plasmo Storage +- `chrome.tabs` - Tab management +- `chrome.runtime` - Messaging + +--- + +## Testing Strategy + +### Unit Tests +- [ ] PageContextProvider state management +- [ ] Token data extraction from DexScreener +- [ ] Settings sync logic + +### Integration Tests +- [ ] Side panel opens on icon click +- [ ] Chat streaming works +- [ ] Context detection works on DexScreener +- [ ] Token card displays correctly +- [ ] Quick capture saves page + +### Manual Testing +- [ ] Test on DexScreener.com +- [ ] Test on CoinGecko +- [ ] Test on Twitter +- [ ] Test settings sync with frontend +- [ ] Test chat history persistence + +--- + +## Definition of Done + +- [ ] All 6 stories completed +- [ ] All acceptance criteria met +- [ ] Unit tests passing +- [ ] Integration tests passing +- [ ] Manual testing completed +- [ ] Code reviewed +- [ ] Documentation updated +- [ ] Deployed to staging + +--- + +## Notes + +**Phase 1 Status:** βœ… COMPLETED (as of 2026-02-01) + +**Next Epic:** Epic 2 - Smart Monitoring & Alerts (Phase 2) diff --git a/_bmad-epics/epic-2-smart-monitoring-alerts.md b/_bmad-epics/epic-2-smart-monitoring-alerts.md new file mode 100644 index 000000000..4bc772629 --- /dev/null +++ b/_bmad-epics/epic-2-smart-monitoring-alerts.md @@ -0,0 +1,392 @@ +# Epic 2: Smart Monitoring & Alerts + +**Status:** πŸ“‹ PLANNED +**Phase:** Phase 2 +**Duration:** 2 weeks +**Priority:** P0 (Critical - Risk Protection) + +--- + +## Epic Overview + +XΓ’y dα»±ng hệ thα»‘ng monitoring vΓ  alerts thΓ΄ng minh để bαΊ£o vệ users khỏi rủi ro vΓ  giΓΊp họ khΓ΄ng bỏ lα»‘ cΖ‘ hα»™i. TαΊ­p trung vΓ o **risk protection** (rug pull detection) vΓ  **opportunity alerts** (whale activity, price movements). + +**Business Value:** +- **Risk Protection:** GiΓΊp users trΓ‘nh mαΊ₯t tiền vΓ o rug pulls +- **Opportunity Alerts:** KhΓ΄ng bỏ lα»‘ whale movements vΓ  price spikes +- **Always-On Monitoring:** Background monitoring ngay cαΊ£ khi browser Δ‘Γ³ng +- **Competitive Advantage:** Proactive alerts vs passive dashboards (DexScreener/DexTools) + +**Key Differentiator:** AI-driven anomaly detection, khΓ΄ng chỉ lΓ  threshold alerts. + +--- + +## User Stories + +### Story 2.1: Real-time Price Alerts +**[FR-EXT-07]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** set price alerts cho tokens trong watchlist, +**Để** tΓ΄i được notify khi price hit target mΓ  khΓ΄ng cαΊ§n stare vΓ o chart cαΊ£ ngΓ y. + +**Acceptance Criteria:** +- [ ] Watchlist management trong side panel + - Add token to watchlist (from DexScreener page) + - Remove token from watchlist + - View all watchlist tokens + - Edit token alerts +- [ ] Alert types: + - Price above threshold (e.g., > $0.001) + - Price below threshold (e.g., < $0.0005) + - Price change % (e.g., +20% in 1h) + - Volume spike (e.g., 3x average volume) + - Liquidity change (e.g., -50% liquidity) +- [ ] Browser notifications: + - Work even when tab closed + - Show token symbol, price, change % + - Click notification β†’ Open DexScreener page +- [ ] Sound alerts (optional): + - Enable/disable per alert + - Different sounds for different alert types +- [ ] Alert history: + - View past alerts + - Mark as read/unread + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ“Š Watchlist (5 tokens) β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ BULLA/SOL $0.0001 +15% β”‚ +β”‚ πŸ”” Alert: Price > $0.00015 β”‚ +β”‚ [Edit] [Remove] β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ PEPE/ETH $0.000001 -5% β”‚ +β”‚ πŸ”• No alerts β”‚ +β”‚ [Add Alert] β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ [+ Add Token to Watchlist] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface PriceAlert { + id: string; + tokenAddress: string; + chain: string; + alertType: 'above' | 'below' | 'change_percent' | 'volume_spike' | 'liquidity_change'; + threshold: number; + enabled: boolean; + soundEnabled: boolean; + lastTriggered?: number; +} + +// Background service worker +chrome.alarms.create('checkPriceAlerts', { periodInMinutes: 1 }); +chrome.alarms.onAlarm.addListener(async (alarm) => { + if (alarm.name === 'checkPriceAlerts') { + await checkAllPriceAlerts(); + } +}); +``` + +**Backend API:** +``` +POST /api/watchlist/add +DELETE /api/watchlist/:id +GET /api/watchlist +POST /api/alerts/create +GET /api/alerts/check // Returns triggered alerts +``` + +**Files:** +- `background/alerts/price-alerts.ts` (new) +- `sidepanel/watchlist/WatchlistPanel.tsx` (new) +- `sidepanel/watchlist/AddAlertModal.tsx` (new) + +--- + +### Story 2.2: Whale Activity Tracker +**[FR-EXT-08]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** được notify khi cΓ³ whale buy/sell lα»›n, +**Để** tΓ΄i cΓ³ thể follow smart money vΓ  trΓ‘nh bα»‹ dumped. + +**Acceptance Criteria:** +- [ ] Monitor large transactions: + - Configurable thresholds: $10K, $50K, $100K + - Detect buy vs sell + - Show transaction size in USD +- [ ] Wallet clustering detection: + - Identify same entity (multiple wallets) + - Show total holdings across wallets +- [ ] Smart money tracking: + - Track specific wallet addresses + - Alert on their activities + - Show their historical performance +- [ ] Transaction details: + - Wallet address + - Transaction hash + - Amount (tokens + USD) + - Time + - Link to explorer +- [ ] Notification: + - Browser notification for whale activity + - Show in side panel feed + - Filter by token (only watchlist or all) + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ‹ Whale Activity β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ 2 min ago β”‚ +β”‚ 🟒 BUY $100K BULLA/SOL β”‚ +β”‚ Wallet: 0x1234...5678 β”‚ +β”‚ Amount: 1B tokens β”‚ +β”‚ [View on Explorer] β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ 5 min ago β”‚ +β”‚ πŸ”΄ SELL $50K PEPE/ETH β”‚ +β”‚ Wallet: 0xabcd...ef01 β”‚ +β”‚ ⚠️ Smart Money Wallet β”‚ +β”‚ [Track This Wallet] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface WhaleTransaction { + id: string; + tokenAddress: string; + chain: string; + type: 'buy' | 'sell'; + amountUSD: number; + amountTokens: string; + walletAddress: string; + txHash: string; + timestamp: number; + isSmartMoney: boolean; +} + +// Poll blockchain for large transactions +async function monitorWhaleActivity() { + const watchlistTokens = await getWatchlistTokens(); + for (const token of watchlistTokens) { + const largeTxs = await fetchLargeTransactions(token, threshold); + for (const tx of largeTxs) { + await notifyWhaleActivity(tx); + } + } +} +``` + +**Data Sources:** +- Solana: Helius API / QuickNode +- Ethereum: Etherscan API / Alchemy +- Base: BaseScan API + +**Files:** +- `background/alerts/whale-tracker.ts` (new) +- `sidepanel/whale/WhaleActivityFeed.tsx` (new) +- `lib/blockchain/transaction-monitor.ts` (new) + +--- + +### Story 2.3: Rug Pull Early Warning System +**[FR-EXT-09]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** được cαΊ£nh bΓ‘o sα»›m về rug pull risks, +**Để** tΓ΄i khΓ΄ng mαΊ₯t tiền vΓ o scam tokens. + +**Acceptance Criteria:** +- [ ] Risk indicators monitored: + - LP removal (liquidity pulled) + - Mint authority changes (can mint more tokens) + - Suspicious holder patterns (top 10 holders > 80%) + - Contract ownership (not renounced) + - Honeypot detection (can't sell) +- [ ] Risk score calculation: + - 0-3: Low risk (green) + - 4-6: Medium risk (yellow) + - 7-10: High risk (red) +- [ ] Risk score display: + - Show on Token Info Card + - Update in real-time + - Explain each risk factor +- [ ] Recommendations: + - SAFE: "Low risk, proceed with caution" + - CAUTION: "Medium risk, do your own research" + - AVOID: "High risk, likely scam" +- [ ] Alerts: + - Notify when risk score increases + - Notify on LP removal + - Notify on mint authority changes + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ ⚠️ RUG PULL WARNING β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ Risk Score: 7/10 (High) β”‚ +β”‚ β”‚ +β”‚ πŸ”΄ LP unlocked (High Risk) β”‚ +β”‚ 🟑 Top holder owns 40% β”‚ +β”‚ 🟒 Contract verified β”‚ +β”‚ 🟒 Mint authority renounced β”‚ +β”‚ β”‚ +β”‚ Recommendation: AVOID β”‚ +β”‚ This token shows signs of β”‚ +β”‚ potential rug pull. β”‚ +β”‚ β”‚ +β”‚ [View Full Analysis] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface RiskAssessment { + tokenAddress: string; + chain: string; + riskScore: number; // 0-10 + riskLevel: 'low' | 'medium' | 'high'; + indicators: { + lpLocked: boolean; + lpLockDuration?: number; // days + mintAuthority: 'renounced' | 'active' | 'unknown'; + topHolderPercent: number; + contractVerified: boolean; + isHoneypot: boolean; + }; + recommendation: 'safe' | 'caution' | 'avoid'; + explanation: string; + timestamp: number; +} + +async function assessRugPullRisk(tokenAddress: string, chain: string): Promise { + // Check LP lock status + const lpLocked = await checkLPLock(tokenAddress, chain); + + // Check mint authority + const mintAuthority = await checkMintAuthority(tokenAddress, chain); + + // Check holder distribution + const holders = await getTopHolders(tokenAddress, chain); + const topHolderPercent = calculateTopHolderPercent(holders); + + // Check contract verification + const contractVerified = await isContractVerified(tokenAddress, chain); + + // Check honeypot + const isHoneypot = await checkHoneypot(tokenAddress, chain); + + // Calculate risk score + const riskScore = calculateRiskScore({ + lpLocked, + mintAuthority, + topHolderPercent, + contractVerified, + isHoneypot, + }); + + return { + tokenAddress, + chain, + riskScore, + riskLevel: getRiskLevel(riskScore), + indicators: { + lpLocked, + mintAuthority, + topHolderPercent, + contractVerified, + isHoneypot, + }, + recommendation: getRecommendation(riskScore), + explanation: generateExplanation(riskScore, indicators), + timestamp: Date.now(), + }; +} +``` + +**Data Sources:** +- LP Lock: RugCheck API, Token Sniffer +- Mint Authority: On-chain data (Solana/Ethereum) +- Holders: Blockchain explorers +- Contract Verification: Etherscan, Solscan +- Honeypot: Honeypot.is API + +**Files:** +- `lib/risk/rug-pull-detector.ts` (new) +- `sidepanel/risk/RiskScoreCard.tsx` (new) +- `background/alerts/risk-monitor.ts` (new) + +--- + +## Technical Dependencies + +### Backend APIs +``` +POST /api/watchlist/add +GET /api/watchlist +POST /api/alerts/create +GET /api/alerts/check +GET /api/whale/transactions +GET /api/risk/assess +``` + +### External APIs +- **Helius API** (Solana transactions) +- **Alchemy** (Ethereum transactions) +- **RugCheck API** (LP lock status) +- **Token Sniffer** (Contract analysis) +- **Honeypot.is** (Honeypot detection) + +### Chrome APIs +- `chrome.alarms` - Periodic checks +- `chrome.notifications` - Browser notifications +- `chrome.storage` - Watchlist persistence + +--- + +## Testing Strategy + +### Unit Tests +- [ ] Risk score calculation +- [ ] Whale transaction detection +- [ ] Alert triggering logic + +### Integration Tests +- [ ] Price alerts trigger correctly +- [ ] Whale activity notifications work +- [ ] Risk assessment updates in real-time + +### Manual Testing +- [ ] Add token to watchlist +- [ ] Set price alert and verify notification +- [ ] Monitor whale activity on live token +- [ ] Check rug pull warning on known scam token + +--- + +## Definition of Done + +- [ ] All 3 stories completed +- [ ] All acceptance criteria met +- [ ] Unit tests passing +- [ ] Integration tests passing +- [ ] Manual testing completed +- [ ] External API integrations working +- [ ] Code reviewed +- [ ] Documentation updated + +--- + +## Notes + +**Priority Justification:** Risk protection (rug pull detection) is CRITICAL for user trust. Users will not use the product if they lose money to scams. + +**Next Epic:** Epic 3 - Trading Intelligence (Phase 3) diff --git a/_bmad-epics/epic-3-trading-intelligence.md b/_bmad-epics/epic-3-trading-intelligence.md new file mode 100644 index 000000000..08848cfb7 --- /dev/null +++ b/_bmad-epics/epic-3-trading-intelligence.md @@ -0,0 +1,490 @@ +# Epic 3: Trading Intelligence + +**Status:** πŸ“‹ PLANNED +**Phase:** Phase 3 +**Duration:** 2 weeks +**Priority:** P1 (High - Value Add) + +--- + +## Epic Overview + +Cung cαΊ₯p AI-powered trading insights để giΓΊp users make better trading decisions. TαΊ­p trung vΓ o **comprehensive analysis**, **entry/exit suggestions**, vΓ  **portfolio tracking**. + +**Business Value:** +- **Better Decisions:** AI-generated insights giΓΊp users trade smarter +- **Time Savings:** One-click analysis thay vΓ¬ hours of research +- **Portfolio Management:** Track performance vΓ  optimize holdings +- **Competitive Advantage:** AI predictions vs static data (DexScreener/DexTools) + +**Key Differentiator:** AI-first analysis vα»›i natural language explanations. + +--- + +## User Stories + +### Story 3.1: One-Click Token Analysis +**[FR-EXT-10]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** analyze token vα»›i mα»™t click, +**Để** tΓ΄i cΓ³ comprehensive insights mΓ  khΓ΄ng cαΊ§n research thủ cΓ΄ng. + +**Acceptance Criteria:** +- [ ] "Analyze This Token" button trΓͺn Token Info Card +- [ ] Comprehensive analysis includes: + - **Contract Analysis:** + - Verified/unverified + - Renounced ownership + - Proxy contract detection + - Source code availability + - **Holder Distribution:** + - Top 10 holders percentage + - Holder count + - Whale concentration + - Distribution chart + - **Liquidity Analysis:** + - Total liquidity (USD) + - LP lock status & duration + - Liquidity history (7d, 30d) + - Liquidity/Market cap ratio + - **Trading Volume:** + - 24h volume + - Volume trend (increasing/decreasing) + - Volume/Liquidity ratio + - Unusual volume spikes + - **Price History:** + - All-time high/low + - 7d, 30d performance + - Price volatility + - Support/resistance levels + - **Social Sentiment:** + - Twitter mentions + - Telegram activity + - Reddit discussions + - Sentiment score (positive/negative/neutral) +- [ ] AI-Generated Summary: + - 2-3 sentence summary + - Key insights highlighted + - Risk assessment + - Trading recommendation +- [ ] Analysis caching: + - Cache for 5 minutes + - Show "Last updated" timestamp + - Refresh button + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ“Š Token Analysis β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ AI Summary: β”‚ +β”‚ "BULLA shows strong holder β”‚ +β”‚ distribution with verified β”‚ +β”‚ contract. Volume increasing β”‚ +β”‚ 200% in 24h. Moderate risk."β”‚ +β”‚ β”‚ +β”‚ Contract: βœ… Verified β”‚ +β”‚ Ownership: βœ… Renounced β”‚ +β”‚ β”‚ +β”‚ Holders: 1,234 β”‚ +β”‚ Top 10: 35% (Good) β”‚ +β”‚ β”‚ +β”‚ Liquidity: $50K β”‚ +β”‚ LP Lock: 90 days β”‚ +β”‚ β”‚ +β”‚ Volume 24h: $100K (+200%) β”‚ +β”‚ Price: $0.0001 (+15%) β”‚ +β”‚ β”‚ +β”‚ Sentiment: 😊 Positive β”‚ +β”‚ Twitter: 500 mentions β”‚ +β”‚ β”‚ +β”‚ Recommendation: BUY β”‚ +β”‚ Confidence: 75% β”‚ +β”‚ β”‚ +β”‚ [View Full Report] β”‚ +β”‚ Last updated: 2 min ago β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface TokenAnalysis { + tokenAddress: string; + chain: string; + timestamp: number; + + contract: { + verified: boolean; + renounced: boolean; + isProxy: boolean; + sourceCode: boolean; + }; + + holders: { + count: number; + top10Percent: number; + distribution: { address: string; percent: number }[]; + }; + + liquidity: { + totalUSD: number; + lpLocked: boolean; + lpLockDuration?: number; + history7d: number[]; + liquidityMcapRatio: number; + }; + + volume: { + volume24h: number; + trend: 'increasing' | 'decreasing' | 'stable'; + volumeLiquidityRatio: number; + spikes: { timestamp: number; volume: number }[]; + }; + + price: { + current: number; + ath: number; + atl: number; + change7d: number; + change30d: number; + volatility: number; + supportLevels: number[]; + resistanceLevels: number[]; + }; + + social: { + twitterMentions: number; + telegramActivity: number; + redditDiscussions: number; + sentimentScore: number; // -1 to 1 + sentiment: 'positive' | 'negative' | 'neutral'; + }; + + aiSummary: string; + recommendation: 'buy' | 'hold' | 'sell' | 'avoid'; + confidence: number; // 0-100 +} + +async function analyzeToken(tokenAddress: string, chain: string): Promise { + // Parallel data fetching + const [contract, holders, liquidity, volume, price, social] = await Promise.all([ + analyzeContract(tokenAddress, chain), + analyzeHolders(tokenAddress, chain), + analyzeLiquidity(tokenAddress, chain), + analyzeVolume(tokenAddress, chain), + analyzePrice(tokenAddress, chain), + analyzeSocial(tokenAddress, chain), + ]); + + // AI-generated summary + const aiSummary = await generateAISummary({ + contract, + holders, + liquidity, + volume, + price, + social, + }); + + return { + tokenAddress, + chain, + timestamp: Date.now(), + contract, + holders, + liquidity, + volume, + price, + social, + aiSummary, + recommendation: getRecommendation(/* ... */), + confidence: calculateConfidence(/* ... */), + }; +} +``` + +**Files:** +- `lib/analysis/token-analyzer.ts` (new) +- `sidepanel/analysis/TokenAnalysisPanel.tsx` (new) +- `sidepanel/analysis/AnalysisSummary.tsx` (new) + +--- + +### Story 3.2: Smart Entry/Exit Suggestions +**[FR-EXT-11]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** AI suggest entry/exit points, +**Để** tΓ΄i maximize profits vΓ  minimize losses. + +**Acceptance Criteria:** +- [ ] Technical analysis: + - Support/Resistance levels (3 levels each) + - Fibonacci retracement levels + - Volume profile analysis + - Moving averages (20, 50, 200) +- [ ] AI predictions: + - Predicted price targets (3 levels) + - Time horizon (1h, 4h, 24h) + - Confidence score per prediction +- [ ] Risk/Reward calculation: + - Suggested entry range + - Stop loss level + - Take profit levels (3 targets) + - Risk/Reward ratio +- [ ] Visual representation: + - Price chart with levels marked + - Entry/exit zones highlighted + - Risk/reward visualization +- [ ] Explanation: + - Why these levels? + - What signals support this? + - What could invalidate this? + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ’‘ AI Trading Suggestion β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ Current Price: $0.00010 β”‚ +β”‚ β”‚ +β”‚ Entry Zone: 🟒 β”‚ +β”‚ $0.00010 - $0.00012 β”‚ +β”‚ β”‚ +β”‚ Targets: β”‚ +β”‚ 🎯 Target 1: $0.00015 (+25%)β”‚ +β”‚ 🎯 Target 2: $0.00018 (+50%)β”‚ +β”‚ 🎯 Target 3: $0.00022 (+83%)β”‚ +β”‚ β”‚ +β”‚ Stop Loss: πŸ”΄ β”‚ +β”‚ $0.00008 (-20%) β”‚ +β”‚ β”‚ +β”‚ Risk/Reward: 1:3.3 (Good) β”‚ +β”‚ Confidence: 75% β”‚ +β”‚ β”‚ +β”‚ Why? β”‚ +β”‚ β€’ Strong support at $0.0001 β”‚ +β”‚ β€’ Volume increasing β”‚ +β”‚ β€’ Fibonacci 0.618 at $0.00015β”‚ +β”‚ β”‚ +β”‚ [View Chart] [Set Alerts] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface TradingSuggestion { + tokenAddress: string; + chain: string; + currentPrice: number; + timestamp: number; + + entry: { + min: number; + max: number; + reasoning: string; + }; + + targets: { + level: number; + price: number; + percentGain: number; + confidence: number; + }[]; + + stopLoss: { + price: number; + percentLoss: number; + reasoning: string; + }; + + riskReward: number; + overallConfidence: number; + + technicalLevels: { + support: number[]; + resistance: number[]; + fibonacci: { level: number; price: number }[]; + movingAverages: { period: number; price: number }[]; + }; + + reasoning: string[]; + invalidationConditions: string[]; +} +``` + +**Files:** +- `lib/analysis/trading-suggestions.ts` (new) +- `sidepanel/analysis/TradingSuggestionPanel.tsx` (new) + +--- + +### Story 3.3: Portfolio Tracker Integration +**[FR-EXT-12]** + +**LΓ  mα»™t** crypto trader, +**TΓ΄i muα»‘n** track portfolio trong extension, +**Để** tΓ΄i biαΊΏt P&L real-time mΓ  khΓ΄ng cαΊ§n mở nhiều tabs. + +**Acceptance Criteria:** +- [ ] Wallet connection: + - Support MetaMask, Phantom, Coinbase Wallet + - Multi-wallet support + - Auto-detect holdings +- [ ] Portfolio overview: + - Total value (USD) + - 24h P&L ($ and %) + - All-time P&L + - Asset allocation chart +- [ ] Holdings list: + - Token symbol/name + - Amount held + - Current value + - 24h change + - P&L per token + - Entry price (if available) +- [ ] Performance analytics: + - Best/worst performers + - Win rate + - Average hold time + - Total trades +- [ ] Quick actions: + - Analyze token + - Set price alert + - View on DexScreener + - Sell (link to DEX) + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ’Ό Portfolio β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ Total Value: $5,234 β”‚ +β”‚ 24h P&L: +$234 (+4.7%) πŸ“ˆ β”‚ +β”‚ β”‚ +β”‚ Holdings (5 tokens): β”‚ +β”‚ β”‚ +β”‚ BULLA/SOL β”‚ +β”‚ 1,000,000 tokens β”‚ +β”‚ $1,234 (+15%) πŸ“ˆ β”‚ +β”‚ [Analyze] [Alert] [Sell] β”‚ +β”‚ β”‚ +β”‚ PEPE/ETH β”‚ +β”‚ 500,000,000 tokens β”‚ +β”‚ $2,100 (-5%) πŸ“‰ β”‚ +β”‚ [Analyze] [Alert] [Sell] β”‚ +β”‚ β”‚ +β”‚ [+ Add Manual Position] β”‚ +β”‚ β”‚ +β”‚ Performance: β”‚ +β”‚ Best: BULLA (+15%) β”‚ +β”‚ Worst: PEPE (-5%) β”‚ +β”‚ Win Rate: 60% β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface Portfolio { + wallets: { + address: string; + chain: string; + type: 'metamask' | 'phantom' | 'coinbase'; + }[]; + + totalValue: number; + change24h: number; + change24hPercent: number; + + holdings: { + tokenAddress: string; + chain: string; + symbol: string; + name: string; + amount: string; + currentPrice: number; + currentValue: number; + change24h: number; + change24hPercent: number; + entryPrice?: number; + pnl?: number; + pnlPercent?: number; + }[]; + + analytics: { + bestPerformer: { symbol: string; change: number }; + worstPerformer: { symbol: string; change: number }; + winRate: number; + avgHoldTime: number; + totalTrades: number; + }; +} +``` + +**Files:** +- `lib/wallet/wallet-connector.ts` (new) +- `lib/portfolio/portfolio-tracker.ts` (new) +- `sidepanel/portfolio/PortfolioPanel.tsx` (new) + +--- + +## Technical Dependencies + +### Backend APIs +``` +POST /api/analysis/token +GET /api/analysis/suggestions +POST /api/portfolio/connect +GET /api/portfolio/holdings +GET /api/portfolio/analytics +``` + +### External APIs +- **Blockchain Data:** Helius, Alchemy, QuickNode +- **Price Data:** DexScreener API +- **Social Data:** Twitter API, LunarCrush +- **Technical Analysis:** TradingView indicators + +### Wallet Integration +- MetaMask SDK +- Phantom SDK +- Coinbase Wallet SDK + +--- + +## Testing Strategy + +### Unit Tests +- [ ] Token analysis calculation +- [ ] Trading suggestion algorithm +- [ ] Portfolio P&L calculation + +### Integration Tests +- [ ] Wallet connection flow +- [ ] Portfolio data fetching +- [ ] Analysis generation + +### Manual Testing +- [ ] Analyze live token +- [ ] Connect wallet and view portfolio +- [ ] Verify trading suggestions accuracy + +--- + +## Definition of Done + +- [ ] All 3 stories completed +- [ ] All acceptance criteria met +- [ ] Unit tests passing +- [ ] Integration tests passing +- [ ] Manual testing completed +- [ ] Wallet integrations working +- [ ] Code reviewed +- [ ] Documentation updated + +--- + +## Notes + +**Next Epic:** Epic 4 - Content Creation & Productivity (Phase 4) diff --git a/_bmad-epics/epic-4-content-creation-productivity.md b/_bmad-epics/epic-4-content-creation-productivity.md new file mode 100644 index 000000000..cf4ef5e10 --- /dev/null +++ b/_bmad-epics/epic-4-content-creation-productivity.md @@ -0,0 +1,451 @@ +# Epic 4: Content Creation & Productivity + +**Status:** πŸ“‹ PLANNED +**Phase:** Phase 4 +**Duration:** 2 weeks +**Priority:** P2 (Medium - Nice to Have) + +--- + +## Epic Overview + +TαΊ‘o tools giΓΊp users create content (charts, threads) vΓ  improve productivity (quick actions, notifications, shortcuts). TαΊ­p trung vΓ o **content creators** vΓ  **power users**. + +**Business Value:** +- **Content Creators:** Tools để tαΊ‘o Twitter threads, chart screenshots +- **Power Users:** Keyboard shortcuts, quick actions để work faster +- **Viral Marketing:** Users share content β†’ Free marketing +- **User Retention:** Productivity features β†’ Sticky product + +**Key Differentiator:** AI-powered content generation vs manual tools. + +--- + +## User Stories + +### Story 4.1: Chart Screenshot with Annotations +**[FR-EXT-13]** + +**LΓ  mα»™t** crypto content creator, +**TΓ΄i muα»‘n** capture vΓ  annotate charts, +**Để** tΓ΄i cΓ³ thể share insights trΓͺn Twitter/Telegram. + +**Acceptance Criteria:** +- [ ] One-click chart capture: + - Capture from DexScreener page + - Auto-detect chart area + - High-resolution screenshot +- [ ] Auto-add metadata: + - Token symbol/name + - Current price + - 24h change + - Volume, liquidity + - Timestamp + - Watermark (optional) +- [ ] Drawing tools: + - Lines (trend lines, support/resistance) + - Arrows (direction indicators) + - Text labels + - Shapes (circles, rectangles) + - Fibonacci retracement +- [ ] Template styles: + - Dark mode (default) + - Light mode + - Neon (crypto aesthetic) + - Custom colors +- [ ] Export options: + - Twitter format (1200x675) + - Telegram format (square) + - Instagram format (1080x1080) + - Custom size + - Copy to clipboard + - Save to file + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ“Έ Chart Capture β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ [Capture Chart] β”‚ +β”‚ β”‚ +β”‚ Drawing Tools: β”‚ +β”‚ [Line] [Arrow] [Text] [Fib] β”‚ +β”‚ β”‚ +β”‚ Style: β”‚ +β”‚ ● Dark β—‹ Light β—‹ Neon β”‚ +β”‚ β”‚ +β”‚ Metadata: β”‚ +β”‚ β˜‘ Token info β”‚ +β”‚ β˜‘ Price & change β”‚ +β”‚ β˜‘ Volume & liquidity β”‚ +β”‚ β˜‘ Timestamp β”‚ +β”‚ ☐ Watermark β”‚ +β”‚ β”‚ +β”‚ Export: β”‚ +β”‚ [Twitter] [Telegram] [Copy] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface ChartCapture { + screenshot: Blob; + metadata: { + tokenSymbol: string; + price: number; + change24h: number; + volume: number; + liquidity: number; + timestamp: number; + }; + annotations: { + type: 'line' | 'arrow' | 'text' | 'shape' | 'fibonacci'; + coordinates: { x: number; y: number }[]; + text?: string; + color: string; + }[]; + style: 'dark' | 'light' | 'neon'; +} + +async function captureChart(): Promise { + // Capture DexScreener chart area + const chartElement = document.querySelector('.chart-container'); + const canvas = await html2canvas(chartElement); + return canvas.toBlob(); +} + +function addAnnotations(canvas: HTMLCanvasElement, annotations: Annotation[]) { + const ctx = canvas.getContext('2d'); + for (const annotation of annotations) { + switch (annotation.type) { + case 'line': + drawLine(ctx, annotation); + break; + case 'arrow': + drawArrow(ctx, annotation); + break; + // ... + } + } +} +``` + +**Files:** +- `lib/capture/chart-capture.ts` (new) +- `sidepanel/capture/ChartCapturePanel.tsx` (new) +- `sidepanel/capture/AnnotationTools.tsx` (new) + +--- + +### Story 4.2: AI Thread Generator +**[FR-EXT-14]** + +**LΓ  mα»™t** crypto content creator, +**TΓ΄i muα»‘n** AI generate Twitter threads, +**Để** tΓ΄i cΓ³ thể share insights nhanh chΓ³ng. + +**Acceptance Criteria:** +- [ ] Input: + - Token address (auto-filled if on DexScreener) + - Thread topic (optional) + - Thread length (5-10 tweets) + - Tone (bullish/neutral/bearish) +- [ ] AI generation: + - Analyze token data + - Generate thread structure + - Include key stats + - Add charts/screenshots + - Optimize for engagement +- [ ] Thread structure: + - Tweet 1: Hook (attention grabber) + - Tweets 2-4: Analysis (data, insights) + - Tweets 5-7: Implications (what it means) + - Tweet 8-9: Conclusion (summary, CTA) + - Tweet 10: Disclaimer (optional) +- [ ] Editing: + - Edit each tweet + - Reorder tweets + - Add/remove tweets + - Preview thread +- [ ] Export: + - Copy all tweets + - Copy individual tweet + - Tweet directly (Twitter API) + - Save as draft + +**UI Design:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ 🧡 AI Thread Generator β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ Token: BULLA/SOL β”‚ +β”‚ Topic: [Auto] β”‚ +β”‚ Length: [7 tweets] β–Ό β”‚ +β”‚ Tone: ● Bullish β—‹ Neutral β”‚ +β”‚ β”‚ +β”‚ [Generate Thread] β”‚ +β”‚ β”‚ +β”‚ Preview: β”‚ +β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ +β”‚ β”‚ 1/ 🧡 BULLA is showing β”‚ β”‚ +β”‚ β”‚ massive volume spike... β”‚ β”‚ +β”‚ β”‚ [Edit] β”‚ β”‚ +β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ +β”‚ β”‚ 2/ Contract analysis: β”‚ β”‚ +β”‚ β”‚ βœ… Verified βœ… Renouncedβ”‚ β”‚ +β”‚ β”‚ [Edit] β”‚ β”‚ +β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ +β”‚ β”‚ +β”‚ [Copy All] [Tweet Now] β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +interface ThreadRequest { + tokenAddress: string; + chain: string; + topic?: string; + length: number; + tone: 'bullish' | 'neutral' | 'bearish'; +} + +interface GeneratedThread { + tweets: { + number: number; + content: string; + type: 'hook' | 'analysis' | 'implication' | 'conclusion' | 'disclaimer'; + includeChart?: boolean; + }[]; + metadata: { + tokenSymbol: string; + keyStats: Record; + }; +} + +async function generateThread(request: ThreadRequest): Promise { + // Analyze token + const analysis = await analyzeToken(request.tokenAddress, request.chain); + + // Generate thread with AI + const prompt = ` + Generate a ${request.length}-tweet thread about ${analysis.symbol}. + Tone: ${request.tone} + Include: price, volume, holders, liquidity, sentiment + Structure: Hook β†’ Analysis β†’ Implications β†’ Conclusion + `; + + const thread = await callAI(prompt, { analysis }); + + return thread; +} +``` + +**Files:** +- `lib/content/thread-generator.ts` (new) +- `sidepanel/content/ThreadGeneratorPanel.tsx` (new) + +--- + +### Story 4.3: Quick Actions & Productivity +**[FR-EXT-15, FR-EXT-16, FR-EXT-17]** + +**LΓ  mα»™t** power user, +**TΓ΄i muα»‘n** quick actions vΓ  shortcuts, +**Để** tΓ΄i cΓ³ thể work faster. + +**Acceptance Criteria:** + +#### Quick Actions Context Menu (FR-EXT-15) +- [ ] Right-click on token address β†’ Context menu +- [ ] Menu items: + - "Add to Watchlist" + - "Analyze Token" + - "Check Safety" + - "Copy Address" + - "View on Explorer" + - "View on DexScreener" +- [ ] Works on any webpage (not just DexScreener) +- [ ] Auto-detect token address format + +#### Smart Notifications (FR-EXT-16) +- [ ] Notification priority levels: + - High: Rug pull warnings, whale dumps + - Medium: Price alerts, volume spikes + - Low: General updates +- [ ] Quiet hours: + - Set sleep schedule (e.g., 11pm - 7am) + - No notifications during quiet hours + - Emergency alerts only (rug pulls) +- [ ] Grouped notifications: + - Group by token + - Group by type + - Collapse similar notifications +- [ ] Smart batching: + - 5+ alerts β†’ 1 summary notification + - "5 price alerts triggered" + - Click to expand +- [ ] Per-token settings: + - Enable/disable notifications + - Set priority level + - Custom quiet hours + +#### Keyboard Shortcuts (FR-EXT-17) +- [ ] Global shortcuts: + - `Cmd+Shift+S` β†’ Open side panel + - `Cmd+Shift+H` β†’ Hide side panel + - `Cmd+Shift+N` β†’ New chat +- [ ] Context shortcuts (when on DexScreener): + - `Cmd+Shift+A` β†’ Analyze current token + - `Cmd+Shift+W` β†’ Add to watchlist + - `Cmd+Shift+C` β†’ Capture chart + - `Cmd+Shift+T` β†’ Generate thread +- [ ] Portfolio shortcuts: + - `Cmd+Shift+P` β†’ Open portfolio + - `Cmd+Shift+R` β†’ Refresh portfolio +- [ ] Customizable shortcuts: + - User can remap shortcuts + - No conflicts with browser shortcuts + +**UI Design - Settings:** +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ βš™οΈ Productivity Settings β”‚ +β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ +β”‚ Notifications: β”‚ +β”‚ Priority: [High] [Med] [Low]β”‚ +β”‚ Quiet Hours: 11pm - 7am β”‚ +β”‚ β˜‘ Group notifications β”‚ +β”‚ β˜‘ Smart batching β”‚ +β”‚ β”‚ +β”‚ Keyboard Shortcuts: β”‚ +β”‚ Open panel: Cmd+Shift+S β”‚ +β”‚ Analyze: Cmd+Shift+A β”‚ +β”‚ Watchlist: Cmd+Shift+W β”‚ +β”‚ [Customize] β”‚ +β”‚ β”‚ +β”‚ Quick Actions: β”‚ +β”‚ β˜‘ Context menu enabled β”‚ +β”‚ β˜‘ Auto-detect addresses β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +**Technical Implementation:** +```typescript +// Context menu +chrome.contextMenus.create({ + id: 'analyze-token', + title: 'Analyze Token', + contexts: ['selection'], +}); + +chrome.contextMenus.onClicked.addListener((info, tab) => { + if (info.menuItemId === 'analyze-token') { + const address = extractTokenAddress(info.selectionText); + analyzeToken(address); + } +}); + +// Keyboard shortcuts +chrome.commands.onCommand.addListener((command) => { + switch (command) { + case 'open-panel': + chrome.sidePanel.open(); + break; + case 'analyze-token': + analyzeCurrentToken(); + break; + // ... + } +}); + +// Smart notifications +interface NotificationSettings { + priority: 'high' | 'medium' | 'low'; + quietHours: { start: string; end: string }; + grouping: boolean; + batching: boolean; + perToken: Record; +} + +function shouldShowNotification(notification: Notification, settings: NotificationSettings): boolean { + // Check quiet hours + if (isQuietHours(settings.quietHours) && notification.priority !== 'high') { + return false; + } + + // Check per-token settings + const tokenSettings = settings.perToken[notification.tokenAddress]; + if (tokenSettings && !tokenSettings.enabled) { + return false; + } + + return true; +} +``` + +**Files:** +- `background/context-menu.ts` (new) +- `background/keyboard-shortcuts.ts` (new) +- `background/notifications/smart-notifications.ts` (new) +- `sidepanel/settings/ProductivitySettings.tsx` (new) + +--- + +## Technical Dependencies + +### Chrome APIs +- `chrome.contextMenus` - Context menu +- `chrome.commands` - Keyboard shortcuts +- `chrome.notifications` - Notifications +- `chrome.alarms` - Quiet hours + +### External Libraries +- `html2canvas` - Chart capture +- `fabric.js` - Drawing tools (optional) + +--- + +## Testing Strategy + +### Unit Tests +- [ ] Token address detection +- [ ] Notification priority logic +- [ ] Quiet hours calculation + +### Integration Tests +- [ ] Chart capture works +- [ ] Thread generation works +- [ ] Context menu appears +- [ ] Shortcuts trigger actions + +### Manual Testing +- [ ] Capture chart and annotate +- [ ] Generate thread for live token +- [ ] Test all keyboard shortcuts +- [ ] Verify quiet hours work + +--- + +## Definition of Done + +- [ ] All 3 stories completed +- [ ] All acceptance criteria met +- [ ] Unit tests passing +- [ ] Integration tests passing +- [ ] Manual testing completed +- [ ] Code reviewed +- [ ] Documentation updated + +--- + +## Notes + +**Target Users:** Content creators vΓ  power users. + +**Marketing Opportunity:** User-generated content (threads, charts) β†’ Free viral marketing. + +**All Epics Complete!** πŸŽ‰