# GewerbeLotse

> Kostenloses Web-Tool für Österreich: Alltagssprache wird in offizielle GISA-Gewerbewortlaute übersetzt — inkl. Gewerbeschlüssel, Einordnung frei/reglementiert und Orientierungshinweisen. Ohne Nutzerkonten, ohne Tracking, ohne personenbezogene Datenspeicherung.

Kunde / Kontext: Monadion GmbH
Rolle: Konzeption, Produktentwicklung, Datenschutz-by-Design, AWS-Betrieb & Datenpflege
Status: Live

## Ergebnis

Gründerinnen und Gründer finden vor der Gewerbeanmeldung den passenden offiziellen Wortlaut — datenschutzfreundlich, KI-gestützt und klar als Orientierung statt Rechtsberatung gekennzeichnet.

Kostenloses, öffentlich zugängliches Web-Tool für Österreich: Nutzerinnen und Nutzer beschreiben in Alltagssprache, was sie beruflich tun möchten — GewerbeLotse liefert dazu die passenden **offiziellen Gewerbewortlaute** aus dem GISA inkl. Gewerbeschlüssel, Einordnung frei/reglementiert sowie typischer Orientierungshinweise.

🌐 **Live unter:** [gewerbelotse.at](https://gewerbelotse.at)

---

## Ausgangslage

In Österreich ist die Gewerbeanmeldung an offizielle Wortlaute gebunden. Wer „ich will Fotos für Hochzeiten machen“ sagt, kennt selten den exakten GISA-Wortlaut, den Gewerbeschlüssel oder ob das Vorhaben frei oder reglementiert ist. Die offiziellen Listen sind umfangreich und in Behördensprache formuliert — schwer zugänglich für Gründerinnen, Solo-Selbständige und Beratende.

## Lösung

GewerbeLotse übersetzt Alltagssprache in die Sprache der Gewerbeordnung — mit klarer Kennzeichnung als **Orientierung**, nicht als Rechtsberatung und nicht als Behördenentscheidung.

---

## So funktioniert es

### 1. Eingabe in natürlicher Sprache
Beispiele: „Nagelstudio“, „Webseiten bauen“, „Döner verkaufen“. Keine Formulare in Behördensprache nötig.

### 2. Suche & Einordnung
Lexikalische, semantische und KI-gestützte Treffer finden passende Wortlaute — auch wenn die Formulierung vom offiziellen Text abweicht.

### 3. Ergebnis mit Klarheit
Offizieller Wortlaut, Gewerbeschlüssel, Art (frei / reglementiert / Teilgewerbe) und typische Fallstricke auf einen Blick.

### 4. Nächste Schritte
Weiterführende Orientierung zu Befähigung, Behördenfinder und Anmeldung — immer mit dem Hinweis: keine Rechtsberatung.

---

## Was das Tool leistet

**Orientierung statt Behördensprache**
- Alltagssprache → offizielle GISA-Wortlaute
- Gewerbeschlüssel und Einordnung frei / reglementiert / Teilgewerbe
- Typische Fallstricke und Orientierungshinweise

**Datenschutz by Design**
- Keine personenbezogenen Daten
- Kein Client-Storage (keine Cookies, kein localStorage)
- Kein Tracking, keine Analytics von Drittanbietern
- Keine IP-Adressen, keine Fingerprints, kein User-Agent
- Suchlogs nur normalisiert, Zeitstempel maximal Datum + Stunde
- KI-Transparenzhinweis direkt an der Suche (EU AI Act)

**Datengrundlage**
- GISA / BMWET über data.gv.at (CC BY 4.0)
- RIS – Rechtsinformationssystem des Bundes (CC BY 4.0)
- Datenstand und Attribution dauerhaft im Footer ausgewiesen

---

## Architektur (Überblick)

Statisches Frontend + serverlose Such-API auf AWS (`eu-central-1`). Fachdaten liegen als vorbereitete JSON-Artefakte in S3 — **ohne klassische Fachdatenbank** und ohne Vektordatenbank.

**Such-Pipeline**
1. Normalisierung der Anfrage (ohne Speicherung des Rohtexts)
2. Cache-Lookup in DynamoDB
3. Lexikalische Suche + Substring-Matching
4. Semantische Suche über vorberechnete Embeddings
5. Reciprocal Rank Fusion der Trefferlisten
6. Optionales LLM-Ranking mit Passungsfilter und Orientierungstexten
7. Anonymes Logging und Antwort an den Client

Bei erschöpftem globalen LLM-Budget läuft die Suche **ohne KI-Ranking** weiter (lexikalischer Fallback) — Schutz vor Kostenexplosion und Missbrauch.

Clientseitig ergänzt MiniSearch eine Offline-fähige Suche im Build.

---

## Ergebnis

- **Schnelle Orientierung** vor der Gewerbeanmeldung — in Alltagssprache statt Behördendeutsch
- **Offizielle Wortlaute & Schlüssel** aus öffentlichen Quellen, transparent attribuiert
- **Datenschutzfreundlich:** keine Konten, kein Tracking, keine personenbezogenen Daten
- **Kostensicher:** Budget-Limits und Fallback ohne KI-Ranking
- **Betrieb in der EU:** AWS Frankfurt (`eu-central-1`)

---

## Tech-Stack

| Bereich | Technologien |
|---|---|
| Frontend | React 18, TypeScript (strict), Vite, Tailwind CSS |
| Client-Suche | MiniSearch |
| Backend | AWS Lambda (Node.js), Function URLs |
| Hosting | AWS Amplify Hosting |
| Speicher | Amazon S3 (JSON-Datensatz, Logs, Aggregate) |
| Cache | Amazon DynamoDB (Query-Cache + Budget-Zähler) |
| KI | OpenAI (Embeddings + Ranking-Modell) |
| Pipeline | Node.js + TypeScript (`tsx`), pnpm Monorepo |
| Region | AWS `eu-central-1` (Frankfurt) |

---

## Bewusste Nicht-Ziele

- Keine Rechtsberatung / keine verbindliche Behördenentscheidung
- Keine Nutzerkonten, kein CRM, kein Analytics-Stack
- Kein Docker, kein Redux/Zustand, keine Vektordatenbank für die Wortlaute

---

*Dieses Projekt zeigt Monadions Fähigkeit, ein öffentlich nutzbares Fachprodukt end-to-end zu liefern: Konzeption, KI-gestützte Suche, Datenschutz-by-Design, serverless AWS-Betrieb und laufende Datenpflege — aus einer Hand.*

## Technologien

- React
- TypeScript
- Vite
- Tailwind CSS
- AWS Lambda
- Amazon S3
- DynamoDB
- OpenAI
- MiniSearch
- Amplify

## Relevante Links

- [HTML-Version](https://monadion.com/de/work/gewerbelotse)
- [Deutscher Überblick (llms.txt)](https://monadion.com/de/llms.txt)
- [Vollständiger AI-Kontext](https://monadion.com/de/llms-full.txt)
- [Analysegespräch buchen](https://monadion.com/de/booking)
- [Kontakt](https://monadion.com/de/contact)

## Weiterführende Inhalte

- [Alle Projekte](https://monadion.com/de/work.md)