Hustler: Name in der Oberfläche, Budget höchstens 150 $/Monat (6 $/Tag) mit hartem Deckel
Kenso, 17.10.: "150 € im Monat max", "nenne es Hustler". Technische Namen (workers*) bleiben. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
740089c997
commit
11e4280a92
8 files changed
+184
-156
No files matched your search
@@ -1,6 +1,8 @@
|
||||
# Workers – Plan-Übersicht und gemeinsame Schnittstellen
|
||||
# Hustler – Plan-Übersicht und gemeinsame Schnittstellen
|
||||
|
||||
> Dieses Dokument ist die **verbindliche Quelle** für alle Workers-Teilpläne P1–P6. Jeder Teilplan verweist hierauf und darf die hier festgelegten Namen, Felder, Pfade und Signaturen nicht abweichend verwenden. Wer etwas ändern muss, ändert es **hier** und in allen betroffenen Plänen.
|
||||
> Name in der Oberfläche: **Hustler** [Kenso, 17.10.]; technische Namen bleiben workers* (Namensregel in §7).
|
||||
|
||||
> Dieses Dokument ist die **verbindliche Quelle** für alle Hustler-Teilpläne P1–P6 (Dateien `…-workers-pN-…`). Jeder Teilplan verweist hierauf und darf die hier festgelegten Namen, Felder, Pfade und Signaturen nicht abweichend verwenden. Wer etwas ändern muss, ändert es **hier** und in allen betroffenen Plänen.
|
||||
|
||||
**Spec:** `docs/superpowers/specs/2026-10-17-workers-design.md` (freigegeben 17.10.2026)
|
||||
**Code-Landkarten (Fakten zum Bestand):** `/root/reports/workers-2026-10-16/codekarten/{woms,portal,infra,mail-claude,daten-spiel}.md`
|
||||
@@ -13,10 +15,10 @@
|
||||
| Plan | Datei | Inhalt | Repo / Arbeitsort | Hängt ab von |
|
||||
|---|---|---|---|---|
|
||||
| **P1** Dienst-Fundament | `2026-10-17-workers-p1-dienst-fundament.md` | Dienst-Gerüst, Appwrite-Sammlungen + Setup-Skript, Normalisierung + Nie-doppelt-Register + Startbestand, Ereignisstrom, Budget-Wächter + Claude-Hülle, Rollen-Register mit Werkzeug-/Kanal-Sperre, Zeitplan-Tick, Otto (Nachtplan + Morgenbericht), HTTP-API, Container + Betrieb | neues Repo `knso/workers-dienst` | – |
|
||||
| **P2** Hochhaus in WOMS | `2026-10-17-workers-p2-hochhaus-woms.md` | Menüpunkt + Route `/workers`, WorkersPage, Pixel-Engine (Port aus der Vorlage, Etagen/Räume als Daten, Lift, Ereignis-Regie, Leerlauf-/Grau-Zustände), Polling-Feed, Worker-Karte mit Spur, Kennzahlen, Pausenschalter, Einstellungen (Admin) | WOMS `JUSN/tickte-system`, Worktree `dev-workers`, Branch `feature/workers` | P1 (API) |
|
||||
| **P2** Hochhaus in WOMS | `2026-10-17-workers-p2-hochhaus-woms.md` | Menüpunkt „Hustler“ + Route `/hustler` (`/leads` und `/workers` leiten um), Seite `WorkersPage` (Dateiname bleibt), Pixel-Engine (Port aus der Vorlage, Etagen/Räume als Daten, Lift, Ereignis-Regie, Leerlauf-/Grau-Zustände), Polling-Feed, Worker-Karte mit Spur, Kennzahlen, Pausenschalter, Einstellungen (Admin) | WOMS `JUSN/tickte-system`, Worktree `dev-workers`, Branch `feature/workers` | P1 (API) |
|
||||
| **P3** Etage „Anfragen“ + Freigabe-Pult | `2026-10-17-workers-p3-anfragen-pult.md` | Rita/Kim/Pia/Finn, Alarm-Postfach lesen, Bea-Bewertung für Anfragen, Clara-Erstantwort, Pult im Dienst + Pult-UI in WOMS | Dienst + WOMS | P1, P2 |
|
||||
| **P4** Gespräche, Werkstatt, Prüfung | `2026-10-17-workers-p4-gespraeche-werkstatt.md` | Max als einziger Absender (SMTP-Tor), Nora-Posteingang (IMAP + Einordnung), Fäden, Theo, Bob/Bianca/Ben-Bau, Paul-Prüfung mit Screenshots, Vorschau-Server `entwurf.project.webklar.com`, Vorschau-Freigabe, Erinnerungen, Plattform-Folge-Antworten (Einfügen im Pult, Clara schreibt den nächsten Entwurf, A20) | Dienst (+ WOMS-Pult-Erweiterung) | P1–P3 |
|
||||
| **P5** Kaufweg im Portal | `2026-10-17-workers-p5-portal-kaufweg.md` | „Website übernehmen“-Seite + Routen ohne Login, Stripe-Checkout ohne Kunde, Webhook-Zweig legt Kunde an, Nachweis, K44-Mail, Vorschau → Kundenprojekt, Status zurück an Workers | Portal `knso/Webklar-Kundenbereich`, Worktree `dev-workers-kauf`, Branch `feature/workers-kaufweg` | P1, P4 (Angebots-Doc) |
|
||||
| **P5** Kaufweg im Portal | `2026-10-17-workers-p5-portal-kaufweg.md` | „Website übernehmen“-Seite + Routen ohne Login, Stripe-Checkout ohne Kunde, Webhook-Zweig legt Kunde an, Nachweis, K44-Mail, Vorschau → Kundenprojekt, Status zurück an den Workers-Dienst | Portal `knso/Webklar-Kundenbereich`, Worktree `dev-workers-kauf`, Branch `feature/workers-kaufweg` | P1, P4 (Angebots-Doc) |
|
||||
| **P6** Etage „Ohne Website“ + Kaltmail | `2026-10-17-workers-p6-ohne-website.md` | Ali/Hanna/Sven/Lea (Places/OSM/Impressum), Top-3 über alle Räume, Bot-Lead-Liste (Dienst + WOMS-Ansicht), Max-Kaltmail mit allen Pflichtangaben, Nachfassen, Aufbewahrung/Kürzung, Datenschutz-Abschnitt „Interessenten“ | Dienst + WOMS + webklar.com-Rechtstext | P1–P4 |
|
||||
|
||||
**Reihenfolge der Umsetzung:** P1 → P2 → P3 → P4 → P5 → P6. P5 kann nach P1 parallel zu P3/P4 laufen (eigene Dateien im Portal), solange das Angebots-Dokument aus §4.12 feststeht.
|
||||
@@ -41,11 +43,11 @@
|
||||
6. **Dienst:** Node 22 (Container `node:22-alpine`), ESM, keine Semikolons, deutsche Kommentare, Tests `timeout 300 node --max-old-space-size=1024 --test test/*.test.js`. Jede äußere Abhängigkeit (Appwrite, Anthropic, SMTP, IMAP, Uhr) wird per Parameter injiziert, damit Tests ohne Netz laufen. **In Tests nie echte Anthropic-, SMTP- oder Appwrite-Aufrufe.**
|
||||
7. **Abhängigkeiten des Dienstes (exakt):** `@anthropic-ai/sdk@0.135.0`, `node-appwrite@14.1.0` (wie Portal), `nodemailer@10.1.2`, `imapflow@2.5.2`, `mailparser@3.9.40`, `playwright-core@1.62.1` (passt zu Chromium im Image). Keine weiteren ohne Eintrag hier.
|
||||
8. **Modelle:** `claude-opus-5-5` (Otto, Bob, Bianca, Ben), `claude-sonnet-5-5` (Bea, Max, Clara, Theo, Paul), `claude-haiku-5-5` (Rita, Kim, Pia, Finn, Ali, Hanna, Sven, Lea, Nora, Arne). Kein `temperature`/`top_p`. Strukturierte Antworten über `output_config.format` (json_schema). Suche und Strukturierung in **zwei** Aufrufen (Suche mit Werkzeugen → freier Text; danach werkzeugloser Aufruf mit Schema), weil Such-Zitate und `output_config.format` kollidieren können.
|
||||
9. **Budget (Kenso):** 10 $/Tag, 250 $/Monat in den ersten 4 Wochen, Warnung bei 80 %. Workspace-Ausgabenlimit in der Console zusätzlich. Antwort „HTTP 400 … reached your specified … API usage limits“ oder 429 mit `enforced_spend_limit_reached` ⇒ sofort `budget_stopp`.
|
||||
9. **Budget (Kenso):** 6 $/Tag (Ausreißer-Wächter), 150 $/Monat in den ersten 4 Wochen, Warnung bei 80 %. **[Kenso, 17.10.: max. 150 € im Monat]** Anthropic rechnet in USD: 150 $ ≈ 130 €, also unter 150 €, solange 1 € mindestens 1 $ wert ist. Workspace-Ausgabenlimit in der Console zusätzlich: 150 $/Monat. Eine Grenze über 150 € im Monat braucht eine neue Entscheidung von Kenso. Antwort „HTTP 400 … reached your specified … API usage limits“ oder 429 mit `enforced_spend_limit_reached` ⇒ sofort `budget_stopp`.
|
||||
10. **Mail (Kenso + Spec §8):** Kaltmails **nie** über webklar.com/Hetzner. Höchstens 3 unverlangte Mails/Tag (Erst + Nachfass zusammen), Antworten an Schreibende + Vorschau-Links eigene Grenze 15/Tag, nur werktags 09:00–16:00 Europe/Berlin. Nur Max sendet. Sperrliste vor jedem Versand. Ein SMTP-Login-Fehler ⇒ Versand für den Tag aus (kein Wiederholen; Hetzner-IP-Sperre-Erfahrung gilt sinngemäß).
|
||||
11. **Keine Umgehung (Kenso):** kein Captcha/Cloudflare-Umgehen, kein Login-Scraping, `robots.txt` beachten (`url_not_allowed` = auslassen). Plattformen mit Bot-Verbot (Kleinanzeigen, Facebook, Upwork, MyHammer, freelancermap-Login-Bereich, freelance.de-Login-Bereich): **nie** direkt abrufen; Lesen nur über deren Alarm-Mails im Alarm-Postfach oder Suchmaschinen-Treffer; Senden nur durch Menschen über das Pult.
|
||||
12. **Texte nach außen:** Deutsch, „Sie“ in Kaltmails an Betriebe, „du“ nur, wenn der Anfragende duzt. Kein „Sehr geehrte Damen und Herren“, kein Ausrufezeichen im Betreff. Pflichtbausteine (KI-Hinweis, Quelle, Datenschutz-Link, Widerspruch, Abmelde-Link, Angebotssatz) werden **per Code** angehängt, nie dem Modell überlassen.
|
||||
13. **Keine Bot-Leads in WOMS-Kunden:** Vor einem bezahlten Deal schreibt kein Teil von Workers in `customers`, `workorders`, `websiteProjects`, `customerPortalAccess` oder legt Appwrite-Benutzer an.
|
||||
13. **Keine Bot-Leads in WOMS-Kunden:** Vor einem bezahlten Deal schreibt kein Teil von Hustler (Dienst, WOMS, Portal-Kaufweg) in `customers`, `workorders`, `websiteProjects`, `customerPortalAccess` oder legt Appwrite-Benutzer an.
|
||||
14. **Zeit:** Dienst läuft mit `TZ=Europe/Berlin`; gespeichert wird ISO-8601 UTC.
|
||||
|
||||
---
|
||||
@@ -93,7 +95,7 @@ Alle Workers-Sammlungen: Rechte `[]` (nur Server-Schlüssel), `documentSecurity=
|
||||
Typ-Kürzel: `s(n)` String max. n, `i` Integer, `f` Float, `b` Boolean, `dt` Datetime, `e[…]` Enum, `[]` Array. `*` = Pflicht.
|
||||
|
||||
### 4.1 `workersSettings` (genau ein Dokument, `$id = "main"`)
|
||||
`paused b*` · `dailyBudgetUsd f*` (10) · `monthlyBudgetUsd f*` (250) · `warnPct i*` (80) · `mailColdPerDay i*` (3) · `mailReplyCapPerDay i*` (15) · `sendWindowStart s(5)*` ("09:00") · `sendWindowEnd s(5)*` ("16:00") · `sendWeekdaysOnly b*` (true) · `runsPerNight i*` (1) · `candidatesPerRun i*` (10) · `activeRooms s(32)[]` (["netz","kleinanzeigen","portale","foren","aerzte","handwerk","selbst","laden"]) · `connectedRooms s(32)[]` (Such-Räume mit echter Quelle; leer bis eingerichtet; nur die Räume aus `SEARCH_ROOMS` können „nicht angeschlossen“ sein, alle anderen Räume gelten immer als angeschlossen, P1-E9) · `regions s(64)[]` (["Rheinland-Pfalz"]) · `previewGate e[erste_n,immer,nie]*` ("erste_n") · `previewGateN i*` (10) · `previewsSent i*` (0) · `offerText s(400)*` (Kensos Satz aus Spec §11.2; höchstens 400 Zeichen, damit eine Kaltmail unter 180 Wörter bleibt, H3) · `offerProductKey s(32)*` (nur "hosting", P5-E10) · `pultStaleDays i*` (3) · `retentionDays i*` (90; erlaubt 7–90, der Datenschutztext verspricht höchstens 90 Tage) · `followupDays i*` (7) · `previewReminderDays i*` (5) · `previewDeleteDays i*` (60) · `reportEmail s(256)*` (Kensos Adresse) · `privacyInteressentenLive b` (nicht Pflicht, Standard false; der **einzige** Datenschutz-Schalter, Gate für jede Erstnachricht; P3 legt an) · `sendingHalted b` (nicht Pflicht, Standard false; Bounce-Notbremse H4; P4 legt an) · `sendingHaltedReason s(300)` (nicht Pflicht, leer solange nicht gestoppt; P4) · `updatedAt dt` · `updatedBy s(64)`
|
||||
`paused b*` · `dailyBudgetUsd f*` (6; Ausreißer-Wächter) · `monthlyBudgetUsd f*` (150; max. 150 € im Monat, [Kenso, 17.10.: max. 150 € im Monat]) · `warnPct i*` (80) · `mailColdPerDay i*` (3) · `mailReplyCapPerDay i*` (15) · `sendWindowStart s(5)*` ("09:00") · `sendWindowEnd s(5)*` ("16:00") · `sendWeekdaysOnly b*` (true) · `runsPerNight i*` (1) · `candidatesPerRun i*` (10) · `activeRooms s(32)[]` (["netz","kleinanzeigen","portale","foren","aerzte","handwerk","selbst","laden"]) · `connectedRooms s(32)[]` (Such-Räume mit echter Quelle; leer bis eingerichtet; nur die Räume aus `SEARCH_ROOMS` können „nicht angeschlossen“ sein, alle anderen Räume gelten immer als angeschlossen, P1-E9) · `regions s(64)[]` (["Rheinland-Pfalz"]) · `previewGate e[erste_n,immer,nie]*` ("erste_n") · `previewGateN i*` (10) · `previewsSent i*` (0) · `offerText s(400)*` (Kensos Satz aus Spec §11.2; höchstens 400 Zeichen, damit eine Kaltmail unter 180 Wörter bleibt, H3) · `offerProductKey s(32)*` (nur "hosting", P5-E10) · `pultStaleDays i*` (3) · `retentionDays i*` (90; erlaubt 7–90, der Datenschutztext verspricht höchstens 90 Tage) · `followupDays i*` (7) · `previewReminderDays i*` (5) · `previewDeleteDays i*` (60) · `reportEmail s(256)*` (Kensos Adresse) · `privacyInteressentenLive b` (nicht Pflicht, Standard false; der **einzige** Datenschutz-Schalter, Gate für jede Erstnachricht; P3 legt an) · `sendingHalted b` (nicht Pflicht, Standard false; Bounce-Notbremse H4; P4 legt an) · `sendingHaltedReason s(300)` (nicht Pflicht, leer solange nicht gestoppt; P4) · `updatedAt dt` · `updatedBy s(64)`
|
||||
|
||||
Harte Grenzen im Code, auch bei von Hand geändertem Dokument: `mailColdPerDay` ≤ 3, `mailReplyCapPerDay` ≤ 15, `runsPerNight` ≤ 2. `sendingHalted` setzt der Dienst (`updatedBy = system`); aufheben (`false`, leert den Grund) kann nur ein Admin über `PUT /settings` im Einstellungs-Dialog.
|
||||
|
||||
@@ -201,7 +203,7 @@ Pfade relativ zum Dienst-Repo. Alle Funktionen `async`, sofern sie I/O machen. `
|
||||
| `src/claude.js` | `createClaude({apiKey, sdk, searchModel})` | → `{ ask(deps, opts), search(deps, opts), batch:{ create(deps, requests), retrieve(id), results(id) } }`. Immer `deps.claude.ask(deps, opts)`, nie `ask(opts)`. |
|
||||
| | `ask(deps, {workerId, model?, system, input, schema?, images?, maxTokens, effort?, reply?, stream?})` | prüft `checkBudget(…, {reply})`; ruft die Messages API (`stream:true` für den langen Opus-Bau, P4); bucht Kosten; → `{ data|text, usage, costUsd, model }`. Wirft `BudgetStop` (`.reason` ∈ tag, monat, pause, console) bei Budget-Antworten der API (§2.9), `ClaudeRefusal` bei Verweigerung. |
|
||||
| | `search(deps, {workerId, system, task, maxUses, allowedDomains?, blockedDomains?, maxTokens?, reply?})` | `assertCap(workerId,'web_search')`; `web_search_20260318` + `web_fetch_20260318` mit `allowed_callers:['direct']`; folgt `pause_turn` max. 5×; → `{ text, sources:[{url,title}], usage, costUsd, incomplete, toolErrors:[{tool,code,url?}] }` (`url_not_allowed` = robots.txt, Quelle auslassen). `BOT_VERBOT_DOMAINS` (`src/claude.js`, **einzige** Liste; P3s `BLOCKED_DOMAINS` ist derselbe Wert) sperrt `web_fetch` immer. |
|
||||
| `src/settings.js` | `getSettings(deps)`, `updateSettings(deps, patch, by)`, `publicSettings(s)` | Standardwerte nach §4.1; `updateSettings` validiert den ganzen Patch zuerst (Budget > 0, `mailColdPerDay` ≤ 3, `mailReplyCapPerDay` ≤ 15, `runsPerNight` 1–2, `retentionDays` 7–90, `offerText` 1–400, `offerProductKey` nur `hosting`, `privacyInteressentenLive`/`sendingHalted` nur Boolean; `sendingHalted:false` leert `sendingHaltedReason`). |
|
||||
| `src/settings.js` | `getSettings(deps)`, `updateSettings(deps, patch, by)`, `publicSettings(s)` | Standardwerte nach §4.1; `updateSettings` validiert den ganzen Patch zuerst (Budget > 0, `monthlyBudgetUsd` ≤ 150 und `dailyBudgetUsd` ≤ `monthlyBudgetUsd` – auch `getSettings` deckelt so –, `mailColdPerDay` ≤ 3, `mailReplyCapPerDay` ≤ 15, `runsPerNight` 1–2, `retentionDays` 7–90, `offerText` 1–400, `offerProductKey` nur `hosting`, `privacyInteressentenLive`/`sendingHalted` nur Boolean; `sendingHalted:false` leert `sendingHaltedReason`). |
|
||||
| `src/schedule.js` | `berlinNow(clock)`, `runKey(kind, now)`, `isDue(kind, now, last)`, `inSendWindow(now, settings)` | `now` = Ergebnis von `berlinNow(clock)`; Tick-Arten in §6.1; Muster Serverpuls. |
|
||||
| `src/priority.js` (H1) | `rankOf(kind)`, `JOB_RANKS` | Rang 0–5 für jede Job- und Tick-Art (§12 H1); unbekannte Art wirft. |
|
||||
| `src/jobs.js` | `enqueue(deps, {kind, workerId, prospectId?, threadId?, previewId?, payload}) → Job`, `next(deps, {kinds, workerIds?}) → Job oder null`, `finish(deps, jobId, result)`, `fail(deps, jobId, error, {retry=true})`, `reclaimStale(deps, {olderThanMs})` | `next` fragt die angeforderten Arten in `rankOf`-Reihenfolge ab und liefert je Art den ältesten `offen`-Job (H1); Job-Objekt §4.14; nach 3 Versuchen `fehler`. |
|
||||
@@ -268,20 +270,22 @@ Basis intern: `http://webklar-workers:8092`. Von WOMS über nginx `https://ticke
|
||||
|
||||
| Datei | Export / Zweck |
|
||||
|---|---|
|
||||
| `src/lib/navLinks.js` | Eintrag `{ key:'workers', label:'Workers', href:'/workers' }` ersetzt `leads` (nicht mehr `paused`). |
|
||||
| `src/App.jsx` | Route `/workers` → `React.lazy(() => import('./pages/WorkersPage.jsx'))`; `/leads` leitet auf `/workers` um. |
|
||||
| `src/lib/navLinks.js` | Eintrag `{ key:'hustler', label:'Hustler', href:'/hustler' }` ersetzt `leads` (nicht mehr `paused`). |
|
||||
| `src/App.jsx` | Route `/hustler` → `React.lazy(() => import('./pages/WorkersPage.jsx'))` (Dateiname bleibt); `/leads` und `/workers` leiten beide per `<Navigate replace>` auf `/hustler` um, die Query bleibt erhalten (`/workers?tab=botleads&bot=<id>` → `/hustler?tab=botleads&bot=<id>`). |
|
||||
| `src/lib/workersApi.js` · `src/lib/workersClient.js` | `createWorkersApi({ getJwt, fetchImpl })` → `{ state(), events(after, limit?), trace(workerId, limit?), pause(paused), settings(), saveSettings(patch), pult(status = 'offen' oder Komma-Liste), pultAction(id, action, body?), botleads({ room, q, page, id }), prospect(id) }`; `action` ∈ claim, sent, discard, done, reply, approve-preview, paste; `pult(status)` nimmt einen Status oder eine Komma-Liste (`'offen,in_arbeit'`) bzw. ein Array und prüft jeden Eintrag gegen die sechs Pult-Status; `botleads({ room, q, page, id })` reicht `id` seit P2-T04 durch; `getJwt({ fresh }?)`; Header `X-Appwrite-JWT`; Basis `/api/workers`. `workersClient.js` exportiert den verdrahteten `workersApi`. |
|
||||
| `src/lib/workersRoster.js` | `ROLES`, `FLOORS`, `SEARCH_ROOMS` (Spiegel von §3 und `src/roles.js`), `hatForModel(model)`. |
|
||||
| `src/lib/workersView.js` | reine Ableitungen: `formatUsd`, `formatCount`, `workerStatusLabel`, `kpiTiles(kpis)`. |
|
||||
| `src/lib/workersEvents.js` | `reduceEvents(stateByWorker, events)` → `{ [workerId]: { status, task, lastTs } }`; `eventToSteps(event)` → Animationsschritte für die Regie. |
|
||||
| `src/hooks/useWorkersFeed.js` | Polling: `state` alle 15 s, `events?after=` alle 5 s, Pause bei `document.visibilityState==='hidden'`. |
|
||||
| `src/components/workers/engine/*` | `scene.js`: `mountTower(canvas, { onSelect }) → { destroy(), setState(state), pushEvents(events), select(workerId), setPaused(bool) }` + `sprites.js`, `props.js`, `layout.js`, `building.js`, `lift.js`, `director.js`, `fx.js` (Plain Canvas 2D, Vorlage `scene-turm.js`). |
|
||||
| `src/components/workers/{WorkersStage,WorkersBoard,WorkerCard,WorkerList,WorkersKpis,WorkersSettingsDialog}.jsx` | UI-Teile (P2). `WorkersSettingsDialog` kennt `paused` nicht, zeigt `connectedRooms` nur an und enthält bei `sendingHalted` den Block „Versand wieder freigeben“ (H4, sendet `saveSettings({ sendingHalted: false })`); `WorkersBoard` zeigt bei `state.sendingHalted` eine Warnzeile. P3 ergänzt `PultList.jsx`, `ProspectPanel.jsx`, P4 erweitert `PultList.jsx` (u. a. „Antwort des Kunden einfügen“ bei Plattform-Einträgen), P6 ergänzt `BotLeadList.jsx`. |
|
||||
| `src/components/workers/{WorkersStage,WorkersBoard,WorkerCard,WorkerList,WorkersKpis,WorkersSettingsDialog}.jsx` | UI-Teile (P2; Dateinamen bleiben, sichtbare Texte nennen „Hustler“, der Titel von `WorkersSettingsDialog` zum Beispiel „Hustler-Einstellungen“). `WorkersSettingsDialog` kennt `paused` nicht, zeigt `connectedRooms` nur an und enthält bei `sendingHalted` den Block „Versand wieder freigeben“ (H4, sendet `saveSettings({ sendingHalted: false })`); `WorkersBoard` zeigt bei `state.sendingHalted` eine Warnzeile. P3 ergänzt `PultList.jsx`, `ProspectPanel.jsx`, P4 erweitert `PultList.jsx` (u. a. „Antwort des Kunden einfügen“ bei Plattform-Einträgen), P6 ergänzt `BotLeadList.jsx`. |
|
||||
| `src/lib/workersSettingsForm.js` (P2) · `src/lib/workersPult.js`, `src/lib/workersProspect.js` (P3; P4 erweitert `workersPult.js`) · `src/lib/botleadsView.js` (P6) | reine Logik; `READONLY_KEYS` der Einstellungsform: `paused`, `previewsSent`, `updatedAt`, `updatedBy`, `offerProductKey`, `connectedRooms`, `privacyInteressentenLive`, `sendingHalted`, `sendingHaltedReason`. |
|
||||
| `src/pages/WorkersPage.jsx` | `WORKERS_TABS` (Ids `hochhaus` · `freigabe` (P3) · `botleads` (P6), Beschriftung Hochhaus · Freigabe · Bot-Leads) und `const api = workersApi`; P2 legt nur `hochhaus` an (kein Platzhalter-Reiter), die Reiterleiste erscheint ab zwei Reitern; Auswahl über `?tab=`, unbekannter Wert fällt auf `hochhaus`. |
|
||||
| `src/pages/WorkersPage.jsx` | Seitentitel (H1) und Browser-Tab-Titel „Hustler“; `WORKERS_TABS` (Ids `hochhaus` · `freigabe` (P3) · `botleads` (P6), Beschriftung Hochhaus · Freigabe · Bot-Leads) und `const api = workersApi`; P2 legt nur `hochhaus` an (kein Platzhalter-Reiter), die Reiterleiste erscheint ab zwei Reitern; Auswahl über `?tab=`, unbekannter Wert fällt auf `hochhaus`. |
|
||||
| `src/styles/workers.css` | Klassen mit Präfix `wk-`. Schrift „Pixelify Sans“ selbst gehostet (`public/fonts/PixelifySans-*.woff2`). |
|
||||
| `tests/fixtures/workers-roster.json` | gemeinsame Fixture (§3). |
|
||||
|
||||
**Namensregel (Kenso, 17.10.):** Der Bereich heißt für Mitarbeiter **Hustler**, nicht „Workers“. Das gilt für alles, was Mitarbeiter sehen: Menüpunkt, Seitentitel (H1), Browser-Tab-Titel, Route `/hustler`, Titel des Einstellungsdialogs, Leerzustände, Toasts, Fehlertexte, die Morgenbericht-Mail (Betreff „Hustler-Nachtbericht …“, die Anrede darf „hier ist Otto“ bleiben) und Team-Hinweismails (Betreff-Präfix `[Hustler]`). Technische Namen bleiben unverändert: Sammlungen `workers*`, Dienst/Container `webklar-workers`, Repo `knso/workers-dienst`, API-Pfade `/api/workers/*`, Datei- und Komponentennamen (`WorkersPage.jsx`, `workersApi.js`, `workersRoster.js` …), CSS-Präfix `wk-`, Env `WORKERS_*`, `workerId`, Ereignisarten; das Wort „Worker“ für eine einzelne Figur oder Rolle bleibt ebenfalls. Texte an Interessenten und Kunden (Mails, Antworten, Übernahme-Seite, Vorschau-Seiten) nennen weder „Workers“ noch „Hustler“; sie sprechen als „KI-Assistent(in) von WEBklar“.
|
||||
|
||||
---
|
||||
|
||||
## 8. Portal – feste Namen (P5 liefert)
|
||||
@@ -294,7 +298,7 @@ Basis intern: `http://webklar-workers:8092`. Von WOMS über nginx `https://ticke
|
||||
| `server/services/workersKaufAbschluss.js` | `isWorkersCheckoutEvent(event)` (Session-`metadata.workersOfferId` vorhanden), `handleWorkersCheckoutEvent(event, { aboWeg })` (`aboWeg` = normaler Abo-Zweig `handleAboEvent`). |
|
||||
| `server/services/{reserviert,workersVorschau,workersKaufProjekt,workersKaufTexte}.js` | reservierte Subdomain `entwurf`; Vorschau-Ordner sicher lesen; Vorschau → Kundenprojekt; Wortlaut Fassung v5 + Nachweis-Texte. |
|
||||
| `server/routes/abo.js` | im Webhook nach dem Feature-Zweig und **vor** dem normalen Zweig: `if (isWorkersCheckoutEvent(event)) return handleWorkersCheckoutEvent(event, { aboWeg: handleAboEvent })`, sonst `handleAboEvent(event)`. |
|
||||
| `server/mail-templates/K44 Website übernommen.html`, `server/mail-templates/T25 Workers Hinweis.html` | K44 = Zugangsdaten + Begrüßung (an die Adresse des Kundendokuments, ohne BCC); T25 = Team-Hinweis mit Betreff-Präfix `[Workers]`. Die Nummern sind festgelegt; vor dem Anlegen trotzdem alle Branches prüfen. K01 (Vertragsbestätigung) kommt über den normalen Abo-Weg. |
|
||||
| `server/mail-templates/K44 Website übernommen.html`, `server/mail-templates/T25 Workers Hinweis.html` | K44 = Zugangsdaten + Begrüßung (an die Adresse des Kundendokuments, ohne BCC); T25 = Team-Hinweis mit Betreff-Präfix `[Hustler]` (der Dateiname bleibt). Die Nummern sind festgelegt; vor dem Anlegen trotzdem alle Branches prüfen. K01 (Vertragsbestätigung) kommt über den normalen Abo-Weg. |
|
||||
| `server/config.js` | `collections.workersOffers`, `.workersProspects`, `.workersPreviews`, `.workersEvents`, `.workersSettings` (Env `APPWRITE_COLLECTION_WORKERS_*`, Standard = Sammlungs-ID); `config.workers = { kaufEnabled, vorschauRoot, vorschauBaseUrl }` (Env `WORKERS_KAUF_ENABLED` off/on, Standard off; `WORKERS_VORSCHAU_ROOT`, Standard `/workers-vorschau/vorschau`; `WORKERS_VORSCHAU_BASE`). |
|
||||
|
||||
Ablauf nach Zahlung (`handleWorkersCheckoutEvent`, unter einer Sperre je Angebot, jeder Schritt wiederholbar): Kunde mit `createCustomerWithPortalAccess({ name, email, password:<zufällig>, kundenart })` anlegen (Status danach `customer`) → Stripe-Customer + Subscription-Metadaten `webklarCustomerId` setzen → normaler Abo-Weg `aboWeg` (`syncSubscription`, `recordAbschluss`, T02 an Team, K01) → Nachweis (`featureConsents`) → Vorschau als Kundenprojekt übernehmen (Repo aus Vorlage in Org WEBklar mit Systembenutzer, Dateien in einem Commit, `websiteProjects` mit `customerId`, Typ `preview`) → K44 senden → `forgetStoredPortalPassword` → `workersOffers.status='bezahlt'` + `paidAt`, `workersProspects.status='deal'` + `customerId` → Ereignis `deal` (workerId `system`, ID `eventIdFor('deal', offerId)`, `metaJson` laut §5). Dauerhafte Fehler (Vorschau unlesbar, Nachweis) melden T25 und der Ablauf geht weiter, vorübergehende (Gitea 5xx, Mail) antworten dem Webhook mit 500.
|
||||
@@ -315,11 +319,11 @@ Ablauf nach Zahlung (`handleWorkersCheckoutEvent`, unter einer Sperre je Angebot
|
||||
| Traefik | Datei `/home/webklar/apps/traefik/dynamic/workers-entwurf.yml`: Router `Host(\`entwurf.project.webklar.com\`)`, Priorität 200, `certResolver: letsencrypt`, Ziel `http://webklar-workers:8093` (P4) |
|
||||
| Reservierte Subdomain | `entwurf` im Portal-Subdomain-Schutz sperren (P5) |
|
||||
| Env (`.env` → Compose) | `WORKERS_APPWRITE_API_KEY`→`APPWRITE_API_KEY`, `WORKERS_ANTHROPIC_API_KEY`→`ANTHROPIC_API_KEY`, `APPWRITE_ENDPOINT=http://webklar-appwrite/v1`, `APPWRITE_PROJECT_ID=6a1058610003c5a13a05`, `WORKERS_SMTP_HOST/PORT/USER/PASS/FROM` (Absender-Postfach der neuen Domain), `WORKERS_IMAP_HOST/PORT/USER/PASS` (gleiches Postfach), `WORKERS_ALERT_IMAP_HOST/PORT/USER/PASS` (Alarm-Postfach), `WORKERS_REPORT_SMTP_*` (interner Morgenbericht über das bestehende webklar.com-Konto erlaubt, da kein Kaltkontakt), `WORKERS_PLACES_API_KEY` (P6), `WORKERS_UNSUB_BASE=https://entwurf.project.webklar.com/abmelden`, `WORKERS_UNSUB_SECRET` (32 Byte zufällig), `WORKERS_SEARCH_MODEL` (optional, Fallback `claude-sonnet-5-5`, falls Haiku kein `web_search` kann), `WORKERS_AUTOMAIL` (`ja`/`nein`, Standard nein: Max sendet Claras `mail_antwort`-Entwürfe erst bei `ja`, P4), `WORKERS_CHROMIUM_PATH` (P4). Es gibt **keinen** Env-Schalter für den Datenschutz-Abschnitt: das ist `settings.privacyInteressentenLive`. |
|
||||
| Serverpuls | Gruppe `{"app":"Workers","match":["webklar-workers*"],"folders":["workers"]}` in `apps/serverpuls/config/apps.json` |
|
||||
| Anthropic | eigener Console-Workspace „Workers“, Ausgabenlimit 250 $/Monat (Kenso) |
|
||||
| Serverpuls | Gruppe `{"app":"Hustler","match":["webklar-workers*"],"folders":["workers"]}` in `apps/serverpuls/config/apps.json` (`app` ist die sichtbare Beschriftung, `match` und `folders` sind technisch) |
|
||||
| Anthropic | eigener Console-Workspace „Hustler“, Ausgabenlimit 150 $/Monat (Kenso, 17.10.: max. 150 € im Monat) |
|
||||
|
||||
## 10. Was Kenso vorab einrichtet (Spec §12)
|
||||
Console-Workspace + Schlüssel; Domain `webklar-team.de` (INWX) + Google-Workspace-Postfächer (Absender + Alarme) oder Alternative; Konten + Suchaufträge auf Kleinanzeigen/freelancermap/freelance.de an das Alarm-Postfach; Freigabe des Datenschutz-Abschnitts „Interessenten“. Jeder Plan nennt am Ende seine **Betriebsanleitung** (Schritte, die Kenso ausführt: Skripte, `.env`, Compose, nginx, Push).
|
||||
Console-Workspace „Hustler“ mit Ausgabenlimit 150 $/Monat (Kenso, 17.10.: max. 150 € im Monat) + Schlüssel; Domain `webklar-team.de` (INWX) + Google-Workspace-Postfächer (Absender + Alarme) oder Alternative; Konten + Suchaufträge auf Kleinanzeigen/freelancermap/freelance.de an das Alarm-Postfach; Freigabe des Datenschutz-Abschnitts „Interessenten“. Jeder Plan nennt am Ende seine **Betriebsanleitung** (Schritte, die Kenso ausführt: Skripte, `.env`, Compose, nginx, Push).
|
||||
|
||||
---
|
||||
|
||||
@@ -380,7 +384,7 @@ Stand: Abgleich der Teilpläne P1–P6 am 17.10.2026. Die Teilpläne haben ihre
|
||||
| P5-E4 | P5 | Portal-Container hängt `workers_data:/workers-vorschau:ro` an (§9). |
|
||||
| P5-E5 | P4 | Vorschau-Server 404 ab `convertedProjectId`; Angebote `abgelaufen` bei Sperre; Ordner einer übernommenen Vorschau bleibt ≥ 7 Tage. |
|
||||
| P5-E6 | P1 | `newAbosMonth`, `mrrNewEur` und `dealsMonth` zählt P1 aus `workersOffers` (A12); das Portal schreibt das Ereignis `deal` mit `metaJson` laut §5. |
|
||||
| P5-E7 | P5 | Mail-Kennungen K44 „Website übernommen“ und T25 „[Workers] …“ (Präfix-Test in `mailTemplates.test.js` erweitert). |
|
||||
| P5-E7 | P5 | Mail-Kennungen K44 „Website übernommen“ und T25 „[Hustler] …“ (Präfix-Test in `mailTemplates.test.js` erweitert). |
|
||||
| P5-E8 | P5 | `createWorkersCheckout(offer, consent, buyer, { token })`; der Token steht nur im Fragment der Abbruch-Adresse. |
|
||||
| P5-E9 | P5 | Neue Wortlaute (Kundenart, Stripe-Hinweis, Angebotssatz-Zitat) brauchen Kensos Freigabe vor `WORKERS_KAUF_ENABLED=on`. |
|
||||
| P5-E10 | P1, P4 | Verkauft wird nur `productKey 'hosting'` (P1 beschränkt `offerProductKey`, P4 legt nur solche Angebote an). |
|
||||
@@ -390,7 +394,7 @@ Stand: Abgleich der Teilpläne P1–P6 am 17.10.2026. Die Teilpläne haben ihre
|
||||
| P6-E4 | P6 | `deps.places`, `deps.osm`, `deps.dns = { resolveMx, resolve4 }`; `deps.llm` entfällt (A1); das Impressum-Lesen nutzt `deps.fetch` (H2). |
|
||||
| P6-E5 | P6 | Tick-Arten `top3` (05:30) und `scouts` (alle 2 min) ergänzt P6 in `src/schedule.js`; `kuerzen` (täglich 03:00) steht dort seit P1-T08 und wird von P6 nicht noch einmal angelegt (P6 liefert nur den Lauf `runKuerzen` und den Tick-Eintrag). |
|
||||
| P6-E6 | P6 | Zusatzprüfung `coldChecks` über `registerGateCheck` (Gründe `datenschutz`, `adresse_nicht_belegt`, `kein_kaltkontakt`, `kaltmail_ohne_antwort`, `status_unpassend`); `appendCompliance` Zweig `cold:true`. |
|
||||
| P6-E7 | P6 | `GET /botleads?id=<prospectId>`; Ereignislink `/workers?tab=botleads&bot=<prospectId>`; Route über `routes`. |
|
||||
| P6-E7 | P6 | `GET /botleads?id=<prospectId>`; Ereignislink `/hustler?tab=botleads&bot=<prospectId>`; Route über `routes`. |
|
||||
| P6-E8 | P6 | `deps.drafters.erstmail/nachfass(deps, job)` liefert P6; die Aufträge legen `selectNightTop3` bzw. `scheduleFollowups` an, versendet werden sie von P4s Tick `senden`. |
|
||||
|
||||
### 11.2 Neu aus dem Abgleich (widerspruchsfrei entschieden)
|
||||
@@ -419,6 +423,8 @@ Stand: Abgleich der Teilpläne P1–P6 am 17.10.2026. Die Teilpläne haben ihre
|
||||
| A20 | P4 | **Gelöst in P4-T34:** Die Eingabeseite für Folge-Antworten von Plattformen (Spec §5): Einfügen im Pult (`POST /pult/:id/paste`, `POST /prospect/:id/paste`) oder passende Plattform-Benachrichtigung im Alarm-Postfach ⇒ eingegangene Nachricht im Plattform-Faden ⇒ Nora ordnet ein ⇒ ja ⇒ Bau, Frage ⇒ Clara schreibt den nächsten Entwurf (Pult `plattform_antwort`), siehe P4-E12. Ein eigener Teilplan P7 ist nicht nötig. |
|
||||
| A21 | P2 | WOMS zeigt `sendingHalted` als Warnzeile im Board und bietet dem Admin im Einstellungs-Dialog „Versand wieder freigeben“ (H4). |
|
||||
| A22 | P6 | Kaltmails und Nachfass-Mails enthalten im Text genau **einen** Link, `https://www.webklar.com` (H3), eingesetzt vom Code, nie vom Modell; der Pflichtblock bleibt bei den drei Adressen aus `buildColdFooter`. |
|
||||
| A23 | alle | **Budget [Kenso, 17.10.: max. 150 € im Monat]:** Standardwerte `dailyBudgetUsd` 6 und `monthlyBudgetUsd` 150 (USD, ≈ 130 €), `warnPct` 80, Console-Ausgabenlimit 150 $/Monat (§2.9, §4.1, §9, §10). Tests und Beispieldaten der Teilpläne nutzen diese Werte. |
|
||||
| A24 | alle | **Name [Kenso, 17.10.]:** Mitarbeiter sehen „Hustler“ (Menü, Titel, Route `/hustler`, Dialoge, Toasts, Fehlertexte, Morgenbericht „Hustler-Nachtbericht …“, Team-Mails `[Hustler]`); technische Namen bleiben `workers*`; Texte an Interessenten und Kunden nennen weder „Workers“ noch „Hustler“ (Namensregel in §7). |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user