Workers-Spec: Ergebnisse der Builder-Prüfung eingearbeitet, 4 offene Entscheidungen markiert

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 16:53:19 +00:00
1 parent 823f64961b
commit 6fdeb10523
@@ -110,14 +110,16 @@ Es gibt zwei Eingänge, die in denselben Gesprächs- und Abschlussweg münden.
   Das Ergebnis ist eine Punktzahl mit Begründung. **[Claude]**
 3. **Erstantwort.** Clara schreibt eine kurze, persönliche Antwort mit dem Angebot einer Gratis-Vorschau, mit KI-Hinweis und den Pflichtangaben. **[Kenso: Gratis-Vorschau anbieten]**
   - Darf ein Bot auf der Plattform nicht senden, landet die Antwort im **Freigabe-Pult**. Dort klickt ein Mensch auf „Kopieren & Anfrage öffnen“ und sendet sie selbst. **[Kenso]**
-   - Hat der Anfragende selbst eine E-Mail-Adresse genannt und um Angebote gebeten, geht die Antwort automatisch per Mail raus. **[Claude]**
+   - Hat der Anfragende selbst eine E-Mail-Adresse genannt und um Angebote gebeten, geht die Antwort automatisch per Mail raus. Gesendet wird über Max (die einzige Rolle, die Mails verschickt) von der eigenen Absender-Domain. Bis diese Domain eingerichtet ist, landen auch solche Antworten im Freigabe-Pult. **[Claude]**
 4. **Gespräch** (Abschnitt 4.3).

 ### 4.2 Eingang „Ohne Website“: Betriebe, die nie gefragt haben

 1. **Finden.** Pro Branche ein Raum mit einem Scout, siehe Abschnitt 5. Ein Suchlauf liefert **10 Kandidaten**. **[Kenso]**
+   - Pro Nacht gibt es standardmäßig einen Lauf mit 10 Kandidaten. Die Branchen-Räume kommen reihum dran, und Otto wählt Raum und Region nach dem Suchprotokoll. Mehr Läufe pro Nacht lassen sich in den Einstellungen freischalten. **[Claude: passt zu 3 Mails am Tag und hält die Suchkosten klein]**
   - Gesucht wird über erlaubte Quellen: Suchmaschinen, Google Places API, OpenStreetMap und das Impressum auf der eigenen Website des Betriebs.
-   - Die Mail-Adresse kommt nur aus dem Impressum oder einer anderen öffentlich genannten geschäftlichen Adresse. Adressen werden nie nach Muster geraten. **[Claude]**
+   - Die Mail-Adresse kommt nur aus dem Impressum oder von der Kontaktseite der eigenen Website des Betriebs. Adressen werden nie nach Muster geraten, und Facebook-Seiten werden nicht ausgelesen. **[Claude]**
+   - **Eine veröffentlichte Mail-Adresse ist Pflicht für einen Mail-Platz.** Ohne sie kommt der Betrieb mit dem Grund „keine veröffentlichte Mail“ in die Bot-Lead-Liste. Folge davon: Betriebe ganz ohne Website haben fast nie eine Mail-Adresse und werden deshalb meist nur gelistet. In der Praxis schreibt die Etage vor allem Betriebe mit stark veralteter Website an. **[Claude, ergibt sich aus „nur E-Mail“ und „nur veröffentlichte Adressen“]**
 2. **Bewerten.** Bea vergibt Punkte für:
   - fehlende oder veraltete Website
   - gute Bewertungen
@@ -130,9 +132,9 @@ Es gibt zwei Eingänge, die in denselben Gesprächs- und Abschlussweg münden.
   - Weil es höchstens 3 Mails am Tag gibt, gelten die Top 3 über alle Branchen-Räume einer Nacht zusammen, nicht pro Raum. **[Claude: so passen „10 → Top 3“ und „max. 3 Mails“ zusammen]**
   - Alle übrigen Kandidaten kommen mit Telefonnummer und dem Grund, warum sie nicht genommen wurden, in die **Bot-Lead-Liste**. Diese Betriebe bekommen keine Website und keinen Anruf. **[Kenso]**
 4. **Erstmail.** Max schreibt die Mail: kurz, persönlich, mit dem Angebot einer Gratis-Vorschau und allen Schutzmaßnahmen aus Abschnitt 8.
