stadtwerke/README.md

2.7 KiB
Raw Blame History

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)

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