till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-23 04:26:42 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
managarten/memoro/apps/landing/docs/requirements/unified-analytics-dashboard-requirements.md
Till-JS e7f5f942f3 chore: initial commit - consolidate 4 projects into monorepo 
Projects included:
- maerchenzauber (NestJS backend + Expo mobile + SvelteKit web + Astro landing)
- manacore (Expo mobile + SvelteKit web + Astro landing)
- manadeck (NestJS backend + Expo mobile + SvelteKit web)
- memoro (Expo mobile + SvelteKit web + Astro landing)

This commit preserves the current state before monorepo restructuring.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-22 23:38:24 +01:00

12 KiB
Raw Blame History

Anforderungsdokument: Unified Analytics Dashboard

Projekt: Memoro Unified Analytics Dashboard
Version: 1.0
Datum: Dezember 2024
Autor: Memoro Team
Status: Draft

1. Executive Summary

Projektziel

Entwicklung eines zentralisierten Analytics-Dashboards, das alle relevanten Business-Metriken von Memoro in Echtzeit sammelt, speichert und visualisiert.

Business Value

  • Zeitersparnis: 10+ Stunden/Woche durch automatisierte Datensammlung
  • Bessere Entscheidungen: Alle KPIs auf einen Blick
  • Früherkennung: Automatische Alerts bei Anomalien
  • Wachstum: Datengetriebene Optimierung aller Kanäle

2. Datenquellen & Metriken

📱 App Stores

Plattform Metriken Update-Frequenz Priorität
App Store Connect Downloads, Reviews, Revenue, Crashes Täglich P1
Google Play Console Installs, Ratings, Revenue, ANRs Täglich P1

💰 Revenue & Subscriptions

Plattform Metriken Update-Frequenz Priorität
RevenueCat MRR, Churn, LTV, Active Subs Real-time P1
Stripe Payments, Refunds, MRR Real-time P2

📊 Website & Product Analytics

Plattform Metriken Update-Frequenz Priorität
Umami Analytics Visitors, Sessions, Pageviews, Bounce Stündlich P1
PostHog Events, Funnels, Retention, Feature Usage Real-time P1
Google Analytics 4 Users, Conversions, Demographics Stündlich P2

🔍 SEO & Search

Plattform Metriken Update-Frequenz Priorität
Google Search Console Rankings, Clicks, CTR, Impressions Täglich P1
Bing Webmaster Tools Rankings, Clicks, Crawl Errors Täglich P3

📢 Social Media Marketing

Plattform Metriken Update-Frequenz Priorität
Facebook/Meta Reach, Engagement, Follower, Ad Spend, CTR Täglich P1
LinkedIn Impressions, Followers, Engagement, Company Views Täglich P2
YouTube Views, Watch Time, Subscribers, Revenue Täglich P2
Twitter/X Impressions, Followers, Engagement Täglich P3
Instagram Reach, Stories, Engagement, Followers Täglich P3

🚀 Marketing & Campaigns

Plattform Metriken Update-Frequenz Priorität
Google Ads Spend, Conversions, CPC, ROAS Stündlich P2
Facebook Ads Spend, Reach, CTR, CPA Stündlich P2
Email (Sendgrid/Mailchimp) Opens, Clicks, Bounces, Unsubs Nach Versand P3

3. Funktionale Anforderungen

3.1 Datensammlung

  • FR-01: Automatische Datensammlung von allen definierten Quellen
  • FR-02: Inkrementelle Updates (nur neue Daten laden)
  • FR-03: Fehlerbehandlung und Retry-Mechanismen
  • FR-04: API-Rate-Limit Management
  • FR-05: Daten-Validierung und Qualitätschecks

3.2 Datenspeicherung

  • FR-06: Zentrale PostgreSQL Datenbank
  • FR-07: Historische Daten mindestens 24 Monate
  • FR-08: Tägliche Backups
  • FR-09: DSGVO-konforme Datenhaltung
  • FR-10: Daten-Partitionierung für Performance

