@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
@@ -0,0 +1,310 @@
1
+ <!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
2
+
3
+ # dealsystem.config.ts (@dealsystem/site/config)
4
+
5
+ Eine Datei beschreibt die Seite: ihre Kennung, die Sammlungen (Inhalte aus dem CMS) und die Formulare.
6
+ Felder eines Formulars stehen nur hier. Nach einer Änderung an Sammlungen: `npx dealsystem sync`.
7
+
8
+ ### defineSite()
9
+
10
+ Beschreibt die Seite: Kennung, Sammlungen, Formulare und fremde Dienste (`external`). Steht in
11
+ `dealsystem.config.ts` im Projektordner. Aus dem Rückgabetyp entstehen die
12
+ Typen für `funnel` und `collection` — ein Tippfehler ist ein Typfehler.
13
+ Wirft mit einer Liste aller Probleme, wenn die Konfiguration ungültig ist.
14
+
15
+ ```ts
16
+ import { defineSite } from '@dealsystem/site/config';
17
+
18
+ export default defineSite({
19
+ siteId: '…',
20
+ funnels: {
21
+ kontakt: {
22
+ label: 'Kontakt',
23
+ fields: [
24
+ { name: 'email', type: 'email', standardField: 'email', required: true },
25
+ { name: 'nachricht', type: 'textarea' },
26
+ ],
27
+ },
28
+ },
29
+ });
30
+ ```
31
+
32
+ ```ts
33
+ function defineSite<const T extends SiteConfig>(config: T): T;
34
+ ```
35
+
36
+ ### validateSiteConfig()
37
+
38
+ Prüft eine Konfiguration und liefert alle Probleme als Liste.
39
+ Leere Liste heißt: gültig. `defineSite` ruft das auf und wirft; nur eine
40
+ fehlende `siteId` lässt es durch, damit die Seite vor `dealsystem init` läuft.
41
+
42
+ ```ts
43
+ const problems = validateSiteConfig(config);
44
+ if (problems.length > 0) console.log(problems[0].message);
45
+ ```
46
+
47
+ ```ts
48
+ function validateSiteConfig(config: unknown): ConfigProblem[];
49
+ ```
50
+
51
+ ### handleHttpError()
52
+
53
+ Für `kit.prerender.handleHttpError` in `svelte.config.js`. Bilder aus dem CRM
54
+ (`/_ds/media/…`) liefert erst der DealSystem-Server aus; beim Build gibt es
55
+ sie nicht. Diese Funktion lässt genau das durch und bricht bei jedem anderen
56
+ toten Link weiter mit einer Fehlermeldung ab.
57
+
58
+ ```ts
59
+ // svelte.config.js
60
+ import adapter from '@sveltejs/adapter-static';
61
+ import { handleHttpError } from '@dealsystem/site/config';
62
+
63
+ export default {
64
+ kit: {
65
+ adapter: adapter({ fallback: '404.html' }),
66
+ prerender: { handleHttpError },
67
+ },
68
+ };
69
+ ```
70
+
71
+ ```ts
72
+ function handleHttpError(details: {
73
+ status: number;
74
+ path: string;
75
+ referrer: string | null;
76
+ message: string;
77
+ }): void;
78
+ ```
79
+
80
+ ### siteApiOrigin()
81
+
82
+ Für `connect-src` in der Content-Security-Policy von `svelte.config.js`:
83
+ die Adresse, unter der die Seite ihre Formulare an DealSystem schickt. Der
84
+ Server, der die Seite erzeugt, nennt sie in `PUBLIC_DEALSYSTEM_API`; ohne
85
+ Angabe gilt die Adresse von DealSystem. So passt die Seite auch dann, wenn
86
+ sie für eine Test-Umgebung erzeugt wird.
87
+
88
+ ```ts
89
+ // svelte.config.js
90
+ import { siteApiOrigin } from '@dealsystem/site/config';
91
+
92
+ // … in kit.csp.directives:
93
+ // 'connect-src': ['self', siteApiOrigin()],
94
+ ```
95
+
96
+ ```ts
97
+ function siteApiOrigin(): string;
98
+ ```
99
+
100
+ ## Typen
101
+
102
+ ### SiteConfig
103
+
104
+ Inhalt von `dealsystem.config.ts`.
105
+
106
+ ```ts
107
+ interface SiteConfig {
108
+ /** Kennung der Seite im CRM. `npx dealsystem init` trägt sie ein. */
109
+ siteId: string;
110
+ collections?: Readonly<Record<string, CollectionDef>>;
111
+ funnels?: Readonly<Record<string, FunnelDef>>;
112
+ /** Fremde Dienste (Videos, Chat, Skripte). Nur was hier steht, lässt die Seite zu. */
113
+ external?: Readonly<Record<string, ExternalDef>>;
114
+ /** Terminbuchungen für `<Booker>` und `createBookingClient`, je Schlüssel. */
115
+ booking?: Readonly<Record<string, BookingDef>>;
116
+ }
117
+ ```
118
+
119
+ ### FunnelDef
120
+
121
+ Ein Formular in `dealsystem.config.ts`.
122
+
123
+ ```ts
124
+ interface FunnelDef {
125
+ label: string;
126
+ fields: readonly FunnelFieldDef[];
127
+ /** Vorschlag, was im CRM mit der Anfrage passiert (Deal, Pipeline, Tags, Bestätigung). */
128
+ crm?: FunnelCrmConfig;
129
+ /** Datei, die das Formular verspricht. `<LeadForm>` kündigt sie nach dem Absenden an. */
130
+ leadmagnet?: FunnelLeadmagnetConfig;
131
+ }
132
+ ```
133
+
134
+ ### FunnelFieldDef
135
+
136
+ Ein Feld eines Formulars in `dealsystem.config.ts`.
137
+
138
+ ```ts
139
+ interface FunnelFieldDef {
140
+ /** Technischer Name, z. B. `nachricht`. Nur Buchstaben, Ziffern, `_`. */
141
+ name: string;
142
+ type: FieldType;
143
+ /** Sichtbare Beschriftung. Fehlt sie, wird der Name verwendet. */
144
+ label?: string;
145
+ required?: boolean;
146
+ /** Auswahlwerte für `select` und `multiselect`. */
147
+ options?: readonly string[];
148
+ /** Ordnet das Feld einem Kontaktfeld im CRM zu. */
149
+ standardField?: StandardFieldKey;
150
+ placeholder?: string;
151
+ /** Hilfetext unter dem Feld. */
152
+ help?: string;
153
+ maxLength?: number;
154
+ /** Nur bei `type: 'hidden'`: woher der Wert kommt. */
155
+ from?: HiddenFieldSource;
156
+ }
157
+ ```
158
+
159
+ ### FieldType
160
+
161
+ Feldtypen eines Formulars. `hidden` sieht der Besucher nicht; das SDK füllt es beim Absenden (`from`).
162
+
163
+ ```ts
164
+ type FieldType =
165
+ 'text' | 'email' | 'tel' | 'textarea' | 'select' | 'multiselect' | 'checkbox' | 'date' | 'hidden';
166
+ ```
167
+
168
+ ### HiddenFieldSource
169
+
170
+ Woher ein verstecktes Feld (`type: 'hidden'`) seinen Wert nimmt, genau eine Angabe:
171
+ - `{ query: 'partner' }` – URL-Parameter `?partner=…` (aktueller Besuch, gespeichert nur mit Einwilligung)
172
+ - `{ utm: 'campaign' }` – UTM-Angabe des Besuchs (`utm_campaign`)
173
+ - `{ value: 'Bewertungsrechner' }` – fester Text
174
+
175
+ Höchstens 500 Zeichen. Im CRM lässt sich das Feld einem eigenen Feld zuordnen, nie einem Standardfeld.
176
+
177
+ ```ts
178
+ type HiddenFieldSource = { query: string } | { utm: UtmKey } | { value: string };
179
+ ```
180
+
181
+ ### FunnelCrmConfig
182
+
183
+ Was mit einer Anfrage im CRM passiert, als Vorschlag aus dem Code. Der Kunde kann jede Angabe im CRM ändern;
184
+ ab dann gilt seine, auch nach dem nächsten Hochladen („Code legt vor, CRM entscheidet“). Namen (Pipeline,
185
+ Phase, Tags, Lead-Quelle) sucht das CRM im Workspace; was es dort nicht gibt, legt es nicht an, sondern meldet
186
+ es als Warnung beim Hochladen.
187
+
188
+ ```ts
189
+ interface FunnelCrmConfig {
190
+ /** Einen Deal anlegen. */
191
+ createDeal?: boolean;
192
+ /** Pipeline des Deals, Name oder ID, höchstens 100 Zeichen. */
193
+ pipeline?: string;
194
+ /** Phase in der Pipeline, Name oder ID, höchstens 100 Zeichen. */
195
+ stage?: string;
196
+ /**
197
+ * Name des Deals, höchstens 200 Zeichen. Platzhalter: `{{firstName}}`, `{{lastName}}`, `{{email}}`,
198
+ * `{{phone}}`, `{{adresse}}`.
199
+ */
200
+ dealName?: string;
201
+ /** Tags am Kontakt, höchstens 20, je höchstens 50 Zeichen. */
202
+ tags?: readonly string[];
203
+ /** Lead-Quelle, Name oder ID, höchstens 100 Zeichen. */
204
+ leadSource?: string;
205
+ /**
206
+ * Eingangsbestätigung an den Absender. Betreff höchstens 200, Text höchstens 5 000 Zeichen, nur Klartext,
207
+ * Platzhalter `{{firstName}}`, `{{lastName}}`, `{{formName}}`. Ohne Betreff oder Text gilt der Standard.
208
+ */
209
+ confirmation?: { enabled: boolean; subject?: string; body?: string };
210
+ }
211
+ ```
212
+
213
+ ### FunnelLeadmagnetConfig
214
+
215
+ Leadmagnet: Das Formular verspricht eine Datei (z. B. einen Ratgeber als PDF). Im Code steht nur, **was**
216
+ versprochen wird. Die Datei lädt der Kunde im CRM hoch (Eigene Website → Formulare); das CRM schickt den
217
+ Download-Link in der Eingangsbestätigung; die muss dort eingeschaltet sein (oder `crm.confirmation`). Kein Feld
218
+ für Datei, Pfad oder Link: so etwas ist ein Fehler.
219
+
220
+ ```ts
221
+ ratgeber: { label: 'Ratgeber', fields: [...], leadmagnet: { label: 'Ratgeber Immobilienverkauf' } }
222
+ ```
223
+
224
+ ```ts
225
+ interface FunnelLeadmagnetConfig {
226
+ /** Name der Datei für Besucher, 1 bis 120 Zeichen, z. B. „Ratgeber Immobilienverkauf“. Kein Link. */
227
+ label: string;
228
+ }
229
+ ```
230
+
231
+ ### StandardFieldKey
232
+
233
+ Kontakt-Standardfelder im CRM. Namen immer getrennt als `firstName` und
234
+ `lastName`. Jedes Formular braucht ein Feld mit `email` oder `phone`.
235
+
236
+ ```ts
237
+ type StandardFieldKey =
238
+ 'firstName' | 'lastName' | 'email' | 'phone' | 'address1' | 'postalCode' | 'city';
239
+ ```
240
+
241
+ ### BookingDef
242
+
243
+ Eine Terminbuchung in `dealsystem.config.ts` (`booking`). Die Terminart selbst (Dauer, Arbeitszeiten, Fragen)
244
+ richtet der Kunde im CRM unter Termine ein, oder der Agent über die MCP-Werkzeuge; hier steht nur die Zuordnung.
245
+
246
+ ```ts
247
+ interface BookingDef {
248
+ /** Bezeichnung auf der Seite und im CRM, z. B. „Erstgespräch“. Ohne Angabe gilt der Name der Terminart. */
249
+ label?: string;
250
+ /**
251
+ * Kurzname (Slug) der Terminart im CRM, z. B. `erstgespraech`. Wird beim Hochladen zugeordnet, wenn genau eine
252
+ * aktive Terminart so heißt; sonst wählt der Kunde sie im CRM. Nie erfinden: nur einen Slug, den es gibt.
253
+ */
254
+ eventType?: string;
255
+ }
256
+ ```
257
+
258
+ ### CollectionDef
259
+
260
+ Eine Sammlung in `dealsystem.config.ts`.
261
+
262
+ ```ts
263
+ interface CollectionDef {
264
+ /** Quelle der Einträge. Bisher nur das CMS. */
265
+ source?: 'cms';
266
+ label: string;
267
+ /** Route eines Eintrags, z. B. `/angebote/:slug`. */
268
+ route: string;
269
+ /** Übersichtsseite, z. B. `/angebote`. */
270
+ indexRoute?: string;
271
+ /** Feld, aus dem das CMS den Slug vorschlägt. Standard: das erste Textfeld. */
272
+ slugFrom?: string;
273
+ fields: readonly CollectionFieldDef[];
274
+ }
275
+ ```
276
+
277
+ ### CollectionFieldDef
278
+
279
+ Ein Feld einer Sammlung in `dealsystem.config.ts`.
280
+
281
+ ```ts
282
+ interface CollectionFieldDef {
283
+ name: string;
284
+ type: CollectionFieldType;
285
+ label?: string;
286
+ required?: boolean;
287
+ options?: readonly string[];
288
+ maxItems?: number;
289
+ }
290
+ ```
291
+
292
+ ### CollectionFieldType
293
+
294
+ Feldtypen eines CMS-Eintrags.
295
+
296
+ ```ts
297
+ type CollectionFieldType =
298
+ | 'text'
299
+ | 'textarea'
300
+ | 'richtext'
301
+ | 'number'
302
+ | 'url'
303
+ | 'date'
304
+ | 'checkbox'
305
+ | 'select'
306
+ | 'multiselect'
307
+ | 'image'
308
+ | 'gallery'
309
+ | 'file';
310
+ ```
package/docs/llms.txt ADDED
@@ -0,0 +1,19 @@
1
+ # @dealsystem/site 0.2.1
2
+
3
+ > Bausteine, Lade-Helfer und Regeln für statische SvelteKit-Websites, die DealSystem baut und hostet. Geschrieben für KI-Agenten, die im Auftrag eines Kunden ohne technische Vorkenntnisse arbeiten. Sprache: Deutsch.
4
+
5
+ Beginne mit agents-block.md. Die übrigen Seiten sind Nachschlagewerke zu je einem Thema.
6
+
7
+ ## Anleitung
8
+
9
+ - [agents-block.md](agents-block.md): Regeln, Ablauf und Gesprächsführung; steht auch in AGENTS.md des Projekts
10
+ - [ablauf.md](ablauf.md): Weg bis zur veröffentlichten Seite
11
+ - [komponenten.md](komponenten.md): Bausteine mit Pflichtangaben und Beispielen
12
+ - [inhalte.md](inhalte.md): Sammlungen (Angebote) laden
13
+ - [konfiguration.md](konfiguration.md): Formulare, Sammlungen, Termine
14
+ - [gestaltung.md](gestaltung.md): Farben, Schrift, Bilder, Barrierefreiheit
15
+ - [rechtstexte.md](rechtstexte.md): Impressum, Datenschutz, Cookie-Hinweis
16
+ - [extern.md](extern.md): fremde Dienste: Videos, Widgets, Skripte
17
+ - [seo.md](seo.md): Titel, Vorschaubild, Favicon, noindex
18
+ - [regeln.md](regeln.md): Prüfregeln mit Korrektur
19
+ - [befehle.md](befehle.md): Befehle mit Optionen
@@ -0,0 +1,84 @@
1
+ # Impressum, Datenschutz und Einwilligung
2
+
3
+ ## Wer die Texte schreibt
4
+
5
+ Impressum und Datenschutzerklärung schreibt und verantwortet **der Kunde**. Er trägt sie im CRM unter
6
+ Eigene Website → Rechtliches ein. DealSystem liefert keine vorformulierten Rechtstexte, und du schreibst auch
7
+ keine: nicht als Vorschlag, nicht als Platzhalter, nicht im Code. Frag der Kunde danach, verweise ihn auf
8
+ seinen Anwalt oder einen Generator seiner Wahl; den fertigen Text fügt er im CRM ein.
9
+
10
+ Für den Teil „Hosting“ bietet das CRM an derselben Stelle einen sachlichen Baustein „Hosting durch
11
+ DealSystem“ an (wer die Seite ausliefert, wo, welche Zugriffsdaten dabei anfallen). Der Kunde kann ihn mit
12
+ einem Klick in seinen Datenschutztext übernehmen. Maßgeblich ist der Wortlaut im CRM.
13
+
14
+ ## Was die Seite braucht
15
+
16
+ - `src/routes/impressum/+page.svelte` mit `<Impressum />`
17
+ - `src/routes/datenschutz/+page.svelte` mit `<Datenschutz />`
18
+ - im Layout `<SiteFooterLegal />` (Links zu beiden Seiten und „Cookie-Einstellungen“) und `<CookieBanner />`
19
+
20
+ Der Starter enthält das alles. Entferne nichts davon (`PRV-004`, `PRV-005`).
21
+
22
+ `<Impressum />` und `<Datenschutz />` geben genau den Text aus dem CRM aus. Überschriften im Text des
23
+ Kunden ordnen sie von selbst unter die Überschrift der Seite ein.
24
+
25
+ ## Wenn ein Text fehlt
26
+
27
+ Solange der Kunde einen Text nicht eingetragen hat, zeigt die Vorschau an seiner Stelle einen Hinweis, wo er
28
+ einzutragen ist. Veröffentlichen lässt sich die Seite dann nicht: `npx dealsystem publish` meldet, welche
29
+ Angaben fehlen. Pflicht sind Impressum, Datenschutzerklärung, Firmenname und E-Mail-Adresse. Die
30
+ Telefonnummer ist freiwillig.
31
+
32
+ Sag dem Kunden in einem Satz, was fehlt und wo er es einträgt. Nach dem Eintragen: `npx dealsystem sync`,
33
+ neu hochladen, die neue Vorschau zeigen und **erneut fragen**, ob die Seite veröffentlicht werden soll.
34
+ Jede neue Vorschau braucht ein neues ausdrückliches Ja; die frühere Zustimmung galt dem Stand ohne die
35
+ Texte.
36
+
37
+ ## Firmendaten auf der Seite
38
+
39
+ Firmenname, Adresse, E-Mail und Telefon aus dem CRM liefert `getSite()` (siehe `inhalte.md`). Im Starter
40
+ stehen sie auf jeder Seite als `data.site` bereit:
41
+
42
+ ```svelte
43
+ <script lang="ts">
44
+ let { data } = $props();
45
+ </script>
46
+
47
+ {#if data.site.address}<p>{data.site.address}</p>{/if}
48
+ {#if data.site.phone}<p><a href="tel:{data.site.phone.replace(/[^+0-9]/g, '')}">{data.site.phone}</a></p>{/if}
49
+ {#if data.site.email}<p><a href="mailto:{data.site.email}">{data.site.email}</a></p>{/if}
50
+ ```
51
+
52
+ Das Formular zeigt sie von selbst als Ausweichkontakt, wenn das Senden scheitert. Schreibe Adresse,
53
+ Telefonnummer und E-Mail-Adresse nie fest in den Code, auch wenn der Kunde sie dir im Gespräch nennt
54
+ (`CNT-002`): Ändert er sie im CRM, soll die Seite folgen. Bitte ihn stattdessen, sie im CRM unter
55
+ Eigene Website → Rechtliches einzutragen. Ein Feld, das dort leer ist, lässt du auf der Seite weg.
56
+
57
+ ## Einwilligung
58
+
59
+ - Vor der Entscheidung des Besuchers lädt die Seite nichts von fremden Servern und speichert nur seine Wahl.
60
+ - „Alle ablehnen“ und „Alle akzeptieren“ sind gleich gestaltet. Ändere das nicht.
61
+ - Tracking: nur `<ConsentGate category="marketing"><Tracking /></ConsentGate>`. Keine eigenen Pixel-Snippets.
62
+ - Karte: `<MapEmbed lat={…} lon={…} title="…" />` (OpenStreetMap). Sie fragt selbst nach der Zustimmung.
63
+ - Andere fremde Dienste (YouTube, Vimeo, Google Maps, Widgets, Chat) stehen unter `external` in
64
+ `dealsystem.config.ts` und kommen über `<Embed>` oder `<ExternalScript>` auf die Seite (`extern.md`). Der
65
+ Hinweis nennt sie je Zweck mit Anbieter und Datenschutz-Link. Der Kunde muss sie in seiner
66
+ Datenschutzerklärung aufführen; sag ihm das, den Text schreibst du nicht.
67
+ - Der Hinweis erscheint nur, wenn die Seite etwas nutzt, das eine Einwilligung braucht: Tracking-Kennungen im
68
+ CRM, einen Dienst unter `external`, `<ConsentGate>`, `<MapEmbed>` oder ein Video eines anderen Anbieters. Sonst bleibt er unsichtbar, und
69
+ „Cookie-Einstellungen“ fehlt ebenfalls; es gibt dann nichts einzuwilligen. `<CookieBanner />` und
70
+ `<SiteFooterLegal />` bleiben trotzdem im Layout. Ein `<ConsentGate category="marketing">` zählt nur mit
71
+ Tracking-Kennung oder einem Dienst mit `category: 'marketing'` unter `external`.
72
+ - Gefragt wird nur nach den Zwecken, die die Seite braucht. Fest vorgeben: `<CookieBanner categories={['marketing']} />`.
73
+ - **Kampagnen und Seitenaufrufe erfasst das SDK selbst** (`<SiteHead>`, `<LeadForm>`). Bau nichts davon nach:
74
+ kein eigenes Auslesen von `utm_*`, `gclid` oder `fbclid`, kein eigener Speicher, keine eigenen Pixel-Ereignisse.
75
+ - Ohne Einwilligung: nur der aktuelle Besuch (UTM, fremder Referrer, Einstiegsseite, eigene URL-Parameter), nur
76
+ im Arbeitsspeicher. Er geht mit der Anfrage ins CRM. Seitenaufrufe zählt das CRM anonym.
77
+ - Mit Einwilligung „Marketing“ zusätzlich im Browser (`localStorage` `ds-attr`): erster und letzter Besuch,
78
+ Klick-IDs (`gclid`, `gbraid`, `wbraid`, `fbclid`, `msclkid`, `_fbp`, 90 Tage) und eine Besuchs-ID (13 Monate).
79
+ Ein Widerruf löscht das wieder.
80
+ - Nach einer angenommenen Anfrage meldet das SDK `Lead` an das Meta Pixel und `generate_lead` an Google, mit
81
+ derselben Ereignis-ID wie die serverseitige Meldung des CRM (`lead-<submissionId>`); so zählt sie einmal.
82
+ - Eigene URL-Parameter (z. B. `?partner=…`) liest `getCampaignParam('partner')` (`komponenten.md`).
83
+ - Das Formular schützt eine Rechenaufgabe im Hintergrund (ALTCHA) vor Missbrauch. Sie kommt von
84
+ DealSystem selbst, setzt kein Cookie und braucht keine Einwilligung.
package/docs/regeln.md ADDED
@@ -0,0 +1,108 @@
1
+ <!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
2
+
3
+ # Regeln von `dealsystem check` (Regelsatz 3)
4
+
5
+ `npx dealsystem check` prüft den Quelltext, `npx dealsystem check --output build` nach `npm run build`
6
+ zusätzlich die fertige Seite. Dieselben Regeln laufen beim Hochladen noch einmal auf dem Server; dort
7
+ entscheidet sich, ob die Seite angenommen wird. Ein Fehler verhindert das Hochladen, eine Warnung nicht.
8
+ Jede Meldung nennt Datei, Zeile und die Korrektur. Behebe die Ursache; schalte keine Regel ab.
9
+
10
+ | Regel | Art | Prüft an | Was geprüft wird | So behebst du es |
11
+ |---|---|---|---|---|
12
+ | `STR-001` | Fehler | Quelltext | `@sveltejs/adapter-static` in svelte.config.js | Setze in svelte.config.js den Adapter `@sveltejs/adapter-static`: `import adapter from "@sveltejs/adapter-static"` und `kit: { adapter: adapter() }`. |
13
+ | `STR-002` | Fehler | Quelltext | kein Server-Code: keine `+server.ts` (außer sitemap.xml/robots.txt), keine `hooks.server.ts`, keine Form-Actions | Lösche die Datei. Formulare gehen über `<LeadForm>`, Daten über `getCollection()`. |
14
+ | `STR-003` | Fehler | Quelltext | `+page.server.ts`/`+layout.server.ts` nur mit `prerender = true`; Lade-Helfer nur dort | Ergänze `export const prerender = true` in der Datei oder in `src/routes/+layout.ts`. |
15
+ | `STR-004` | Fehler | Quelltext | dynamische Routen exportieren `entries()` | Exportiere in `+page.server.ts` der Route `export const entries = () => collectionEntries('<key>')`. |
16
+ | `STR-005` | Fehler | Quelltext | `dealsystem.config.ts` gültig, `siteId` gesetzt | Führe `npx dealsystem init` aus. |
17
+ | `STR-008` | Fehler | Quelltext | `kit.prerender` in svelte.config.js: `handleHttpError` aus `@dealsystem/site/config` und `handleUnseenRoutes: 'ignore'` | Ergänze in svelte.config.js `import { handleHttpError } from '@dealsystem/site/config'` und `kit: { prerender: { handleHttpError, handleUnseenRoutes: 'ignore' } }`, oder führe `npx dealsystem sync --fix-config` aus. |
18
+ | `STR-009` | Fehler | Quelltext | Vite-Plugin `dealsystem(site)` vor `sveltekit()` in vite.config.ts | Schreibe in vite.config.ts `plugins: [dealsystem(site), sveltekit()]` mit `import { dealsystem } from '@dealsystem/site/vite'` und `import site from './dealsystem.config.ts'`. |
19
+ | `STR-006` | Fehler | Quelltext | `@dealsystem/site` im unterstützten Versionsbereich | Aktualisiere mit `npm install @dealsystem/site@latest` und führe `npx dealsystem sync` aus. |
20
+ | `STR-007` | Fehler | Quelltext | `package-lock.json` vorhanden und passend zu package.json | Führe `npm install` aus und lade das Lockfile mit hoch. |
21
+ | `DEP-001` | Fehler | Quelltext | direkte Abhängigkeiten stehen auf der Positiv-Liste | Entferne das Paket mit `npm uninstall <name>`. Freigegebene Pakete: `npx dealsystem check --allowed`. |
22
+ | `DEP-002` | Fehler | Quelltext | Pakete kommen nur aus der npm-Registry (kein Git, keine URL, kein `file:`) | Installiere die veröffentlichte Version aus der npm-Registry: `npm install <name>@latest`. |
23
+ | `SEC-001` | Fehler | Quelltext + fertige Seite | kein Zugangsschlüssel in Quelle oder Ausgabe | Entferne den Schlüssel und erneuere ihn beim Anbieter. Diese Seite braucht keine Secrets. |
24
+ | `SEC-002` | Fehler | Quelltext | kein `$env/static/private`, `$env/dynamic/private`, keine `.env` im Upload | Private Umgebungsvariablen gibt es auf einer statischen Seite nicht. Entferne den Import. |
25
+ | `SEC-003` | Fehler | Quelltext | kein `{@html}` außerhalb der SDK-Komponenten | Ersetze `{@html …}` durch `<RichText>` oder gib den Text normal aus. |
26
+ | `SEC-004` | Fehler | Quelltext | kein eigener Aufruf von `/api/site/`, `/api/v1/`, `/api/internal/` | Sprich die DealSystem-API nicht direkt an. Nutze `<LeadForm>`, `getCollection()` oder `<CollectionList>`. |
27
+ | `SEC-005` | Fehler | Quelltext | `kit.csp: dealsystemCsp()` (oder die feste Liste bis SDK 0.1); `external` in dealsystem.config.ts gültig: nur `https://host`, Platzhalter nicht in `script`/`frame`, kein `unsafe-eval` | Schreibe in svelte.config.js `csp: dealsystemCsp()` (`npx dealsystem sync --fix-config`) und trage fremde Hosts unter `external` in dealsystem.config.ts ein (extern.md). |
28
+ | `SEC-006` | Fehler | Quelltext | kein `eval`, `new Function`, WebAssembly, kein Inline-Event-Handler als Zeichenkette, kein `<script>` ohne `src`, kein eigener Inhaltsblock `ds-content` | Entferne den Fund; die Seite läuft mit einer strengen Content-Security-Policy. Eigenen Code legst du als Datei in `static/scripts/` ab und lädst ihn mit `<ExternalScript>` (extern.md). |
29
+ | `SEC-007` | Fehler | Quelltext | eigenes `<form>` mit `onsubmit`, ohne `action` oder nur auf dieselbe Seite/`#`; kein `method="post"` mit `action`, kein fremdes `target` | Lass `action` weg, schreib `<form onsubmit={senden}>` und sende in `senden` mit `createLeadClient()`; oder nimm `<LeadForm funnel="…" />` mit dem Formular unter `funnels` in dealsystem.config.ts. |
30
+ | `SEC-008` | Fehler | Quelltext + fertige Seite | fremde Rahmen und Skripte nur über `<Embed>`/`<ExternalScript>` mit Eintrag unter `external`; CSP der fertigen Seite = erwartete CSP | Trage den Dienst unter `external` in dealsystem.config.ts ein und binde ihn mit `<Embed>` (Video, Karte, Termin) oder `<ExternalScript>` (Skript) ein. Anleitung: extern.md. Lockere nicht die Regeln in svelte.config.js. |
31
+ | `SEC-009` | Fehler | Quelltext + fertige Seite | kein Passwortfeld (`<input type="password">`) | Entferne das Passwortfeld. Eine Seite auf DealSystem hat keine Anmeldung. |
32
+ | `SEC-010` | Fehler | Build | deklarierte fremde Hosts sind nicht als gefährlich gemeldet (Prüfung durch DealSystem beim Hochladen) | Entferne den Dienst aus `external` in dealsystem.config.ts und aus der Seite. Ein gemeldeter Host schadet den Besuchern. |
33
+ | `SEC-011` | Fehler | fertige Seite | `<ExternalScript>` nur auf Seiten mit eigener Domain, solange `dealsystem.site` nicht auf der Public Suffix List steht (nur Build-Host) | Verbinde eine eigene Domain (Eigene Website → Domains) oder nimm `<ExternalScript>` heraus. Videos über `<Embed>` und `<Tracking />` gehen auch ohne. |
34
+ | `PRV-001` | Fehler | Quelltext + fertige Seite | keine externen Skripte, Styles, Iframes, Schriften, Bilder vor der Einwilligung (außerhalb `<Embed>`, `<ExternalScript>`, `<ConsentGate>`) | Lege die Datei lokal ab (Ordner `static/` oder Import). Fremde Dienste bindest du mit `<Embed>` oder `<ExternalScript>` ein (extern.md). |
35
+ | `PRV-002` | Fehler | Quelltext + fertige Seite | keine Google-Fonts- oder CDN-Schrift-URLs | Schriften müssen lokal liegen. Installiere `@fontsource/<name>` und importiere sie in `src/routes/+layout.svelte`. |
36
+ | `PRV-003` | Fehler | Quelltext | Tracking über `<Tracking>` oder als Datei in `static/`, geladen von `<ExternalScript>` mit Kategorie `statistics`/`marketing` | Google Tag und Meta Pixel: Kennung im CRM eintragen und `<ConsentGate category="marketing"><Tracking /></ConsentGate>`. Andere Snippets als Datei unter `static/scripts/` mit `<ExternalScript>` laden (extern.md). |
37
+ | `PRV-004` | Fehler | Quelltext + fertige Seite | Routen `/impressum` und `/datenschutz` mit `<Impressum>` bzw. `<Datenschutz>` | Lege `src/routes/impressum/+page.svelte` mit `<Impressum />` und `src/routes/datenschutz/+page.svelte` mit `<Datenschutz />` an. |
38
+ | `PRV-005` | Fehler | Quelltext + fertige Seite | jede Seite verlinkt Impressum und Datenschutz und enthält den Cookie-Hinweis | Füge `<SiteFooterLegal />` und `<CookieBanner />` in `src/routes/+layout.svelte` ein. |
39
+ | `PRV-006` | Warnung | Quelltext | kein eigener Zugriff auf `document.cookie`, `localStorage`, `sessionStorage` | Wenn das Speichern nicht technisch nötig ist, gehört es hinter `<ConsentGate>`. |
40
+ | `PRV-008` | Warnung | Quelltext | eigener fremder Dienst unter `external` nennt `provider`, `purpose` und `privacyUrl` | Ergänze Anbieter mit Sitz, Zweck und Datenschutz-Link: Der Cookie-Hinweis zeigt sie dem Besucher. |
41
+ | `A11Y-001` | Fehler | Quelltext + fertige Seite | `<html lang>` gesetzt | Setze `<html lang="de">` in `src/app.html`. |
42
+ | `A11Y-002` | Fehler | Quelltext + fertige Seite | jedes Bild hat `alt`; `<img>` nur über `<MediaImage>` | Ersetze `<img>` durch `<MediaImage>` und beschreibe das Bild in `alt`. Rein dekorativ: `alt="" decorative`. |
43
+ | `A11Y-003` | Fehler | fertige Seite | genau eine `<h1>` je Seite, keine übersprungene Überschriften-Ebene | Nutze genau eine `<h1>` je Seite und danach jeweils die nächste Ebene. |
44
+ | `A11Y-004` | Fehler | fertige Seite | Formularfelder haben eine verknüpfte Beschriftung | Nutze `<LeadForm>` oder ergänze `<label for="…">`. |
45
+ | `A11Y-005` | Fehler | fertige Seite | Links und Schaltflächen haben einen zugänglichen Namen; kein „hier klicken“ als einziger Text | Ergänze sichtbaren, beschreibenden Text oder `aria-label`. |
46
+ | `A11Y-006` | Fehler | Quelltext | Farbpaare der Design-Tokens erreichen 4,5:1 | Wähle für `--color-on-<name>` oder `--color-<name>` einen Farbton mit mindestens 4,5:1 Kontrast. |
47
+ | `A11Y-007` | Fehler | Quelltext | kein `outline: none` ohne Ersatz, kein `tabindex` > 0, kein `user-scalable=no` | Entferne den Fund; Tastaturnutzer brauchen den sichtbaren Fokus. |
48
+ | `A11Y-008` | Fehler | fertige Seite | `<title>` und `meta description` je Seite, Titel eindeutig | Ergänze `<svelte:head><title>…</title><meta name="description" content="…" /></svelte:head>`. |
49
+ | `A11Y-009` | Fehler | Quelltext + fertige Seite | Videos über `<MediaVideo>` mit `title`; kein Autoplay mit Ton | Nutze `<MediaVideo media={…} title="…" />`. |
50
+ | `QUA-001` | Fehler | fertige Seite | Ausgabe ≤ 200 MB, ≤ 10 000 Dateien, Einzeldatei ≤ 25 MB | Verkleinere Bilder oder lege Videos im CRM ab. |
51
+ | `QUA-002` | Warnung | fertige Seite | JavaScript je Seite ≤ 300 KB (gzip) | Entferne ungenutzte Pakete und große Bibliotheken. |
52
+ | `QUA-003` | Fehler | fertige Seite | keine toten internen Links, `404.html` vorhanden | Korrigiere den Link oder lege die Zielseite an. |
53
+ | `QUA-004` | Fehler | fertige Seite | `sitemap.xml` und `robots.txt` vorhanden | Stelle `src/routes/sitemap.xml/+server.ts` und `src/routes/robots.txt/+server.ts` aus dem Starter wieder her (mit `export const prerender = true`). |
54
+ | `QUA-005` | Fehler | Quelltext | jedes Formular hat ein Feld mit `standardField` `email` oder `phone` | Ergänze im Formular ein Feld `{ name: 'email', type: 'email', standardField: 'email', required: true }`. |
55
+ | `QUA-006` | Fehler | Quelltext | Schlüssel-Formate (Slots, Formulare, Sammlungen), kein Slot-Schlüssel mit zwei Typen | Formular- und Sammlungs-Schlüssel: Kleinbuchstaben, Ziffern und Bindestriche, z. B. `kontakt`. Slot-Schlüssel: zwei bis fünf Teile mit Punkten, der erste ohne Bindestrich, z. B. `ueberuns.team.titel` für die Seite „Über uns“. |
56
+ | `QUA-007` | Warnung | Quelltext | AGENTS.md-Block passt zur installierten SDK-Version | Führe `npx dealsystem sync` aus, damit die Agenten-Anleitung zur SDK-Version passt. |
57
+ | `QUA-009` | Warnung | Quelltext | `<Zeitfenster>`: `ab`/`bis` als feste Zeitpunkte mit Zeitzone, `ab` vor `bis` | Schreibe den Zeitpunkt als feste Zeichenkette mit Zeitzone, z. B. `bis="2026-12-01T18:00:00+01:00"` (Winterzeit, Sommerzeit `+02:00`). Keine Variable, sonst kann DealSystem zur Grenze nicht neu bauen. |
58
+ | `QUA-008` | Warnung | Quelltext | eigene Oberfläche mit `createLeadClient`: Ausweichkontakt (`fallback`) und Bot-Falle (`<LeadHoneypot>`) | Zeig bei jedem Fehler außer `validation` `result.message` und den Ausweichkontakt `result.fallback` (Telefon, E-Mail) und setz `<LeadHoneypot client={lead} />` in die Oberfläche. Vorlage: Skill `funnel-mehrstufig`. |
59
+ | `QUA-010` | Warnung | Quelltext | höchstens 50 Felder je Formular (mehr übernimmt das CRM nicht) | Teile das Formular auf oder streiche Felder. Felder ab dem 51. kommen nur als Notiz an, ohne Prüfung und ohne Zuordnung im CRM. Versteckte Felder zählen mit. |
60
+ | `CNT-001` | Warnung | Quelltext | Überschriften und längere Texte als Content-Slot statt fest im Code | Lege den Text als Slot an, damit er im CRM änderbar ist: `<Text key="seite.bereich.name" default="…" />` (Überschrift: `as="h2"`, mehrzeilig: `multiline`, mit Formatierung: `<RichText>`). |
61
+ | `CNT-002` | Warnung | Quelltext | Adresse, Telefonnummer und E-Mail-Adresse kommen aus dem CRM, nicht aus dem Code | Nimm die Angabe aus dem CRM: `getSite()` aus `@dealsystem/site/content` liefert `company`, `address`, `email` und `phone` (im Starter als `data.site` auf jeder Seite). Gib sie mit `{data.site.address}` aus. Ändert der Kunde sie im CRM, folgt die Seite. |
62
+ | `CNT-003` | Warnung | Quelltext | kein `\n` im `default` von `<Text>`/`<RichText>`: im Attribut ist es kein Zeilenumbruch | Setz den Text in geschweifte Klammern, dann ist `\n` ein echter Zeilenumbruch: `default={'1. Erster Schritt\n2. Zweiter Schritt'}`. Leerzeile (`\n\n`) = neuer Absatz. Bei `<Text>` zusätzlich `multiline`. Beispiele: komponenten.md, `<Text>` und `<RichText>`. |
63
+ | `CNT-004` | Warnung | Quelltext | Titel und Beschreibung über `<Seo>`, Favicon und `noindex` über `<SiteHead>`, damit „Google und Teilen“ im CRM wirkt | Ersetze `<title>` und `<meta name="description">` in `<svelte:head>` durch `<Seo title="…" description="…" />` (Import aus `@dealsystem/site`). Ins Haupt-Layout gehört `<SiteHead favicon="/favicon.svg" />`, der Favicon-Link nicht nach `src/app.html`. |
64
+ | `BLD-001` | Fehler | Build | `npm ci` oder `vite build` scheitert | Führe lokal `npm run build` aus und behebe den ersten Fehler. |
65
+ | `BLD-002` | Fehler | Build | Zeit- oder Speichergrenze des Builds überschritten | Der Build darf höchstens 5 Minuten und 2 GB brauchen. Entferne große Abhängigkeiten oder Seiten mit sehr vielen Einträgen. |
66
+ | `BLD-003` | Fehler | Build | Archiv oder Ausgabe ungültig (Symlinks, `..` im Pfad, Gerätedateien, Größengrenze) | Entferne Symlinks und Dateien außerhalb des Projekts und verkleinere große Dateien. Lade nur mit `npx dealsystem deploy` hoch; es packt ausschließlich die erlaubten Dateien. |
67
+
68
+ ## Freigegebene Pakete
69
+
70
+ In `package.json` dürfen nur diese Pakete stehen (`DEP-001`). Aktuelle Liste: `npx dealsystem check --allowed`.
71
+
72
+ - `@dealsystem/site` – DealSystem-SDK
73
+ - `dealsystem` – DealSystem-CLI
74
+ - `@sveltejs/kit` – SvelteKit
75
+ - `@sveltejs/adapter-static` – statischer Build
76
+ - `@sveltejs/vite-plugin-svelte` – Svelte für Vite
77
+ - `@sveltejs/enhanced-img` – Bilder in WebP/AVIF mit srcset
78
+ - `svelte` – Svelte
79
+ - `vite` – Build
80
+ - `typescript` – Typen
81
+ - `tslib` – Typen
82
+ - `svelte-check` – Typprüfung
83
+ - `@types/node` – Typen
84
+ - `tailwindcss` – CSS
85
+ - `@tailwindcss/vite` – CSS
86
+ - `@tailwindcss/typography` – CSS
87
+ - `@tailwindcss/forms` – CSS
88
+ - `postcss` – CSS
89
+ - `autoprefixer` – CSS
90
+ - `sass` – CSS
91
+ - `clsx` – CSS-Klassen
92
+ - `tailwind-merge` – CSS-Klassen
93
+ - `@fontsource/*` – lokale Schriften
94
+ - `@fontsource-variable/*` – lokale Schriften
95
+ - `@lucide/svelte` – Icons
96
+ - `lucide-svelte` – Icons
97
+ - `@iconify/svelte` – Icons (nur mit lokal gebündelten Icons)
98
+ - `embla-carousel` – Karussell
99
+ - `embla-carousel-svelte` – Karussell
100
+ - `date-fns` – Datumsformat
101
+ - `prettier` – Formatierung
102
+ - `prettier-plugin-svelte` – Formatierung
103
+ - `prettier-plugin-tailwindcss` – Formatierung
104
+ - `eslint` – Linter
105
+ - `@eslint/js` – Linter
106
+ - `eslint-plugin-svelte` – Linter
107
+ - `typescript-eslint` – Linter
108
+ - `globals` – Linter
package/docs/seo.md ADDED
@@ -0,0 +1,55 @@
1
+ # Titel, Beschreibung, Vorschaubild und Favicon
2
+
3
+ Was bei Google, im Browser-Tab und beim Teilen (WhatsApp, Facebook, LinkedIn) erscheint, pflegt der Kunde im
4
+ CRM unter **Eigene Website → Einstellungen → Google und Teilen**: Titel und Beschreibung je Seite, eine
5
+ Vorgabe für alle Seiten, ein Vorschaubild, ein Favicon und „Nicht bei Google anzeigen“. Nach dem Speichern
6
+ baut DealSystem die Seite neu, ohne Agent. Damit das wirkt, setzt du diese Angaben nur über zwei Bausteine.
7
+
8
+ ## Auf jeder Seite: `<Seo>`
9
+
10
+ ```svelte
11
+ <script lang="ts">
12
+ import { Seo } from '@dealsystem/site';
13
+ let { data } = $props();
14
+ </script>
15
+
16
+ <Seo title="Kontakt – {data.site.name}" description="Schreiben Sie uns. Wir melden uns schnell zurück." />
17
+ ```
18
+
19
+ - Schreib `<title>`, `<meta name="description">`, `og:*` und `twitter:*` **nicht** selbst in `<svelte:head>`.
20
+ `<Seo>` setzt sie. Stünden sie zusätzlich da, gäbe es sie doppelt, und die Angaben aus dem CRM wirkten
21
+ nicht. `npx dealsystem check` warnt (`CNT-004`). Anderes (z. B. `<link rel="canonical">`) darf weiter in
22
+ `<svelte:head>` stehen.
23
+ - Was gilt, entscheidet `<Seo>` je Angabe: Angabe des Kunden für diese Seite → `title`/`description`/`image`
24
+ aus dem Code → Vorgabe des Kunden für alle Seiten → beim Titel zuletzt der Name der Website. Was du im
25
+ Code angibst, ist also der Standard, den der Kunde ersetzen kann.
26
+ - Seitentitel im CRM gibt es nur für feste Seiten (`/kontakt`), nicht für Detailseiten wie
27
+ `/angebote/[slug]`. Dort gibt der Code Titel und Bild aus dem Eintrag mit:
28
+ `<Seo title={angebot.data.titel} description={angebot.data.kurztext} image={angebot.media.bilder[0]} />`.
29
+ - `image` ist ein Bild aus dem CMS (`MediaRef`) oder der Pfad eines Bildes im Projekt; dann beschreibt
30
+ `imageAlt`, was zu sehen ist. Ohne Bild gibt es die kleine Vorschau.
31
+ - Titel und Beschreibung werden immer als Text ausgegeben, nie als HTML.
32
+ - Jede Seite braucht einen eigenen Titel und eine Beschreibung (`A11Y-008`). Gib sie deshalb im Code an,
33
+ auch wenn der Kunde sie später ersetzt.
34
+
35
+ ## Im Layout: `<SiteHead>`
36
+
37
+ ```svelte
38
+ <SiteHead favicon="/favicon.svg" />
39
+ ```
40
+
41
+ Einmal in `src/routes/+layout.svelte`. `favicon` ist das Favicon aus dem Projekt (`static/`). Hat der Kunde im
42
+ CRM eins hochgeladen, gilt seins (32 px im Tab, 180 px für iOS, 192 und 512 px im Web-Manifest
43
+ `/manifest.webmanifest`, das der Build anlegt). Schreib den Favicon-Link nicht nach `src/app.html`, sonst gäbe
44
+ es zwei (`CNT-004`).
45
+
46
+ ## Nicht bei Google anzeigen
47
+
48
+ Wählt der Kunde das im CRM, steht auf jeder Seite `<meta name="robots" content="noindex">`, und
49
+ `robots.txt` nennt die Sitemap nicht mehr. Ein `Disallow` steht bewusst nicht darin: Sonst läse Google das
50
+ `noindex` nie, und schon gefundene Seiten blieben im Index. Bau dafür nichts selbst ein.
51
+
52
+ ## Was du dem Kunden sagst
53
+
54
+ Fragt der Kunde, wie er den Text bei Google, das Bild beim Teilen in WhatsApp oder das kleine Symbol im Tab
55
+ ändert: im CRM unter Eigene Website → Einstellungen → Google und Teilen, ohne neue Version von dir.
@@ -0,0 +1,73 @@
1
+ # Terminbuchung: `<Booker>` und `createBookingClient`
2
+
3
+ Besucher wählen auf der Seite einen freien Termin aus dem DealSystem-Kalender. Der Termin landet im Kalender
4
+ des Kunden, der Kontakt mit Herkunft „Website“ im CRM, der Besucher bekommt eine Bestätigung mit Links zum
5
+ Absagen und Verschieben. Kein iframe, kein fremder Dienst, keine Einwilligung nötig: Die Buchung geht wie ein
6
+ Formular an die Site-API.
7
+
8
+ ## Die Terminart kommt aus dem CRM
9
+
10
+ Was gebucht werden kann, legt der Kunde im CRM unter Termine fest: Dauer, Arbeitszeiten, Buchungsfragen,
11
+ Gastgeber, Ort (Telefon, Google Meet, vor Ort). Über den DealSystem-Konnektor kann der Agent das für ihn tun
12
+ (`list_event_types`, `create_event_type`, `upsert_schedule`, `upsert_booking_field`). **Erfinde keine
13
+ Terminart, keine Dauer und keine Arbeitszeiten.** Die Seite nennt nur, welche Terminart wo gebucht wird.
14
+
15
+ ## Konfiguration
16
+
17
+ ```ts
18
+ // dealsystem.config.ts
19
+ export default defineSite({
20
+ siteId: '…',
21
+ booking: {
22
+ erstgespraech: { label: 'Erstgespräch', eventType: 'erstgespraech' },
23
+ },
24
+ });
25
+ ```
26
+
27
+ | Angabe | Pflicht | Bedeutung |
28
+ | ----------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
29
+ | Schlüssel | ja | Kleinbuchstaben, Ziffern, Bindestriche, höchstens 50 Zeichen. Höchstens 20 Buchungen je Seite. |
30
+ | `label` | nein | Bezeichnung auf der Seite und im CRM (1 bis 100 Zeichen). Ohne Angabe der Name der Terminart. |
31
+ | `eventType` | nein | `slug` der Terminart (`list_event_types`). Zugeordnet beim Hochladen, wenn genau eine aktive Terminart so heißt. |
32
+
33
+ Ohne `eventType` oder bei einem unbekannten Slug wählt der Kunde die Terminart im CRM; bis dahin zeigt der
34
+ Baustein den Ausweichkontakt (Telefon und E-Mail aus den Firmendaten).
35
+
36
+ ## Fertiger Baustein
37
+
38
+ ```svelte
39
+ <Booker booking="erstgespraech" />
40
+ ```
41
+
42
+ - Schritte: Tag wählen, Uhrzeit wählen, Angaben (Vorname, Nachname, E-Mail, Telefon, die Fragen der Terminart,
43
+ bei mehreren Ort-Arten die Wahl), Bestätigung.
44
+ - Barrierefrei: Tage und Zeiten sind Buttons, der gewählte Tag hat `aria-pressed`, beim Schrittwechsel springt
45
+ der Fokus auf die Überschrift des neuen Schritts, eine Live-Region meldet „Termin gebucht“. Fehler stehen
46
+ am Feld und sind mit ihm verbunden.
47
+ - Zeiten erscheinen in der Zeitzone des Besuchers; die Zeitzone des Kalenders steht als Hinweis dabei.
48
+ Gesendet und gespeichert wird in UTC; die Zeitumstellung erledigt der Kalender.
49
+ - „Weitere Termine“ lädt die nächsten Tage nach (`days`, Standard 14, höchstens 31 je Abruf).
50
+ - Ist die Zeit inzwischen vergeben (`slot_taken`), lädt der Baustein die Zeiten neu, die Angaben bleiben.
51
+ - Gestaltung über dieselben CSS-Variablen wie `<LeadForm>` (`--ds-color-primary`, `--ds-radius`, …),
52
+ Überschriften-Ebene über `headingLevel`.
53
+
54
+ ## Eigene Oberfläche
55
+
56
+ `createBookingClient('erstgespraech')` liefert `info()` (Terminart, Fragen, Zeitzone des Kalenders),
57
+ `slots(from, to)` (freie Zeiten in UTC) und `book({ start, firstName, email, … })`. Zum Anzeigen:
58
+ `groupSlotsByDay(slots, visitorTimeZone())` gruppiert nach Tag in der Zeitzone des Besuchers.
59
+
60
+ - Setz `<LeadHoneypot client={termin} />` in die Oberfläche (Bot-Falle) und ruf `termin.prepare()` auf,
61
+ sobald eine Zeit gewählt ist (startet die Sicherheitsprüfung).
62
+ - `book()` gibt nie eine Ausnahme, sondern `{ ok: false, reason, message, fallback }`:
63
+ `validation` (Texte je Feld unter `fields`), `slot_taken` (Zeiten neu laden), `not_qualified` (Regel der
64
+ Terminart), `captcha`, `rate_limited`, `network`, `unavailable`. Zeig `message` und bei allem außer
65
+ `validation` den Ausweichkontakt.
66
+ - Doppelt abschicken bucht nicht doppelt: Derselbe Beginn behält seine `submissionId`, der Server meldet dann
67
+ `duplicate: true`.
68
+
69
+ ## Ausprobieren
70
+
71
+ - `npm run dev`: Probe-Terminart mit Zeiten werktags 9 bis 16 Uhr (Berlin), eine Buchung wird nur geprüft.
72
+ - Vorschau nach dem Hochladen: echte freie Zeiten; eine Buchung wird geprüft, aber nicht angelegt (`dryRun`).
73
+ - Erst auf der veröffentlichten Seite entsteht der Termin.