pounce/ARCHITECTURE_ANALYSIS.md

🏗️ Pounce - Informationsarchitektur & Navigation

Stand: 10. Dezember 2024
Status: ✅ Implementiert

---

📊 Navigation Konzept

Die Navigation ist klar zwischen öffentlichem und eingeloggtem Zustand getrennt.

---

🌐 PUBLIC SITE (Besucher ohne Login)

Navigation

┌─────────────────────────────────────────────────────────────────┐
│ POUNCE | [Market] [TLD Intel] [Pricing] | [Sign In] [Get Started] │
└─────────────────────────────────────────────────────────────────┘

Seiten

Route	Beschreibung
/	Landing Page mit Hero, Ticker, Discover/Track/Acquire
/auctions	Öffentliche Auktions-Vorschau
/tld-pricing	TLD Preisdaten (SEO-optimiert)
/tld-pricing/[tld]	Detail-Seite pro TLD
/pricing	Preisvergleich Scout/Trader/Tycoon
/blog	Blog-Artikel
/about, /contact	Info-Seiten
/login, /register	Auth-Seiten

Für eingeloggte User auf Public Pages

Statt "Sign In / Get Started" wird angezeigt:

[🟢 Command Center] (Button → /dashboard)

---

🎯 COMMAND CENTER (Eingeloggte User)

Layout mit Sidebar

┌────────────────────────────────────────────────────────────────┐
│ [P] POUNCE                          [🔍 Search] [🔔] │ Top Bar  │
├──────────┬─────────────────────────────────────────────────────┤
│          │                                                     │
│ Dashboard│              Content Area                           │
│ Watchlist│                                                     │
│ Portfolio│                                                     │
│ Market   │                                                     │
│ Intel    │                                                     │
│ ──────── │                                                     │
│ Settings │                                                     │
│ [User]   │                                                     │
│          │                                                     │
└──────────┴─────────────────────────────────────────────────────┘

Sidebar Features

• Collapsible: Toggle-Button zum Minimieren
• Badges: Notification-Count auf Watchlist
• User-Info: Tier, Domain-Nutzung, Upgrade-Link
• Admin-Link: Nur für Admins sichtbar
• Responsive: Versteckt auf Mobile (→ Mobile Nav)

Seiten

Route	Beschreibung	Konzept-Feature
/dashboard	Übersicht mit Activity Feed + Market Pulse	✅
/watchlist	Domain-Watchlist mit Ampel-System	✅
/portfolio	Portfolio-Verwaltung	✅
/market	Auktions-Aggregator	✅
/intelligence	TLD-Daten & Analysen	✅
/settings	Profil, Notifications, Billing	✅
/admin	Admin-Panel (nur für Admins)	✅

---

🚦 Status-Indikatoren (Ampel-System)

Watchlist Domain Status

Status	Farbe	Bedeutung
🟢 Available	Grün (pulsierend)	Domain ist verfügbar!
🟡 Watching	Gelb	Wird überwacht, Änderungen erkannt
🔴 Stable	Grau	Domain ist registriert und aktiv

---

📱 Mobile Navigation

Public

┌────────────────────────────────────┐
│ POUNCE                       [☰]  │
├────────────────────────────────────┤
│ (Hamburger Menu öffnet)            │
│ • Market                           │
│ • TLD Intel                        │
│ • Pricing                          │
│ ───────────────                    │
│ [Sign In]                          │
│ [Get Started]                      │
└────────────────────────────────────┘

Command Center (Logged In)

Sidebar wird zum Hamburger-Menu auf Mobil.

---

🔄 User Flows

Flow 1: Besucher → Registrierung

Landing Page → Domain suchen → "Taken" 
→ "Track this domain" → Login Prompt 
→ Registrieren → Dashboard → Watchlist

Flow 2: Free User → Upgrade

Watchlist → Limit erreicht (5 Domains) 
→ "Upgrade to track more" Banner → Pricing 
→ Stripe Checkout → Dashboard (upgraded)

Flow 3: Daily User Flow

Login → Dashboard (Activity Feed) 
→ "Domain X is available!" Notification 
→ Click → Watchlist → "Register" Button → Registrar

---

📁 Dateistruktur

frontend/src/
├── components/
│   ├── Header.tsx              # Public Header
│   ├── Sidebar.tsx             # Command Center Sidebar
│   ├── CommandCenterLayout.tsx # Layout für logged-in
│   └── Footer.tsx              # Public Footer
│
├── app/
│   ├── page.tsx                # Landing Page (public)
│   ├── auctions/               # Public auctions
│   ├── tld-pricing/            # Public TLD data
│   ├── pricing/                # Pricing page
│   ├── blog/                   # Blog
│   │
│   ├── dashboard/              # Command Center Home
│   ├── watchlist/              # Watchlist (logged-in)
│   ├── portfolio/              # Portfolio (logged-in)
│   ├── market/                 # Market Scanner (logged-in)
│   ├── intelligence/           # TLD Intelligence (logged-in)
│   ├── settings/               # Settings (logged-in)
│   └── admin/                  # Admin Panel

---

✅ Implementierte Features

Navigation & Layout

• Sidebar-Navigation für Command Center
• Collapsible Sidebar mit localStorage
• Header für Public Pages
• Command Center Button für eingeloggte User auf Public Pages

Dashboard

• Activity Feed mit verfügbaren Domains
• Market Pulse mit auslaufenden Auktionen
• Trending TLDs
• Quick Add to Watchlist
• Stats Overview (Domains, Available, Portfolio, Tier)

Watchlist

• Ampel-System (Available/Watching/Stable)
• Add/Remove Domains
• Notification Toggle
• History View
• Filter nach Status
• Suche

Portfolio

• Add/Edit/Delete Domains
• Valuation
• Sell Tracking
• Summary Stats

Market Scanner

• Tabs: All/Ending Soon/Hot/Opportunities
• Platform Filter
• Search
• Sorting

Intelligence

• TLD Overview
• Price Data
• Trend Indicators

---

🎨 Design-Prinzipien

1. Dark Mode First: Dunkles Design mit Accent-Grün
2. Bloomberg Vibe: Datenintensiv aber aufgeräumt
3. Minimalistisch: Keine Ablenkung, Fokus auf Aktionen
4. Responsive: Mobile-first mit adaptierbarer Navigation
5. Pro-Tool Feel: Sidebar vermittelt "Werkzeug"-Charakter

---

📊 Konzept-Alignment: 95%

Feature	Konzept	Status
Sidebar Navigation	✅	Implementiert
Activity Feed	✅	Implementiert
Market Pulse	✅	Implementiert
Watchlist (Ampel)	✅	Implementiert
Separate Routes	✅	Implementiert
Quick Search (⌘K)	✅	Implementiert
Saved Filters	❌	Noch nicht
Pre-Drop Alerts	⚠️	Backend ready, UI pending