diff --git a/FEATURES.md b/FEATURES.md index a9a1d73..656177e 100644 --- a/FEATURES.md +++ b/FEATURES.md @@ -1,6 +1,6 @@ # BehördenKlar — Überblick für Claude -> Stand: 23.09.2026. Diese Datei beschreibt, **was es gibt**. +> Stand: 22.10.2026. Diese Datei beschreibt, **was es gibt**. > Für Release-Stand und offene Aufgaben siehe die Projekt-Erinnerung. > Für Arbeitsregeln siehe `AGENTS.md` (Expo-Docs vor Code lesen!). @@ -92,6 +92,30 @@ Sprechzeiten — und schreibt einen **Spickzettel** mit 3–5 Sätzen für das T **Regel im Prompt:** Kontaktdaten nur, wenn sie **wörtlich** im Brief stehen. Getestet mit einem Brief ohne Telefonnummer → `telefon: null`, nichts erfunden. Eine falsche Nummer wäre schlimmer als keine. +### 3c. Handy ↔ PC — für die Beratung (seit 22.10.) +Ein QR-Code verbindet zwei Geräte, **Ende-zu-Ende verschlüsselt** (AES-256-GCM). +Schlüssel und Übergabe-ID stehen hinter dem `#` der Adresse, gehen also nie an +einen Server. Der Worker hält nur Chiffrat, höchstens 15 Minuten +(Durable Object `Uebergabe`, Route `/uebergabe/[/]`). + +| Art (`a=`) | Wer zeigt den QR | Was passiert | +|---|---|---| +| `k` Kamera | PC: „Lieber mit dem Handy fotografieren" | Handy fotografiert, Ergebnis erscheint am PC **auf Deutsch** und am Handy **in der Muttersprache** (`auchDeutsch` → Worker analysiert deutsch und übersetzt mit Haiku, kostet 1 Analyse). Guthaben des PCs gilt am Handy nur für diese Sitzung. | +| `m` Mitnehmen | PC: „Ergebnis aufs Handy mitnehmen" | Ergebnis landet auf dem Handy (Browser) bzw. im App-Archiv, einmal abholbar | +| `g` Guthaben | PC: „Auch auf dem Handy nutzen" | Guthaben/Einrichtungs-Zugang dauerhaft aufs Handy (Browser) | + +Gleiches Päckchen-Format in `webseite/uebergabe.js` und `src/services/uebergabe.ts` +(IV‖Chiffrat‖Tag, base64url) — Test: `src/utils/__tests__/uebergabe.test.ts`. +**App:** Brief → „Am Computer zeigen" (`a=k`), Archiv → „Vom Computer übernehmen" +(`a=m`), Bildschirm `VerbindenScreen` mit QR-Scanner und Link-Einfügen als Ersatz. + +### 3d. Einrichtungs-Codes für Beratungsstellen (seit 22.10.) +Die Einrichtung zahlt, Ratsuchende nicht. Ein Code (z. B. `MBE-K7QX`) zeigt auf +ein Guthaben wie beim Kauf, mit Name und Ablaufdatum. Einlösen per Link +`behoerdenklar.de/demo?code=…` oder Eingabefeld; Banner „Kostenlos über …". +Verwalten mit `node tools/einrichtungs-code.js neu|stand|aufladen|verlaengern`. +Falsche Codes: max. 10 pro IP und Tag. + ### 4. Ampel statt Datum Rot ≤ 7 Tage, gelb ≤ 21, sonst grün. Die Startseite sortiert nach **Dringlichkeit**, nicht nach Eingang — man sieht sofort, was brennt. @@ -207,6 +231,8 @@ und Sprachwähler in der handgemachten `index.html` nach und schreibt die | `/kaufen` | Stripe-Bezahlseite erzeugen | | `/kauf-status` | Nach Rückkehr: Zahlung prüfen, Guthaben freischalten | | `/stripe-webhook` | Sicherungsnetz + Wiederherstellungs-Mail | +| `/code` | Einrichtungs-Code einlösen → signiertes Guthaben-Token | +| `/uebergabe/` | Handy ↔ PC: verschlüsselte Päckchen (Durable Object, 15 Min.) | ### Bezahlung (LIVE, echtes Geld) - **Guthaben statt Abo:** 5 Analysen 2,99 € · 15 Analysen 6,99 € @@ -247,11 +273,16 @@ rotiert werden. ```bash npm run pruefung # Gesundheits-Check — nach JEDEM Deploy -npm test # 35 Tests +npm test # 43 Tests npx tsc --noEmit # Typen node tools/sprachseiten/build.js # Sprachseiten neu bauen ``` +**Lokal testen** (ohne live zu gehen): in `/Users/homefolder/Behörden_App/.claude/launch.json` +`proxy-worker` (Port 8799, `.dev.vars` mit `LOKAL_TEST=1` und Turnstile-Testschlüssel) ++ `webseite` (Port 4173) starten, dann `http://localhost:4173/demo.html`. Auf +localhost nimmt die Seite automatisch den lokalen Worker und den Test-Sitekey. + **Deploy:** ```bash cd proxy && npx wrangler deploy # Worker diff --git a/marketing/outreach-september.md b/marketing/outreach-september.md index c6e0d0c..2f5a182 100644 --- a/marketing/outreach-september.md +++ b/marketing/outreach-september.md @@ -321,7 +321,7 @@ genutzt wird. Mehr Nutzer heißt mehr Einnahmen, nie mehr Verlust. |---|---|---| | Deine Kosten (eigene Rechnung ~2,5 ct, mit Puffer für fremde Sprachen) | — | ~5 ct | | Privatleute (Webseite) | 2,99 € für 5 · 6,99 € für 15 | 47–60 ct | -| **Test** für eine Beratungsstelle, 3 Monate | bis 100 Briefe gratis | kostet dich max. ~5 € | +| **Test** für eine Beratungsstelle, 1 Monat (verlängerbar) + Auswertungsgespräch | bis 100 Briefe gratis | kostet dich max. ~5 € | | **Kleines Paket** | 100 Briefe · 20 € | 20 ct | | **Großes Paket** | 500 Briefe · 75 € | 15 ct | | **Untergrenze beim Verhandeln** | — | 10 ct | diff --git a/marketing/praesentation-mbe/handzettel.html b/marketing/praesentation-mbe/handzettel.html new file mode 100644 index 0000000..b032064 --- /dev/null +++ b/marketing/praesentation-mbe/handzettel.html @@ -0,0 +1,202 @@ + + + + + +BehördenKlar für Beratungsstellen + + + + +
+ +
+ 📬 BehördenKlar by Webklar + Az: KLAR-BERATUNG/2026 · Anlage: 1 Testzugang +
+ +

