stadtwerke/README.md

91 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.