@dealsystem/site 0.0.0-stage → 0.2.1

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 (183) hide show
  1. package/README.md +145 -2
  2. package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
  3. package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
  4. package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
  5. package/agent-files/claude/skills/erster-entwurf/SKILL.md +54 -0
  6. package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
  7. package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
  8. package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
  9. package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
  10. package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
  11. package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
  12. package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
  13. package/agent-files/claude/skills/veroeffentlichen/SKILL.md +38 -0
  14. package/agent-files/cursor/rules/dealsystem.mdc +7 -0
  15. package/agent-files/manifest.json +101 -0
  16. package/contract/README.md +41 -0
  17. package/contract/ds-content.v1.json +2355 -0
  18. package/contract/external-presets.v1.json +65 -0
  19. package/contract/funnel-code-config.md +87 -0
  20. package/contract/site-api.v1.json +3916 -0
  21. package/dist/client/altcha-workers.d.ts +10 -0
  22. package/dist/client/attribution.d.ts +119 -0
  23. package/dist/client/attribution.js +341 -0
  24. package/dist/client/bookingClient.svelte.d.ts +166 -0
  25. package/dist/client/bookingClient.svelte.js +369 -0
  26. package/dist/client/bookingTime.d.ts +46 -0
  27. package/dist/client/bookingTime.js +109 -0
  28. package/dist/client/captcha.d.ts +26 -0
  29. package/dist/client/captcha.js +71 -0
  30. package/dist/client/captchaSession.d.ts +21 -0
  31. package/dist/client/captchaSession.js +105 -0
  32. package/dist/client/collections.d.ts +34 -0
  33. package/dist/client/collections.js +40 -0
  34. package/dist/client/externalScript.d.ts +20 -0
  35. package/dist/client/externalScript.js +36 -0
  36. package/dist/client/funnelState.svelte.d.ts +47 -0
  37. package/dist/client/funnelState.svelte.js +81 -0
  38. package/dist/client/leadClient.svelte.d.ts +131 -0
  39. package/dist/client/leadClient.svelte.js +250 -0
  40. package/dist/client/pageview.d.ts +7 -0
  41. package/dist/client/pageview.js +44 -0
  42. package/dist/client/siteApi.d.ts +211 -0
  43. package/dist/client/siteApi.js +320 -0
  44. package/dist/client/tracking.d.ts +18 -0
  45. package/dist/client/tracking.js +93 -0
  46. package/dist/client/validation.d.ts +10 -0
  47. package/dist/client/validation.js +66 -0
  48. package/dist/components/Booker.svelte +729 -0
  49. package/dist/components/Booker.svelte.d.ts +42 -0
  50. package/dist/components/CollectionList.svelte +122 -0
  51. package/dist/components/CollectionList.svelte.d.ts +65 -0
  52. package/dist/components/ConsentGate.svelte +68 -0
  53. package/dist/components/ConsentGate.svelte.d.ts +44 -0
  54. package/dist/components/CookieBanner.svelte +303 -0
  55. package/dist/components/CookieBanner.svelte.d.ts +29 -0
  56. package/dist/components/Datenschutz.svelte +84 -0
  57. package/dist/components/Datenschutz.svelte.d.ts +26 -0
  58. package/dist/components/Embed.svelte +263 -0
  59. package/dist/components/Embed.svelte.d.ts +41 -0
  60. package/dist/components/ExternalScript.svelte +94 -0
  61. package/dist/components/ExternalScript.svelte.d.ts +41 -0
  62. package/dist/components/Impressum.svelte +59 -0
  63. package/dist/components/Impressum.svelte.d.ts +25 -0
  64. package/dist/components/LeadForm.svelte +475 -0
  65. package/dist/components/LeadForm.svelte.d.ts +35 -0
  66. package/dist/components/LeadHoneypot.svelte +43 -0
  67. package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
  68. package/dist/components/Link.svelte +48 -0
  69. package/dist/components/Link.svelte.d.ts +30 -0
  70. package/dist/components/MapEmbed.svelte +154 -0
  71. package/dist/components/MapEmbed.svelte.d.ts +28 -0
  72. package/dist/components/MediaImage.svelte +218 -0
  73. package/dist/components/MediaImage.svelte.d.ts +128 -0
  74. package/dist/components/MediaVideo.svelte +103 -0
  75. package/dist/components/MediaVideo.svelte.d.ts +20 -0
  76. package/dist/components/RichText.svelte +105 -0
  77. package/dist/components/RichText.svelte.d.ts +55 -0
  78. package/dist/components/Seo.svelte +89 -0
  79. package/dist/components/Seo.svelte.d.ts +45 -0
  80. package/dist/components/SiteFooterLegal.svelte +75 -0
  81. package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
  82. package/dist/components/SiteHead.svelte +79 -0
  83. package/dist/components/SiteHead.svelte.d.ts +32 -0
  84. package/dist/components/Text.svelte +100 -0
  85. package/dist/components/Text.svelte.d.ts +55 -0
  86. package/dist/components/Tracking.svelte +30 -0
  87. package/dist/components/Tracking.svelte.d.ts +14 -0
  88. package/dist/components/Zeitfenster.svelte +92 -0
  89. package/dist/components/Zeitfenster.svelte.d.ts +34 -0
  90. package/dist/components/legal.d.ts +12 -0
  91. package/dist/components/legal.js +27 -0
  92. package/dist/config/index.d.ts +121 -0
  93. package/dist/config/index.js +602 -0
  94. package/dist/config/static/index.d.ts +3 -0
  95. package/dist/config/static/index.js +5 -0
  96. package/dist/config/static/lines.d.ts +9 -0
  97. package/dist/config/static/lines.js +22 -0
  98. package/dist/config/static/literal.d.ts +45 -0
  99. package/dist/config/static/literal.js +175 -0
  100. package/dist/config/static/siteConfig.d.ts +39 -0
  101. package/dist/config/static/siteConfig.js +150 -0
  102. package/dist/consent/consent.svelte.d.ts +91 -0
  103. package/dist/consent/consent.svelte.js +221 -0
  104. package/dist/content/index.d.ts +123 -0
  105. package/dist/content/index.js +247 -0
  106. package/dist/contentBlock.d.ts +45 -0
  107. package/dist/contentBlock.js +78 -0
  108. package/dist/csp/index.d.ts +27 -0
  109. package/dist/csp/index.js +74 -0
  110. package/dist/external/csp.d.ts +25 -0
  111. package/dist/external/csp.js +104 -0
  112. package/dist/external/hosts.d.ts +30 -0
  113. package/dist/external/hosts.js +128 -0
  114. package/dist/external/presets.d.ts +54 -0
  115. package/dist/external/presets.js +212 -0
  116. package/dist/external/resolve.d.ts +39 -0
  117. package/dist/external/resolve.js +254 -0
  118. package/dist/index.d.ts +32 -0
  119. package/dist/index.js +32 -0
  120. package/dist/internal/consentNeed.d.ts +21 -0
  121. package/dist/internal/consentNeed.js +50 -0
  122. package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
  123. package/dist/internal/dealsystem-legal-imprint.js +5 -0
  124. package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
  125. package/dist/internal/dealsystem-legal-privacy.js +5 -0
  126. package/dist/internal/dealsystem-site-data.d.ts +3 -0
  127. package/dist/internal/dealsystem-site-data.js +2 -0
  128. package/dist/internal/imprint.d.ts +4 -0
  129. package/dist/internal/imprint.js +10 -0
  130. package/dist/internal/mediaImage.d.ts +15 -0
  131. package/dist/internal/mediaImage.js +22 -0
  132. package/dist/internal/privacy.d.ts +4 -0
  133. package/dist/internal/privacy.js +10 -0
  134. package/dist/internal/providers.d.ts +9 -0
  135. package/dist/internal/providers.js +44 -0
  136. package/dist/internal/reload.d.ts +2 -0
  137. package/dist/internal/reload.js +5 -0
  138. package/dist/internal/seo.d.ts +41 -0
  139. package/dist/internal/seo.js +79 -0
  140. package/dist/internal/siteData.d.ts +7 -0
  141. package/dist/internal/siteData.js +39 -0
  142. package/dist/internal/usage.d.ts +7 -0
  143. package/dist/internal/usage.js +13 -0
  144. package/dist/keys.d.ts +20 -0
  145. package/dist/keys.js +58 -0
  146. package/dist/leadmagnet.d.ts +16 -0
  147. package/dist/leadmagnet.js +28 -0
  148. package/dist/paths.d.ts +8 -0
  149. package/dist/paths.js +9 -0
  150. package/dist/richtext/escape.d.ts +4 -0
  151. package/dist/richtext/escape.js +18 -0
  152. package/dist/richtext/server.d.ts +16 -0
  153. package/dist/richtext/server.js +123 -0
  154. package/dist/schedule.d.ts +23 -0
  155. package/dist/schedule.js +67 -0
  156. package/dist/slots.d.ts +9 -0
  157. package/dist/slots.js +38 -0
  158. package/dist/snapshot.d.ts +14 -0
  159. package/dist/snapshot.js +214 -0
  160. package/dist/types.d.ts +550 -0
  161. package/dist/types.js +4 -0
  162. package/dist/version.d.ts +2 -0
  163. package/dist/version.js +2 -0
  164. package/dist/vite/index.d.ts +85 -0
  165. package/dist/vite/index.js +641 -0
  166. package/dist/vite/scan.d.ts +47 -0
  167. package/dist/vite/scan.js +355 -0
  168. package/dist/vite/zeitfenster.d.ts +18 -0
  169. package/dist/vite/zeitfenster.js +76 -0
  170. package/docs/ablauf.md +191 -0
  171. package/docs/agents-block.md +101 -0
  172. package/docs/befehle.md +103 -0
  173. package/docs/extern.md +143 -0
  174. package/docs/gestaltung.md +139 -0
  175. package/docs/inhalte.md +224 -0
  176. package/docs/komponenten.md +1273 -0
  177. package/docs/konfiguration.md +310 -0
  178. package/docs/llms.txt +19 -0
  179. package/docs/rechtstexte.md +84 -0
  180. package/docs/regeln.md +108 -0
  181. package/docs/seo.md +55 -0
  182. package/docs/termine.md +73 -0
  183. package/package.json +115 -5