3.3 Dashboard & Visualisierung

  • FR-11: Executive Summary Dashboard (C-Level Überblick)
  • FR-12: Detaillierte Dashboards pro Bereich (Marketing, Product, Revenue)
  • FR-13: Custom Reports erstellbar
  • FR-14: Export-Funktionen (PDF, Excel, CSV)
  • FR-15: Mobile-optimierte Ansicht

3.4 Key Performance Indicators (KPIs)

Primäre Business KPIs

1. MRR (Monthly Recurring Revenue)
2. DAU/MAU (Daily/Monthly Active Users)
3. Churn Rate
4. Customer Acquisition Cost (CAC)
5. Life Time Value (LTV)
6. LTV:CAC Ratio

Marketing KPIs

7. Website Conversion Rate
8. Cost per Acquisition (CPA)
9. Return on Ad Spend (ROAS)
10. Organic Traffic Growth
11. Social Media Engagement Rate
12. Email Open Rate

Product KPIs

13. Feature Adoption Rate
14. User Retention (D1, D7, D30)
15. Session Duration
16. Crash Rate
17. App Store Rating
18. NPS Score

3.5 Alerting & Monitoring

  • FR-16: Automatische Alerts bei KPI-Abweichungen (>20%)
  • FR-17: Täglicher Report per Email/Slack
  • FR-18: Anomalie-Erkennung mit ML
  • FR-19: Downtime-Monitoring für Datenquellen
  • FR-20: Performance-Degradation Alerts

4. Nicht-funktionale Anforderungen

4.1 Performance

  • NFR-01: Dashboard-Ladezeit < 3 Sekunden
  • NFR-02: Daten-Update-Latenz < 1 Stunde (außer Real-time)
  • NFR-03: Concurrent Users: min. 20
  • NFR-04: Datenverarbeitung: 10GB/Tag

4.2 Verfügbarkeit

  • NFR-05: System-Verfügbarkeit: 99.5%
  • NFR-06: Geplante Wartungsfenster: max. 2h/Monat
  • NFR-07: Recovery Time Objective (RTO): 4 Stunden
  • NFR-08: Recovery Point Objective (RPO): 24 Stunden

4.3 Sicherheit

  • NFR-09: SSL/TLS Verschlüsselung
  • NFR-10: API-Keys verschlüsselt speichern
  • NFR-11: Role-Based Access Control (RBAC)
  • NFR-12: Audit-Logging aller Zugriffe
  • NFR-13: DSGVO/GDPR Compliance

4.4 Skalierbarkeit

  • NFR-14: Horizontal skalierbar
  • NFR-15: Support für 50+ Datenquellen
  • NFR-16: 5 Jahre Datenhistorie speicherbar

5. Technische Architektur

5.1 Tech Stack

Data Collection:
  - Primary: Airbyte (Open Source)
  - Alternative: Apache NiFi
  - Custom: Python/Node.js Scripts

Data Storage:
  - Database: PostgreSQL 14+
  - Cache: Redis
  - Files: S3/MinIO

Data Processing:
  - Transformation: dbt (data build tool)
  - Orchestration: Apache Airflow
  - Stream Processing: Apache Kafka (optional)

Visualization:
  - Internal: Metabase
  - Technical: Grafana
  - Public: Custom React Dashboard

Infrastructure:
  - Container: Docker/Kubernetes
  - Cloud: AWS/GCP/Hetzner
  - Monitoring: Prometheus + Grafana

5.2 System-Architektur Diagramm

┌─────────────────────────────────────────────────────┐
│                   DATA SOURCES                       │
├───────┬─────────┬──────────┬───────────┬───────────┤
│  App  │ Revenue │ Analytics│  Search   │  Social   │
│Stores │   Cat   │  Umami   │  Console  │   Media   │
└───┬───┴────┬────┴────┬─────┴─────┬─────┴─────┬─────┘
    │        │         │           │           │
    └────────┴─────────┴───────────┴───────────┘
                        │
                    [AIRBYTE]
                        │
                  ┌─────┴─────┐
                  │PostgreSQL │
                  └─────┬─────┘
                        │
                   ┌────┴────┐
                   │   dbt   │
                   └────┬────┘
                        │
         ┌──────────────┼──────────────┐
         │              │              │
    [Metabase]    [Grafana]    [React App]
         │              │              │
    [Business]    [Technical]    [Public]

