@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.
- package/README.md +145 -2
- package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
- package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
- package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
- package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
- package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
- package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
- package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
- package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
- package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
- package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
- package/agent-files/claude/skills/veroeffentlichen/SKILL.md +32 -0
- package/agent-files/cursor/rules/dealsystem.mdc +7 -0
- package/agent-files/manifest.json +93 -0
- package/contract/README.md +41 -0
- package/contract/ds-content.v1.json +2355 -0
- package/contract/external-presets.v1.json +65 -0
- package/contract/funnel-code-config.md +87 -0
- package/contract/site-api.v1.json +3916 -0
- package/dist/client/altcha-workers.d.ts +10 -0
- package/dist/client/attribution.d.ts +119 -0
- package/dist/client/attribution.js +341 -0
- package/dist/client/bookingClient.svelte.d.ts +166 -0
- package/dist/client/bookingClient.svelte.js +369 -0
- package/dist/client/bookingTime.d.ts +46 -0
- package/dist/client/bookingTime.js +109 -0
- package/dist/client/captcha.d.ts +26 -0
- package/dist/client/captcha.js +71 -0
- package/dist/client/captchaSession.d.ts +21 -0
- package/dist/client/captchaSession.js +105 -0
- package/dist/client/collections.d.ts +34 -0
- package/dist/client/collections.js +40 -0
- package/dist/client/externalScript.d.ts +20 -0
- package/dist/client/externalScript.js +36 -0
- package/dist/client/funnelState.svelte.d.ts +47 -0
- package/dist/client/funnelState.svelte.js +81 -0
- package/dist/client/leadClient.svelte.d.ts +131 -0
- package/dist/client/leadClient.svelte.js +250 -0
- package/dist/client/pageview.d.ts +7 -0
- package/dist/client/pageview.js +44 -0
- package/dist/client/siteApi.d.ts +211 -0
- package/dist/client/siteApi.js +320 -0
- package/dist/client/tracking.d.ts +18 -0
- package/dist/client/tracking.js +93 -0
- package/dist/client/validation.d.ts +10 -0
- package/dist/client/validation.js +66 -0
- package/dist/components/Booker.svelte +729 -0
- package/dist/components/Booker.svelte.d.ts +42 -0
- package/dist/components/CollectionList.svelte +122 -0
- package/dist/components/CollectionList.svelte.d.ts +65 -0
- package/dist/components/ConsentGate.svelte +68 -0
- package/dist/components/ConsentGate.svelte.d.ts +44 -0
- package/dist/components/CookieBanner.svelte +303 -0
- package/dist/components/CookieBanner.svelte.d.ts +29 -0
- package/dist/components/Datenschutz.svelte +84 -0
- package/dist/components/Datenschutz.svelte.d.ts +26 -0
- package/dist/components/Embed.svelte +263 -0
- package/dist/components/Embed.svelte.d.ts +41 -0
- package/dist/components/ExternalScript.svelte +94 -0
- package/dist/components/ExternalScript.svelte.d.ts +41 -0
- package/dist/components/Impressum.svelte +59 -0
- package/dist/components/Impressum.svelte.d.ts +25 -0
- package/dist/components/LeadForm.svelte +475 -0
- package/dist/components/LeadForm.svelte.d.ts +35 -0
- package/dist/components/LeadHoneypot.svelte +43 -0
- package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
- package/dist/components/Link.svelte +48 -0
- package/dist/components/Link.svelte.d.ts +30 -0
- package/dist/components/MapEmbed.svelte +154 -0
- package/dist/components/MapEmbed.svelte.d.ts +28 -0
- package/dist/components/MediaImage.svelte +218 -0
- package/dist/components/MediaImage.svelte.d.ts +128 -0
- package/dist/components/MediaVideo.svelte +103 -0
- package/dist/components/MediaVideo.svelte.d.ts +20 -0
- package/dist/components/RichText.svelte +105 -0
- package/dist/components/RichText.svelte.d.ts +55 -0
- package/dist/components/Seo.svelte +89 -0
- package/dist/components/Seo.svelte.d.ts +45 -0
- package/dist/components/SiteFooterLegal.svelte +75 -0
- package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
- package/dist/components/SiteHead.svelte +79 -0
- package/dist/components/SiteHead.svelte.d.ts +32 -0
- package/dist/components/Text.svelte +100 -0
- package/dist/components/Text.svelte.d.ts +55 -0
- package/dist/components/Tracking.svelte +30 -0
- package/dist/components/Tracking.svelte.d.ts +14 -0
- package/dist/components/Zeitfenster.svelte +92 -0
- package/dist/components/Zeitfenster.svelte.d.ts +34 -0
- package/dist/components/legal.d.ts +12 -0
- package/dist/components/legal.js +27 -0
- package/dist/config/index.d.ts +121 -0
- package/dist/config/index.js +602 -0
- package/dist/config/static/index.d.ts +3 -0
- package/dist/config/static/index.js +5 -0
- package/dist/config/static/lines.d.ts +9 -0
- package/dist/config/static/lines.js +22 -0
- package/dist/config/static/literal.d.ts +45 -0
- package/dist/config/static/literal.js +175 -0
- package/dist/config/static/siteConfig.d.ts +39 -0
- package/dist/config/static/siteConfig.js +150 -0
- package/dist/consent/consent.svelte.d.ts +91 -0
- package/dist/consent/consent.svelte.js +221 -0
- package/dist/content/index.d.ts +123 -0
- package/dist/content/index.js +247 -0
- package/dist/contentBlock.d.ts +45 -0
- package/dist/contentBlock.js +78 -0
- package/dist/csp/index.d.ts +27 -0
- package/dist/csp/index.js +74 -0
- package/dist/external/csp.d.ts +25 -0
- package/dist/external/csp.js +104 -0
- package/dist/external/hosts.d.ts +30 -0
- package/dist/external/hosts.js +128 -0
- package/dist/external/presets.d.ts +54 -0
- package/dist/external/presets.js +212 -0
- package/dist/external/resolve.d.ts +39 -0
- package/dist/external/resolve.js +254 -0
- package/dist/index.d.ts +32 -0
- package/dist/index.js +32 -0
- package/dist/internal/consentNeed.d.ts +21 -0
- package/dist/internal/consentNeed.js +50 -0
- package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
- package/dist/internal/dealsystem-legal-imprint.js +5 -0
- package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
- package/dist/internal/dealsystem-legal-privacy.js +5 -0
- package/dist/internal/dealsystem-site-data.d.ts +3 -0
- package/dist/internal/dealsystem-site-data.js +2 -0
- package/dist/internal/imprint.d.ts +4 -0
- package/dist/internal/imprint.js +10 -0
- package/dist/internal/mediaImage.d.ts +15 -0
- package/dist/internal/mediaImage.js +22 -0
- package/dist/internal/privacy.d.ts +4 -0
- package/dist/internal/privacy.js +10 -0
- package/dist/internal/providers.d.ts +9 -0
- package/dist/internal/providers.js +44 -0
- package/dist/internal/reload.d.ts +2 -0
- package/dist/internal/reload.js +5 -0
- package/dist/internal/seo.d.ts +41 -0
- package/dist/internal/seo.js +79 -0
- package/dist/internal/siteData.d.ts +7 -0
- package/dist/internal/siteData.js +39 -0
- package/dist/internal/usage.d.ts +7 -0
- package/dist/internal/usage.js +13 -0
- package/dist/keys.d.ts +20 -0
- package/dist/keys.js +58 -0
- package/dist/leadmagnet.d.ts +16 -0
- package/dist/leadmagnet.js +28 -0
- package/dist/paths.d.ts +8 -0
- package/dist/paths.js +9 -0
- package/dist/richtext/escape.d.ts +4 -0
- package/dist/richtext/escape.js +18 -0
- package/dist/richtext/server.d.ts +16 -0
- package/dist/richtext/server.js +123 -0
- package/dist/schedule.d.ts +23 -0
- package/dist/schedule.js +67 -0
- package/dist/slots.d.ts +9 -0
- package/dist/slots.js +38 -0
- package/dist/snapshot.d.ts +14 -0
- package/dist/snapshot.js +214 -0
- package/dist/types.d.ts +550 -0
- package/dist/types.js +4 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +2 -0
- package/dist/vite/index.d.ts +85 -0
- package/dist/vite/index.js +641 -0
- package/dist/vite/scan.d.ts +47 -0
- package/dist/vite/scan.js +355 -0
- package/dist/vite/zeitfenster.d.ts +18 -0
- package/dist/vite/zeitfenster.js +76 -0
- package/docs/ablauf.md +167 -0
- package/docs/agents-block.md +100 -0
- package/docs/befehle.md +103 -0
- package/docs/extern.md +143 -0
- package/docs/gestaltung.md +139 -0
- package/docs/inhalte.md +224 -0
- package/docs/komponenten.md +1273 -0
- package/docs/konfiguration.md +310 -0
- package/docs/llms.txt +19 -0
- package/docs/rechtstexte.md +84 -0
- package/docs/regeln.md +108 -0
- package/docs/seo.md +55 -0
- package/docs/termine.md +73 -0
- package/package.json +115 -5
|
@@ -0,0 +1,1273 @@
|
|
|
1
|
+
<!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
|
|
2
|
+
|
|
3
|
+
# Bausteine von @dealsystem/site 0.2.0
|
|
4
|
+
|
|
5
|
+
Alle Bausteine kommen aus einem Import: `import { … } from '@dealsystem/site'`.
|
|
6
|
+
Pflichtangaben sind im Typ ohne `?` notiert; fehlt eine, meldet `npm run check` einen Fehler.
|
|
7
|
+
|
|
8
|
+
## Text
|
|
9
|
+
|
|
10
|
+
Ein kurzer Text (Überschrift, Satz, Beschriftung), den der Kunde im CRM ändern
|
|
11
|
+
kann.
|
|
12
|
+
Angezeigt wird der Text aus dem CRM, sonst `default`.
|
|
13
|
+
|
|
14
|
+
`key` und `default` müssen feste Zeichenketten sein (keine Variablen): der
|
|
15
|
+
Build liest sie aus dem Quelltext und meldet sie ans CRM.
|
|
16
|
+
|
|
17
|
+
`key` hat zwei bis fünf Teile mit Punkten. Der erste Teil, meist die Seite,
|
|
18
|
+
besteht nur aus Kleinbuchstaben und Ziffern, ohne Bindestrich: für die Seite
|
|
19
|
+
`/ueber-uns` also `ueberuns.team.titel`, nicht `ueber-uns.team.titel`. Die
|
|
20
|
+
weiteren Teile dürfen Bindestriche haben (`start.ueber-uns`). Das gilt für alle
|
|
21
|
+
Schlüssel von `<Text>`, `<RichText>`, `<Link>` und `<MediaImage>`.
|
|
22
|
+
|
|
23
|
+
```svelte
|
|
24
|
+
<Text key="start.hero.titel" default="Wir kaufen Ihr Haus" as="h1" label="Überschrift" group="Startseite" />
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Mehrere Zeilen: `multiline` und den Text in geschweiften Klammern, dann ist
|
|
28
|
+
`\n` ein Zeilenumbruch. In `default="…"` wäre `\n` kein Umbruch, sondern
|
|
29
|
+
stünde wörtlich auf der Seite (`dealsystem check` warnt, CNT-003).
|
|
30
|
+
|
|
31
|
+
```svelte
|
|
32
|
+
<Text key="kontakt.zeiten" multiline default={'Mo bis Fr 9 bis 18 Uhr\nSa nach Vereinbarung'} />
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Eigenschaften:
|
|
36
|
+
|
|
37
|
+
```ts
|
|
38
|
+
/** HTML-Elemente, die `<Text>` ausgeben kann. */
|
|
39
|
+
export type TextElement =
|
|
40
|
+
| 'span'
|
|
41
|
+
| 'p'
|
|
42
|
+
| 'h1'
|
|
43
|
+
| 'h2'
|
|
44
|
+
| 'h3'
|
|
45
|
+
| 'h4'
|
|
46
|
+
| 'h5'
|
|
47
|
+
| 'h6'
|
|
48
|
+
| 'strong'
|
|
49
|
+
| 'em'
|
|
50
|
+
| 'small'
|
|
51
|
+
| 'div'
|
|
52
|
+
| 'li'
|
|
53
|
+
| 'blockquote'
|
|
54
|
+
| 'figcaption'
|
|
55
|
+
| 'dt'
|
|
56
|
+
| 'dd';
|
|
57
|
+
|
|
58
|
+
export interface TextProps {
|
|
59
|
+
/** Eindeutiger Schlüssel, z. B. `start.hero.titel`: Teile mit Punkten, der erste ohne Bindestrich (`ueberuns.team.titel`). */
|
|
60
|
+
key: string;
|
|
61
|
+
/** Text, solange im CRM nichts anderes eingetragen ist. */
|
|
62
|
+
default: string;
|
|
63
|
+
/** HTML-Element. Standard `span`. Je Seite genau eine `h1`. */
|
|
64
|
+
as?: TextElement;
|
|
65
|
+
/** Mehrzeiliger Text: Zeilenumbrüche bleiben erhalten. */
|
|
66
|
+
multiline?: boolean;
|
|
67
|
+
/** Beschriftung im CRM, z. B. „Überschrift“. */
|
|
68
|
+
label?: string;
|
|
69
|
+
/** Gruppe im CRM, z. B. „Startseite“. */
|
|
70
|
+
group?: string;
|
|
71
|
+
/** Hinweis für den Kunden im CRM. */
|
|
72
|
+
help?: string;
|
|
73
|
+
/** Höchstlänge im CRM. */
|
|
74
|
+
maxLength?: number;
|
|
75
|
+
/** Der Kunde darf den Text im CRM nicht leeren. */
|
|
76
|
+
required?: boolean;
|
|
77
|
+
/** Frühere Schlüssel dieses Textes, damit Änderungen des Kunden beim Umbenennen bleiben. */
|
|
78
|
+
aliases?: readonly string[];
|
|
79
|
+
class?: string;
|
|
80
|
+
id?: string;
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## RichText
|
|
85
|
+
|
|
86
|
+
Formatierter Text: Absätze, Überschriften, Listen, Links. Das ist die einzige
|
|
87
|
+
Stelle, an der HTML aus dem CRM ausgegeben wird. `{@html}` schreibt die Seite nie.
|
|
88
|
+
|
|
89
|
+
Als Text, den der Kunde im CRM ändern kann (`key` und `default` als feste
|
|
90
|
+
Zeichenketten):
|
|
91
|
+
|
|
92
|
+
```svelte
|
|
93
|
+
<RichText key="start.ueber-uns" default="Wir sind **seit 2010** in Leipzig tätig." />
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Liste oder mehrere Absätze: den Text in geschweifte Klammern, dann ist `\n`
|
|
97
|
+
ein Zeilenumbruch und `\n\n` ein neuer Absatz. In `default="…"` stünde `\n`
|
|
98
|
+
wörtlich auf der Seite (`dealsystem check` warnt, CNT-003).
|
|
99
|
+
|
|
100
|
+
```svelte
|
|
101
|
+
<RichText
|
|
102
|
+
key="ankauf.ablauf"
|
|
103
|
+
default={'1. Sie schicken uns die Eckdaten.\n2. Wir prüfen und melden uns.\n3. Sie erhalten ein Angebot.\n\nDer Ablauf ist für Sie kostenlos.'}
|
|
104
|
+
/>
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
Für ein Richtext-Feld eines CMS-Eintrags:
|
|
108
|
+
|
|
109
|
+
```svelte
|
|
110
|
+
<RichText content={angebot.data.beschreibung} />
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Eigenschaften:
|
|
114
|
+
|
|
115
|
+
```ts
|
|
116
|
+
export type RichTextProps = { class?: string } & (
|
|
117
|
+
| {
|
|
118
|
+
/** Eindeutiger Schlüssel, z. B. `start.ueber-uns`. */
|
|
119
|
+
key: string;
|
|
120
|
+
/** Markdown, solange im CRM nichts anderes eingetragen ist. */
|
|
121
|
+
default: string;
|
|
122
|
+
/** Beschriftung im CRM. */
|
|
123
|
+
label?: string;
|
|
124
|
+
/** Gruppe im CRM. */
|
|
125
|
+
group?: string;
|
|
126
|
+
/** Hinweis für den Kunden im CRM. */
|
|
127
|
+
help?: string;
|
|
128
|
+
/** Der Kunde darf den Text im CRM nicht leeren. */
|
|
129
|
+
required?: boolean;
|
|
130
|
+
/** Frühere Schlüssel dieses Textes. */
|
|
131
|
+
aliases?: readonly string[];
|
|
132
|
+
content?: undefined;
|
|
133
|
+
}
|
|
134
|
+
| {
|
|
135
|
+
/** Richtext-Feld eines Eintrags aus `getCollection()`, `getEntry()` oder `loadCollection()`. */
|
|
136
|
+
content: SafeHtml | null | undefined;
|
|
137
|
+
key?: undefined;
|
|
138
|
+
}
|
|
139
|
+
);
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## Link
|
|
143
|
+
|
|
144
|
+
Ein Link, dessen Ziel und Beschriftung der Kunde im CRM ändern kann. Gedacht
|
|
145
|
+
z. B. für die wichtigste Schaltfläche der Startseite; für gewöhnliche Links
|
|
146
|
+
reicht `<a href>`.
|
|
147
|
+
|
|
148
|
+
`key` und `default` müssen fest im Quelltext stehen (keine Variablen).
|
|
149
|
+
|
|
150
|
+
```svelte
|
|
151
|
+
<Link key="start.hero.knopf" default={{ href: '/kontakt', label: 'Kontakt aufnehmen' }} label="Schaltfläche" group="Startseite" />
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Eigenschaften:
|
|
155
|
+
|
|
156
|
+
```ts
|
|
157
|
+
export interface LinkProps {
|
|
158
|
+
/** Eindeutiger Schlüssel, z. B. `start.hero.knopf`. */
|
|
159
|
+
key: string;
|
|
160
|
+
/** Ziel und Beschriftung, solange im CRM nichts anderes eingetragen ist. */
|
|
161
|
+
default: ContentSlotLinkValue;
|
|
162
|
+
/** Beschriftung im CRM. */
|
|
163
|
+
label?: string;
|
|
164
|
+
/** Gruppe im CRM. */
|
|
165
|
+
group?: string;
|
|
166
|
+
/** Hinweis für den Kunden im CRM. */
|
|
167
|
+
help?: string;
|
|
168
|
+
/** Frühere Schlüssel dieses Links. */
|
|
169
|
+
aliases?: readonly string[];
|
|
170
|
+
class?: string;
|
|
171
|
+
}
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
## MediaImage
|
|
175
|
+
|
|
176
|
+
Ein Bild, immer mit Alternativtext. `<img>` wird auf der Seite nie direkt
|
|
177
|
+
geschrieben, immer `<MediaImage>`.
|
|
178
|
+
`alt` beschreibt, was auf dem Bild zu sehen ist. Nur bei reinem Schmuck:
|
|
179
|
+
`alt="" decorative`.
|
|
180
|
+
|
|
181
|
+
Lokales Bild (`width` und `height` sind die echten Maße der Datei):
|
|
182
|
+
|
|
183
|
+
```svelte
|
|
184
|
+
<script lang="ts">
|
|
185
|
+
import { MediaImage } from '@dealsystem/site';
|
|
186
|
+
import heroBild from '$lib/assets/bilder/hero.jpg';
|
|
187
|
+
</script>
|
|
188
|
+
|
|
189
|
+
<MediaImage src={heroBild} alt="Sanierter Altbau in Leipzig" width={1600} height={1067} sizes="100vw" priority />
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
Bild aus dem CMS (der Alternativtext kommt aus dem CMS):
|
|
193
|
+
|
|
194
|
+
```svelte
|
|
195
|
+
<MediaImage media={angebot.media.bilder[0]} sizes="(min-width: 800px) 50vw, 100vw" />
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
Bild, das der Kunde selbst austauschen kann (Porträt, Team, Titelbild): mit
|
|
199
|
+
`key` und `default`. Nach dem Hochladen tauscht er es im CRM unter Eigene
|
|
200
|
+
Website → Inhalte. `key`, `label`, `group` und `help` müssen feste
|
|
201
|
+
Zeichenketten in Anführungszeichen sein; mit einer Variablen scheitern Build
|
|
202
|
+
und `dealsystem check` (QUA-006). `default` ist das Bild aus dem Projekt:
|
|
203
|
+
ein Import (wie unten) oder ein Pfad unter `static/` (`default="/bilder/haus.jpg"`).
|
|
204
|
+
Dann zeigt das CRM es als Vorschau; bei `?enhanced` oder einer Variablen nicht.
|
|
205
|
+
|
|
206
|
+
```svelte
|
|
207
|
+
<script lang="ts">
|
|
208
|
+
import { MediaImage } from '@dealsystem/site';
|
|
209
|
+
import portrait from '$lib/assets/bilder/inhaber.jpg';
|
|
210
|
+
</script>
|
|
211
|
+
|
|
212
|
+
<MediaImage
|
|
213
|
+
key="team.inhaber.foto"
|
|
214
|
+
default={portrait}
|
|
215
|
+
width={1200}
|
|
216
|
+
height={1500}
|
|
217
|
+
alt="Porträt des Inhabers vor dem Büro"
|
|
218
|
+
label="Foto des Inhabers"
|
|
219
|
+
group="Über uns"
|
|
220
|
+
help="Hochformat, am besten mit Gesicht in der Mitte."
|
|
221
|
+
sizes="(min-width: 60rem) 33vw, 100vw"
|
|
222
|
+
/>
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
Eigenschaften:
|
|
226
|
+
|
|
227
|
+
```ts
|
|
228
|
+
/** Ein leerer Alternativtext ist nur zusammen mit `decorative` erlaubt. */
|
|
229
|
+
type DescribingAlt<A extends string> = A extends ''
|
|
230
|
+
? 'Fehler: alt darf nicht leer sein. Beschreibe das Bild, oder setze alt="" zusammen mit decorative.'
|
|
231
|
+
: A;
|
|
232
|
+
|
|
233
|
+
type AltProps<A extends string> =
|
|
234
|
+
| {
|
|
235
|
+
/** Beschreibt das Bild für Menschen, die es nicht sehen. */
|
|
236
|
+
alt: DescribingAlt<A>;
|
|
237
|
+
decorative?: false;
|
|
238
|
+
}
|
|
239
|
+
| {
|
|
240
|
+
alt: '';
|
|
241
|
+
/** Reiner Schmuck: Vorleseprogramme überspringen das Bild. */
|
|
242
|
+
decorative: true;
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
interface CommonProps {
|
|
246
|
+
/** Anzeigebreite für die Auswahl der Bildgröße, z. B. `(min-width: 800px) 50vw, 100vw`. Standard `100vw`. */
|
|
247
|
+
sizes?: string;
|
|
248
|
+
/** Für das wichtigste Bild im sichtbaren Bereich: wird sofort geladen. */
|
|
249
|
+
priority?: boolean;
|
|
250
|
+
class?: string;
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
export type MediaImageProps<A extends string = string> = CommonProps &
|
|
254
|
+
(
|
|
255
|
+
| ({
|
|
256
|
+
/** Lokales Bild: Import mit `?enhanced` oder Pfad aus `static/`. */
|
|
257
|
+
src: EnhancedPicture | string;
|
|
258
|
+
/** Breite in Pixeln. Nur nötig, wenn `src` ein Pfad ist. */
|
|
259
|
+
width?: number;
|
|
260
|
+
/** Höhe in Pixeln. Nur nötig, wenn `src` ein Pfad ist. */
|
|
261
|
+
height?: number;
|
|
262
|
+
key?: undefined;
|
|
263
|
+
media?: undefined;
|
|
264
|
+
} & AltProps<A>)
|
|
265
|
+
| ({
|
|
266
|
+
/** Schlüssel des Bild-Slots, z. B. `start.hero.bild`. */
|
|
267
|
+
key: string;
|
|
268
|
+
/** Bild, solange im CRM kein anderes gewählt ist. */
|
|
269
|
+
default: EnhancedPicture | string;
|
|
270
|
+
width?: number;
|
|
271
|
+
height?: number;
|
|
272
|
+
/** Beschriftung im CRM. */
|
|
273
|
+
label?: string;
|
|
274
|
+
/** Gruppe im CRM. */
|
|
275
|
+
group?: string;
|
|
276
|
+
/** Hinweis für den Kunden im CRM. */
|
|
277
|
+
help?: string;
|
|
278
|
+
/** Frühere Schlüssel dieses Bildes. */
|
|
279
|
+
aliases?: readonly string[];
|
|
280
|
+
src?: undefined;
|
|
281
|
+
media?: undefined;
|
|
282
|
+
} & AltProps<A>)
|
|
283
|
+
| {
|
|
284
|
+
/** Bild aus einem CMS-Eintrag. Fehlt es, wird nichts ausgegeben. */
|
|
285
|
+
media: MediaRef | null | undefined;
|
|
286
|
+
/** Ersetzt den Alternativtext aus dem CMS. */
|
|
287
|
+
alt?: string;
|
|
288
|
+
decorative?: boolean;
|
|
289
|
+
src?: undefined;
|
|
290
|
+
key?: undefined;
|
|
291
|
+
}
|
|
292
|
+
);
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
## MediaVideo
|
|
296
|
+
|
|
297
|
+
Ein Video aus dem CMS, mit Bedienelementen und ohne automatischen Start.
|
|
298
|
+
`title` benennt das Video für Vorleseprogramme. Kommt das Video von einem
|
|
299
|
+
anderen Anbieter, wird es erst nach der Einwilligung „Externe Inhalte“ geladen.
|
|
300
|
+
|
|
301
|
+
```svelte
|
|
302
|
+
<MediaVideo media={angebot.media.video[0]} title="Rundgang durch die Wohnung" />
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
Eigenschaften:
|
|
306
|
+
|
|
307
|
+
```ts
|
|
308
|
+
export interface MediaVideoProps {
|
|
309
|
+
/** Video aus einem CMS-Eintrag. Fehlt es, wird nichts ausgegeben. */
|
|
310
|
+
media: MediaRef | null | undefined;
|
|
311
|
+
/** Kurzer Name des Videos, z. B. „Rundgang“. */
|
|
312
|
+
title: string;
|
|
313
|
+
class?: string;
|
|
314
|
+
}
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
## LeadForm
|
|
318
|
+
|
|
319
|
+
Ein Formular aus `dealsystem.config.ts`. Die Felder, Beschriftungen,
|
|
320
|
+
Fehlermeldungen, der Spam-Schutz und der Versand an das CRM sind eingebaut.
|
|
321
|
+
Schreibe kein eigenes `<form>` und kein eigenes `fetch`.
|
|
322
|
+
|
|
323
|
+
```svelte
|
|
324
|
+
<LeadForm funnel="kontakt" submitLabel="Anfrage senden" successMessage="Danke, wir melden uns." />
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
Neue Felder trägst du in `dealsystem.config.ts` unter `funnels.<schlüssel>.fields` ein.
|
|
328
|
+
Farben und Rundungen steuerst du mit CSS-Variablen, z. B. `--ds-color-primary`.
|
|
329
|
+
|
|
330
|
+
Eigenschaften:
|
|
331
|
+
|
|
332
|
+
```ts
|
|
333
|
+
export interface LeadFormProps {
|
|
334
|
+
/** Schlüssel des Formulars aus `dealsystem.config.ts`, z. B. `kontakt`. */
|
|
335
|
+
funnel: FunnelKey;
|
|
336
|
+
/** Text der Schaltfläche. Standard „Absenden“. */
|
|
337
|
+
submitLabel?: string;
|
|
338
|
+
/**
|
|
339
|
+
* Text nach erfolgreichem Versand. Standard „Vielen Dank. Ihre Anfrage ist bei uns angekommen.“; verspricht
|
|
340
|
+
* das Formular eine Datei (`leadmagnet`), kündigt der Standard sie per E-Mail an.
|
|
341
|
+
*/
|
|
342
|
+
successMessage?: string;
|
|
343
|
+
/** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
|
|
344
|
+
privacyHref?: string;
|
|
345
|
+
/** Eigene Anzeige nach erfolgreichem Versand, statt `successMessage`. */
|
|
346
|
+
success?: Snippet;
|
|
347
|
+
/** Wird nach erfolgreichem Versand aufgerufen, z. B. für eine Weiterleitung. */
|
|
348
|
+
onsuccess?: () => void;
|
|
349
|
+
class?: string;
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
type AutoFill =
|
|
353
|
+
'given-name' | 'family-name' | 'email' | 'tel' | 'address-line1' | 'postal-code' | 'address-level2';
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
## LeadHoneypot
|
|
357
|
+
|
|
358
|
+
Bot-Falle für ein Formular mit `createLeadClient()`: ein Feld, das Menschen nicht
|
|
359
|
+
sehen und nicht erreichen. Füllt ein Programm es aus, nimmt DealSystem die
|
|
360
|
+
Anfrage still nicht an. Gehört einmal in die eigene Oberfläche, am besten in
|
|
361
|
+
das `<form>`. `<LeadForm>` bringt es schon mit.
|
|
362
|
+
|
|
363
|
+
```svelte
|
|
364
|
+
<LeadHoneypot client={lead} />
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
Eigenschaften:
|
|
368
|
+
|
|
369
|
+
```ts
|
|
370
|
+
export interface LeadHoneypotProps {
|
|
371
|
+
/** Der Client aus `createLeadClient()`. */
|
|
372
|
+
client: Pick<LeadClient, 'setHoneypot'>;
|
|
373
|
+
}
|
|
374
|
+
```
|
|
375
|
+
|
|
376
|
+
## Booker
|
|
377
|
+
|
|
378
|
+
Terminbuchung auf der Seite: Tag wählen, Uhrzeit wählen, Angaben, Bestätigung. Die freien Zeiten,
|
|
379
|
+
Buchungsfragen, der Spam-Schutz und die Buchung im CRM sind eingebaut. Kein iframe, kein eigenes `fetch`.
|
|
380
|
+
|
|
381
|
+
```svelte
|
|
382
|
+
<Booker booking="erstgespraech" />
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
Den Schlüssel trägst du in `dealsystem.config.ts` unter `booking` ein. Die Terminart (Dauer, Arbeitszeiten,
|
|
386
|
+
Fragen) richtet der Kunde im CRM unter Termine ein; erfinde keine. Zeiten erscheinen in der Zeitzone des
|
|
387
|
+
Besuchers, die des Kalenders steht als Hinweis dabei. Farben und Rundungen wie bei `<LeadForm>` über
|
|
388
|
+
CSS-Variablen, z. B. `--ds-color-primary`.
|
|
389
|
+
|
|
390
|
+
Eigenschaften:
|
|
391
|
+
|
|
392
|
+
```ts
|
|
393
|
+
export interface BookerProps {
|
|
394
|
+
/** Schlüssel aus `booking` in `dealsystem.config.ts`, z. B. `erstgespraech`. */
|
|
395
|
+
booking: BookingKey;
|
|
396
|
+
/** So viele Tage zeigt der erste Abruf, Standard 14 (höchstens 31). „Weitere Termine“ lädt nach. */
|
|
397
|
+
days?: number;
|
|
398
|
+
/** Ebene der Schritt-Überschriften, Standard 2. */
|
|
399
|
+
headingLevel?: 2 | 3 | 4;
|
|
400
|
+
/** Text der Schaltfläche. Standard „Termin buchen“. */
|
|
401
|
+
submitLabel?: string;
|
|
402
|
+
/** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
|
|
403
|
+
privacyHref?: string;
|
|
404
|
+
/** Eigene Anzeige nach der Buchung; bekommt Datum und Uhrzeit als Text. */
|
|
405
|
+
success?: Snippet<[{ when: string; dryRun: boolean }]>;
|
|
406
|
+
/** Wird nach der Buchung aufgerufen. */
|
|
407
|
+
onbooked?: (booked: { start: string; end: string | null; dryRun: boolean }) => void;
|
|
408
|
+
class?: string;
|
|
409
|
+
}
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
## CollectionList
|
|
413
|
+
|
|
414
|
+
Liste der Einträge einer Sammlung. Das Snippet `item` bestimmt, wie ein
|
|
415
|
+
Eintrag aussieht.
|
|
416
|
+
|
|
417
|
+
Empfohlen: Einträge beim Build laden und übergeben. Dann stehen sie im
|
|
418
|
+
fertigen HTML und Suchmaschinen sehen sie.
|
|
419
|
+
|
|
420
|
+
```svelte
|
|
421
|
+
<script lang="ts">
|
|
422
|
+
import { CollectionList, MediaImage } from '@dealsystem/site';
|
|
423
|
+
let { data } = $props(); // aus +page.server.ts: { angebote: await getCollection('angebote') }
|
|
424
|
+
</script>
|
|
425
|
+
|
|
426
|
+
<CollectionList collection="angebote" entries={data.angebote} limit={12}>
|
|
427
|
+
{#snippet item(angebot)}
|
|
428
|
+
<a href="/angebote/{angebot.slug}">
|
|
429
|
+
<MediaImage media={angebot.media.bilder[0]} sizes="33vw" />
|
|
430
|
+
{angebot.data.titel}
|
|
431
|
+
</a>
|
|
432
|
+
{/snippet}
|
|
433
|
+
</CollectionList>
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
Ohne `entries` lädt die Liste die Einträge erst im Browser über die Site-API:
|
|
437
|
+
ohne `limit` die neuesten 20, mit `limit` bis zu 100.
|
|
438
|
+
|
|
439
|
+
Eigenschaften:
|
|
440
|
+
|
|
441
|
+
```ts
|
|
442
|
+
export interface CollectionListProps<K extends CollectionKey> {
|
|
443
|
+
/** Schlüssel der Sammlung aus `dealsystem.config.ts`. */
|
|
444
|
+
collection: K;
|
|
445
|
+
/** Einträge aus `getCollection()`. Ohne Angabe wird im Browser geladen. */
|
|
446
|
+
entries?: CollectionEntry<K>[];
|
|
447
|
+
/** Höchstzahl der angezeigten Einträge. */
|
|
448
|
+
limit?: number;
|
|
449
|
+
/** Darstellung eines Eintrags. */
|
|
450
|
+
item: Snippet<[CollectionEntry<K>]>;
|
|
451
|
+
/** Anzeige, wenn es keine Einträge gibt. */
|
|
452
|
+
empty?: Snippet;
|
|
453
|
+
class?: string;
|
|
454
|
+
}
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
## MapEmbed
|
|
458
|
+
|
|
459
|
+
Eine Karte von OpenStreetMap mit einer Markierung, z. B. für die Anfahrt. Sie
|
|
460
|
+
braucht keinen Eintrag unter `external`. Google Maps geht über `<Embed>` mit
|
|
461
|
+
der Vorlage `google-maps`. Die Karte lädt erst, wenn der Besucher zustimmt; vorher steht
|
|
462
|
+
dort ein Hinweis mit der Schaltfläche „Karte anzeigen“. Der Link „Karte in
|
|
463
|
+
OpenStreetMap öffnen“ funktioniert immer.
|
|
464
|
+
|
|
465
|
+
`lat` und `lon` sind die Koordinaten des Ortes als Dezimalzahlen. Kennst du sie
|
|
466
|
+
nicht, frag den Kunden danach oder verlinke stattdessen die Adresse; rate sie nie.
|
|
467
|
+
|
|
468
|
+
```svelte
|
|
469
|
+
<MapEmbed lat={53.8676} lon={10.6866} title="Unser Büro in der Lübecker Altstadt" />
|
|
470
|
+
```
|
|
471
|
+
|
|
472
|
+
Eigenschaften:
|
|
473
|
+
|
|
474
|
+
```ts
|
|
475
|
+
export interface MapEmbedProps {
|
|
476
|
+
/** Breitengrad des Ortes, z. B. `53.8676`. */
|
|
477
|
+
lat: number;
|
|
478
|
+
/** Längengrad des Ortes, z. B. `10.6866`. */
|
|
479
|
+
lon: number;
|
|
480
|
+
/** Was die Karte zeigt, z. B. „Unser Büro in der Lübecker Altstadt“. Für Vorleseprogramme. */
|
|
481
|
+
title: string;
|
|
482
|
+
/** Zoomstufe von 3 (Kontinent) bis 18 (Hausnummer). Standard 16. */
|
|
483
|
+
zoom?: number;
|
|
484
|
+
class?: string;
|
|
485
|
+
}
|
|
486
|
+
```
|
|
487
|
+
|
|
488
|
+
## Embed
|
|
489
|
+
|
|
490
|
+
Bettet einen fremden Dienst ein: YouTube, Vimeo, Google Maps, Calendly oder
|
|
491
|
+
einen anderen Anbieter. Vor der Einwilligung steht dort ein Platzhalter mit
|
|
492
|
+
Titel, Anbieter und „Video laden“; erst danach lädt der Rahmen. Der Link zum
|
|
493
|
+
Anbieter funktioniert immer.
|
|
494
|
+
|
|
495
|
+
`id` ist ein Schlüssel aus `external` in `dealsystem.config.ts`. Die Adresse
|
|
496
|
+
darfst du so kopieren, wie der Kunde sie schickt, z. B.
|
|
497
|
+
`https://www.youtube.com/watch?v=…`; das SDK macht daraus die Einbettung
|
|
498
|
+
(YouTube ohne Cookies, Vimeo mit `dnt=1`). Vorschaubilder von YouTube lädt der
|
|
499
|
+
Platzhalter nicht; für ein Bild davor nimm `poster` mit einem Bild aus
|
|
500
|
+
`static/`. Anleitung: `extern.md`.
|
|
501
|
+
|
|
502
|
+
```svelte
|
|
503
|
+
<Embed id="video" src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Rundgang durch das Haus" />
|
|
504
|
+
```
|
|
505
|
+
|
|
506
|
+
```ts
|
|
507
|
+
// dealsystem.config.ts
|
|
508
|
+
external: { video: { preset: 'youtube' } },
|
|
509
|
+
```
|
|
510
|
+
|
|
511
|
+
Eigenschaften:
|
|
512
|
+
|
|
513
|
+
```ts
|
|
514
|
+
export interface EmbedProps {
|
|
515
|
+
/** Schlüssel aus `external` in `dealsystem.config.ts`, z. B. `video`. */
|
|
516
|
+
id: ExternalKey;
|
|
517
|
+
/** Adresse beim Anbieter, z. B. `https://www.youtube.com/watch?v=…` oder `https://vimeo.com/123456789`. */
|
|
518
|
+
src: string;
|
|
519
|
+
/** Was zu sehen ist, z. B. „Rundgang durch das Haus“. Für Vorleseprogramme und den Platzhalter. */
|
|
520
|
+
title: string;
|
|
521
|
+
/** Seitenverhältnis, z. B. `16 / 9` (Video) oder `4 / 3`. Standard aus der Vorlage. */
|
|
522
|
+
aspect?: string;
|
|
523
|
+
/** Feste Höhe statt Seitenverhältnis, z. B. `700px` (Terminbuchung). */
|
|
524
|
+
height?: string;
|
|
525
|
+
/** Bild im Platzhalter, ein Pfad der eigenen Seite (`/bilder/vorschau.jpg`). Nie ein Bild des Anbieters. */
|
|
526
|
+
poster?: string;
|
|
527
|
+
class?: string;
|
|
528
|
+
}
|
|
529
|
+
```
|
|
530
|
+
|
|
531
|
+
## ExternalScript
|
|
532
|
+
|
|
533
|
+
Lädt ein fremdes Skript (Chat, Tag-Manager, Widget) erst, wenn der Besucher der
|
|
534
|
+
Kategorie aus der Deklaration zugestimmt hat. Je Seite höchstens einmal; nach
|
|
535
|
+
einem Widerruf lädt die Seite neu, damit das Skript weg ist. Zeigt selbst nichts.
|
|
536
|
+
|
|
537
|
+
`id` ist ein Schlüssel aus `external` in `dealsystem.config.ts`; `src` muss zu
|
|
538
|
+
einem Host unter `script` passen oder ein Pfad der eigenen Seite sein
|
|
539
|
+
(`/scripts/gtm.js` aus `static/`). Inline-Code gibt es nicht: Ein Snippet des
|
|
540
|
+
Anbieters legst du als Datei unter `static/scripts/` ab. Anleitung: `extern.md`.
|
|
541
|
+
|
|
542
|
+
```svelte
|
|
543
|
+
<ExternalScript id="chat" src="https://js.hs-scripts.com/1234567.js" attrs={{ id: 'hs-script-loader', defer: true }} />
|
|
544
|
+
```
|
|
545
|
+
|
|
546
|
+
```ts
|
|
547
|
+
// dealsystem.config.ts
|
|
548
|
+
external: {
|
|
549
|
+
chat: {
|
|
550
|
+
category: 'marketing',
|
|
551
|
+
provider: 'HubSpot, Inc., USA',
|
|
552
|
+
purpose: 'Live-Chat mit dem Vertrieb',
|
|
553
|
+
privacyUrl: 'https://legal.hubspot.com/de/privacy-policy',
|
|
554
|
+
script: ['https://js.hs-scripts.com'],
|
|
555
|
+
connect: ['https://*.hubspot.com'],
|
|
556
|
+
},
|
|
557
|
+
},
|
|
558
|
+
```
|
|
559
|
+
|
|
560
|
+
Eigenschaften:
|
|
561
|
+
|
|
562
|
+
```ts
|
|
563
|
+
export interface ExternalScriptProps {
|
|
564
|
+
/** Schlüssel aus `external` in `dealsystem.config.ts`, z. B. `chat`. */
|
|
565
|
+
id: ExternalKey;
|
|
566
|
+
/** Adresse des Skripts beim Anbieter oder Pfad der eigenen Seite (`/scripts/gtm.js`). */
|
|
567
|
+
src: string;
|
|
568
|
+
/** `async`, `defer`, `id`, `type`, `crossorigin`, `referrerpolicy` und `data-*`. Ohne Angabe: `async`. */
|
|
569
|
+
attrs?: ExternalScriptAttrs;
|
|
570
|
+
}
|
|
571
|
+
```
|
|
572
|
+
|
|
573
|
+
## CookieBanner
|
|
574
|
+
|
|
575
|
+
Hinweis zur Einwilligung. Gehört einmal in `src/routes/+layout.svelte`.
|
|
576
|
+
Er erscheint nur, wenn die Seite etwas nutzt, das eine Einwilligung braucht:
|
|
577
|
+
Tracking mit Kennung aus dem CRM, `<ConsentGate>`, `<MapEmbed>` oder ein Video
|
|
578
|
+
eines anderen Anbieters. Sonst bleibt er unsichtbar, und es wird nichts gespeichert.
|
|
579
|
+
„Alle ablehnen“ und „Alle akzeptieren“ sind gleich gestaltet. Die Wahl wird im
|
|
580
|
+
Browser gespeichert; ändern lässt sie sich über „Cookie-Einstellungen“ in
|
|
581
|
+
`<SiteFooterLegal />`.
|
|
582
|
+
|
|
583
|
+
```svelte
|
|
584
|
+
<CookieBanner />
|
|
585
|
+
```
|
|
586
|
+
|
|
587
|
+
Gefragt wird nach den Zwecken, die die Seite gerade braucht. Fest vorgeben lassen sie sich so:
|
|
588
|
+
|
|
589
|
+
```svelte
|
|
590
|
+
<CookieBanner categories={['marketing']} />
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
Eigenschaften:
|
|
594
|
+
|
|
595
|
+
```ts
|
|
596
|
+
export interface CookieBannerProps {
|
|
597
|
+
/** Zwecke, nach denen gefragt wird. Standard: die, die Bausteine auf der Seite brauchen. */
|
|
598
|
+
categories?: readonly ConsentCategory[];
|
|
599
|
+
/** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
|
|
600
|
+
privacyHref?: string;
|
|
601
|
+
}
|
|
602
|
+
```
|
|
603
|
+
|
|
604
|
+
## ConsentGate
|
|
605
|
+
|
|
606
|
+
Zeigt seinen Inhalt erst, wenn der Besucher dem Zweck zugestimmt hat. Vorher
|
|
607
|
+
wird der Inhalt gar nicht erzeugt, auch nicht beim Build.
|
|
608
|
+
|
|
609
|
+
Für fremde Dienste brauchst du `<ConsentGate>` meist nicht: Videos, Karten und
|
|
610
|
+
Terminbuchung bindest du mit `<Embed>` ein, fremde Skripte mit
|
|
611
|
+
`<ExternalScript>`, Tracking mit `<Tracking />`. Diese Bausteine fragen selbst
|
|
612
|
+
nach der Einwilligung. Jeder fremde Host muss unter `external` in
|
|
613
|
+
`dealsystem.config.ts` stehen, sonst blockiert ihn der Browser
|
|
614
|
+
(`npx dealsystem check` meldet es, `SEC-008`). Anleitung: `extern.md`.
|
|
615
|
+
|
|
616
|
+
```svelte
|
|
617
|
+
<ConsentGate category="marketing">
|
|
618
|
+
<Tracking />
|
|
619
|
+
</ConsentGate>
|
|
620
|
+
```
|
|
621
|
+
|
|
622
|
+
Eigener Inhalt, der erst nach der Zustimmung erscheinen soll, mit Ersatz davor:
|
|
623
|
+
|
|
624
|
+
```svelte
|
|
625
|
+
<ConsentGate category="media">
|
|
626
|
+
<Embed id="video" src="https://www.youtube.com/watch?v=…" title="Rundgang" />
|
|
627
|
+
{#snippet fallback({ accept })}
|
|
628
|
+
<p>Hier steht nach Ihrer Zustimmung ein Video von YouTube.</p>
|
|
629
|
+
<button type="button" onclick={accept}>Video anzeigen</button>
|
|
630
|
+
{/snippet}
|
|
631
|
+
</ConsentGate>
|
|
632
|
+
```
|
|
633
|
+
|
|
634
|
+
Eigenschaften:
|
|
635
|
+
|
|
636
|
+
```ts
|
|
637
|
+
export interface ConsentGateProps {
|
|
638
|
+
/** Zweck: `statistics`, `marketing` oder `media`. */
|
|
639
|
+
category: ConsentCategory;
|
|
640
|
+
/** Inhalt, der erst nach der Einwilligung entsteht. */
|
|
641
|
+
children: Snippet;
|
|
642
|
+
/** Ersatz ohne Einwilligung. `accept` stimmt genau diesem Zweck zu. */
|
|
643
|
+
fallback?: Snippet<[{ accept: () => void }]>;
|
|
644
|
+
}
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
## Tracking
|
|
648
|
+
|
|
649
|
+
Bindet Meta Pixel und Google Tag ein. Die IDs stehen im CRM unter
|
|
650
|
+
Eigene Website → Einstellungen, nie im Code. Geladen wird erst nach der Einwilligung
|
|
651
|
+
„Marketing“. Eigene Pixel-Snippets sind nicht erlaubt.
|
|
652
|
+
|
|
653
|
+
```svelte
|
|
654
|
+
<ConsentGate category="marketing">
|
|
655
|
+
<Tracking />
|
|
656
|
+
</ConsentGate>
|
|
657
|
+
```
|
|
658
|
+
|
|
659
|
+
|
|
660
|
+
## Impressum
|
|
661
|
+
|
|
662
|
+
Das Impressum der Seite. Gibt den Text aus, den der Kunde im CRM unter
|
|
663
|
+
Eigene Website → Rechtliches eingetragen hat. Der Text steht nie im Code, und die
|
|
664
|
+
Komponente erzeugt keinen eigenen. Gehört auf `src/routes/impressum/+page.svelte`.
|
|
665
|
+
|
|
666
|
+
Fehlt der Text noch, zeigt die Vorschau einen Hinweis, wo er einzutragen ist.
|
|
667
|
+
Live schalten lässt sich die Seite erst mit Text.
|
|
668
|
+
|
|
669
|
+
```svelte
|
|
670
|
+
<svelte:head>
|
|
671
|
+
<title>Impressum</title>
|
|
672
|
+
<meta name="description" content="Impressum und Anbieterkennzeichnung." />
|
|
673
|
+
</svelte:head>
|
|
674
|
+
|
|
675
|
+
<Impressum />
|
|
676
|
+
```
|
|
677
|
+
|
|
678
|
+
Eigenschaften:
|
|
679
|
+
|
|
680
|
+
```ts
|
|
681
|
+
export interface ImpressumProps {
|
|
682
|
+
/** Ebene der Überschrift „Impressum“. Standard 1 (die `h1` der Seite). */
|
|
683
|
+
headingLevel?: 1 | 2;
|
|
684
|
+
class?: string;
|
|
685
|
+
}
|
|
686
|
+
```
|
|
687
|
+
|
|
688
|
+
## Datenschutz
|
|
689
|
+
|
|
690
|
+
Die Datenschutzerklärung der Seite. Gibt den Text aus, den der Kunde im CRM
|
|
691
|
+
unter Eigene Website → Rechtliches eingetragen hat. Der Text steht nie im Code, und
|
|
692
|
+
die Komponente erzeugt keinen eigenen. Gehört auf
|
|
693
|
+
`src/routes/datenschutz/+page.svelte`.
|
|
694
|
+
|
|
695
|
+
Fehlt der Text noch, zeigt die Vorschau einen Hinweis, wo er einzutragen ist.
|
|
696
|
+
Live schalten lässt sich die Seite erst mit Text.
|
|
697
|
+
|
|
698
|
+
```svelte
|
|
699
|
+
<svelte:head>
|
|
700
|
+
<title>Datenschutz</title>
|
|
701
|
+
<meta name="description" content="Datenschutzerklärung dieser Website." />
|
|
702
|
+
</svelte:head>
|
|
703
|
+
|
|
704
|
+
<Datenschutz />
|
|
705
|
+
```
|
|
706
|
+
|
|
707
|
+
Eigenschaften:
|
|
708
|
+
|
|
709
|
+
```ts
|
|
710
|
+
export interface DatenschutzProps {
|
|
711
|
+
/** Ebene der Überschrift „Datenschutzerklärung“. Standard 1 (die `h1` der Seite). */
|
|
712
|
+
headingLevel?: 1 | 2;
|
|
713
|
+
class?: string;
|
|
714
|
+
}
|
|
715
|
+
```
|
|
716
|
+
|
|
717
|
+
## SiteFooterLegal
|
|
718
|
+
|
|
719
|
+
Die Pflicht-Links jeder Seite: Impressum, Datenschutz und „Cookie-Einstellungen“
|
|
720
|
+
(Widerruf der Einwilligung). Gehört in den Footer von `src/routes/+layout.svelte`.
|
|
721
|
+
„Cookie-Einstellungen“ erscheint nur, wenn es etwas einzustellen gibt (wie beim
|
|
722
|
+
`<CookieBanner />`).
|
|
723
|
+
|
|
724
|
+
```svelte
|
|
725
|
+
<footer>
|
|
726
|
+
<SiteFooterLegal />
|
|
727
|
+
</footer>
|
|
728
|
+
```
|
|
729
|
+
|
|
730
|
+
Eigenschaften:
|
|
731
|
+
|
|
732
|
+
```ts
|
|
733
|
+
export interface SiteFooterLegalProps {
|
|
734
|
+
/** Adresse des Impressums. Standard `/impressum`. */
|
|
735
|
+
impressumHref?: string;
|
|
736
|
+
/** Adresse der Datenschutzerklärung. Standard `/datenschutz`. */
|
|
737
|
+
datenschutzHref?: string;
|
|
738
|
+
class?: string;
|
|
739
|
+
}
|
|
740
|
+
```
|
|
741
|
+
|
|
742
|
+
## Seo
|
|
743
|
+
|
|
744
|
+
Titel, Beschreibung und Vorschaubild einer Seite: `<title>`, `meta description`,
|
|
745
|
+
die Angaben für WhatsApp, Facebook und LinkedIn (`og:*`) und `twitter:card`.
|
|
746
|
+
Gehört einmal auf jede Seite, statt `<title>` und `meta description` selbst in
|
|
747
|
+
`<svelte:head>` zu schreiben. Sonst stünden die Tags doppelt da, und der Kunde
|
|
748
|
+
könnte sie im CRM nicht ändern.
|
|
749
|
+
|
|
750
|
+
Was gilt, wird je Angabe entschieden: was der Kunde im CRM unter Eigene Website
|
|
751
|
+
→ Einstellungen → Google und Teilen für diese Seite eingetragen hat, sonst
|
|
752
|
+
`title`/`description`/`image` von hier, sonst seine Vorgabe für alle Seiten,
|
|
753
|
+
beim Titel zuletzt der Name der Website. Alles wird als Text ausgegeben, nie als
|
|
754
|
+
HTML.
|
|
755
|
+
|
|
756
|
+
```svelte
|
|
757
|
+
<script lang="ts">
|
|
758
|
+
import { Seo } from '@dealsystem/site';
|
|
759
|
+
let { data } = $props();
|
|
760
|
+
</script>
|
|
761
|
+
|
|
762
|
+
<Seo
|
|
763
|
+
title="Kontakt – {data.site.name}"
|
|
764
|
+
description="Schreiben Sie uns. Wir melden uns schnell bei Ihnen zurück."
|
|
765
|
+
/>
|
|
766
|
+
```
|
|
767
|
+
|
|
768
|
+
Auf einer Detailseite mit Bild aus dem CMS:
|
|
769
|
+
|
|
770
|
+
```svelte
|
|
771
|
+
<Seo title={angebot.data.titel} description={angebot.data.kurztext} image={angebot.media.bilder[0]} />
|
|
772
|
+
```
|
|
773
|
+
|
|
774
|
+
Eigenschaften:
|
|
775
|
+
|
|
776
|
+
```ts
|
|
777
|
+
export interface SeoProps {
|
|
778
|
+
/** Titel dieser Seite (Tab, Google), solange im CRM keiner eingetragen ist. Je Seite ein eigener. */
|
|
779
|
+
title?: string | null;
|
|
780
|
+
/** Beschreibung für Google und Vorschauen, ein bis zwei Sätze. */
|
|
781
|
+
description?: string | null;
|
|
782
|
+
/** Vorschaubild beim Teilen: Bild aus dem CMS oder Pfad bzw. Import eines Bildes im Projekt. */
|
|
783
|
+
image?: MediaRef | string | null;
|
|
784
|
+
/** Was auf dem Vorschaubild zu sehen ist (nur nötig, wenn `image` ein Pfad ist). */
|
|
785
|
+
imageAlt?: string | null;
|
|
786
|
+
}
|
|
787
|
+
```
|
|
788
|
+
|
|
789
|
+
## SiteHead
|
|
790
|
+
|
|
791
|
+
Angaben im Kopf jeder Seite, die für die ganze Website gelten. Gehört einmal in
|
|
792
|
+
`src/routes/+layout.svelte`.
|
|
793
|
+
|
|
794
|
+
- Favicon: Hat der Kunde im CRM unter Eigene Website → Einstellungen → Google und
|
|
795
|
+
Teilen eins hochgeladen, gelten dessen Größen (32 px im Tab, 180 px für iOS,
|
|
796
|
+
192 und 512 px im Web-Manifest). Sonst das Favicon aus dem Code, das du mit
|
|
797
|
+
`favicon` angibst. Schreib den Favicon-Link nicht zusätzlich in `src/app.html`.
|
|
798
|
+
- „Nicht bei Google anzeigen“: Hat der Kunde das eingestellt, steht auf jeder
|
|
799
|
+
Seite `<meta name="robots" content="noindex">`.
|
|
800
|
+
|
|
801
|
+
- Inhaltsblock: Die Texte und Bilder aus dem CRM (Content-Slots) stehen einmal
|
|
802
|
+
je Seite als `<script type="application/json" id="ds-content">` im Kopf. Der
|
|
803
|
+
Browser liest sie dort, nicht aus dem JS-Bundle. So kann DealSystem einen
|
|
804
|
+
geänderten Text in die fertige Seite schreiben, ohne sie neu zu bauen.
|
|
805
|
+
|
|
806
|
+
Titel und Beschreibung je Seite setzt `<Seo>`.
|
|
807
|
+
|
|
808
|
+
Außerdem meldet `<SiteHead>` jeden Seitenaufruf für die Statistik im CRM: Pfad,
|
|
809
|
+
Einstieg und Kampagne. Die Besuchs-ID geht nur mit Einwilligung „Marketing“ mit.
|
|
810
|
+
|
|
811
|
+
```svelte
|
|
812
|
+
<SiteHead favicon="/favicon.svg" />
|
|
813
|
+
```
|
|
814
|
+
|
|
815
|
+
Eigenschaften:
|
|
816
|
+
|
|
817
|
+
```ts
|
|
818
|
+
export interface SiteHeadProps {
|
|
819
|
+
/** Favicon aus dem Projekt (Pfad unter `static/`), solange im CRM keins hochgeladen ist. */
|
|
820
|
+
favicon?: string;
|
|
821
|
+
}
|
|
822
|
+
```
|
|
823
|
+
|
|
824
|
+
## Zeitfenster
|
|
825
|
+
|
|
826
|
+
Zeigt seinen Inhalt nur in einem Zeitraum, z. B. eine Anmeldung bis zum Beginn
|
|
827
|
+
eines Webinars. `ab` gehört dazu, `bis` nicht mehr. Eine Grenze reicht.
|
|
828
|
+
|
|
829
|
+
Zeitpunkte immer mit Zeitzone: `+01:00` im Winter, `+02:00` im Sommer (deutsche
|
|
830
|
+
Zeit), oder `Z` für UTC. Ohne Zeitzone bricht der Build ab (`QUA-009`).
|
|
831
|
+
|
|
832
|
+
```svelte
|
|
833
|
+
<Zeitfenster bis="2026-12-01T18:00:00+01:00">
|
|
834
|
+
<Text key="start.webinar.anmeldung" default="Jetzt anmelden: Webinar am 1. Dezember" />
|
|
835
|
+
</Zeitfenster>
|
|
836
|
+
<Zeitfenster ab="2026-12-01T18:00:00+01:00" bis="2026-12-01T19:30:00+01:00">
|
|
837
|
+
<Text key="start.webinar.live" default="Das Webinar läuft gerade" />
|
|
838
|
+
</Zeitfenster>
|
|
839
|
+
```
|
|
840
|
+
|
|
841
|
+
So wirkt es: Beim Bauen entscheidet die Uhrzeit des Builds, was im HTML steht.
|
|
842
|
+
Im Browser schaltet der Baustein sofort um, wenn eine Grenze erreicht ist.
|
|
843
|
+
DealSystem baut die Seite zu jeder Grenze neu, damit auch das HTML (Google,
|
|
844
|
+
Vorschauen) nach wenigen Minuten stimmt. Dafür müssen `ab` und `bis` feste
|
|
845
|
+
Zeichenketten sein, keine Variablen.
|
|
846
|
+
|
|
847
|
+
Eigenschaften:
|
|
848
|
+
|
|
849
|
+
```ts
|
|
850
|
+
export interface ZeitfensterProps {
|
|
851
|
+
/** Ab diesem Zeitpunkt sichtbar, mit Zeitzone, z. B. `2026-12-01T18:00:00+01:00`. */
|
|
852
|
+
ab?: string;
|
|
853
|
+
/** Bis zu diesem Zeitpunkt sichtbar (ausschließlich), mit Zeitzone. */
|
|
854
|
+
bis?: string;
|
|
855
|
+
/** Inhalt im Zeitraum. */
|
|
856
|
+
children: Snippet;
|
|
857
|
+
}
|
|
858
|
+
```
|
|
859
|
+
|
|
860
|
+
## consent
|
|
861
|
+
|
|
862
|
+
### consent
|
|
863
|
+
|
|
864
|
+
Zustand der Einwilligung. Reaktiv: in Markup und `$derived` verwendbar.
|
|
865
|
+
Vor der Entscheidung des Besuchers ist nichts erlaubt.
|
|
866
|
+
|
|
867
|
+
- `consent.has(zweck)` – hat der Besucher diesem Zweck zugestimmt?
|
|
868
|
+
- `consent.openSettings()` – den Hinweis erneut öffnen (Widerruf)
|
|
869
|
+
- `consent.grant(zweck)` – einem Zweck zustimmen, z. B. über „Karte anzeigen“
|
|
870
|
+
- `consent.acceptAll()`, `consent.rejectAll()`, `consent.save([zwecke])`
|
|
871
|
+
- `consent.decided` – hat der Besucher schon gewählt?
|
|
872
|
+
|
|
873
|
+
```ts
|
|
874
|
+
<script>
|
|
875
|
+
import { consent } from '@dealsystem/site';
|
|
876
|
+
</script>
|
|
877
|
+
|
|
878
|
+
<button type="button" onclick={() => consent.openSettings()}>Cookie-Einstellungen</button>
|
|
879
|
+
{#if consent.has('media')}<p>Karte wird angezeigt.</p>{/if}
|
|
880
|
+
```
|
|
881
|
+
|
|
882
|
+
### ConsentCategory
|
|
883
|
+
|
|
884
|
+
Zwecke, für die eine Einwilligung nötig ist:
|
|
885
|
+
`statistics` (Reichweitenmessung), `marketing` (Werbe-Pixel, Kampagnen),
|
|
886
|
+
`media` (eingebettete Inhalte Dritter wie Karten oder Videos).
|
|
887
|
+
|
|
888
|
+
```ts
|
|
889
|
+
type ConsentCategory = 'statistics' | 'marketing' | 'media';
|
|
890
|
+
```
|
|
891
|
+
|
|
892
|
+
## Eigene Formular-Oberfläche
|
|
893
|
+
|
|
894
|
+
Für mehrstufige Funnels, Rechner und Quiz. Vorlage: Skill `funnel-mehrstufig`.
|
|
895
|
+
|
|
896
|
+
### createLeadClient()
|
|
897
|
+
|
|
898
|
+
Formular ohne `<LeadForm>`: für eigene Oberflächen wie mehrstufige Funnels. Nimmt den Schlüssel aus
|
|
899
|
+
`dealsystem.config.ts`. Kein eigenes `fetch` an DealSystem, das ist verboten (`SEC-004`).
|
|
900
|
+
|
|
901
|
+
Zeig bei jedem Fehler außer `validation` den Ausweichkontakt `res.fallback` (`QUA-008`) und
|
|
902
|
+
setz `<LeadHoneypot client={lead} />` in die Oberfläche (Bot-Falle). Nach Erfolg passt `lead.successMessage`;
|
|
903
|
+
verspricht das Formular eine Datei (`leadmagnet`), kündigt dieser Text sie an.
|
|
904
|
+
|
|
905
|
+
```ts
|
|
906
|
+
<script lang="ts">
|
|
907
|
+
import { createLeadClient, LeadHoneypot } from '@dealsystem/site';
|
|
908
|
+
import { onMount } from 'svelte';
|
|
909
|
+
|
|
910
|
+
const lead = createLeadClient('bewertung');
|
|
911
|
+
onMount(() => () => lead.destroy());
|
|
912
|
+
let email = $state('');
|
|
913
|
+
let result = $state<Awaited<ReturnType<typeof lead.submit>> | null>(null);
|
|
914
|
+
|
|
915
|
+
// Eigenes <form>: Enter sendet, der Browser prüft `required`. Ohne `action`, Absenden nur hier (SEC-007).
|
|
916
|
+
async function senden(event: SubmitEvent) {
|
|
917
|
+
event.preventDefault();
|
|
918
|
+
result = await lead.submit({ email });
|
|
919
|
+
}
|
|
920
|
+
</script>
|
|
921
|
+
|
|
922
|
+
<form onsubmit={senden}>
|
|
923
|
+
<label for="email">E-Mail</label>
|
|
924
|
+
<input id="email" type="email" autocomplete="email" required bind:value={email} onfocus={() => lead.prepare()} />
|
|
925
|
+
<LeadHoneypot client={lead} />
|
|
926
|
+
<button type="submit">Senden</button>
|
|
927
|
+
</form>
|
|
928
|
+
{#if result && !result.ok}
|
|
929
|
+
<p role="alert">{result.message}</p>
|
|
930
|
+
{#if result.fallback?.phone}<a href="tel:{result.fallback.phone}">{result.fallback.phone}</a>{/if}
|
|
931
|
+
{/if}
|
|
932
|
+
```
|
|
933
|
+
|
|
934
|
+
```ts
|
|
935
|
+
function createLeadClient<K extends FunnelKey>(
|
|
936
|
+
funnel: K,
|
|
937
|
+
options: LeadClientOptions = {},
|
|
938
|
+
): LeadClient<K>;
|
|
939
|
+
```
|
|
940
|
+
|
|
941
|
+
### LeadResult
|
|
942
|
+
|
|
943
|
+
Ergebnis von `submit()`.
|
|
944
|
+
|
|
945
|
+
```ts
|
|
946
|
+
type LeadResult =
|
|
947
|
+
| {
|
|
948
|
+
ok: true;
|
|
949
|
+
/** `true` in der Vorschau: geprüft, aber nicht gespeichert. Zeig dann einen Hinweis. */
|
|
950
|
+
dryRun: boolean;
|
|
951
|
+
submissionId: string;
|
|
952
|
+
}
|
|
953
|
+
| {
|
|
954
|
+
ok: false;
|
|
955
|
+
reason: 'validation';
|
|
956
|
+
/** Text für Besucher, auf Deutsch. */
|
|
957
|
+
message: string;
|
|
958
|
+
/** Je abgelehntem Feld ein Text, z. B. `{ email: 'Bitte geben Sie …' }`. */
|
|
959
|
+
fields: Record<string, string>;
|
|
960
|
+
fallback: null;
|
|
961
|
+
/** @internal Fehler der Site-API, wenn der Server abgelehnt hat. */
|
|
962
|
+
error: SiteApiError | null;
|
|
963
|
+
}
|
|
964
|
+
| {
|
|
965
|
+
ok: false;
|
|
966
|
+
reason: Exclude<LeadFailureReason, 'validation'>;
|
|
967
|
+
message: string;
|
|
968
|
+
fields: Record<string, never>;
|
|
969
|
+
/** Telefon und E-Mail aus dem CRM. Zeig sie, damit der Besucher trotzdem anfragen kann. */
|
|
970
|
+
fallback: LeadFallback;
|
|
971
|
+
retryAfterSeconds: number | null;
|
|
972
|
+
/** @internal */
|
|
973
|
+
error: SiteApiError;
|
|
974
|
+
};
|
|
975
|
+
```
|
|
976
|
+
|
|
977
|
+
### LeadFailureReason
|
|
978
|
+
|
|
979
|
+
Warum eine Einsendung nicht angekommen ist.
|
|
980
|
+
|
|
981
|
+
```ts
|
|
982
|
+
type LeadFailureReason =
|
|
983
|
+
/** Angaben fehlen oder passen nicht: `fields` nennt je Feld den Text, `message` den für das ganze Formular. */
|
|
984
|
+
| 'validation'
|
|
985
|
+
/** Die Sicherheitsprüfung (Captcha) ließ sich nicht durchführen. */
|
|
986
|
+
| 'captcha'
|
|
987
|
+
/** Zu viele Anfragen;
|
|
988
|
+
```
|
|
989
|
+
|
|
990
|
+
### LeadFallback
|
|
991
|
+
|
|
992
|
+
Ausweichkontakt aus den Firmendaten im CRM. Leere Angaben sind `null`. Zeig ihn bei jedem Fehler außer `validation`.
|
|
993
|
+
|
|
994
|
+
```ts
|
|
995
|
+
interface LeadFallback {
|
|
996
|
+
phone: string | null;
|
|
997
|
+
email: string | null;
|
|
998
|
+
}
|
|
999
|
+
```
|
|
1000
|
+
### createFunnelState()
|
|
1001
|
+
|
|
1002
|
+
Hilfe für mehrstufige Formulare mit `createLeadClient()`: Schritte, Prüfung je Schritt, Fortschritt. Die
|
|
1003
|
+
Oberfläche baust du selbst; setze beim Schrittwechsel den Fokus auf die Überschrift des neuen Schritts.
|
|
1004
|
+
|
|
1005
|
+
```ts
|
|
1006
|
+
const lead = createLeadClient('bewertung');
|
|
1007
|
+
const funnel = createFunnelState(lead, [
|
|
1008
|
+
{ id: 'objekt', title: 'Um welche Immobilie geht es?', fields: ['objektart', 'wohnflaeche'] },
|
|
1009
|
+
{ id: 'kontakt', title: 'Wohin dürfen wir die Einschätzung schicken?', fields: ['firstName', 'email'] },
|
|
1010
|
+
]);
|
|
1011
|
+
// <input bind:value={funnel.values.wohnflaeche} />, <button onclick={() => funnel.next()}>Weiter</button>
|
|
1012
|
+
```
|
|
1013
|
+
|
|
1014
|
+
```ts
|
|
1015
|
+
function createFunnelState<K extends string>(
|
|
1016
|
+
client: LeadClient<K>,
|
|
1017
|
+
steps: readonly FunnelStep[],
|
|
1018
|
+
): FunnelState<K>;
|
|
1019
|
+
```
|
|
1020
|
+
|
|
1021
|
+
### FunnelStep
|
|
1022
|
+
|
|
1023
|
+
Ein Schritt: eine Überschrift und die Felder, die auf ihm stehen.
|
|
1024
|
+
|
|
1025
|
+
```ts
|
|
1026
|
+
interface FunnelStep {
|
|
1027
|
+
/** Eindeutig, z. B. `objekt`. */
|
|
1028
|
+
id: string;
|
|
1029
|
+
/** Überschrift des Schritts, z. B. „Um welche Immobilie geht es?“. */
|
|
1030
|
+
title: string;
|
|
1031
|
+
/** Namen der Felder aus `dealsystem.config.ts`, die auf diesem Schritt stehen. Leer = ein Schritt ohne Felder. */
|
|
1032
|
+
fields: readonly string[];
|
|
1033
|
+
}
|
|
1034
|
+
```
|
|
1035
|
+
|
|
1036
|
+
## Eigene Terminbuchung
|
|
1037
|
+
|
|
1038
|
+
Ohne `<Booker>`, mit eigener Oberfläche. Ablauf und Regeln: `termine.md`.
|
|
1039
|
+
|
|
1040
|
+
### createBookingClient()
|
|
1041
|
+
|
|
1042
|
+
Terminbuchung ohne `<Booker>`: für eine eigene Oberfläche. Nimmt den Schlüssel aus `booking` in
|
|
1043
|
+
`dealsystem.config.ts`. Die Terminart (Dauer, Arbeitszeiten, Fragen) richtet der Kunde im CRM ein; erfinde
|
|
1044
|
+
keine. Kein eigenes `fetch` an DealSystem (`SEC-004`).
|
|
1045
|
+
|
|
1046
|
+
Zeiten kommen und gehen in UTC. Zeig sie in der Zeitzone des Besuchers (`groupSlotsByDay`, `visitorTimeZone`)
|
|
1047
|
+
und nenne die des Kalenders (`timezone`) als Hinweis. Zeig bei jedem Fehler außer `validation` den
|
|
1048
|
+
Ausweichkontakt `fallback`; bei `slot_taken` die Zeiten neu laden. Setz `<LeadHoneypot client={termin} />` in
|
|
1049
|
+
die Oberfläche.
|
|
1050
|
+
|
|
1051
|
+
```ts
|
|
1052
|
+
<script lang="ts">
|
|
1053
|
+
import { createBookingClient, groupSlotsByDay, visitorTimeZone, LeadHoneypot } from '@dealsystem/site';
|
|
1054
|
+
import { onMount } from 'svelte';
|
|
1055
|
+
|
|
1056
|
+
const termin = createBookingClient('erstgespraech');
|
|
1057
|
+
const zone = visitorTimeZone();
|
|
1058
|
+
let tage = $state<ReturnType<typeof groupSlotsByDay>>([]);
|
|
1059
|
+
let start = $state('');
|
|
1060
|
+
let vorname = $state('');
|
|
1061
|
+
let email = $state('');
|
|
1062
|
+
let ergebnis = $state<Awaited<ReturnType<typeof termin.book>> | null>(null);
|
|
1063
|
+
|
|
1064
|
+
onMount(() => {
|
|
1065
|
+
termin.slots().then((r) => (tage = r.ok ? groupSlotsByDay(r.slots, zone) : []));
|
|
1066
|
+
return () => termin.destroy();
|
|
1067
|
+
});
|
|
1068
|
+
|
|
1069
|
+
async function buchen(event: SubmitEvent) {
|
|
1070
|
+
event.preventDefault();
|
|
1071
|
+
ergebnis = await termin.book({ start, firstName: vorname, email });
|
|
1072
|
+
}
|
|
1073
|
+
</script>
|
|
1074
|
+
|
|
1075
|
+
{#each tage as tag (tag.date)}
|
|
1076
|
+
<h3>{tag.long}</h3>
|
|
1077
|
+
{#each tag.slots as zeit (zeit.start)}
|
|
1078
|
+
<button type="button" aria-pressed={start === zeit.start} onclick={() => ((start = zeit.start), termin.prepare())}>
|
|
1079
|
+
{zeit.time}
|
|
1080
|
+
</button>
|
|
1081
|
+
{/each}
|
|
1082
|
+
{/each}
|
|
1083
|
+
<form onsubmit={buchen}>
|
|
1084
|
+
<label for="vorname">Vorname</label>
|
|
1085
|
+
<input id="vorname" required bind:value={vorname} />
|
|
1086
|
+
<label for="email">E-Mail</label>
|
|
1087
|
+
<input id="email" type="email" required bind:value={email} />
|
|
1088
|
+
<LeadHoneypot client={termin} />
|
|
1089
|
+
<button type="submit" disabled={!start}>Termin buchen</button>
|
|
1090
|
+
</form>
|
|
1091
|
+
{#if ergebnis && !ergebnis.ok}<p role="alert">{ergebnis.message}</p>{/if}
|
|
1092
|
+
```
|
|
1093
|
+
|
|
1094
|
+
```ts
|
|
1095
|
+
function createBookingClient<K extends BookingKey>(
|
|
1096
|
+
booking: K,
|
|
1097
|
+
options: BookingClientOptions = {},
|
|
1098
|
+
): BookingClient<K>;
|
|
1099
|
+
```
|
|
1100
|
+
|
|
1101
|
+
### BookingInput
|
|
1102
|
+
|
|
1103
|
+
Was gebucht werden soll.
|
|
1104
|
+
|
|
1105
|
+
```ts
|
|
1106
|
+
interface BookingInput {
|
|
1107
|
+
/** Beginn genau wie `start` aus `slots()` (UTC). */
|
|
1108
|
+
start: string;
|
|
1109
|
+
firstName: string;
|
|
1110
|
+
lastName?: string;
|
|
1111
|
+
email: string;
|
|
1112
|
+
phone?: string;
|
|
1113
|
+
/** Antworten auf die Buchungsfragen (`info.questions[].key`). */
|
|
1114
|
+
answers?: Record<string, string | number | boolean | readonly string[] | undefined>;
|
|
1115
|
+
/** Gewählte Ort-Art aus `info.locations`; ohne Angabe die erste. */
|
|
1116
|
+
locationType?: BookingLocationType;
|
|
1117
|
+
}
|
|
1118
|
+
```
|
|
1119
|
+
|
|
1120
|
+
### BookingResult
|
|
1121
|
+
|
|
1122
|
+
Ergebnis von `book()`.
|
|
1123
|
+
|
|
1124
|
+
```ts
|
|
1125
|
+
type BookingResult =
|
|
1126
|
+
| {
|
|
1127
|
+
ok: true;
|
|
1128
|
+
/** `true` in der Vorschau: geprüft, nichts gebucht, keine Mail. Zeig dann einen Hinweis. */
|
|
1129
|
+
dryRun: boolean;
|
|
1130
|
+
/** `true`, wenn derselbe Vorgang schon gebucht war (doppelt abgeschickt). Für Besucher: gebucht. */
|
|
1131
|
+
duplicate: boolean;
|
|
1132
|
+
/** Beginn und Ende in UTC. */
|
|
1133
|
+
start: string;
|
|
1134
|
+
end: string | null;
|
|
1135
|
+
submissionId: string;
|
|
1136
|
+
}
|
|
1137
|
+
| {
|
|
1138
|
+
ok: false;
|
|
1139
|
+
reason: 'validation';
|
|
1140
|
+
message: string;
|
|
1141
|
+
/** Je abgelehntem Feld ein Text: `firstName`, `lastName`, `email`, `phone` oder `answers.<key>`. */
|
|
1142
|
+
fields: Record<string, string>;
|
|
1143
|
+
fallback: null;
|
|
1144
|
+
/** @internal */
|
|
1145
|
+
error: SiteApiError | null;
|
|
1146
|
+
}
|
|
1147
|
+
| BookingFailure;
|
|
1148
|
+
```
|
|
1149
|
+
|
|
1150
|
+
### BookingFailureReason
|
|
1151
|
+
|
|
1152
|
+
Warum etwas nicht geklappt hat.
|
|
1153
|
+
|
|
1154
|
+
```ts
|
|
1155
|
+
type BookingFailureReason =
|
|
1156
|
+
/** Angaben fehlen oder passen nicht: `fields` nennt je Feld den Text. */
|
|
1157
|
+
| 'validation'
|
|
1158
|
+
/** Die Zeit ist inzwischen vergeben: freie Zeiten neu laden und eine andere wählen lassen. */
|
|
1159
|
+
| 'slot_taken'
|
|
1160
|
+
/** Die Angaben passen nicht zu dieser Terminart (Regel im CRM). Ausweichkontakt zeigen. */
|
|
1161
|
+
| 'not_qualified'
|
|
1162
|
+
/** Die Sicherheitsprüfung (Captcha) ließ sich nicht durchführen. */
|
|
1163
|
+
| 'captcha'
|
|
1164
|
+
/** Zu viele Anfragen;
|
|
1165
|
+
```
|
|
1166
|
+
### groupSlotsByDay()
|
|
1167
|
+
|
|
1168
|
+
Freie Termine nach Kalendertag in der Anzeige-Zeitzone, aufsteigend. Ein Termin um 23:30 UTC gehört in Berlin
|
|
1169
|
+
zum nächsten Tag; ein Tag der Zeitumstellung hat einfach eine Stunde mehr oder weniger.
|
|
1170
|
+
|
|
1171
|
+
```ts
|
|
1172
|
+
function groupSlotsByDay(
|
|
1173
|
+
slots: readonly BookingSlot[],
|
|
1174
|
+
timeZone: string,
|
|
1175
|
+
locale = 'de-DE',
|
|
1176
|
+
): BookingDay[];
|
|
1177
|
+
```
|
|
1178
|
+
|
|
1179
|
+
### visitorTimeZone()
|
|
1180
|
+
|
|
1181
|
+
IANA-Zeitzone des Besuchers, z. B. `Europe/Berlin`. Ohne Angabe des Browsers `Europe/Berlin`.
|
|
1182
|
+
|
|
1183
|
+
```ts
|
|
1184
|
+
function visitorTimeZone(): string;
|
|
1185
|
+
```
|
|
1186
|
+
|
|
1187
|
+
### timeZoneLabel()
|
|
1188
|
+
|
|
1189
|
+
Name einer Zeitzone für Besucher, z. B. `Mitteleuropäische Zeit (Berlin)`. Ohne Namen in `Intl` nur die Stadt.
|
|
1190
|
+
|
|
1191
|
+
```ts
|
|
1192
|
+
function timeZoneLabel(timeZone: string, locale = 'de-DE', at: Date = new Date()): string;
|
|
1193
|
+
```
|
|
1194
|
+
|
|
1195
|
+
### formatBookingTime()
|
|
1196
|
+
|
|
1197
|
+
Uhrzeit eines Zeitpunkts in einer Zeitzone, z. B. `09:30`.
|
|
1198
|
+
|
|
1199
|
+
```ts
|
|
1200
|
+
function formatBookingTime(instant: Date | string, timeZone: string): string;
|
|
1201
|
+
```
|
|
1202
|
+
|
|
1203
|
+
### formatBookingDate()
|
|
1204
|
+
|
|
1205
|
+
Datum eines Zeitpunkts in einer Zeitzone, z. B. `Dienstag, 1. Dezember 2026`.
|
|
1206
|
+
|
|
1207
|
+
```ts
|
|
1208
|
+
function formatBookingDate(instant: Date | string, timeZone: string, locale = 'de-DE'): string;
|
|
1209
|
+
```
|
|
1210
|
+
|
|
1211
|
+
## Kampagnen-Parameter
|
|
1212
|
+
|
|
1213
|
+
### getCampaignParam()
|
|
1214
|
+
|
|
1215
|
+
Wert eines eigenen URL-Parameters, z. B. `partner` aus `?partner=…`: aus dem aktuellen Besuch, sonst (nur mit
|
|
1216
|
+
Einwilligung) aus dem zuletzt gespeicherten. `null`, wenn es ihn nicht gibt. Nur im Browser.
|
|
1217
|
+
|
|
1218
|
+
Nicht gelesen werden UTM-Parameter, Klick-IDs und Namen, die nach Zugangs- oder Personendaten aussehen
|
|
1219
|
+
(`email`, `token`, `session` …); höchstens 20 Parameter, Werte bis 500 Zeichen. Mit der Anfrage gehen die
|
|
1220
|
+
Parameter ohnehin an das CRM (`<LeadForm>`), dafür ist nichts zu tun.
|
|
1221
|
+
|
|
1222
|
+
```ts
|
|
1223
|
+
<script lang="ts">
|
|
1224
|
+
import { getCampaignParam } from '@dealsystem/site';
|
|
1225
|
+
import { onMount } from 'svelte';
|
|
1226
|
+
let partner = $state<string | null>(null);
|
|
1227
|
+
onMount(() => (partner = getCampaignParam('partner')));
|
|
1228
|
+
</script>
|
|
1229
|
+
```
|
|
1230
|
+
|
|
1231
|
+
```ts
|
|
1232
|
+
function getCampaignParam(name: string): string | null;
|
|
1233
|
+
```
|
|
1234
|
+
|
|
1235
|
+
## Inhalte im Browser nachladen
|
|
1236
|
+
|
|
1237
|
+
### loadCollection()
|
|
1238
|
+
|
|
1239
|
+
Lädt Einträge einer Sammlung **im Browser** über die Site-API, z. B. für
|
|
1240
|
+
„Mehr laden“. Wirft nie: das Ergebnis ist `{ ok: true, data }` oder
|
|
1241
|
+
`{ ok: false, error }`. Ohne `limit` kommen 20 Einträge, höchstens 100 je
|
|
1242
|
+
Abruf; `total` nennt die Gesamtzahl, weitere holt `offset`. Inhalte, die Suchmaschinen sehen sollen, lädt
|
|
1243
|
+
stattdessen `getCollection()` aus `@dealsystem/site/content` beim Build.
|
|
1244
|
+
|
|
1245
|
+
```ts
|
|
1246
|
+
const result = await loadCollection('angebote', { limit: 12, offset: 12 });
|
|
1247
|
+
if (result.ok) angebote.push(...result.data.entries);
|
|
1248
|
+
else meldung = result.error.message;
|
|
1249
|
+
```
|
|
1250
|
+
|
|
1251
|
+
```ts
|
|
1252
|
+
async function loadCollection<K extends CollectionKey>(
|
|
1253
|
+
key: K,
|
|
1254
|
+
query: { limit?: number; offset?: number; sort?: 'newest' | 'oldest' } = {},
|
|
1255
|
+
): Promise<SiteApiResult<LoadedCollection<K>>>;
|
|
1256
|
+
```
|
|
1257
|
+
|
|
1258
|
+
### loadEntry()
|
|
1259
|
+
|
|
1260
|
+
Lädt einen Eintrag **im Browser** über die Site-API. Wirft nie; ein
|
|
1261
|
+
unbekannter Slug ergibt `{ ok: false, error: { kind: 'not_found' } }`.
|
|
1262
|
+
|
|
1263
|
+
```ts
|
|
1264
|
+
const result = await loadEntry('angebote', 'altbau-leipzig');
|
|
1265
|
+
if (result.ok) angebot = result.data;
|
|
1266
|
+
```
|
|
1267
|
+
|
|
1268
|
+
```ts
|
|
1269
|
+
async function loadEntry<K extends CollectionKey>(
|
|
1270
|
+
key: K,
|
|
1271
|
+
slug: string,
|
|
1272
|
+
): Promise<SiteApiResult<CollectionEntry<K>>>;
|
|
1273
|
+
```
|