# Boilerplate-Inventur: Domaenen-Pakete (Spezial) > Faktische Bestandsaufnahme der fertigen Domaenen-Bausteine in der Boilerplate > (`/Users/raffaelsheikh/Documents/GitHub/boilerplate`), die HiveGrid-Module direkt > nutzen koennten. Quelle: gelesene Pakete, `index.ts`, READMEs, Prisma-Schemas, > Service-Layer in `apps/web/app/modules/*` und Worker-Jobs. > > Konvention im gesamten Repo: Pakete heissen `@toolctrl/`, sind `private: true`, > `type: module`, ESM-only, `exports` zeigen direkt auf `./src/*.ts` (kein Build-Output); > Build = `pnpm run typecheck`. Tests via `vitest run src`. Prisma-Schema ist > per-Domain aufgesplittet unter `prisma/schema/*.prisma`. DB-spezifische > Service-Logik liegt in `*.db.server.ts` / `*.server.ts` Dateien im Web-App-Modul. --- ## Reifegrad-Legende - **Reif (fertig)** — Prisma-Modell + Service-Layer + Worker/Route + Tests vorhanden. - **Solide (Helper/Schema-Layer)** — eigenstaendiges Paket mit Tests, aber bewusst dependency-frei (kein DB-/UI-Layer im Paket selbst). - **Daten-Modell + Service** — Prisma-Modell + DB-/Service-Layer im Web-App-Modul (kein eigenes npm-Paket). --- ## Uebersichts-Tabelle | Baustein | Code-Ort | Reifegrad | HiveGrid-Modul (Kandidat) | | --- | --- | --- | --- | | Subscriptions/Billing (Stripe) | `prisma/schema/subscriptions.prisma` + `apps/web/app/utils/stripe.server.ts` + `packages/entitlements` | Reif | Billing / Plaene / Entitlements-Querschnitt | | Onboarding-Wizard | `prisma/schema/onboarding.prisma` + `apps/web/app/modules/onboarding` | Reif | Onboarding / User-Aktivierung | | Help-Desk / Support | `prisma/schema/helpDesk.prisma` + `apps/web/app/modules/helpDesk` | Reif | Support / Feedback | | Customer-Portals | `prisma/schema/portals.prisma` + `apps/web/app/modules/portals` | Reif | Kunden-/Partner-Portale, White-Label-Subdomains | | Form-Widget / Form-Builder | `packages/form-widget` + `prisma/schema/formWidget.prisma` + `apps/web/app/modules/formWidget` | Reif | Lead-Capture / Formulare / Embeds | | Import (DSGVO/CSV/JSON/XLSX) | `packages/imports` + `prisma/schema/imports.prisma` | Solide + Job | Daten-Import / Migration | | Export (CSV/JSON/XLSX/PDF, DSGVO) | `packages/exports` + Worker `export.ts`/`dsgvo-export.ts` | Solide + Job | Daten-Export / DSGVO-Auskunft / Audit-PDF | | Branding / Theme | `packages/brand` | Solide | Theming-Querschnitt / Mail-Branding | | Entity-Builder (Custom-Felder) | `prisma/schema/entityBuilder.prisma` + `apps/web/app/components/entities` | Reif | No-Code-Entitaeten / Custom-Felder | | Knowledge-Base (Help-Center) | `prisma/schema/knowledgeBase.prisma` + `apps/web/app/modules/knowledgeBase` | Reif | Help-Center / Wissensdatenbank | | Analytics (Visitor/Event) | `prisma/schema/analytics.prisma` + `apps/web/app/modules/portals/utils/analytics-redaction.ts` | Daten-Modell + Service | Web-Analytics (Portal-fokussiert) | | Marketing-Leads / Funnel | `prisma/schema/marketingLeads.prisma` + `packages/marketing-outbound` + `apps/web/app/utils/leads` | Reif | Marketing / Lead-Funnel / Attribution | | Shared-Store (Redis-KV) | `packages/shared-store` | Solide | Querschnitt: Rate-Limit, Cache, Sessions, Idempotenz | | API-Client / API-Types (SDK) | `packages/api-client-ts`, `packages/api-types` | Solide | Externe Integration / SDK / Webhook-Verify | --- ## 1. `@toolctrl/form-widget` + Form-Builder **Zweck:** Geteilte Typen & Helper fuer das einbettbare iframe-Formular-Widget. Bewusst **ohne Runtime-Abhaengigkeiten** auf den Rest des Codebases (nur `zod`), damit Web/API/Worker/CLI es importieren koennen, ohne Prisma/React mitzuziehen. **Haupt-Exporte** (`packages/form-widget/src/index.ts`): | Export | Datei | Funktion | | --- | --- | --- | | `FormDefinitionSchema`, `FormFieldSchema`, `FormThemeSchema`, `FormSubmissionPayloadSchema`, `FieldTypeSchema` | `src/schema.ts` | Zod-Definitionen fuer Form/Feld/Theme/Submission-JSON. Feldtypen: text, email, number, textarea, select, radio, checkbox, honeypot | | `HONEYPOT_FIELD_KEY` (= `"hp_extra_data"`) | `src/schema.ts` | Stabiler Honeypot-Feldschluessel | | `matchAllowedOrigin`, `normalizeOrigin` | `src/origin.ts` | Origin-Allowlist mit Wildcard-Subdomain (`*.example.com`); leere Allowlist = nicht submittbar | | `isHoneypotTriggered` | `src/honeypot.ts` | Anti-Spam Honeypot-Erkennung (still 204 zurueck) | | `resolveSubmissionTarget`, `applyFieldMapping` | `src/routing.ts` | Submission-Routing: `generic` \| `crm-contact` \| `entity-row` + Field-Mapping (worker-hot-path, sync) | **Prisma-Modelle** (`prisma/schema/formWidget.prisma`): - `Form` — tenant-authored Definition + Theme + Delivery-Config (versioniertes `definition` JSON, `theme`, `targetType`, `targetEntityId`, `fieldMapping`, `allowedOrigins[]`, `notifyEmails[]`, `webhookUrl`, `config`, `key` fuer `