-   - Pro Tag gehen höchstens 3 Mails raus. **[Kenso]**
-   - Höchstens eine Nachfass-Mail. **[Claude]**
+   - Pro Tag gehen höchstens 3 unverlangte Mails raus. **[Kenso]** Dazu zählen die Erstmails und die eine Nachfass-Mail, die nach 7 Tagen kommt. **[Claude]**
   - Die Mails gehen vollautomatisch raus, ohne Freigabe. **[Kenso: vollautomatisch, wo erlaubt]**
+   - Versendet wird nur werktags zwischen 9 und 16 Uhr. **[Claude]**
 5. **Gespräch** (Abschnitt 4.3).

 ### 4.3 Gespräch, Bau und Abschluss (für beide Eingänge gleich)
@@ -152,7 +154,10 @@ Es gibt zwei Eingänge, die in denselben Gesprächs- und Abschlussweg münden.
   - Paul prüft Desktop- und Handy-Ansicht, Texte und die Rechtsregeln für Vorschauen. Bei Mängeln geht die Seite zurück, bis sie passt. **[Kenso: Schleife]**
   - Nach 3 Runden ohne Erfolg geht der Auftrag an einen Menschen. Das verhindert eine endlose Kostenschleife. **[Claude]**
 3. **Link schicken.** Die geprüfte Vorschau geht über denselben Weg raus wie das Gespräch: per Mail automatisch, auf Plattformen mit Bot-Verbot über das Freigabe-Pult.
-4. **Weiterreden.** Clara (Plattform) und Max (Mail) beantworten Fragen im jeweiligen Faden. Theo übernimmt, sobald es ums Kaufen geht:
+   - Die ersten 10 Vorschau-Links gehen vor dem Versand über das Freigabe-Pult. Danach laufen sie automatisch. Ein Schalter regelt das: „erste N“, „immer“ oder „nie“. **[Claude: schützt vor einer schlechten Seite mit fremdem Firmennamen, solange das System neu ist]**
+   - Ein „Ja“, bei dem Nora unsicher ist, geht immer ins Pult, bevor die Werkstatt etwas baut.
+   - Bleibt der Interessent nach dem Link still, kommt nach 5 Tagen genau eine Erinnerung, danach ist Ruhe. **[Claude]**
+4. **Weiterreden.** Clara (Plattform) und Max (Mail) beantworten Fragen im jeweiligen Faden. Theo übernimmt, sobald es ums Kaufen geht. Seine Nachrichten sind Entwürfe: Per Mail verschickt sie Max, auf Plattformen landen sie im Pult.
   - Er erklärt das Angebot und schickt den Weg ins Portal.
   - Er nennt nur Preise und Angebote, die in den Workers-Einstellungen hinterlegt sind.
 5. **Abschluss.** Der Kunde bucht im Portal ein Abo. Erst jetzt wird er ein echter WOMS-Kunde. Die Kundenübernahme, der Portal-Zugang und das Freischalten der Vorschau laufen dabei automatisch. **[Claude, abgeleitet aus „Bot-Leads nicht zu unseren Leads“]**
@@ -188,17 +193,23 @@ Die Besetzung zum Start **[Claude, Namen und Zuschnitt änderbar]**:
 | | Selbstständige | Sven | Haiku | Branchen-Scout |
 | | Läden & Gastro | Lea | Haiku | Branchen-Scout |
 | Bewertung | Waage | Bea | Sonnet | bewertet Anfragen und Kandidaten, verteilt Top 3 und Rest |
-| **Gespräche** (groß) | Mail-Stube | Max | Sonnet | schreibt nur Mails (Erstmail, ein Nachfassen, Antworten im Mail-Faden) |
-| | Forum-Stube | Clara | Sonnet | schreibt nur Plattform-Antworten (für das Freigabe-Pult oder per Mail an Anfragende) |
+| **Gespräche** (groß) | Mail-Stube | Max | Sonnet | schreibt Mails und ist **der einzige Absender**: Erstmail, Nachfassen, Antworten im Mail-Faden und das Versenden der Entwürfe von Clara und Theo |
+| | Forum-Stube | Clara | Sonnet | schreibt nur Antworten auf Anfragen (Plattform → Pult, Mail → an Max) |
 | | Posteingang | Nora | Haiku | liest und sortiert alle eingehenden Antworten |