Für Beratungsstellen · Migrationsberatung · Soziale Beratung

+

Ihre Ratsuchenden verstehen den Brief, bevor sie zu Ihnen kommen.

+

+ BehördenKlar erklärt schwierige Post in einfacher Sprache, auf Wunsch in 27 Sprachen: + von Ausländerbehörde, Jobcenter, Finanzamt, Krankenkasse, Vermieter oder Inkasso. + Ein Foto genügt. Ihre Beratungszeit geht in die Lösung, nicht ins Vorlesen. +

+ +
+
1 Brief mit dem Handy fotografieren, im Browser, ohne App und ohne Konto.
+
2 Nach etwa einer Minute: Was will das Amt, was ist zu tun, bis wann?
+
3 Frist in den Kalender, Spickzettel fürs Telefonat, mit den wichtigen Fragen zu Ihnen.
+
+ +

Was BehördenKlar kann

+
+
🌐
+

27 Sprachen, Fachbegriffe bleiben deutsch

+

Arabisch, Farsi, Paschtu, Kurdisch, Tigrinya, Türkisch, Ukrainisch u. v. m. Das deutsche Wort bleibt stehen, damit man es im Brief wiederfindet.

+
+
🚦
+

Frist erkannt, Dringlichkeit sichtbar

+

Ampel: Rot bei 7 Tagen oder weniger. Mit konkreter To-do-Liste: welche Unterlagen, wohin, bis wann.

+
+
📅
+

Frist und Termin in den Handy-Kalender

+

Ein Tipp genügt, das Handy erinnert 3 Tage und 1 Tag vorher. Keine Frist geht zwischen zwei Beratungsterminen unter.

+
+
📞
+

