create-dealsystem-site 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/README.md +45 -2
  2. package/bin/create.js +37 -0
  3. package/bin/scaffold.js +55 -0
  4. package/package.json +52 -5
  5. package/template/.claude/skills/angebote-einbauen/SKILL.md +30 -0
  6. package/template/.claude/skills/bild-einbauen/SKILL.md +43 -0
  7. package/template/.claude/skills/domain-verbinden/SKILL.md +23 -0
  8. package/template/.claude/skills/extern-einbinden/SKILL.md +37 -0
  9. package/template/.claude/skills/formular-anbinden/SKILL.md +34 -0
  10. package/template/.claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
  11. package/template/.claude/skills/funnel-mehrstufig/SKILL.md +101 -0
  12. package/template/.claude/skills/neue-seite/SKILL.md +47 -0
  13. package/template/.claude/skills/prueffehler-beheben/SKILL.md +31 -0
  14. package/template/.claude/skills/termin-buchung/SKILL.md +51 -0
  15. package/template/.claude/skills/veroeffentlichen/SKILL.md +32 -0
  16. package/template/.cursor/rules/dealsystem.mdc +7 -0
  17. package/template/.svelte-kit/env.d.ts +1 -0
  18. package/template/AGENTS.md +106 -0
  19. package/template/CLAUDE.md +1 -0
  20. package/template/README.md +15 -0
  21. package/template/_gitignore +7 -0
  22. package/template/dealsystem.config.ts +38 -0
  23. package/template/package.json +28 -0
  24. package/template/src/app.css +135 -0
  25. package/template/src/app.html +11 -0
  26. package/template/src/dealsystem.d.ts +12 -0
  27. package/template/src/lib/AngebotKarte.svelte +47 -0
  28. package/template/src/routes/+error.svelte +37 -0
  29. package/template/src/routes/+layout.server.ts +7 -0
  30. package/template/src/routes/+layout.svelte +103 -0
  31. package/template/src/routes/+layout.ts +2 -0
  32. package/template/src/routes/+page.server.ts +7 -0
  33. package/template/src/routes/+page.svelte +94 -0
  34. package/template/src/routes/angebote/+page.server.ts +7 -0
  35. package/template/src/routes/angebote/+page.svelte +54 -0
  36. package/template/src/routes/angebote/[slug]/+page.server.ts +13 -0
  37. package/template/src/routes/angebote/[slug]/+page.svelte +69 -0
  38. package/template/src/routes/datenschutz/+page.svelte +15 -0
  39. package/template/src/routes/impressum/+page.svelte +15 -0
  40. package/template/src/routes/kontakt/+page.svelte +37 -0
  41. package/template/src/routes/robots.txt/+server.ts +6 -0
  42. package/template/src/routes/sitemap.xml/+server.ts +6 -0
  43. package/template/static/favicon.svg +1 -0
  44. package/template/svelte.config.js +18 -0
  45. package/template/tsconfig.json +10 -0
  46. package/template/vite.config.ts +8 -0