-| | Abschluss | Theo | Sonnet | führt Interessierte zum Kauf im Portal |
+| | Abschluss | Theo | Sonnet | schreibt die Nachrichten rund um den Kauf (als Entwurf, versendet über Max oder das Pult) |
 | Werkstatt | 3 Tische | Bob, Bianca, Ben | Opus | bauen Vorschauen, nur nach einem Ja |
 | Prüfung | Prüftisch | Paul | Sonnet | prüft jede Vorschau, schickt sie zurück oder gibt sie frei |
 | Freigabe | Dein Pult | (Mensch) | – | alles, was auf einen Menschen wartet |
 | Tresor | Tresor | – | – | Deals, Pokale, Geld |
 | Keller | Archiv & Register | Arne | Haiku | führt das Nie-doppelt-Register und die Bot-Lead-Liste |

-Weitere Branchen und Quellen kommen als **neue Räume** dazu, zum Beispiel Beauty & Friseure, Vereine oder später Ausschreibungen. Die Etage wird dann breiter oder bekommt einen zweiten Stock. Welche Räume aktiv sind, steht in den Einstellungen. **[Claude]**
+Weitere Branchen und Quellen kommen als **neue Räume** dazu, zum Beispiel Beauty & Friseure, Vereine oder später Ausschreibungen. Die Etage wird dann breiter oder bekommt einen zweiten Stock. Welche Räume aktiv sind, steht in den Einstellungen. Ein Raum ohne echte Quelle bleibt grau mit dem Schild „noch nicht angeschlossen“. Er zeigt keine vorgespielte Arbeit, zum Beispiel solange für Kleinanzeigen noch kein Suchauftrag eingerichtet ist. **[Claude]**
+
+**Rollen werden technisch getrennt, nicht nur gezeichnet** **[Claude]**:
+- Jede Rolle hat einen eigenen Prompt und eine eigene Liste erlaubter Werkzeuge.
+- Nur Max' Weg erreicht den Mail-Versand. Nur Clara und Theo erzeugen Pult-Einträge für Plattformen. Die Such-Worker lesen nur.
+- Vor jedem Versand prüft der Dienst Rolle, Kanal, Sperrliste und Tageszähler an einer einzigen Stelle.
+- Jede Aktion landet mit Rollen-Id, Auftrag, Kosten und Link im Ereignisstrom. Daraus werden der Raum und die Spur gezeichnet.

 **Was man sieht und anklicken kann** (Grundlage ist Entwurf C):
 - **Echte Ereignisse statt Fantasie:** Jede Bewegung gehört zu einem echten Auftrag. Gibt es nichts zu tun, sitzen die Workers, trinken Kaffee oder schlafen. **[Claude]**
@@ -210,7 +221,12 @@ Weitere Branchen und Quellen kommen als **neue Räume** dazu, zum Beispiel Beaut
  - wartet auf dich
  - Bot-Leads gesamt
  - API-Kosten heute im Vergleich zur Tagesgrenze
- **Freigabe-Pult:** eine Liste mit allem, was wartet, jeweils mit Originalanfrage, Entwurf und den Knöpfen „Kopieren & öffnen“, „Als gesendet markieren“ und „Verwerfen“.
+- **Freigabe-Pult:** eine Liste mit allem, was wartet, jeweils mit Originalanfrage, Entwurf und den Knöpfen „Kopieren & öffnen“, „Als gesendet markieren“, „Verwerfen“ und (bei Mail-Fäden) „Als Mensch antworten“.
+  - Alle WOMS-Mitarbeiter sehen das Pult. Mit „Ich kümmere mich“ übernimmt jemand einen Eintrag. **[Kenso: „ich gucke es mir an und drück auf Senden“; dass alle es sehen, ist mein Vorschlag]**
+  - Kenso bekommt jeden Morgen eine kurze Mail mit dem Nachtbericht. Bei einer Beschwerde oder rechtlichen Drohung kommt sofort eine Mail.
+  - Einträge zu Plattform-Gesuchen gelten nach 3 Tagen als „veraltet“, weil Gesuche schnell vergeben sind. **[Claude]**
+  - Folge-Antworten von Plattformen kommen über die Benachrichtigungs-Mails der Plattform ins Postfach oder werden von Hand ins Pult eingefügt. Clara schreibt dann den nächsten Entwurf.
+  - Den Pausenschalter dürfen alle bedienen. Einstellungen wie Limits, Preise und Räume ändern nur Admins.
 - **Bot-Lead-Liste:** eine eigene Ansicht (Liste, Filter, Grund, Telefonnummer, Quelle), klar getrennt von Kunden und Leads.
 - **Spielgefühl** **[Claude]**:
  - ein Pokal im Tresor pro echtem Deal
