feat: update documentation with an overview of AsphaltGhost, quickstart setup, and detailed feature descriptions for community feed, spot map, moderation, and push notifications

Author: Qu3ntinS

docs/features/feed.md

@@ -0,0 +1,3 @@
+# Feature: Community-Feed
+
+Chronologischer Feed, Post erstellen (Text + Fotos), Like und Kommentar. Post-Detail als Modal. Bild-Safety bei Uploads. Routen: feed.tsx, create-post.tsx, post/[id].tsx. Siehe DATABASE.md und ARCHITECTURE.md.

docs/features/map.md

@@ -0,0 +1,3 @@
+# Feature: Spot-Map
+
+Karte mit approved Spots, react-native-maps und Google Maps. Optional Custom Dark Style. Ghost-Marker je Spot-Typ. Filter und Suchfeld. Spot-Detail oeffnet als Modal. Siehe ARCHITECTURE.md und DESIGN.md im Repo.

docs/features/moderation.md

@@ -0,0 +1,3 @@
+# Feature: Moderation und Admin
+
+Moderatoren: Pending Spots freigeben/ablehnen; Reports (Spot/Post) bearbeiten; Push bei neuer Meldung oder neuem Spot-Review. Admins: Moderatoren verwalten; User loeschen. Tabellen: moderators, admins, reports. Routen: moderation.tsx, admin.tsx. Siehe DATABASE.md und DECISIONS.md.

docs/features/push-notifications.md

@@ -0,0 +1,3 @@
+# Feature: Push-Benachrichtigungen
+
+Zwei Arten: (1) Moderator-Push per Edge Function notify-moderators bei neuer Meldung oder Spot-Review; Tokens in moderation_push_tokens. (2) Taegliche lokale Erinnerung (max. 1/Tag), Toggle in Einstellungen. In Expo Go wird Push-Logik uebersprungen. Siehe DATABASE.md, SETUP.md, DECISIONS.md.

docs/intro.md

@@ -1,38 +1,26 @@
----
-sidebar_position: 1
-slug: /
----
+# AsphaltGhost – Ueberblick
 
-# AsphaltGhost Documentation
+AsphaltGhost ist eine mobile Community-App fuer die Auto-Szene: Drift-Spots und Tuning-Treffen finden, einreichen und bewerten, plus Community-Feed.
 
-Welcome to the AsphaltGhost documentation site.
+## Tech Stack
 
-## Getting Started (5 Minuten)
+- **App:** Expo SDK 54, Expo Router v6, TypeScript, React Query, Zustand
+- **Karte:** react-native-maps mit Google Maps (PROVIDER_GOOGLE)
+- **Backend:** Supabase (Auth, PostgreSQL, Storage, Edge Functions)
+- **Push:** Expo Notifications (Moderator-Benachrichtigungen, taegliche Erinnerung optional)
 
-1. Clone:
-   - `git clone --recurse-submodules git@github.com:AsphaltGhost/base-app.git`
-2. Install:
-   - `cd base-app`
-   - `npm install`
-3. Configure env:
-   - `.env.example` zu `.env` kopieren
-   - `EXPO_PUBLIC_SUPABASE_URL`, `EXPO_PUBLIC_SUPABASE_ANON_KEY`, `EXPO_PUBLIC_MAPBOX_ACCESS_TOKEN` setzen
-4. Build Android Dev Client (wegen Mapbox):
-   - `npx expo run:android`
-5. Start App:
-   - `npx expo start --dev-client`
+## Kernfunktionen (MVP)
 
-## Overview
+- **Auth:** Login mit E-Mail oder Username; Profil mit optionalem Vor-/Nachnamen
+- **Spot-Map:** Karte mit approved Spots, Filter, Ghost-Marker, Spot-Detail als Modal
+- **Spot einreichen:** Adresssuche + Kartenauswahl; KI-Analyse; Bild-Safety
+- **Bewertung und Kommentare:** 1-5 Sterne, Kommentar; Bewertung bearbeiten/loeschen
+- **Feed:** Chronologischer Feed, Post erstellen, Like/Kommentar, Post-Detail
+- **Moderation:** Pending Spots und Reports; Moderatoren-Push
+- **Admin:** Moderatoren zuweisen; User loeschen
+- **Einstellungen:** Map-Style, Haptik, Push-Erinnerung; Profil/Account; Account loeschen (2-Schritt)
 
-This site centralizes setup, architecture, database, design, deployment, and MVP handoff documentation for `base-app`.
+## Weitere Docs
 
-## Documentation Index
-
-- [Setup](./setup)
-- [Architecture](./architecture)
-- [Database](./database)
-- [Design](./design)
-- [Deployment](./deployment)
-- [Decisions (ADR Light)](./decisions)
-- [MVP Acceptance Checklist](./mvp-acceptance)
-- [Troubleshooting](./troubleshooting)
+- Repo `docs/`: ARCHITECTURE, DATABASE, SETUP, DEPLOYMENT, DECISIONS, DESIGN
+- Plan: `asphaltghost-mvp-plan.md`

docs/setup-quickstart.md

@@ -0,0 +1,23 @@
+# Setup – Kurzfassung
+
+Schneller Einstieg für Entwickler. Ausführlich: `docs/SETUP.md` im Repo.
+
+## Voraussetzungen
+
+- Node 20, npm, JDK 17, Android Studio (für Android Build)
+- Supabase-Projekt, Google Maps API Key
+
+## Schritte
+
+1. **Repo klonen:** `git clone --recurse-submodules <repo-url>` → `cd base-app`
+2. **Install:** `npm install`
+3. **Umgebung:** `.env` mit `EXPO_PUBLIC_SUPABASE_URL`, `EXPO_PUBLIC_SUPABASE_ANON_KEY`; Google Maps Key in `app.json`
+4. **Supabase:** Alle Migrationen von `0001` bis `0020` im SQL Editor ausführen (siehe `docs/DATABASE.md`)
+5. **Edge Functions:** `supabase functions deploy analyze-spot` und `supabase functions deploy notify-moderators`; Secret `OPENAI_API_KEY` setzen
+6. **Dev Build:** `npx expo run:android` (oder iOS), danach `npx expo start --dev-client`
+
+## Wichtige Hinweise
+
+- **Karte & Push** benötigen einen Development Build (nicht Expo Go).
+- **Auth** nutzt AsyncStorage; Redirect in Supabase auf `asphaltghost://login` setzen.
+- **Docs (Docusaurus):** Bei Bedarf `cd docs-site && npm install && npm start`.