package/README.md CHANGED
@@ -1,3 +1,146 @@
1
- # Temporary Holding Version
1
+ # @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
+ Bausteine für Self-Service-Websites auf DealSystem: Svelte-5-Komponenten, Lade-Helfer für den Build, ein
4
+ Vite-Plugin und die Konfiguration. Die Seite ist statisch (`@sveltejs/adapter-static`), enthält kein Secret
5
+ und spricht das CRM nur über die öffentliche Site-API an.
6
+
7
+ ## Einstiegspunkte
8
+
9
+ | Import | Inhalt |
10
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------- |
11
+ | `@dealsystem/site` | Komponenten, `consent`, `loadCollection`, `loadEntry` |
12
+ | `@dealsystem/site/content` | `getCollection`, `getEntry`, `collectionEntries`, `getSlots`, `getSite`, `sitemap`, `robots` (nur beim Build) |
13
+ | `@dealsystem/site/config` | `defineSite`, `validateSiteConfig`, `handleHttpError`, `siteApiOrigin` |
14
+ | `@dealsystem/site/vite` | `dealsystem(site)` |
15
+
16
+ ## Einrichtung
17
+
18
+ ```ts
19
+ // dealsystem.config.ts
20
+ import { defineSite } from '@dealsystem/site/config';
21
+
22
+ export default defineSite({
23
+ siteId: '…',
24
+ funnels: {
25
+ kontakt: {
26
+ label: 'Kontakt',
27
+ fields: [
28
+ { name: 'email', type: 'email', standardField: 'email', required: true },
29
+ { name: 'nachricht', type: 'textarea' },
30
+ ],
31
+ },
32
+ },
33
+ });
34
+ ```
35
+
36
+ ```ts
37
+ // vite.config.ts — dealsystem() steht vor sveltekit()
38
+ import { sveltekit } from '@sveltejs/kit/vite';
39
+ import { dealsystem } from '@dealsystem/site/vite';
40
+ import { defineConfig } from 'vite';
41
+ import site from './dealsystem.config';
42
+
43
+ export default defineConfig({ plugins: [dealsystem(site), sveltekit()] });
44
+ ```
45
+
46
+ ```js
47
+ // svelte.config.js
48
+ import adapter from '@sveltejs/adapter-static';
49
+ import { handleHttpError } from '@dealsystem/site/config';
50
+
51
+ export default {
52
+ kit: { adapter: adapter({ fallback: '404.html' }), prerender: { handleHttpError } },
53
+ };
54
+ ```
55
+
56
+ ```ts
57
+ // src/dealsystem.d.ts — macht funnel- und collection-Schlüssel zu geprüften Typen
58
+ import type site from '../dealsystem.config';
59
+
60
+ declare global {
61
+ interface DealsystemSiteTypes {
62
+ config: typeof site;
63
+ }
64
+ }
65
+
66
+ export {};
67
+ ```
68
+
69
+ ## Komponenten
70
+
71
+ | Komponente | Zweck |
72
+ | ----------------------------------------------- | ------------------------------------------------------------------------- |
73
+ | `<LeadForm funnel>` | Formular mit Beschriftungen, Fehlertexten, Honeypot, Captcha und Versand |
74
+ | `<Text key default>` | kurzer Text, im CRM änderbar |
75
+ | `<RichText key default>` / `<RichText content>` | formatierter Text, geprüft |
76
+ | `<MediaImage src\|media\|key alt>` | Bild; `alt` ist Pflicht, leer nur mit `decorative` |
77
+ | `<MediaVideo media title>` | Video mit Bedienelementen |
78
+ | `<MapEmbed lat lon title>` | Karte von OpenStreetMap, lädt erst nach Zustimmung |
79
+ | `<CollectionList collection entries>` | Liste von CMS-Einträgen |
80
+ | `<CookieBanner />`, `<ConsentGate category>` | Einwilligung, nur wenn nötig; vorher lädt nichts von Dritten |
81
+ | `<Tracking />` | Meta Pixel und Google Tag, nur in `<ConsentGate category="marketing">` |
82
+ | `<Impressum />`, `<Datenschutz />` | geben den Rechtstext des Kunden aus dem CRM aus; das Paket erzeugt keinen |
83
+ | `<SiteFooterLegal />` | Pflicht-Links und „Cookie-Einstellungen“ |
84
+ | `<Seo title description image />` | Titel, Beschreibung, Vorschaubild je Seite; das CRM kann sie ersetzen |
85
+ | `<SiteHead favicon />` | Favicon und `noindex` aus dem CRM, einmal im Layout |
86
+
87
+ Jede Komponente und Funktion trägt ihre Beschreibung mit Beispiel im Quelltext.
88
+
89
+ ## Gestaltung
90
+
91
+ Die Komponenten erben Schrift und Textfarbe der Seite. Diese CSS-Variablen ändern den Rest:
92
+
93
+ | Variable | Standard | Wirkt auf |
94
+ | ---------------------------------------------- | --------------------- | ------------------------ |
95
+ | `--ds-color-primary` / `--ds-color-on-primary` | `#1a1a1a` / `#ffffff` | Schaltflächen |
96
+ | `--ds-color-text` / `--ds-color-surface` | `#1a1a1a` / `#ffffff` | Formular, Cookie-Hinweis |
97
+ | `--ds-color-border` | `#6b6b6b` | Eingabefelder |
98
+ | `--ds-color-error` | `#b3261e` | Fehlertexte |
99
+ | `--ds-color-focus` | `#1a56db` | Fokusrahmen |
100
+ | `--ds-radius` | `4px` | Ecken |
101
+
102
+ Die Standardwerte erfüllen die Kontraste von WCAG 2.1 AA. Wer sie ändert, prüft die Kontraste neu.
103
+
104
+ ## Umgebung
105
+
106
+ | Variable | Gesetzt von | Bedeutung |
107
+ | ----------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------- |
108
+ | `DEALSYSTEM_CONTENT_FILE` | Build-Host | Pfad des Inhalts-Schnappschusses. Lokal: `.dealsystem/content.json` |
109
+ | `DEALSYSTEM_MANIFEST_FILE` | Build-Host | Zielpfad des Manifests. Lokal: `.dealsystem/manifest.json` |
110
+ | `PUBLIC_DEALSYSTEM_API`, `PUBLIC_DEALSYSTEM_SITE_KEY`, `PUBLIC_DEALSYSTEM_SITE_URL` | Build-Host | Zugang zur Site-API. Ohne sie antwortet der Dev-Server selbst (Schlüssel `dev`) |
111
+
112
+ ## Captcha und Content-Security-Policy
113
+
114
+ Formulare schützt ALTCHA, ein Proof-of-Work-Verfahren ohne Drittanbieter. Beim ersten Kontakt mit dem
115
+ Formular holt der Browser eine Rechenaufgabe von der Site-API (`GET …/captcha`) und löst sie unsichtbar im
116
+ Hintergrund; die Lösung geht als `captcha` mit der Anfrage. Dafür ist keine Einwilligung nötig. Das Paket
117
+ bringt die Worker für `PBKDF2/SHA-*` und `SHA-*` mit; andere Algorithmen kann die Seite nicht lösen.
118
+
119
+ Was die CSP der Seite dafür braucht (in einem echten Browser geprüft):
120
+
121
+ | Direktive | Wert | Wofür |
122
+ | ------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------ |
123
+ | `worker-src` | `'self'` | Worker des Captchas, eigene Dateien der Seite, kein `blob:` |
124
+ | `connect-src` | `'self'` und `siteApiOrigin()` | Aufgabe holen, Formular senden; die Adresse der Site-API kommt aus `PUBLIC_DEALSYSTEM_API` |
125
+ | `frame-src` | `'self'` und `https://www.openstreetmap.org` | Karte über `<MapEmbed />`, nur nach Zustimmung |
126
+ | `style-src` | `'self' 'unsafe-inline'` | Stil-Attribute von SvelteKit und vom Captcha-Widget |
127
+
128
+ `<Tracking />` braucht zusätzlich die Adressen von Google Tag und Meta Pixel in `script-src`, `connect-src`
129
+ und `img-src`.
130
+
131
+ ## Marker im fertigen HTML
132
+
133
+ Für Prüfungen an der Ausgabe setzen die Komponenten feste Attribute: `data-ds-cookie-banner`,
134
+ `data-ds-footer-legal`, `data-ds-impressum`, `data-ds-datenschutz`, `data-ds-lead-form="<funnel>"`,
135
+ `data-ds-image` (am `<img>`), `data-ds-video`, `data-ds-richtext`, `data-ds-collection="<key>"`, `data-ds-slot="<key>"`.
136
+
137
+ ## Anleitungen für Agenten
138
+
139
+ `docs/` enthält die Anleitungen, die ein KI-Agent im Kundenprojekt liest (`agents-block.md`, Detailseiten,
140
+ `llms.txt`). Sie werden mit `npm run docs` im Repo-Root aus dem Code und aus `docs-src/` erzeugt und nie von
141
+ Hand geändert.
142
+
143
+ ## Vertrag
144
+
145
+ `contract/site-api.v1.json` ist die Kopie des Vertrags aus dem Core, gegen die der Client getestet ist
146
+ (siehe `contract/README.md`).
@@ -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,54 @@
1
+ ---
2
+ name: erster-entwurf
3
+ description: Der Anfang mit einem neuen Kunden, von der ersten Nachricht bis zum ersten Entwurf, den er auf seinem Rechner sieht. Verwenden, wenn eine Website neu entsteht oder der Kunde zum ersten Mal mit dir spricht, bevor irgendetwas gebaut oder hochgeladen wird.
4
+ ---
5
+
6
+ # Erster Entwurf: fragen, lokal zeigen, erst dann hochladen
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md` (Schritte 0, 4 und 6).
9
+
10
+ ## 1. Erste Nachricht: genau eine Frage
11
+
12
+ > Wie möchtest du vorgehen? (a) Wir besprechen kurz deine Seite, ich stelle dir ein paar Fragen nacheinander.
13
+ > (b) Ich lege einfach los und baue dir aus dem, was ich habe, einen ersten Entwurf.
14
+
15
+ Bau, lade und frag nichts anderes, bevor er geantwortet hat. Keine Bitte um die Anmeldung in derselben
16
+ Nachricht.
17
+
18
+ ## 2a. Kurz besprechen
19
+
20
+ Höchstens fünf Fragen, **je eine pro Nachricht**, in einfachen Worten. Überspring, was er schon gesagt hat:
21
+
22
+ 1. Was soll die Seite erreichen (z. B. Verkäufer finden, Anfragen zu Objekten, Vertrauen aufbauen)?
23
+ 2. Wen möchtest du damit ansprechen?
24
+ 3. Wie soll sie wirken? Gibt es eine Seite, die dir gefällt?
25
+ 4. Welche Fotos hast du (Porträt, Team, Objekte)? Schick sie mir gern.
26
+ 5. Welche Seiten brauchst du (z. B. Start, Leistungen, Über mich, Kontakt)?
27
+
28
+ ## 2b. Einfach loslegen
29
+
30
+ Nimm, was du hast: was er geschrieben hat, Dateien im Projektordner (Fotos mit `npx dealsystem image add`,
31
+ Skill `bild-einbauen`), eine bestehende Website oder ein Profil, **nur wenn er die Adresse nennt**, und die
32
+ Firmendaten aus `npx dealsystem sync` (`data.site`). Daraus ein erster Entwurf.
33
+
34
+ - Erfinde nichts (AGENTS.md): Was fehlt, steht als sichtbarer Platzhalter da, z. B. „[Hier kommt Ihr Porträt]“
35
+ oder „[Ihre Leistungen in zwei Sätzen]“, als `<Text>` mit festem `key`, damit er es später im CRM tauscht.
36
+ - Behaupte nicht, du kennst frühere Gespräche oder andere Chats.
37
+
38
+ ## 3. Lokal zeigen und gemeinsam ändern
39
+
40
+ `npm run dev` starten und ihm die Adresse geben, die der Befehl anzeigt (meist `http://localhost:5173`):
41
+ „Dein erster Entwurf läuft auf deinem Rechner: http://localhost:5173. Sag mir, was ich ändern soll.“ Ändere,
42
+ bis er zufrieden ist. Prüfen (`npm run check`, `npm run build`, `npx dealsystem check --output build`) gehört
43
+ dazu, aber nicht in die Nachricht an ihn.
44
+
45
+ **Läufst du nicht auf seinem Rechner** (etwa als Agent in der Cloud), kann er localhost nicht öffnen. Sag das in
46
+ einem Satz und zeig ihm stattdessen gleich die Vorschau (Schritt 4).
47
+
48
+ ## 4. Hochladen erst nach seinem Okay
49
+
50
+ Erst wenn er zum lokalen Stand ausdrücklich Ja sagt („passt, zeig es online“): `npx dealsystem deploy -m "…"`
51
+ und ihm die Vorschau-Adresse geben. Die Seite läuft zuerst unter einer Adresse wie `<name>.dealsystem.site`;
52
+ eine eigene Domain kann er später verbinden (Eigene Website → Domains, Skill `domain-verbinden`).
53
+
54
+ Veröffentlichen ist ein eigener Schritt mit einem eigenen Ja zu genau dieser Vorschau: Skill `veroeffentlichen`.
@@ -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>