6. Implementierungsplan

Phase 1: Foundation (Woche 1-2)

  • PostgreSQL Setup
  • Airbyte Installation
  • Erste Datenquelle (Search Console)
  • Basic Dashboard (Metabase)

Phase 2: Core Data Sources (Woche 3-4)

  • App Store Connect Integration
  • Google Play Console Integration
  • RevenueCat Integration
  • Umami/PostHog Integration

Phase 3: Social & Marketing (Woche 5-6)

  • Facebook/Meta Integration
  • LinkedIn Integration
  • YouTube Integration
  • Google Ads Integration

Phase 4: Advanced Features (Woche 7-8)

  • Custom Dashboards
  • Alerting System
  • Historical Data Import
  • Performance Optimization

Phase 5: Production (Woche 9-10)

  • Security Hardening
  • Backup Strategy
  • Documentation
  • Team Training

7. Budget & Ressourcen

Einmalige Kosten

Item Kosten Bemerkung
Setup & Entwicklung 40-80h Intern oder Freelancer
Server Setup €200 Initial Hardware/Cloud
Lizenzen €0 Open Source Stack
Total €200 + Arbeitszeit

Laufende Kosten (monatlich)

Item Kosten Bemerkung
Server/Hosting €50-150 Je nach Traffic
Backup Storage €10-30 S3/Backblaze
Monitoring €0-20 Optional (Datadog etc.)
Wartung 5h/Monat Updates & Fixes
Total €60-200

Team & Rollen

  • Project Owner: CEO/CTO
  • Technical Lead: Backend Developer
  • Data Engineer: Airbyte/ETL Setup
  • Frontend Dev: Dashboard Customization
  • DevOps: Infrastructure & Monitoring

8. Risiken & Mitigationen

Risiko Wahrscheinlichkeit Impact Mitigation
API-Änderungen Hoch Mittel Regelmäßige Updates, Monitoring
Datenverlust Niedrig Hoch Tägliche Backups, Redundanz
Performance-Probleme Mittel Mittel Caching, Indizierung, Partitionierung
Kosten-Explosion Niedrig Mittel Usage Monitoring, Alerts
Compliance-Verstoß Niedrig Hoch DSGVO-Audit, Verschlüsselung

9. Erfolgs-Kriterien

Quantitative Ziele

  • ✅ Alle P1-Datenquellen integriert
  • ✅ Dashboard-Ladezeit < 3 Sekunden
  • ✅ 99.5% Verfügbarkeit erreicht
  • ✅ Automatisierungsgrad > 90%
  • ✅ Zeitersparnis > 10h/Woche

Qualitative Ziele

  • ✅ Intuitive Bedienbarkeit
  • ✅ Aktuelle und korrekte Daten
  • ✅ Actionable Insights
  • ✅ Team-Akzeptanz hoch
  • ✅ Entscheidungsfindung verbessert

10. Nächste Schritte

  1. Sofort (diese Woche):

    • Anforderungen mit Team reviewen
    • Budget freigeben
    • Airbyte lokal testen

  2. Nächste Woche:

    • Server/Cloud Provider wählen
    • PostgreSQL aufsetzen
    • Erste Datenquelle verbinden

  3. In 2 Wochen:

    • MVP Dashboard live
    • Team-Feedback sammeln
    • Roadmap finalisieren

Anhang A: API-Dokumentation Links

Anhang B: Airbyte Connector Status

Datenquelle Connector Status Bemerkung
Google Search Console ✅ Offiziell Stable
App Store Connect ✅ Community Beta
Google Play ✅ Offiziell Beta
RevenueCat ⚠️ Custom Build needed API vorhanden
Facebook/Meta ✅ Offiziell Stable
LinkedIn ✅ Offiziell Stable
YouTube ✅ Offiziell Stable
PostHog ✅ Offiziell Stable
Umami ⚠️ Custom Build needed REST API

Dokumenten-Status: Ready for Review
Nächster Review: Januar 2025
Kontakt: team@memoro.ai