pounce/ARCHITECTURE_ANALYSIS.md
yves.gugger f40d11edb7
Some checks failed
CI / Frontend Lint & Type Check (push) Has been cancelled
CI / Frontend Build (push) Has been cancelled
CI / Backend Lint (push) Has been cancelled
CI / Backend Tests (push) Has been cancelled
CI / Docker Build (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
Deploy / Build & Push Images (push) Has been cancelled
Deploy / Deploy to Server (push) Has been cancelled
Deploy / Notify (push) Has been cancelled
Add architecture analysis, fix landing page price (), update concept
2025-12-10 08:21:43 +01:00

255 lines
8.7 KiB
Markdown

# 🏗️ Pounce - Informationsarchitektur & Navigation Analyse
**Stand:** 10. Dezember 2024
---
## 📊 Executive Summary
Die aktuelle Implementierung ist **solide**, aber die Navigation und Informationsarchitektur weichen an einigen Stellen vom Konzept ab. Die wichtigsten Punkte:
| Bereich | Konzept | Aktuell | Status |
|---------|---------|---------|--------|
| Public Navigation | Home, Market, TLD Intel, Pricing | Market, TLD Intel, Pricing | ⚠️ Fast OK |
| Logged-in Navigation | Sidebar mit Dashboard, Watchlist, Market, Intelligence | Top-Nav mit Dashboard, Market, Intelligence | ⚠️ Struktur anders |
| Command Center | Sidebar-Navigation | Header-Navigation | ❌ Konzept fordert Sidebar |
| Naming | "Market", "Intelligence" | "Auctions", "TLD Pricing" | ⚠️ Inkonsistent |
---
## 🌐 Teil 1: PUBLIC SITE (Besucher ohne Login)
### Aktuelle Struktur
```
POUNCE (Logo) | [Market] [TLD Intel] [Pricing] | [Sign In] [Get Started]
```
### Was fehlt laut Konzept
1. **Kein "Home" Link** - User können nur über Logo zurück
2. **"Market Preview"** - Konzept: "limitiert auf 20 Einträge oder verzögert"
- ✅ Aktuell: Auctions-Seite ist öffentlich, aber ohne klare Limitierung
3. **TLD Intel** - Konzept: SEO-optimierte TLD-Detail-Seiten
- ✅ Vorhanden: `/tld-pricing/[tld]`
### ✅ Gut umgesetzt
- **Hero mit Suchfeld**: DomainChecker prominent platziert
- **Live Market Ticker**: Implementiert mit Auktionen
- **Trending TLDs**: 4 Karten auf Landing Page
- **Tagline**: "Don't guess. Know." ist vorhanden
- **Pricing**: CTA prominent
### ⚠️ Verbesserungsbedarf
| Problem | Lösung | Priorität |
|---------|--------|-----------|
| Pricing zeigt "$19" auf Landing Page | Muss auf "$9" aktualisiert werden | HOCH |
| Auctions komplett öffentlich | Sollte limitiert/verzögert sein für Free | MITTEL |
| Keine "Teaser-Elemente" bei Auctions | Spalten ausgrauen für Valuation | MITTEL |
---
## 🎯 Teil 2: COMMAND CENTER (Eingeloggte User)
### Konzept vs. Realität
**Konzept fordert:**
```
┌─────────────────────────────────────────┐
│ POUNCE [Bell] [👤] │
├──────────┬──────────────────────────────┤
│ Sidebar │ │
│ │ Content Area │
│ Dashboard│ │
│ Watchlist│ │
│ Market │ │
│ Intel │ │
│ Settings │ │
└──────────┴──────────────────────────────┘
```
**Aktuell implementiert:**
```
┌─────────────────────────────────────────────────────────────┐
│ POUNCE | [Dashboard] [Market] [Intelligence] | [Bell] [👤] │
├─────────────────────────────────────────────────────────────┤
│ │
│ Content Area │
│ │
└─────────────────────────────────────────────────────────────┘
```
### Kritische Unterschiede
1. **Keine Sidebar-Navigation**
- Konzept: "Linke Sidebar (Collapsible) wirkt professioneller"
- Aktuell: Standard Top-Navigation
2. **Dashboard Struktur**
- Konzept: Activity Feed, Market Pulse, Quick Search
- Aktuell: Watchlist + Portfolio Tabs
3. **Watchlist fehlt als separater Menüpunkt**
- Konzept: "My Watchlist" ist eigener Bereich
- Aktuell: Tab im Dashboard
4. **Keine "Saved Filters"**
- Konzept: "My AI Search" speichern
- Aktuell: Nicht implementiert
---
## 🗺️ Teil 3: Vollständige Sitemap-Analyse
### PUBLIC PAGES
| Route | Status | Konzept-Alignment | Anmerkung |
|-------|--------|-------------------|-----------|
| `/` | ✅ | ✅ Gut | Hero + Search + Ticker |
| `/auctions` | ✅ | ⚠️ | Sollte limitiert sein für Free |
| `/tld-pricing` | ✅ | ✅ Gut | SEO-optimiert |
| `/tld-pricing/[tld]` | ✅ | ✅ Gut | Detail-Seiten |
| `/pricing` | ✅ | ✅ Gut | Scout/Trader/Tycoon |
| `/blog` | ✅ | ✅ Gut | Resources |
| `/about` | ✅ | ✅ | - |
| `/contact` | ✅ | ✅ | - |
| `/login` | ✅ | ✅ | - |
| `/register` | ✅ | ✅ | - |
### COMMAND CENTER (Logged In)
| Route | Status | Konzept-Alignment | Anmerkung |
|-------|--------|-------------------|-----------|
| `/dashboard` | ✅ | ⚠️ | Fehlt: Activity Feed, Market Pulse |
| `/dashboard?tab=watchlist` | ✅ | ⚠️ | Sollte `/watchlist` sein |
| `/dashboard?tab=portfolio` | ✅ | ⚠️ | Sollte `/portfolio` sein |
| `/auctions` | ✅ | ⚠️ | Sollte `/market` sein |
| `/tld-pricing` | ✅ | ⚠️ | Sollte `/intelligence` sein |
| `/settings` | ✅ | ✅ Gut | Profil, Billing |
| `/admin` | ✅ | ✅ | Nur für Admins |
---
## 🎨 Teil 4: Empfohlene Optimierungen
### Phase 1: Quick Wins (1-2 Tage)
1. **Preis-Fix auf Landing Page**
- `page.tsx` Zeile 547: "$19/month" → "$9/month"
2. **Konsistente Naming**
- Public: "Market" → bleibt (gut für SEO)
- Logged-in: "Market" → bleibt
- "TLD Intel" oder "Intelligence" vereinheitlichen
3. **Dashboard Activity Feed**
- Zeige "3 Domains haben Status geändert"
- Zeige "5 Auktionen enden heute (die deinen Filtern entsprechen)"
### Phase 2: Struktur-Verbesserungen (1-2 Wochen)
1. **Sidebar Navigation für Command Center**
- Implementiere eine collapsible Sidebar für eingeloggte User
- Items: Dashboard, Watchlist, Portfolio, Market, Intelligence
2. **Separate Routes statt Tabs**
- `/watchlist` statt `/dashboard?tab=watchlist`
- `/portfolio` statt `/dashboard?tab=portfolio`
- Bessere Deep-Linking und UX
3. **Breadcrumbs konsistent**
- Bereits implementiert, aber prüfen
### Phase 3: Feature-Erweiterungen (2-4 Wochen)
1. **Dashboard Komponenten**
- Activity Feed mit echten Notifications
- Market Pulse: "Heute enden X Auktionen"
- Quick Search Widget
2. **Watchlist Verbesserungen**
- Ampel-System (🟢🟡🔴)
- Status-Karten statt Tabelle
3. **Market für Free-User limitieren**
- Nur 20 Auktionen anzeigen
- Valuation/Deal-Score ausgrauen
---
## 📱 Teil 5: Mobile Navigation
### Aktueller Status: ✅ Gut
- Hamburger Menu funktioniert
- User-Info wird angezeigt
- Tier-Anzeige vorhanden
- Admin-Link für Admins
### Verbesserungsvorschläge
1. **Bottom Navigation für Command Center**
- Für eingeloggte User auf Mobile
- Quick Access: Dashboard, Watchlist, Market, Profile
---
## 🔄 Teil 6: User Flows
### Flow 1: Besucher → Registrierung (✅ Gut)
```
Landing → Domain Search → "Taken" → "Add to Watchlist"
→ Login/Register Prompt → Account erstellen → Dashboard
```
### Flow 2: Free User → Upgrade (⚠️ Verbesserungsbedarf)
```
Dashboard → Limit erreicht (5 Domains) → ???
```
**Problem:** Kein klarer Upsell-Moment bei Limit
**Lösung:** Modal mit Upgrade-CTA wenn Limit erreicht
### Flow 3: Auctions → Kauf (✅ Gut)
```
Auctions → Filter → Domain finden → "Bid" klicken → Externe Plattform
```
---
## 📋 Prioritäten-Matrix
| Task | Aufwand | Impact | Priorität |
|------|---------|--------|-----------|
| Preis-Fix ($19→$9) | 5 min | Hoch | 🔴 KRITISCH |
| Activity Feed im Dashboard | 2-4h | Hoch | 🟠 HOCH |
| Sidebar Navigation | 1-2 Tage | Mittel | 🟡 MITTEL |
| Separate Routes (Watchlist) | 4-6h | Mittel | 🟡 MITTEL |
| Ampel-System Watchlist | 2-3h | Mittel | 🟡 MITTEL |
| Auctions Limitierung | 1-2h | Niedrig | 🟢 NIEDRIG |
---
## ✅ Zusammenfassung
**Was funktioniert hervorragend:**
- Landing Page mit "Bloomberg meets Apple" Vibe
- Live Market Ticker
- Domain Checker
- TLD Intelligence Seiten
- Mobile Responsiveness
- Dark Mode Design
**Was verbessert werden sollte:**
1. **KRITISCH:** Preis auf Landing Page falsch ($19 statt $9)
2. **HOCH:** Dashboard braucht Activity Feed und Market Pulse
3. **MITTEL:** Sidebar-Navigation für "Pro Tool"-Feeling
4. **MITTEL:** Separate Routes statt Tab-Navigation
**Gesamtbewertung:** Die Implementierung ist zu **75-80%** konzeptkonform. Die fehlenden 20-25% sind primär UX-Verbesserungen (Sidebar, Activity Feed, Ampel-System), die das "Command Center"-Gefühl verstärken würden.