@@ -228,6 +244,12 @@ Weitere Branchen und Quellen kommen als **neue Räume** dazu, zum Beispiel Beaut
  - Auch abgelehnte Kandidaten werden eingetragen.
  - Startbestand: die 95 alten Leads (Backup `/root/reports/leads-auf-eis-2026-09-30/` und `/opt/webklar-automation/master.json`) plus **alle echten WOMS-Kunden**.
  - Name plus Postleitzahl zählt nur als Hinweis, nicht als harter Treffer. Das verhindert falsche Treffer bei Kettenbetrieben.
+  - Import der alten Leads: Sie kommen mit dem Status „bekannt, nie automatisch angeschrieben“ ins Register. Nach einer erneuten Prüfung (Impressum-Mail gilt noch, Website ist immer noch alt) darf Bea sie bewerten. Die 2 mit dem Status „kontaktiert“ und alle echten Kunden werden gesperrt.
+- **Herkunft der Daten** **[Claude, wegen der Google-Nutzungsbedingungen]**: Aus der Google Places API wird dauerhaft nur die `place_id` gespeichert, dazu abgeleitete Merkmale wie „hat keine Website“. Name, Adresse und Telefonnummer kommen von der eigenen Website des Betriebs, aus dem Impressum oder aus OpenStreetMap. Fehlt so eine Quelle, zeigt die Bot-Lead-Liste „nicht verfügbar“.
+- **Aufbewahrung** **[Claude]**:
+  - Bei Betrieben, die nie angeschrieben wurden oder nie geantwortet haben, werden die vollen Daten nach 90 Tagen auf gehashte Schlüssel im Nie-doppelt-Register gekürzt.
+  - Die Sperrliste bleibt für immer.
+  - Bei Heilberufen (Ärzte, Praxen) werden keine Telefonnummern gespeichert (BVerwG 6 C 3.23).
 - **Suchprotokoll**: Quelle oder Branche, Region, Suchanfrage und Datum, damit Gebiete nicht doppelt durchsucht werden.
 - **Gesprächsfäden und Nachrichten**: Kanal, Plattform-Link, Message-ID, In-Reply-To und References. Dazu der genaue Text jeder ausgehenden Nachricht mit Zeitpunkt und der Quelle der Kontaktdaten (als Nachweis).
 - **Freigabe-Einträge**: was auf einen Menschen wartet und warum.
@@ -268,7 +290,8 @@ Die 14 echten Kunden mit `customerStatus = lead` und der Reiter „Leads“ auf

 **[Claude]**, abgeleitet aus Kensos Entscheidungen und der Rechtsrecherche:

-1. **Mail-Grenze:** höchstens 3 Erstmails pro Tag über alle Räume, höchstens eine Nachfass-Mail pro Betrieb, danach Ruhe. **[Kenso: max. 3 am Tag]**
+1. **Mail-Grenze:** höchstens 3 unverlangte Mails pro Tag über alle Räume, Erstmails und Nachfass-Mails zusammengezählt. Pro Betrieb gibt es höchstens eine Nachfass-Mail, danach Ruhe. **[Kenso: max. 3 am Tag]**
+   - Nicht mitgezählt werden Antworten an Leute, die selbst geschrieben haben, und der Vorschau-Link nach einem Ja. Dafür gilt eine eigene Sicherheitsgrenze von 15 Mails am Tag. **[Claude]**
 2. **Sperrliste:** wird vor jeder ausgehenden Nachricht geprüft, egal über welchen Kanal und von welchem Worker. Ein Widerspruch wirkt sofort und für immer.
 3. **Mails von der eigenen Domain beim eigenen Anbieter:**
   - Eigene Absenderdomain und eigener Mail-Anbieter, nie webklar.com.
@@ -280,6 +303,7 @@ Die 14 echten Kunden mit `customerStatus = lead` und der Reiter „Leads“ auf
   - Quelle der Kontaktdaten, zum Beispiel „Ihr Impressum“.
   - Kurzer Datenschutzhinweis mit Link.
   - Widerspruchshinweis.