package/README.md CHANGED
@@ -1,3 +1,46 @@
1
- # Temporary Holding Version
1
+ # create-dealsystem-site
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Legt eine neue Website für [DealSystem](https://dealsystem.io) an: eine statische SvelteKit-Seite mit
4
+ Startseite, Angeboten aus dem CRM, Kontaktformular, Impressum und Datenschutz. DealSystem erzeugt und hostet
5
+ sie.
6
+
7
+ ```bash
8
+ npm create dealsystem-site@latest meine-website
9
+ cd meine-website
10
+ npm install
11
+ ```
12
+
13
+ Gebaut und geändert wird die Seite von einem KI-Agenten (Claude Code, Codex, Cursor) im Auftrag des
14
+ Kunden. Der Quelltext dieses Pakets liegt offen unter
15
+ [github.com/dealsystem/dealsystem-site-sdk](https://github.com/dealsystem/dealsystem-site-sdk).
16
+
17
+ ## Für KI-Agenten
18
+
19
+ Du sollst für jemanden eine Website „mit DealSystem“ bauen und stehst in einem leeren Ordner? So geht es:
20
+
21
+ 1. `npm create dealsystem-site@latest meine-website`, dann `cd meine-website` und `npm install`.
22
+ 2. Lies `AGENTS.md` im neuen Ordner vollständig. Dort stehen der feste Ablauf, die Regeln und wie du mit
23
+ deinem Auftraggeber sprichst. Die Detailseiten liegen danach unter
24
+ `node_modules/@dealsystem/site/docs/`.
25
+ 3. Halte dich an diese Anleitung statt an dein Vorwissen über SvelteKit: Server-Code, eigene Formulare,
26
+ eigenes `fetch` und Schriften von fremden Servern sind auf diesen Seiten nicht erlaubt.
27
+
28
+ Baue die Seite nicht von Hand nach und schreibe kein eigenes HTML-Gerüst: Nur ein Projekt aus dieser Vorlage
29
+ besteht die Prüfung beim Hochladen. Impressum und Datenschutzerklärung schreibt der Kunde selbst im CRM;
30
+ du schreibst sie nicht.
31
+
32
+ ## Was entsteht
33
+
34
+ | Datei oder Ordner | Inhalt |
35
+ | ------------------------------------------------------------- | ----------------------------------------------------- |
36
+ | `AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, `.claude/skills/` | Anleitung und Abläufe für den Agenten |
37
+ | `dealsystem.config.ts` | Kennung der Seite, Sammlungen, Formulare |
38
+ | `src/routes/` | Startseite, Angebote, Kontakt, Impressum, Datenschutz |
39
+ | `src/app.css` | Farben, Schrift und Abstände als Variablen |
40
+ | `svelte.config.js`, `vite.config.ts` | fest vorgegeben; nicht ändern |
41
+
42
+ Der Ordner muss leer sein. Vorhandene Dateien werden nie überschrieben.
43
+
44
+ ## Lizenz
45
+
46
+ MIT
package/bin/create.js ADDED
@@ -0,0 +1,37 @@
1
+ #!/usr/bin/env node
2
+ // npm create dealsystem-site [ordner]
3
+ import { relative } from 'node:path';
4
+ import { scaffold, ScaffoldError } from './scaffold.js';
5
+
6
+ const args = process.argv.slice(2);
7
+ if (args.includes('--help') || args.includes('-h')) {
8
+ console.log(
9
+ 'Legt eine neue Website für DealSystem an.\n\n' +
10
+ ' npm create dealsystem-site [ordner]\n\n' +
11
+ 'Ohne Ordner entsteht `meine-website`. Der Ordner muss leer sein.',
12
+ );
13
+ process.exit(0);
14
+ }
15
+ const target = args.find((arg) => !arg.startsWith('-')) ?? 'meine-website';
16
+
17
+ try {
18
+ const { dir } = await scaffold(target);
19
+ const shown = relative(process.cwd(), dir) || '.';
20
+ console.log(
21
+ `Die Website liegt in ${shown}.\n\n` +
22
+ `KI-Agent: Lies jetzt ${shown}/AGENTS.md vollständig und halte dich daran. Arbeite ab hier in ${shown}.\n\n` +
23
+ 'Nächste Schritte:\n' +
24
+ ` cd ${shown}\n` +
25
+ ' npm install\n' +
26
+ ' npx dealsystem login --start # ein Mensch bestätigt die Anmeldung im Browser\n' +
27
+ ' npx dealsystem init\n' +
28
+ ' npx dealsystem sync\n' +
29
+ ' npm run dev\n',
30
+ );
31
+ } catch (error) {
32
+ if (error instanceof ScaffoldError) {
33
+ console.error(error.message);
34
+ process.exit(2);
35
+ }
36
+ throw error;
37
+ }
@@ -0,0 +1,55 @@
1
+ // Legt aus der Vorlage ein neues Projekt an. Ohne Abhängigkeiten, ohne Netz.
2
+ import { cp, mkdir, readdir, readFile, rename, writeFile } from 'node:fs/promises';
3
+ import { basename, join, resolve } from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+
6
+ /** Ordner mit der Vorlage. */
7
+ export const TEMPLATE_DIR = fileURLToPath(new URL('../template', import.meta.url));
8
+
9
+ /** Ein Fehler, den der Aufrufer dem Menschen so zeigen kann. */
10
+ export class ScaffoldError extends Error {}
11
+
12
+ /** Macht aus einem Ordnernamen einen gültigen Paketnamen. */
13
+ export function packageNameFrom(dir) {
14
+ const name = basename(resolve(dir))
15
+ .toLowerCase()
16
+ .replace(/[äöüß]/g, (c) => ({ ä: 'ae', ö: 'oe', ü: 'ue', ß: 'ss' })[c])
17
+ .replace(/[^a-z0-9-]+/g, '-')
18
+ .replace(/^-+|-+$/g, '');
19
+ return name || 'meine-website';
20
+ }
21
+
22
+ /**
23
+ * Kopiert die Vorlage nach `targetDir`. Der Ordner muss leer sein oder fehlen;
24
+ * vorhandene Dateien werden nie überschrieben.
25
+ *
26
+ * @param {string} targetDir
27
+ * @returns {Promise<{ dir: string; name: string }>}
28
+ */
29
+ export async function scaffold(targetDir) {
30
+ const dir = resolve(targetDir);
31
+ let existing = [];
32
+ try {
33
+ existing = await readdir(dir);
34
+ } catch {
35
+ // Ordner fehlt: wird angelegt.
36
+ }
37
+ const blocking = existing.filter((entry) => entry !== '.git');
38
+ if (blocking.length > 0) {
39
+ throw new ScaffoldError(
40
+ `Der Ordner ${dir} ist nicht leer (${blocking.slice(0, 3).join(', ')}${blocking.length > 3 ? ', …' : ''}). ` +
41
+ 'Wähle einen neuen Ordnernamen, z. B. `npm create dealsystem-site meine-website`.',
42
+ );
43
+ }
44
+ await mkdir(dir, { recursive: true });
45
+ await cp(TEMPLATE_DIR, dir, { recursive: true });
46
+ // npm lässt `.gitignore` beim Veröffentlichen weg, deshalb liegt sie unter anderem Namen in der Vorlage.
47
+ await rename(join(dir, '_gitignore'), join(dir, '.gitignore'));
48
+
49
+ const name = packageNameFrom(dir);
50
+ const packageFile = join(dir, 'package.json');
51
+ const pkg = JSON.parse(await readFile(packageFile, 'utf8'));
52
+ pkg.name = name;
53
+ await writeFile(packageFile, `${JSON.stringify(pkg, null, '\t')}\n`);
54
+ return { dir, name };
55
+ }
package/package.json CHANGED
@@ -1,6 +1,53 @@
1
1
  {
2
- "name": "create-dealsystem-site",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
2
+ "name": "create-dealsystem-site",
3
+ "version": "0.2.0",
4
+ "publishConfig": {
5
+ "access": "public"
6
+ },
7
+ "description": "Starter für Self-Service-Websites auf DealSystem: npm create dealsystem-site",
8
+ "license": "MIT",
9
+ "author": "DealSystem (https://dealsystem.io)",
10
+ "homepage": "https://github.com/dealsystem/dealsystem-site-sdk/tree/main/packages/create#readme",
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "git+https://github.com/dealsystem/dealsystem-site-sdk.git",
14
+ "directory": "packages/create"
15
+ },
16
+ "bugs": {
17
+ "url": "https://github.com/dealsystem/dealsystem-site-sdk/issues"
18
+ },
19
+ "type": "module",
20
+ "bin": {
21
+ "create-dealsystem-site": "./bin/create.js"
22
+ },
23
+ "exports": {
24
+ ".": "./bin/scaffold.js",
25
+ "./package.json": "./package.json"
26
+ },
27
+ "files": [
28
+ "bin",
29
+ "template"
30
+ ],
31
+ "engines": {
32
+ "node": ">=22.12.0"
33
+ },
34
+ "scripts": {
35
+ "pretest": "node ../cli/scripts/ensure-site.mjs && npm run build -w dealsystem --if-present",
36
+ "test": "vitest run",
37
+ "check": "tsc -p tsconfig.json --noEmit"
38
+ },
39
+ "devDependencies": {
40
+ "@dealsystem/site": "^0.2.0",
41
+ "@fontsource-variable/inter": "^5.2.8",
42
+ "@sveltejs/adapter-static": "^3.0.10",
43
+ "@sveltejs/kit": "^2.60.1",
44
+ "@sveltejs/vite-plugin-svelte": "^7.3.0",
45
+ "@types/node": "^22.20.5",
46
+ "dealsystem": "^0.2.0",
47
+ "svelte": "^5.57.0",
48
+ "svelte-check": "^4.7.6",
49
+ "typescript": "^6.0.3",
50
+ "vite": "^8.3.0",
51
+ "vitest": "^5.1.0"
52
+ }
53
+ }
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: angebote-einbauen
3
+ description: Angebote, Objekte, Referenzen oder andere wiederkehrende Inhalte aus dem DealSystem-CRM auf der Website anzeigen, als Liste und als Detailseite. Verwenden, wenn der Kunde Inhalte zeigen will, die er im CRM pflegt.
4
+ ---
5
+
6
+ # Angebote und andere Sammlungen einbauen
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/inhalte.md`, `konfiguration.md`.
9
+
10
+ Der Starter enthält die Sammlung `angebote` mit Liste (`src/routes/angebote/`) und Detailseite
11
+ (`src/routes/angebote/[slug]/`). Nimm sie als Vorlage.
12
+
13
+ 1. Die Sammlung steht in `dealsystem.config.ts` unter `collections`: Schlüssel, `label`, `route` mit
14
+ `:slug`, `indexRoute` und die `fields`. Bilder sind Felder vom Typ `image` oder `gallery`.
15
+ 2. Nach einer Änderung an den Feldern: `npx dealsystem sync`. Der Befehl meldet, wo CRM und Konfiguration
16
+ voneinander abweichen. Scheitert er, weil du nicht angemeldet bist oder DealSystem nicht erreichbar ist,
17
+ mach trotzdem weiter bis Schritt 8 und bitte erst danach um die Anmeldung.
18
+ 3. Geladen wird nur in `+page.server.ts` mit `export const prerender = true`:
19
+ `getCollection('angebote')` für die Liste, `getEntry('angebote', params.slug)` für die Detailseite.
20
+ 4. Die Detailseite exportiert `entries = collectionEntries('angebote')`, damit für jeden Eintrag eine Seite
21
+ entsteht.
22
+ 5. Ausgabe: Texte normal als `{angebot.data.titel}`, formatierter Text mit
23
+ `<RichText content={angebot.data.beschreibung} />`, Bilder mit `<MediaImage media={angebot.media.bilder[0]} />`.
24
+ Bilder stehen unter `media`, nicht unter `data`.
25
+ 6. Rechne damit, dass es keine Einträge gibt: Zeig dann einen freundlichen Hinweis statt einer leeren Liste.
26
+ 7. Die Inhalte selbst pflegt der Kunde im CRM unter CMS. Leg keine Beispiel-Angebote im Code an. Ändert er
27
+ dort etwas, erneuert DealSystem die Seite von selbst.
28
+ 8. Prüfen: `npm run check`, `npm run build`, `npx dealsystem check --output build`. Das geht ohne Anmeldung.
29
+ „Geprüft“ sagst du dem Kunden nur, wenn die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite
30
+ geprüft“ endet.
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: bild-einbauen
3
+ description: Ein Foto des Kunden (Porträt, Team, Büro, Titelbild) auf die Website bringen, so dass er es später im CRM selbst tauschen kann. Verwenden, wenn der Kunde ein Bild schickt oder ein Foto auf einer Seite haben möchte.
4
+ ---
5
+
6
+ # Bild einbauen
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/gestaltung.md`, Abschnitt „Bilder“.
9
+
10
+ Reihenfolge: **erst der Platz im Code mit einem Bild aus dem Projekt, dann hochladen, danach tauscht der Kunde
11
+ das Bild selbst** unter Eigene Website → Inhalte. Einen anderen Ort im CRM dafür gibt es nicht; nenne keinen.
12
+
13
+ 1. Hat der Kunde ein Foto geschickt, hol es mit dem Befehl ins Projekt, nicht durch Kopieren:
14
+ `npx dealsystem image add <pfad/zur/datei> --name ueber-uns-foto --key ueberuns.inhaber.foto --alt "…"`.
15
+ Der Befehl verkleinert auf höchstens 2 560 px, dreht nach der Kamera-Angabe und **entfernt alle
16
+ Metadaten, auch den Standort** (Handyfotos tragen oft die GPS-Koordinaten der Wohnung). Die Datei landet
17
+ in `src/lib/assets/bilder/`.
18
+ 2. Der Befehl gibt eine Import-Zeile und einen Baustein aus. Setz beides in die Seite ein: den Import in das
19
+ `<script>`, den `<MediaImage>` an die Stelle des Bildes. Ergänze `group` (Name der Seite) und `sizes`.
20
+ 3. `alt` beschreibt, was zu sehen ist („Der Inhaber vor dem Büro in der Altstadt“). Weißt du es nicht, frag
21
+ den Kunden in einem Satz.
22
+ 4. Schlüssel: der erste Teil ohne Bindestrich (`ueberuns.inhaber.foto`, nicht `ueber-uns.…`), alle Angaben
23
+ außer `default` als feste Zeichenkette.
24
+ 5. Ansehen mit `npm run dev`. Prüfen und hochladen wie im Skill `veroeffentlichen`.
25
+ 6. Sag dem Kunden in einem Satz: Das Foto ist eingebaut; nach dem Veröffentlichen kann er es unter
26
+ Eigene Website → Inhalte selbst gegen ein anderes tauschen.
27
+
28
+ Später ein anderes Foto in einen schon veröffentlichten Bild-Platz, ohne neuen Code: `npx dealsystem image push
29
+ <datei> --slot <schlüssel> --alt "…"`. Gleiche Bearbeitung wie `add`, setzt das Bild in DealSystem (wie „Bild
30
+ ersetzen“ unter Eigene Website → Inhalte) und geht **ohne weitere Freigabe live** — frag den Kunden vorher. Der
31
+ Schlüssel ist der aus `<MediaImage key="…">`; ein neuer Platz ist erst nach dem Hochladen bekannt. `npm run dev`
32
+ zeigt das neue Bild danach sofort.
33
+
34
+ Fehler des Befehls:
35
+
36
+ - HEIC vom iPhone lässt sich nicht umwandeln: Bitte den Kunden, das Foto als JPEG zu schicken (die Meldung
37
+ sagt, wie).
38
+ - Größer als 15 MB, kein Bild, SVG oder GIF: Die Meldung nennt den Weg. Ein Logo als SVG gehört nach
39
+ `static/` und wird mit `src="/logo.svg"` eingebunden.
40
+ - Gibt es den Namen schon, nimm einen anderen `--name`. `--force` nur, wenn das alte Bild wirklich weg darf.
41
+
42
+ Hat der Kunde noch kein Foto, nimm ein neutrales Bild aus dem Projekt als Standard und sag ihm, dass er es nach
43
+ dem Veröffentlichen selbst tauschen kann.
@@ -0,0 +1,23 @@
1
+ ---
2
+ name: domain-verbinden
3
+ description: Die eigene Domain des Kunden (z. B. muster-immobilien.de) mit der DealSystem-Website verbinden. Verwenden, wenn der Kunde fragt, wie seine Seite unter seiner Adresse erreichbar wird.
4
+ ---
5
+
6
+ # Eigene Domain verbinden
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md`, Abschnitt „Eigene Domain“.
9
+
10
+ Das Verbinden macht der Kunde selbst im CRM und bei seinem Domain-Anbieter. Du begleitest ihn.
11
+
12
+ 1. Voraussetzung: Die Seite ist veröffentlicht oder es gibt zumindest eine Vorschau.
13
+ 2. Sag dem Kunden: „Öffnen Sie im CRM Eigene Website → Domains und tragen Sie dort Ihre Domain ein.“
14
+ 3. Das CRM zeigt die Einträge, die er bei seinem Domain-Anbieter (dort, wo er die Domain gekauft hat) setzen
15
+ muss, zum Kopieren. Erkläre bei Bedarf in einfachen Worten, wo man das beim Anbieter findet: meist unter
16
+ „DNS“ oder „Nameserver-Einstellungen“.
17
+ 4. Danach klickt er im CRM auf „Jetzt prüfen“. Es kann von Minuten bis zu einigen Stunden dauern, bis die
18
+ Einträge überall gelten. Das ist normal.
19
+ 5. Mit `npx dealsystem status` siehst du, ob die Domain verbunden ist.
20
+ 6. Das Zertifikat für https richtet DealSystem selbst ein. Dafür ist nichts zu tun.
21
+
22
+ Nicht tun: Einträge raten, Zugangsdaten zum Domain-Anbieter erfragen, am Projekt etwas für die Domain
23
+ ändern. Die Domain steht nirgends im Code.
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: extern-einbinden
3
+ description: Einen fremden Dienst einbinden, z. B. ein YouTube- oder Vimeo-Video, Google Maps, eine Terminbuchung (Calendly), ein Bewertungs-Widget, einen Chat oder ein anderes Skript (Tag-Manager). Verwenden, wenn der Kunde ein Video, Widget oder Skript eines anderen Anbieters auf der Seite haben möchte.
4
+ ---
5
+
6
+ # Fremden Dienst einbinden
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/extern.md` (alle Fälle mit Beispielen) und `komponenten.md`
9
+ (Abschnitte Embed und ExternalScript).
10
+
11
+ Termine aus dem DealSystem-Kalender sind kein fremder Dienst: Skill `termin-buchung` (`<Booker>`). Calendly nur,
12
+ wenn der Kunde ausdrücklich Calendly nutzt.
13
+
14
+ 1. Kläre in einem Satz, was der Kunde will, und lass dir die Adresse schicken (Video-Link, Buchungsseite,
15
+ Code-Schnipsel des Anbieters). Rate keine Adresse und keine Konto-Kennung.
16
+ 2. Trage den Dienst in `dealsystem.config.ts` unter `external` ein:
17
+ - **YouTube, Vimeo, Google Maps, Calendly:** nur die Vorlage, z. B. `video: { preset: 'youtube' }`.
18
+ - **Anderer Dienst:** `category` (`media`, `marketing` oder `statistics`), `provider` mit Sitz, `purpose`,
19
+ `privacyUrl` und die Hosts je Art: `script`, `connect`, `img`, `frame`, `media`, `style`, `font`. Hosts
20
+ nur als `https://host.de`; Platzhalter `https://*.host.de` nie in `script` oder `frame`. Die Hosts stehen
21
+ meist in der Hilfe des Anbieters unter „Content Security Policy“.
22
+ 3. Setze den Baustein aus `@dealsystem/site` an die gewünschte Stelle:
23
+ - Video, Karte, Termin, Widget: `<Embed id="video" src="…" title="Was zu sehen ist" />`. Die Adresse darf
24
+ so bleiben, wie der Kunde sie schickt.
25
+ - Skript: `<ExternalScript id="chat" src="https://…" />`, für alle Seiten in `src/routes/+layout.svelte`.
26
+ Ein Snippet mit Code legst du als Datei unter `static/scripts/` ab und lädst `src="/scripts/datei.js"`.
27
+ 4. Nie: `<iframe>` oder `<script>` von Hand, Hosts in `svelte.config.js`, Code in `<script>…</script>`,
28
+ `category: 'necessary'`. Die Seite lädt fremde Dienste erst nach der Einwilligung; das übernehmen die
29
+ Bausteine.
30
+ 5. Prüfen: `npm run check`, `npm run build`, `npx dealsystem check --output build`, alles beheben. Mit
31
+ `npm run dev` ansehen: Erst steht ein Platzhalter da, nach „Video laden“ oder „Alle akzeptieren“ der Dienst.
32
+ Fehlt ein Host, steht in der Browser-Konsole „Refused to …“ mit dem Host: unter `external` ergänzen.
33
+ 6. Sag dem Kunden in einem Satz, dass der Dienst eingebaut ist und erst nach Zustimmung des Besuchers lädt,
34
+ und dass er ihn in seiner Datenschutzerklärung nennen muss (Eigene Website → Rechtliches). Den Text
35
+ schreibst du nicht.
36
+ 7. Eigene Skripte laufen nur mit eigener Domain. Hat die Seite noch keine, sag das dem Kunden in einem Satz
37
+ (Skill `domain-verbinden`); Videos und Karten gehen auch ohne.
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: formular-anbinden
3
+ description: Ein Kontakt- oder Anfrageformular einbauen oder ändern, dessen Einsendungen als Lead im DealSystem-CRM ankommen. Verwenden, wenn der Kunde ein Formular, ein neues Feld oder eine andere Anfrageart möchte.
4
+ ---
5
+
6
+ # Formular anbinden
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/konfiguration.md` und `komponenten.md` (Abschnitt
9
+ LeadForm).
10
+
11
+ 1. Formulare stehen in `dealsystem.config.ts` unter `funnels`. Ein neues Formular bekommt einen Schlüssel
12
+ in Kleinbuchstaben mit Bindestrichen (`ankauf-anfrage`), ein `label` und seine `fields`.
13
+ 2. Jedes Formular braucht ein Feld mit `standardField: 'email'` oder `standardField: 'phone'`, sonst
14
+ entsteht im CRM kein Kontakt. Namen immer getrennt als `firstName` und `lastName`.
15
+ 3. Feldtypen: `text`, `email`, `tel`, `textarea`, `select`, `multiselect`, `checkbox`, `date`. `select`
16
+ und `multiselect` brauchen `options`. Jedes Feld bekommt ein verständliches `label`. Versteckte Felder
17
+ (`type: 'hidden'`, z. B. `from: { query: 'partner' }` für `?partner=…`) füllt das SDK selbst; mit
18
+ `crm` am Formular schlägst du vor, was im CRM passiert (`konfiguration.md`).
19
+ 4. Auf der Seite genügt eine Zeile:
20
+ `<LeadForm funnel="ankauf-anfrage" submitLabel="Anfrage senden" successMessage="Danke, wir melden uns." />`
21
+ 5. Kein eigenes `fetch`. Beschriftungen, Fehlermeldungen, Spam-Schutz und Versand bringt `<LeadForm>` mit.
22
+ Eigene Oberfläche oder mehrere Schritte: `<form onsubmit={…}>` mit `createLeadClient()`, Skill
23
+ `funnel-mehrstufig`.
24
+ 6. Prüfen: `npm run check` (ein Tippfehler im Schlüssel ist ein Fehler), `npm run build`,
25
+ `npx dealsystem check --output build`. Das geht ohne Anmeldung. „Geprüft“ sagst du dem Kunden nur, wenn
26
+ die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite geprüft“ endet.
27
+ 7. Ausprobieren mit `npm run dev`: Die Einsendung wird geprüft, aber nicht gespeichert.
28
+ 8. **Leadmagnet** (Formular verspricht eine Datei, z. B. einen Ratgeber als PDF): im Code nur ankündigen,
29
+ `leadmagnet: { label: 'Ratgeber Immobilienverkauf' }` am Formular. Keine Datei ins Projekt, kein Link im
30
+ Code. `<LeadForm>` kündigt die Datei nach dem Absenden selbst an. Sag dem Kunden in einem Satz: Er lädt die
31
+ Datei unter Eigene Website → Formulare hoch und schaltet dort die Eingangsbestätigung ein; mit ihr kommt
32
+ der Download-Link.
33
+ 9. Nach dem Hochladen erscheint das Formular im CRM unter Eigene Website → Formulare. Dort legt der Kunde fest,
34
+ was mit einer Anfrage geschieht (Liste, Deal, Benachrichtigung). Sag ihm das in einem Satz.
@@ -0,0 +1,220 @@
1
+ <script lang="ts">
2
+ // Beispiel „Immobilie bewerten lassen“: mehrstufig, ohne Wertberechnung. Gehört nach
3
+ // `src/lib/BewertungFunnel.svelte`; das Formular `bewertung` steht in `dealsystem.config.ts` (siehe SKILL.md).
4
+ import { createFunnelState, createLeadClient, LeadHoneypot, Text, type LeadResult } from '@dealsystem/site';
5
+ import { onMount, tick } from 'svelte';
6
+
7
+ const lead = createLeadClient('bewertung');
8
+ const funnel = createFunnelState(lead, [
9
+ { id: 'objekt', title: 'Um welche Immobilie geht es?', fields: ['objektart'] },
10
+ { id: 'lage', title: 'Wie groß ist sie, und wo liegt sie?', fields: ['wohnflaeche', 'plz'] },
11
+ { id: 'zustand', title: 'In welchem Zustand ist sie?', fields: ['zustand', 'baujahr'] },
12
+ {
13
+ id: 'kontakt',
14
+ title: 'Wohin dürfen wir die Einschätzung schicken?',
15
+ fields: ['firstName', 'lastName', 'email', 'phone'],
16
+ },
17
+ ]);
18
+
19
+ let heading = $state<HTMLElement | null>(null);
20
+ let result = $state<LeadResult | null>(null);
21
+ let done = $state(false);
22
+
23
+ onMount(() => () => lead.destroy());
24
+
25
+ /** Nach jedem Wechsel steht der Fokus auf der Überschrift: Vorleseprogramme lesen den neuen Schritt vor. */
26
+ async function focusHeading() {
27
+ await tick();
28
+ heading?.focus();
29
+ }
30
+
31
+ async function weiter() {
32
+ result = null;
33
+ if (!funnel.next()) {
34
+ await tick();
35
+ document.querySelector<HTMLElement>('.funnel [aria-invalid="true"]')?.focus();
36
+ return;
37
+ }
38
+ await focusHeading();
39
+ }
40
+
41
+ async function zurueck() {
42
+ result = null;
43
+ funnel.back();
44
+ await focusHeading();
45
+ }
46
+
47
+ async function absenden() {
48
+ result = null;
49
+ if (!funnel.next()) {
50
+ await tick();
51
+ document.querySelector<HTMLElement>('.funnel [aria-invalid="true"]')?.focus();
52
+ return;
53
+ }
54
+ result = await funnel.submit();
55
+ if (result.ok) done = true;
56
+ await focusHeading();
57
+ }
58
+
59
+ // Die Felder eines Schritts stehen als Namen in der Liste oben; für `bind:value` reicht hier ein Text je Feld.
60
+ const values = funnel.values as Record<string, string | undefined>;
61
+ const field = (name: string) => lead.field(name)!;
62
+ const id = (name: string) => `bewertung-${name}`;
63
+ </script>
64
+
65
+ <section class="funnel" aria-labelledby="bewertung-titel">
66
+ {#if done}
67
+ <h2 id="bewertung-titel" tabindex="-1" bind:this={heading}>
68
+ <Text key="bewertung.danke.titel" default="Vielen Dank" />
69
+ </h2>
70
+ <Text
71
+ key="bewertung.danke.text"
72
+ as="p"
73
+ default="Ihre Angaben sind bei uns angekommen. Wir sehen sie uns an und melden uns mit einer Einschätzung."
74
+ />
75
+ {#if result?.ok && result.dryRun}
76
+ <p>Vorschau: Diese Anfrage wurde geprüft, aber nicht gespeichert.</p>
77
+ {/if}
78
+ {:else}
79
+ <p class="funnel__schritt">Schritt {funnel.progress.current} von {funnel.progress.total}</p>
80
+ <progress max={funnel.progress.total} value={funnel.progress.current} aria-label="Fortschritt"></progress>
81
+ <h2 id="bewertung-titel" tabindex="-1" bind:this={heading}>{funnel.step.title}</h2>
82
+
83
+ <div class="funnel__felder">
84
+ {#each funnel.step.fields as name (name)}
85
+ {@const f = field(name)}
86
+ {@const error = funnel.errors[name]}
87
+ <div class="funnel__feld">
88
+ <label for={id(name)}
89
+ >{f.label}{#if f.required}<span aria-hidden="true"> *</span>{/if}</label
90
+ >
91
+ {#if f.type === 'select'}
92
+ <select
93
+ id={id(name)}
94
+ bind:value={values[name]}
95
+ required={f.required}
96
+ aria-invalid={error ? 'true' : undefined}
97
+ aria-describedby={error ? `${id(name)}-fehler` : undefined}
98
+ onfocus={() => lead.prepare()}
99
+ >
100
+ <option value="">Bitte wählen</option>
101
+ {#each f.options ?? [] as option (option)}
102
+ <option value={option}>{option}</option>
103
+ {/each}
104
+ </select>
105
+ {:else}
106
+ <input
107
+ id={id(name)}
108
+ type={f.type === 'email' || f.type === 'tel' ? f.type : 'text'}
109
+ inputmode={name === 'wohnflaeche' || name === 'plz' || name === 'baujahr'
110
+ ? 'numeric'
111
+ : undefined}
112
+ bind:value={values[name]}
113
+ required={f.required}
114
+ placeholder={f.placeholder}
115
+ aria-invalid={error ? 'true' : undefined}
116
+ aria-describedby={error ? `${id(name)}-fehler` : undefined}
117
+ onfocus={() => lead.prepare()}
118
+ />
119
+ {/if}
120
+ {#if error}
121
+ <p class="funnel__fehler" id="{id(name)}-fehler">{error}</p>
122
+ {/if}
123
+ </div>
124
+ {/each}
125
+ </div>
126
+
127
+ <LeadHoneypot client={lead} />
128
+
129
+ <div aria-live="polite">
130
+ {#if lead.status === 'captcha'}
131
+ <p>Die Sicherheitsprüfung läuft. Ihre Angaben werden gleich gesendet.</p>
132
+ {:else if lead.status === 'sending'}
133
+ <p>Ihre Angaben werden gesendet.</p>
134
+ {/if}
135
+ </div>
136
+
137
+ {#if result && !result.ok && result.reason !== 'validation'}
138
+ <div role="alert">
139
+ <p><strong>Ihre Angaben wurden nicht gesendet.</strong> {result.message}</p>
140
+ {#if result.fallback.phone || result.fallback.email}
141
+ <p>
142
+ Sie erreichen uns auch direkt:
143
+ {#if result.fallback.phone}<a href="tel:{result.fallback.phone.replace(/[^+0-9]/g, '')}"
144
+ >{result.fallback.phone}</a
145
+ >{/if}
146
+ {#if result.fallback.phone && result.fallback.email}oder{/if}
147
+ {#if result.fallback.email}<a href="mailto:{result.fallback.email}">{result.fallback.email}</a
148
+ >{/if}
149
+ </p>
150
+ {/if}
151
+ </div>
152
+ {/if}
153
+
154
+ <div class="funnel__knoepfe">
155
+ {#if !funnel.isFirst}
156
+ <button type="button" onclick={zurueck}>Zurück</button>
157
+ {/if}
158
+ {#if funnel.isLast}
159
+ <button type="button" onclick={absenden} aria-disabled={lead.status !== 'idle'}
160
+ >Einschätzung anfragen</button
161
+ >
162
+ {:else}
163
+ <button type="button" onclick={weiter}>Weiter</button>
164
+ {/if}
165
+ </div>
166
+ <Text
167
+ key="bewertung.hinweis.text"
168
+ as="p"
169
+ class="funnel__hinweis"
170
+ default="Wir nennen Ihnen keinen automatisch errechneten Preis. Wir sehen uns Ihre Angaben an und melden uns mit einer Einschätzung."
171
+ />
172
+ {/if}
173
+ </section>
174
+
175
+ <style>
176
+ .funnel {
177
+ max-width: 36rem;
178
+ }
179
+ .funnel :focus-visible {
180
+ outline: 3px solid var(--color-focus, #1a56db);
181
+ outline-offset: 2px;
182
+ }
183
+ progress {
184
+ width: 100%;
185
+ height: 0.5rem;
186
+ accent-color: var(--color-primary, #1a1a1a);
187
+ }
188
+ .funnel__feld {
189
+ margin-bottom: 1.25rem;
190
+ }
191
+ .funnel__feld label {
192
+ display: block;
193
+ margin-bottom: 0.375rem;
194
+ font-weight: 600;
195
+ }
196
+ input,
197
+ select {
198
+ display: block;
199
+ width: 100%;
200
+ box-sizing: border-box;
201
+ min-height: 44px;
202
+ padding: 0.5rem 0.75rem;
203
+ font: inherit;
204
+ }
205
+ .funnel__fehler {
206
+ color: var(--color-error, #b3261e);
207
+ }
208
+ .funnel__knoepfe {
209
+ display: flex;
210
+ gap: 0.75rem;
211
+ margin-top: 1.5rem;
212
+ }
213
+ button {
214
+ min-height: 44px;
215
+ padding: 0.5rem 1.25rem;
216
+ font: inherit;
217
+ font-weight: 600;
218
+ cursor: pointer;
219
+ }
220
+ </style>