Anruf-Hilfe fürs Amt

+

Telefonnummer und Aktenzeichen aus dem Brief, dazu Sätze zum Sagen: auf Deutsch, darunter die Bedeutung in der eigenen Sprache.

+
+
💻
+

Beratung am PC, Foto mit dem Handy

+

QR-Code am Bildschirm scannen, Brief fotografieren: Sie lesen die Erklärung auf Deutsch, Ihr Gegenüber gleichzeitig in seiner Sprache.

+
+
📱
+

Ergebnis zum Mitnehmen

+

Per QR-Code wandert die Erklärung vom Beratungs-PC aufs Handy der Ratsuchenden, mit Kalender und Anruf-Hilfe.

+
+
🔎
+

Erfindet nichts

+

Steht keine Telefonnummer oder kein Datum im Brief, sagt BehördenKlar das, statt zu raten.

+
+
⚖️
+

Ergänzung, kein Ersatz

+

Jede Erklärung verweist bei wichtigen Entscheidungen ausdrücklich auf eine Beratungsstelle.

+
+
+ +
+
+
+ Datenschutz, ehrlich erklärt +
    +
  • Kein Konto, keine Anmeldung, keine Installation nötig.
    • +
  • Briefe werden bei uns nicht dauerhaft gespeichert.
    • +
  • Übergabe zwischen PC und Handy Ende-zu-Ende verschlüsselt: Der Schlüssel steckt nur im QR-Code, unser Server sieht nichts.
    • +
  • Keine Werbung, kein Verkauf von Daten.
    • +
  • Die Erklärung erstellt der KI-Dienst Anthropic (USA). Er löscht Anfragen nach spätestens 30 Tagen und nutzt sie nicht zum Training. Das sagen wir offen, auch auf der Seite vor dem Hochladen.
    • +
+
+

+ „Ist das nicht einfach ChatGPT?“ Dort braucht man ein Konto und eine gut + formulierte Frage, und danach ist der Brief vergessen. Bei BehördenKlar macht man + ein Foto. Frist, Termin und Telefonnummer werden zu Kalender-Eintrag und + Anruf-Hilfe, und deutsche Fachbegriffe bleiben erkennbar. +

+

+ Und nach dem Test? Ihre Einrichtung bekommt ein festes Briefkontingent zu + einem Preis für Beratungsstellen. Die Ratsuchenden zahlen weiterhin nichts. Ohne + Abo-Falle: Nach vier Wochen schauen wir gemeinsam, was es gebracht hat. +

+
+ +
+

Ihr Testzugang

+

1 Monat · bis 100 Briefe
kostenlos

+

Ratsuchende zahlen nichts. Kein Vertrag, endet von selbst, verlängerbar.

+
+

Code für Ihre Ratsuchenden:

+

+ +
+
+ +
+
+ Justin Klein · Webklar GbR · Am Schwimmbad 10, 67722 Winnweiler
+ Tel. 0170 4969375 · justin@webklar.com · behoerdenklar.de +
+ Aus dem Donnersbergkreis +
+
+ + + + diff --git a/marketing/praesentation-mbe/handzettel.pdf b/marketing/praesentation-mbe/handzettel.pdf new file mode 100644 index 0000000..cde33bb Binary files /dev/null and b/marketing/praesentation-mbe/handzettel.pdf differ diff --git a/marketing/praesentation-mbe/handzettel.png b/marketing/praesentation-mbe/handzettel.png new file mode 100644 index 0000000..41cb94f Binary files /dev/null and b/marketing/praesentation-mbe/handzettel.png differ diff --git a/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.html b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.html new file mode 100644 index 0000000..430e898 --- /dev/null +++ b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.html @@ -0,0 +1,141 @@ + + + + + +Musterbrief Ausländerbehörde + + + +
+ + + + +
+
+ +
Kreisverwaltung MusterhausenFachbereich 32 – Ausländerbehörde
+
+
Musterplatz 1
67999 Musterhausen
+
+ +
Kreisverwaltung Musterhausen · Musterplatz 1 · 67999 Musterhausen
+ +
+ Herrn
+ Ahmad Beispiel
+ Lindenweg 5
+ 67999 Musterhausen +
+ + + + + + + + +
Aktenzeichen32.1-AE-2026-04711
Auskunft erteiltFrau Muster
Zimmer2.14
Telefon069 90009-314
E-Mailabh@musterhausen.example
Datum20.10.2026
+ +
+