+   - Vorher nötig: Claude entwirft einen eigenen Abschnitt „Interessenten“ für die Datenschutzerklärung (Art. 14 und 21). Nach Kensos Freigabe wird er als neue Fassung in WOMS „Rechtliches“ hochgeladen und auf webklar.com veröffentlicht. Ohne diesen Abschnitt geht keine Erstnachricht raus.
 5. **Nur veröffentlichte Adressen:** Kontakt nur über Adressen, die der Betrieb selbst veröffentlicht hat. Quelle und Zeitpunkt werden gespeichert.
 6. **Plattformen mit Bot-Verbot:** Dort sendet immer ein Mensch. Der Bot bereitet nur vor.
 7. **Keine Umgehung:** kein Captcha- oder Cloudflare-Umgehen, kein Login-Scraping. `robots.txt` und Ratenlimits werden eingehalten. Gesperrte Quellen werden ausgelassen. **[Kenso]**
@@ -312,7 +336,24 @@ Der Probe-Scout hat bundesweit nur eine Handvoll echter Anfragen pro Woche gefun
  - keine Nachricht an einen gesperrten Kontakt
  - kein Bot-Lead in der echten Kundenliste

-## 11. Dem Builder überlassen
+## 11. Offen – entscheidet Kenso
+
+Diese Punkte ändern, was gebaut wird. Bis zur Antwort gilt jeweils der Vorschlag in Klammern.
+
+1. **Wie kommt ein Interessent zum Kauf?** Heute geht der Abo-Checkout im Portal nur mit Login. Dafür braucht es einen Kundeneintrag mit Portal-Zugang, und eine Einladungs-Mail gibt es nicht. *(Vorschlag: ein „Website übernehmen“-Link ohne Login, mit geheimem Token pro Interessent und denselben Zustimmungen wie im normalen Abo-Checkout, also Abo-Bedingungen, Widerruf und Kundenart. Kunde, Portal-Zugang und Status `customer` entstehen erst im Stripe-Webhook nach der Zahlung. So taucht vorher niemand in den Kundenlisten auf.)*
+2. **Was genau wird angeboten?** *(Vorschlag: „Gratis-Vorschau, unverbindlich. Wenn sie gefällt, ist die Website im Hosting-Abo enthalten: 20 € im Monat, 12 Monate Mindestlaufzeit, ohne MwSt. nach § 19 UStG.“ Diesen Satz enthält schon die Erstnachricht, damit „gratis“ nichts verschleiert. Wartung für 50 € nur auf Nachfrage. Keine Rabatte, solange nichts in den Einstellungen steht.)*
+3. **Budget.** *(Vorschlag: 10 $ pro Tag und 250 $ pro Monat für die ersten 4 Wochen. Das gilt im Code und als Ausgabenlimit in einem eigenen Anthropic-Console-Workspace. Bei 80 % kommt eine Warnung, danach wird nach echten Zahlen neu eingestellt.)*
+4. **Absender-Domain und Mail-Anbieter.** *(Vorschlag: sofort eine neutrale zweite Domain und ein Postfach-Anbieter mit IMAP und SMTP, damit die Aufwärmphase parallel zum Bau läuft. Vor dem Kauf werden die Nutzungsbedingungen des Anbieters geprüft.)*
+
+## 12. Was vorbereitet werden muss (kann kein Bot)
+
+- Anthropic Console: Workspace „Workers“ anlegen, API-Schlüssel erzeugen, Ausgabenlimit setzen. Den Schlüssel bekommt nur der Dienst.
+- Absender-Domain und Postfächer: eins zum Senden, eins als Eingang für Plattform-Benachrichtigungen.
+- Kostenlose Konten auf Kleinanzeigen, freelancermap und freelance.de unter WEBklar. Dort Suchaufträge anlegen, die an das Eingangs-Postfach gehen.
+- Den neuen Datenschutz-Abschnitt „Interessenten“ freigeben.
+- Melden, falls einer der 95 alten Autolackierer schon einmal geantwortet oder widersprochen hat. Er kommt dann auf die Sperrliste.
+
+## 13. Dem Builder überlassen

 - Technische Architektur des Dienstes, Sprache, Container-Zuschnitt, Warteschlangen.
 - Genaue Prompts, Punkteformel und Schwellenwerte für die Bewertung, solange die Kriterien aus Abschnitt 4 gelten.