# InnungsApp — Projektübersicht

> **SaaS-Plattform für Innungen & Kreishandwerkerschaften in Deutschland**
> **Version:** 2.0 | **Status:** Pre-MVP | **Stand:** Februar 2026

---

## Technisches Setup

Die aktuelle und verbindliche Anleitung fuer Start, Docker-Deployment, Migrationen und Seeding liegt in:

- `innungsapp/README.md`

Dieses Root-README ist eine Produkt- und Strategieuebersicht.

## Was ist InnungsApp?

InnungsApp ist eine mobile-first SaaS-Plattform, die Innungen und Kreishandwerkerschaften digitalisiert. Sie löst zwei akute Probleme gleichzeitig:

1. **Innungsverwaltung:** Mitglieder, News, Termine und interne Kommunikation aus Excel und WhatsApp-Gruppen heraus in eine professionelle App
2. **Azubi-Recruiting:** Fachkräftemangel bekämpfen — durch eine TikTok-inspirierte Lehrstellenbörse, die Gen Z dort abholt, wo sie ist

## Marktgröße

| Segment | Anzahl | Adressierbar |
|---|---|---|
| Innungen in Deutschland | ~7.500 | Ja |
| Kreishandwerkerschaften | ~500 | Ja |
| Mitgliedsbetriebe | ~500.000 | Indirekt |
| Offene Ausbildungsplätze | ~250.000 | Ja |

## Kern-These

> 7.500 Innungen verwalten ihre Mitglieder heute mit Excel und WhatsApp.
> Eine branchenspezifische App mit 200 €/Monat × 500 Kunden = **1,2 Mio. € ARR**.
> Der Azubi-Mangel macht dieses Tool zum **Überlebenswerkzeug** — kein Nice-to-have.

## Dokumente

| Datei | Inhalt |
|---|---|
| `PRD.md` | Vollständige Produktspezifikation |
| `ARCHITECTURE.md` | Technische Architektur |
| `DATABASE_SCHEMA.md` | Datenbankschema (SQL) |
| `USER_STORIES.md` | User Stories nach Rolle |
| `PERSONAS.md` | Nutzerprofile |
| `BUSINESS_MODEL.md` | Preismodell & Unit Economics |
| `ROADMAP.md` | Entwicklungsplan |
| `COMPETITIVE_ANALYSIS.md` | Wettbewerbsanalyse |
| `FEATURES_BACKLOG.md` | Feature Backlog |
| `API_DESIGN.md` | API-Endpunkte |
| `ONBOARDING_FLOWS.md` | Onboarding-Flows |
| `GTM_STRATEGY.md` | Go-to-Market Strategie |
| `VALIDATION_PLAYBOOK.md` | Validierungsstrategie |
| `AZUBI_MODULE.md` | Azubi-Recruiting Modul |
| `DSGVO_KONZEPT.md` | Datenschutz & Compliance |

## Tech Stack (Überblick)

- **Mobile:** React Native + Expo
- **Web Admin:** Next.js
- **Backend:** Supabase (PostgreSQL, Auth, Storage, Realtime)
- **Video:** Mux / Cloudflare Stream
- **Hosting:** Vercel
- **Analytics:** PostHog

## Quickstart (Legacy, nicht der aktuelle Betriebsweg)

```bash
# Repo klonen
git clone https://gitea.bizmatch.net/tknuth/stadtwerke.git
cd stadtwerke

# Supabase lokal starten
npx supabase init
npx supabase start

# Expo App starten
cd apps/mobile
npx expo start
```


pnpm --filter @innungsapp/admin dev -- --port 3032

npx expo start --clear

Demo: admin@demo.de / demo1234

Hinweis: Fuer den aktuellen lokalen/produktiven Betrieb bitte `innungsapp/README.md` verwenden.