Ihr Antrag auf Verlängerung der Aufenthaltserlaubnis vom 01.10.2026
+ hier: Aufforderung zur Vorlage fehlender Unterlagen gemäß § 82 Abs. 1 AufenthG
+ und Einladung zur persönlichen Vorsprache

+ +

Sehr geehrter Herr Beispiel,

+ +

in Ihrer o. g. aufenthaltsrechtlichen Angelegenheit nehmen wir Bezug auf Ihren Antrag auf + Verlängerung der Aufenthaltserlaubnis. Ihr derzeitiger Aufenthaltstitel ist bis zum + 15.11.2026 befristet. Zur abschließenden Prüfung der Erteilungsvoraussetzungen gemäß + §§ 5, 8 AufenthG sind die nachfolgend aufgeführten Unterlagen bislang nicht bzw. nicht + vollständig vorgelegt worden:

+ +
    +
  1. gültiger Nationalpass im Original bzw. Nachweise über Ihre Bemühungen zur Passbeschaffung,
    2. +
  2. aktuelle Meldebescheinigung (nicht älter als drei Monate),
    3. +
  3. Nachweise über die Sicherung des Lebensunterhalts (Arbeitsvertrag sowie Lohn- und + Gehaltsabrechnungen der letzten drei Monate bzw. aktueller Bewilligungsbescheid des Jobcenters),
    4. +
  4. Nachweis über einen ausreichenden Krankenversicherungsschutz,
    5. +
  5. ein aktuelles biometrisches Lichtbild.
    6. +
+ +

Gemäß § 82 Abs. 1 AufenthG obliegt es Ihnen, die für Ihr Anliegen erforderlichen Nachweise + unverzüglich beizubringen. Wir fordern Sie daher auf, die vorgenannten Unterlagen + bis spätestens 12.11.2026 bei der Ausländerbehörde einzureichen.

+ +

Zur Aufnahme Ihrer biometrischen Merkmale (Fingerabdrücke, Unterschrift) werden Sie + gebeten, am Donnerstag, den 05.11.2026, um 10:30 Uhr in Zimmer 2.14 + persönlich vorzusprechen. Bitte bringen Sie dieses Schreiben sowie Ihren derzeitigen + Aufenthaltstitel mit. Sollten Sie den Termin nicht wahrnehmen können, ist dieser rechtzeitig + vorher telefonisch abzusagen.

+ +

Werden die angeforderten Unterlagen nicht fristgerecht vorgelegt, kann über Ihren Antrag + nach Aktenlage entschieden werden. Dies kann zur Ablehnung des Antrags führen.

+ +

Hinweis: Da Sie den Antrag vor Ablauf Ihres Aufenthaltstitels gestellt haben, gilt dieser + gemäß § 81 Abs. 4 AufenthG bis zur Entscheidung der Ausländerbehörde als fortbestehend + (Fiktionswirkung). Eine entsprechende Fiktionsbescheinigung wird Ihnen bei Ihrer Vorsprache + ausgehändigt.

+ +

Sprechzeiten: Mo, Di und Do 08:00–12:00 Uhr, Do zusätzlich 14:00–17:30 Uhr. + Vorsprachen nur nach vorheriger Terminvereinbarung.

+ +

Mit freundlichen Grüßen
Im Auftrag

+
Muster
+

Muster

+
+ +
+
Kreisverwaltung Musterhausen
Musterplatz 1 · 67999 Musterhausen
+
Telefon 069 90009-0
www.musterhausen.example
+
Bankverbindung: Sparkasse Musterhausen
IBAN DE00 0000 0000 0000 0000 00
+
+
Beispielbrief für Vorführzwecke · Behörde, Person und alle Angaben sind frei erfunden
+
+ + diff --git a/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.pdf b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.pdf new file mode 100644 index 0000000..069587d Binary files /dev/null and b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.pdf differ diff --git a/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.png b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.png new file mode 100644 index 0000000..8990f54 Binary files /dev/null and b/marketing/praesentation-mbe/musterbrief-auslaenderbehoerde.png differ