@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
package/README.md
CHANGED
|
@@ -1,3 +1,146 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @dealsystem/site
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Bausteine für Self-Service-Websites auf DealSystem: Svelte-5-Komponenten, Lade-Helfer für den Build, ein
|
|
4
|
+
Vite-Plugin und die Konfiguration. Die Seite ist statisch (`@sveltejs/adapter-static`), enthält kein Secret
|
|
5
|
+
und spricht das CRM nur über die öffentliche Site-API an.
|
|
6
|
+
|
|
7
|
+
## Einstiegspunkte
|
|
8
|
+
|
|
9
|
+
| Import | Inhalt |
|
|
10
|
+
| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
11
|
+
| `@dealsystem/site` | Komponenten, `consent`, `loadCollection`, `loadEntry` |
|
|
12
|
+
| `@dealsystem/site/content` | `getCollection`, `getEntry`, `collectionEntries`, `getSlots`, `getSite`, `sitemap`, `robots` (nur beim Build) |
|
|
13
|
+
| `@dealsystem/site/config` | `defineSite`, `validateSiteConfig`, `handleHttpError`, `siteApiOrigin` |
|
|
14
|
+
| `@dealsystem/site/vite` | `dealsystem(site)` |
|
|
15
|
+
|
|
16
|
+
## Einrichtung
|
|
17
|
+
|
|
18
|
+
```ts
|
|
19
|
+
// dealsystem.config.ts
|
|
20
|
+
import { defineSite } from '@dealsystem/site/config';
|
|
21
|
+
|
|
22
|
+
export default defineSite({
|
|
23
|
+
siteId: '…',
|
|
24
|
+
funnels: {
|
|
25
|
+
kontakt: {
|
|
26
|
+
label: 'Kontakt',
|
|
27
|
+
fields: [
|
|
28
|
+
{ name: 'email', type: 'email', standardField: 'email', required: true },
|
|
29
|
+
{ name: 'nachricht', type: 'textarea' },
|
|
30
|
+
],
|
|
31
|
+
},
|
|
32
|
+
},
|
|
33
|
+
});
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
// vite.config.ts — dealsystem() steht vor sveltekit()
|
|
38
|
+
import { sveltekit } from '@sveltejs/kit/vite';
|
|
39
|
+
import { dealsystem } from '@dealsystem/site/vite';
|
|
40
|
+
import { defineConfig } from 'vite';
|
|
41
|
+
import site from './dealsystem.config';
|
|
42
|
+
|
|
43
|
+
export default defineConfig({ plugins: [dealsystem(site), sveltekit()] });
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
```js
|
|
47
|
+
// svelte.config.js
|
|
48
|
+
import adapter from '@sveltejs/adapter-static';
|
|
49
|
+
import { handleHttpError } from '@dealsystem/site/config';
|
|
50
|
+
|
|
51
|
+
export default {
|
|
52
|
+
kit: { adapter: adapter({ fallback: '404.html' }), prerender: { handleHttpError } },
|
|
53
|
+
};
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
```ts
|
|
57
|
+
// src/dealsystem.d.ts — macht funnel- und collection-Schlüssel zu geprüften Typen
|
|
58
|
+
import type site from '../dealsystem.config';
|
|
59
|
+
|
|
60
|
+
declare global {
|
|
61
|
+
interface DealsystemSiteTypes {
|
|
62
|
+
config: typeof site;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export {};
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Komponenten
|
|
70
|
+
|
|
71
|
+
| Komponente | Zweck |
|
|
72
|
+
| ----------------------------------------------- | ------------------------------------------------------------------------- |
|
|
73
|
+
| `<LeadForm funnel>` | Formular mit Beschriftungen, Fehlertexten, Honeypot, Captcha und Versand |
|
|
74
|
+
| `<Text key default>` | kurzer Text, im CRM änderbar |
|
|
75
|
+
| `<RichText key default>` / `<RichText content>` | formatierter Text, geprüft |
|
|
76
|
+
| `<MediaImage src\|media\|key alt>` | Bild; `alt` ist Pflicht, leer nur mit `decorative` |
|
|
77
|
+
| `<MediaVideo media title>` | Video mit Bedienelementen |
|
|
78
|
+
| `<MapEmbed lat lon title>` | Karte von OpenStreetMap, lädt erst nach Zustimmung |
|
|
79
|
+
| `<CollectionList collection entries>` | Liste von CMS-Einträgen |
|
|
80
|
+
| `<CookieBanner />`, `<ConsentGate category>` | Einwilligung, nur wenn nötig; vorher lädt nichts von Dritten |
|
|
81
|
+
| `<Tracking />` | Meta Pixel und Google Tag, nur in `<ConsentGate category="marketing">` |
|
|
82
|
+
| `<Impressum />`, `<Datenschutz />` | geben den Rechtstext des Kunden aus dem CRM aus; das Paket erzeugt keinen |
|
|
83
|
+
| `<SiteFooterLegal />` | Pflicht-Links und „Cookie-Einstellungen“ |
|
|
84
|
+
| `<Seo title description image />` | Titel, Beschreibung, Vorschaubild je Seite; das CRM kann sie ersetzen |
|
|
85
|
+
| `<SiteHead favicon />` | Favicon und `noindex` aus dem CRM, einmal im Layout |
|
|
86
|
+
|
|
87
|
+
Jede Komponente und Funktion trägt ihre Beschreibung mit Beispiel im Quelltext.
|
|
88
|
+
|
|
89
|
+
## Gestaltung
|
|
90
|
+
|
|
91
|
+
Die Komponenten erben Schrift und Textfarbe der Seite. Diese CSS-Variablen ändern den Rest:
|
|
92
|
+
|
|
93
|
+
| Variable | Standard | Wirkt auf |
|
|
94
|
+
| ---------------------------------------------- | --------------------- | ------------------------ |
|
|
95
|
+
| `--ds-color-primary` / `--ds-color-on-primary` | `#1a1a1a` / `#ffffff` | Schaltflächen |
|
|
96
|
+
| `--ds-color-text` / `--ds-color-surface` | `#1a1a1a` / `#ffffff` | Formular, Cookie-Hinweis |
|
|
97
|
+
| `--ds-color-border` | `#6b6b6b` | Eingabefelder |
|
|
98
|
+
| `--ds-color-error` | `#b3261e` | Fehlertexte |
|
|
99
|
+
| `--ds-color-focus` | `#1a56db` | Fokusrahmen |
|
|
100
|
+
| `--ds-radius` | `4px` | Ecken |
|
|
101
|
+
|
|
102
|
+
Die Standardwerte erfüllen die Kontraste von WCAG 2.1 AA. Wer sie ändert, prüft die Kontraste neu.
|
|
103
|
+
|
|
104
|
+
## Umgebung
|
|
105
|
+
|
|
106
|
+
| Variable | Gesetzt von | Bedeutung |
|
|
107
|
+
| ----------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------- |
|
|
108
|
+
| `DEALSYSTEM_CONTENT_FILE` | Build-Host | Pfad des Inhalts-Schnappschusses. Lokal: `.dealsystem/content.json` |
|
|
109
|
+
| `DEALSYSTEM_MANIFEST_FILE` | Build-Host | Zielpfad des Manifests. Lokal: `.dealsystem/manifest.json` |
|
|
110
|
+
| `PUBLIC_DEALSYSTEM_API`, `PUBLIC_DEALSYSTEM_SITE_KEY`, `PUBLIC_DEALSYSTEM_SITE_URL` | Build-Host | Zugang zur Site-API. Ohne sie antwortet der Dev-Server selbst (Schlüssel `dev`) |
|
|
111
|
+
|
|
112
|
+
## Captcha und Content-Security-Policy
|
|
113
|
+
|
|
114
|
+
Formulare schützt ALTCHA, ein Proof-of-Work-Verfahren ohne Drittanbieter. Beim ersten Kontakt mit dem
|
|
115
|
+
Formular holt der Browser eine Rechenaufgabe von der Site-API (`GET …/captcha`) und löst sie unsichtbar im
|
|
116
|
+
Hintergrund; die Lösung geht als `captcha` mit der Anfrage. Dafür ist keine Einwilligung nötig. Das Paket
|
|
117
|
+
bringt die Worker für `PBKDF2/SHA-*` und `SHA-*` mit; andere Algorithmen kann die Seite nicht lösen.
|
|
118
|
+
|
|
119
|
+
Was die CSP der Seite dafür braucht (in einem echten Browser geprüft):
|
|
120
|
+
|
|
121
|
+
| Direktive | Wert | Wofür |
|
|
122
|
+
| ------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
123
|
+
| `worker-src` | `'self'` | Worker des Captchas, eigene Dateien der Seite, kein `blob:` |
|
|
124
|
+
| `connect-src` | `'self'` und `siteApiOrigin()` | Aufgabe holen, Formular senden; die Adresse der Site-API kommt aus `PUBLIC_DEALSYSTEM_API` |
|
|
125
|
+
| `frame-src` | `'self'` und `https://www.openstreetmap.org` | Karte über `<MapEmbed />`, nur nach Zustimmung |
|
|
126
|
+
| `style-src` | `'self' 'unsafe-inline'` | Stil-Attribute von SvelteKit und vom Captcha-Widget |
|
|
127
|
+
|
|
128
|
+
`<Tracking />` braucht zusätzlich die Adressen von Google Tag und Meta Pixel in `script-src`, `connect-src`
|
|
129
|
+
und `img-src`.
|
|
130
|
+
|
|
131
|
+
## Marker im fertigen HTML
|
|
132
|
+
|
|
133
|
+
Für Prüfungen an der Ausgabe setzen die Komponenten feste Attribute: `data-ds-cookie-banner`,
|
|
134
|
+
`data-ds-footer-legal`, `data-ds-impressum`, `data-ds-datenschutz`, `data-ds-lead-form="<funnel>"`,
|
|
135
|
+
`data-ds-image` (am `<img>`), `data-ds-video`, `data-ds-richtext`, `data-ds-collection="<key>"`, `data-ds-slot="<key>"`.
|
|
136
|
+
|
|
137
|
+
## Anleitungen für Agenten
|
|
138
|
+
|
|
139
|
+
`docs/` enthält die Anleitungen, die ein KI-Agent im Kundenprojekt liest (`agents-block.md`, Detailseiten,
|
|
140
|
+
`llms.txt`). Sie werden mit `npm run docs` im Repo-Root aus dem Code und aus `docs-src/` erzeugt und nie von
|
|
141
|
+
Hand geändert.
|
|
142
|
+
|
|
143
|
+
## Vertrag
|
|
144
|
+
|
|
145
|
+
`contract/site-api.v1.json` ist die Kopie des Vertrags aus dem Core, gegen die der Client getestet ist
|
|
146
|
+
(siehe `contract/README.md`).
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: angebote-einbauen
|
|
3
|
+
description: Angebote, Objekte, Referenzen oder andere wiederkehrende Inhalte aus dem DealSystem-CRM auf der Website anzeigen, als Liste und als Detailseite. Verwenden, wenn der Kunde Inhalte zeigen will, die er im CRM pflegt.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Angebote und andere Sammlungen einbauen
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/inhalte.md`, `konfiguration.md`.
|
|
9
|
+
|
|
10
|
+
Der Starter enthält die Sammlung `angebote` mit Liste (`src/routes/angebote/`) und Detailseite
|
|
11
|
+
(`src/routes/angebote/[slug]/`). Nimm sie als Vorlage.
|
|
12
|
+
|
|
13
|
+
1. Die Sammlung steht in `dealsystem.config.ts` unter `collections`: Schlüssel, `label`, `route` mit
|
|
14
|
+
`:slug`, `indexRoute` und die `fields`. Bilder sind Felder vom Typ `image` oder `gallery`.
|
|
15
|
+
2. Nach einer Änderung an den Feldern: `npx dealsystem sync`. Der Befehl meldet, wo CRM und Konfiguration
|
|
16
|
+
voneinander abweichen. Scheitert er, weil du nicht angemeldet bist oder DealSystem nicht erreichbar ist,
|
|
17
|
+
mach trotzdem weiter bis Schritt 8 und bitte erst danach um die Anmeldung.
|
|
18
|
+
3. Geladen wird nur in `+page.server.ts` mit `export const prerender = true`:
|
|
19
|
+
`getCollection('angebote')` für die Liste, `getEntry('angebote', params.slug)` für die Detailseite.
|
|
20
|
+
4. Die Detailseite exportiert `entries = collectionEntries('angebote')`, damit für jeden Eintrag eine Seite
|
|
21
|
+
entsteht.
|
|
22
|
+
5. Ausgabe: Texte normal als `{angebot.data.titel}`, formatierter Text mit
|
|
23
|
+
`<RichText content={angebot.data.beschreibung} />`, Bilder mit `<MediaImage media={angebot.media.bilder[0]} />`.
|
|
24
|
+
Bilder stehen unter `media`, nicht unter `data`.
|
|
25
|
+
6. Rechne damit, dass es keine Einträge gibt: Zeig dann einen freundlichen Hinweis statt einer leeren Liste.
|
|
26
|
+
7. Die Inhalte selbst pflegt der Kunde im CRM unter CMS. Leg keine Beispiel-Angebote im Code an. Ändert er
|
|
27
|
+
dort etwas, erneuert DealSystem die Seite von selbst.
|
|
28
|
+
8. Prüfen: `npm run check`, `npm run build`, `npx dealsystem check --output build`. Das geht ohne Anmeldung.
|
|
29
|
+
„Geprüft“ sagst du dem Kunden nur, wenn die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite
|
|
30
|
+
geprüft“ endet.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bild-einbauen
|
|
3
|
+
description: Ein Foto des Kunden (Porträt, Team, Büro, Titelbild) auf die Website bringen, so dass er es später im CRM selbst tauschen kann. Verwenden, wenn der Kunde ein Bild schickt oder ein Foto auf einer Seite haben möchte.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Bild einbauen
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/gestaltung.md`, Abschnitt „Bilder“.
|
|
9
|
+
|
|
10
|
+
Reihenfolge: **erst der Platz im Code mit einem Bild aus dem Projekt, dann hochladen, danach tauscht der Kunde
|
|
11
|
+
das Bild selbst** unter Eigene Website → Inhalte. Einen anderen Ort im CRM dafür gibt es nicht; nenne keinen.
|
|
12
|
+
|
|
13
|
+
1. Hat der Kunde ein Foto geschickt, hol es mit dem Befehl ins Projekt, nicht durch Kopieren:
|
|
14
|
+
`npx dealsystem image add <pfad/zur/datei> --name ueber-uns-foto --key ueberuns.inhaber.foto --alt "…"`.
|
|
15
|
+
Der Befehl verkleinert auf höchstens 2 560 px, dreht nach der Kamera-Angabe und **entfernt alle
|
|
16
|
+
Metadaten, auch den Standort** (Handyfotos tragen oft die GPS-Koordinaten der Wohnung). Die Datei landet
|
|
17
|
+
in `src/lib/assets/bilder/`.
|
|
18
|
+
2. Der Befehl gibt eine Import-Zeile und einen Baustein aus. Setz beides in die Seite ein: den Import in das
|
|
19
|
+
`<script>`, den `<MediaImage>` an die Stelle des Bildes. Ergänze `group` (Name der Seite) und `sizes`.
|
|
20
|
+
3. `alt` beschreibt, was zu sehen ist („Der Inhaber vor dem Büro in der Altstadt“). Weißt du es nicht, frag
|
|
21
|
+
den Kunden in einem Satz.
|
|
22
|
+
4. Schlüssel: der erste Teil ohne Bindestrich (`ueberuns.inhaber.foto`, nicht `ueber-uns.…`), alle Angaben
|
|
23
|
+
außer `default` als feste Zeichenkette.
|
|
24
|
+
5. Ansehen mit `npm run dev`. Prüfen und hochladen wie im Skill `veroeffentlichen`.
|
|
25
|
+
6. Sag dem Kunden in einem Satz: Das Foto ist eingebaut; nach dem Veröffentlichen kann er es unter
|
|
26
|
+
Eigene Website → Inhalte selbst gegen ein anderes tauschen.
|
|
27
|
+
|
|
28
|
+
Später ein anderes Foto in einen schon veröffentlichten Bild-Platz, ohne neuen Code: `npx dealsystem image push
|
|
29
|
+
<datei> --slot <schlüssel> --alt "…"`. Gleiche Bearbeitung wie `add`, setzt das Bild in DealSystem (wie „Bild
|
|
30
|
+
ersetzen“ unter Eigene Website → Inhalte) und geht **ohne weitere Freigabe live** — frag den Kunden vorher. Der
|
|
31
|
+
Schlüssel ist der aus `<MediaImage key="…">`; ein neuer Platz ist erst nach dem Hochladen bekannt. `npm run dev`
|
|
32
|
+
zeigt das neue Bild danach sofort.
|
|
33
|
+
|
|
34
|
+
Fehler des Befehls:
|
|
35
|
+
|
|
36
|
+
- HEIC vom iPhone lässt sich nicht umwandeln: Bitte den Kunden, das Foto als JPEG zu schicken (die Meldung
|
|
37
|
+
sagt, wie).
|
|
38
|
+
- Größer als 15 MB, kein Bild, SVG oder GIF: Die Meldung nennt den Weg. Ein Logo als SVG gehört nach
|
|
39
|
+
`static/` und wird mit `src="/logo.svg"` eingebunden.
|
|
40
|
+
- Gibt es den Namen schon, nimm einen anderen `--name`. `--force` nur, wenn das alte Bild wirklich weg darf.
|
|
41
|
+
|
|
42
|
+
Hat der Kunde noch kein Foto, nimm ein neutrales Bild aus dem Projekt als Standard und sag ihm, dass er es nach
|
|
43
|
+
dem Veröffentlichen selbst tauschen kann.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: domain-verbinden
|
|
3
|
+
description: Die eigene Domain des Kunden (z. B. muster-immobilien.de) mit der DealSystem-Website verbinden. Verwenden, wenn der Kunde fragt, wie seine Seite unter seiner Adresse erreichbar wird.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Eigene Domain verbinden
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md`, Abschnitt „Eigene Domain“.
|
|
9
|
+
|
|
10
|
+
Das Verbinden macht der Kunde selbst im CRM und bei seinem Domain-Anbieter. Du begleitest ihn.
|
|
11
|
+
|
|
12
|
+
1. Voraussetzung: Die Seite ist veröffentlicht oder es gibt zumindest eine Vorschau.
|
|
13
|
+
2. Sag dem Kunden: „Öffnen Sie im CRM Eigene Website → Domains und tragen Sie dort Ihre Domain ein.“
|
|
14
|
+
3. Das CRM zeigt die Einträge, die er bei seinem Domain-Anbieter (dort, wo er die Domain gekauft hat) setzen
|
|
15
|
+
muss, zum Kopieren. Erkläre bei Bedarf in einfachen Worten, wo man das beim Anbieter findet: meist unter
|
|
16
|
+
„DNS“ oder „Nameserver-Einstellungen“.
|
|
17
|
+
4. Danach klickt er im CRM auf „Jetzt prüfen“. Es kann von Minuten bis zu einigen Stunden dauern, bis die
|
|
18
|
+
Einträge überall gelten. Das ist normal.
|
|
19
|
+
5. Mit `npx dealsystem status` siehst du, ob die Domain verbunden ist.
|
|
20
|
+
6. Das Zertifikat für https richtet DealSystem selbst ein. Dafür ist nichts zu tun.
|
|
21
|
+
|
|
22
|
+
Nicht tun: Einträge raten, Zugangsdaten zum Domain-Anbieter erfragen, am Projekt etwas für die Domain
|
|
23
|
+
ändern. Die Domain steht nirgends im Code.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: extern-einbinden
|
|
3
|
+
description: Einen fremden Dienst einbinden, z. B. ein YouTube- oder Vimeo-Video, Google Maps, eine Terminbuchung (Calendly), ein Bewertungs-Widget, einen Chat oder ein anderes Skript (Tag-Manager). Verwenden, wenn der Kunde ein Video, Widget oder Skript eines anderen Anbieters auf der Seite haben möchte.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Fremden Dienst einbinden
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/extern.md` (alle Fälle mit Beispielen) und `komponenten.md`
|
|
9
|
+
(Abschnitte Embed und ExternalScript).
|
|
10
|
+
|
|
11
|
+
Termine aus dem DealSystem-Kalender sind kein fremder Dienst: Skill `termin-buchung` (`<Booker>`). Calendly nur,
|
|
12
|
+
wenn der Kunde ausdrücklich Calendly nutzt.
|
|
13
|
+
|
|
14
|
+
1. Kläre in einem Satz, was der Kunde will, und lass dir die Adresse schicken (Video-Link, Buchungsseite,
|
|
15
|
+
Code-Schnipsel des Anbieters). Rate keine Adresse und keine Konto-Kennung.
|
|
16
|
+
2. Trage den Dienst in `dealsystem.config.ts` unter `external` ein:
|
|
17
|
+
- **YouTube, Vimeo, Google Maps, Calendly:** nur die Vorlage, z. B. `video: { preset: 'youtube' }`.
|
|
18
|
+
- **Anderer Dienst:** `category` (`media`, `marketing` oder `statistics`), `provider` mit Sitz, `purpose`,
|
|
19
|
+
`privacyUrl` und die Hosts je Art: `script`, `connect`, `img`, `frame`, `media`, `style`, `font`. Hosts
|
|
20
|
+
nur als `https://host.de`; Platzhalter `https://*.host.de` nie in `script` oder `frame`. Die Hosts stehen
|
|
21
|
+
meist in der Hilfe des Anbieters unter „Content Security Policy“.
|
|
22
|
+
3. Setze den Baustein aus `@dealsystem/site` an die gewünschte Stelle:
|
|
23
|
+
- Video, Karte, Termin, Widget: `<Embed id="video" src="…" title="Was zu sehen ist" />`. Die Adresse darf
|
|
24
|
+
so bleiben, wie der Kunde sie schickt.
|
|
25
|
+
- Skript: `<ExternalScript id="chat" src="https://…" />`, für alle Seiten in `src/routes/+layout.svelte`.
|
|
26
|
+
Ein Snippet mit Code legst du als Datei unter `static/scripts/` ab und lädst `src="/scripts/datei.js"`.
|
|
27
|
+
4. Nie: `<iframe>` oder `<script>` von Hand, Hosts in `svelte.config.js`, Code in `<script>…</script>`,
|
|
28
|
+
`category: 'necessary'`. Die Seite lädt fremde Dienste erst nach der Einwilligung; das übernehmen die
|
|
29
|
+
Bausteine.
|
|
30
|
+
5. Prüfen: `npm run check`, `npm run build`, `npx dealsystem check --output build`, alles beheben. Mit
|
|
31
|
+
`npm run dev` ansehen: Erst steht ein Platzhalter da, nach „Video laden“ oder „Alle akzeptieren“ der Dienst.
|
|
32
|
+
Fehlt ein Host, steht in der Browser-Konsole „Refused to …“ mit dem Host: unter `external` ergänzen.
|
|
33
|
+
6. Sag dem Kunden in einem Satz, dass der Dienst eingebaut ist und erst nach Zustimmung des Besuchers lädt,
|
|
34
|
+
und dass er ihn in seiner Datenschutzerklärung nennen muss (Eigene Website → Rechtliches). Den Text
|
|
35
|
+
schreibst du nicht.
|
|
36
|
+
7. Eigene Skripte laufen nur mit eigener Domain. Hat die Seite noch keine, sag das dem Kunden in einem Satz
|
|
37
|
+
(Skill `domain-verbinden`); Videos und Karten gehen auch ohne.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: formular-anbinden
|
|
3
|
+
description: Ein Kontakt- oder Anfrageformular einbauen oder ändern, dessen Einsendungen als Lead im DealSystem-CRM ankommen. Verwenden, wenn der Kunde ein Formular, ein neues Feld oder eine andere Anfrageart möchte.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Formular anbinden
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/konfiguration.md` und `komponenten.md` (Abschnitt
|
|
9
|
+
LeadForm).
|
|
10
|
+
|
|
11
|
+
1. Formulare stehen in `dealsystem.config.ts` unter `funnels`. Ein neues Formular bekommt einen Schlüssel
|
|
12
|
+
in Kleinbuchstaben mit Bindestrichen (`ankauf-anfrage`), ein `label` und seine `fields`.
|
|
13
|
+
2. Jedes Formular braucht ein Feld mit `standardField: 'email'` oder `standardField: 'phone'`, sonst
|
|
14
|
+
entsteht im CRM kein Kontakt. Namen immer getrennt als `firstName` und `lastName`.
|
|
15
|
+
3. Feldtypen: `text`, `email`, `tel`, `textarea`, `select`, `multiselect`, `checkbox`, `date`. `select`
|
|
16
|
+
und `multiselect` brauchen `options`. Jedes Feld bekommt ein verständliches `label`. Versteckte Felder
|
|
17
|
+
(`type: 'hidden'`, z. B. `from: { query: 'partner' }` für `?partner=…`) füllt das SDK selbst; mit
|
|
18
|
+
`crm` am Formular schlägst du vor, was im CRM passiert (`konfiguration.md`).
|
|
19
|
+
4. Auf der Seite genügt eine Zeile:
|
|
20
|
+
`<LeadForm funnel="ankauf-anfrage" submitLabel="Anfrage senden" successMessage="Danke, wir melden uns." />`
|
|
21
|
+
5. Kein eigenes `fetch`. Beschriftungen, Fehlermeldungen, Spam-Schutz und Versand bringt `<LeadForm>` mit.
|
|
22
|
+
Eigene Oberfläche oder mehrere Schritte: `<form onsubmit={…}>` mit `createLeadClient()`, Skill
|
|
23
|
+
`funnel-mehrstufig`.
|
|
24
|
+
6. Prüfen: `npm run check` (ein Tippfehler im Schlüssel ist ein Fehler), `npm run build`,
|
|
25
|
+
`npx dealsystem check --output build`. Das geht ohne Anmeldung. „Geprüft“ sagst du dem Kunden nur, wenn
|
|
26
|
+
die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite geprüft“ endet.
|
|
27
|
+
7. Ausprobieren mit `npm run dev`: Die Einsendung wird geprüft, aber nicht gespeichert.
|
|
28
|
+
8. **Leadmagnet** (Formular verspricht eine Datei, z. B. einen Ratgeber als PDF): im Code nur ankündigen,
|
|
29
|
+
`leadmagnet: { label: 'Ratgeber Immobilienverkauf' }` am Formular. Keine Datei ins Projekt, kein Link im
|
|
30
|
+
Code. `<LeadForm>` kündigt die Datei nach dem Absenden selbst an. Sag dem Kunden in einem Satz: Er lädt die
|
|
31
|
+
Datei unter Eigene Website → Formulare hoch und schaltet dort die Eingangsbestätigung ein; mit ihr kommt
|
|
32
|
+
der Download-Link.
|
|
33
|
+
9. Nach dem Hochladen erscheint das Formular im CRM unter Eigene Website → Formulare. Dort legt der Kunde fest,
|
|
34
|
+
was mit einer Anfrage geschieht (Liste, Deal, Benachrichtigung). Sag ihm das in einem Satz.
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
<script lang="ts">
|
|
2
|
+
// Beispiel „Immobilie bewerten lassen“: mehrstufig, ohne Wertberechnung. Gehört nach
|
|
3
|
+
// `src/lib/BewertungFunnel.svelte`; das Formular `bewertung` steht in `dealsystem.config.ts` (siehe SKILL.md).
|
|
4
|
+
import { createFunnelState, createLeadClient, LeadHoneypot, Text, type LeadResult } from '@dealsystem/site';
|
|
5
|
+
import { onMount, tick } from 'svelte';
|
|
6
|
+
|
|
7
|
+
const lead = createLeadClient('bewertung');
|
|
8
|
+
const funnel = createFunnelState(lead, [
|
|
9
|
+
{ id: 'objekt', title: 'Um welche Immobilie geht es?', fields: ['objektart'] },
|
|
10
|
+
{ id: 'lage', title: 'Wie groß ist sie, und wo liegt sie?', fields: ['wohnflaeche', 'plz'] },
|
|
11
|
+
{ id: 'zustand', title: 'In welchem Zustand ist sie?', fields: ['zustand', 'baujahr'] },
|
|
12
|
+
{
|
|
13
|
+
id: 'kontakt',
|
|
14
|
+
title: 'Wohin dürfen wir die Einschätzung schicken?',
|
|
15
|
+
fields: ['firstName', 'lastName', 'email', 'phone'],
|
|
16
|
+
},
|
|
17
|
+
]);
|
|
18
|
+
|
|
19
|
+
let heading = $state<HTMLElement | null>(null);
|
|
20
|
+
let result = $state<LeadResult | null>(null);
|
|
21
|
+
let done = $state(false);
|
|
22
|
+
|
|
23
|
+
onMount(() => () => lead.destroy());
|
|
24
|
+
|
|
25
|
+
/** Nach jedem Wechsel steht der Fokus auf der Überschrift: Vorleseprogramme lesen den neuen Schritt vor. */
|
|
26
|
+
async function focusHeading() {
|
|
27
|
+
await tick();
|
|
28
|
+
heading?.focus();
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
async function weiter() {
|
|
32
|
+
result = null;
|
|
33
|
+
if (!funnel.next()) {
|
|
34
|
+
await tick();
|
|
35
|
+
document.querySelector<HTMLElement>('.funnel [aria-invalid="true"]')?.focus();
|
|
36
|
+
return;
|
|
37
|
+
}
|
|
38
|
+
await focusHeading();
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
async function zurueck() {
|
|
42
|
+
result = null;
|
|
43
|
+
funnel.back();
|
|
44
|
+
await focusHeading();
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
async function absenden() {
|
|
48
|
+
result = null;
|
|
49
|
+
if (!funnel.next()) {
|
|
50
|
+
await tick();
|
|
51
|
+
document.querySelector<HTMLElement>('.funnel [aria-invalid="true"]')?.focus();
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
result = await funnel.submit();
|
|
55
|
+
if (result.ok) done = true;
|
|
56
|
+
await focusHeading();
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// Die Felder eines Schritts stehen als Namen in der Liste oben; für `bind:value` reicht hier ein Text je Feld.
|
|
60
|
+
const values = funnel.values as Record<string, string | undefined>;
|
|
61
|
+
const field = (name: string) => lead.field(name)!;
|
|
62
|
+
const id = (name: string) => `bewertung-${name}`;
|
|
63
|
+
</script>
|
|
64
|
+
|
|
65
|
+
<section class="funnel" aria-labelledby="bewertung-titel">
|
|
66
|
+
{#if done}
|
|
67
|
+
<h2 id="bewertung-titel" tabindex="-1" bind:this={heading}>
|
|
68
|
+
<Text key="bewertung.danke.titel" default="Vielen Dank" />
|
|
69
|
+
</h2>
|
|
70
|
+
<Text
|
|
71
|
+
key="bewertung.danke.text"
|
|
72
|
+
as="p"
|
|
73
|
+
default="Ihre Angaben sind bei uns angekommen. Wir sehen sie uns an und melden uns mit einer Einschätzung."
|
|
74
|
+
/>
|
|
75
|
+
{#if result?.ok && result.dryRun}
|
|
76
|
+
<p>Vorschau: Diese Anfrage wurde geprüft, aber nicht gespeichert.</p>
|
|
77
|
+
{/if}
|
|
78
|
+
{:else}
|
|
79
|
+
<p class="funnel__schritt">Schritt {funnel.progress.current} von {funnel.progress.total}</p>
|
|
80
|
+
<progress max={funnel.progress.total} value={funnel.progress.current} aria-label="Fortschritt"></progress>
|
|
81
|
+
<h2 id="bewertung-titel" tabindex="-1" bind:this={heading}>{funnel.step.title}</h2>
|
|
82
|
+
|
|
83
|
+
<div class="funnel__felder">
|
|
84
|
+
{#each funnel.step.fields as name (name)}
|
|
85
|
+
{@const f = field(name)}
|
|
86
|
+
{@const error = funnel.errors[name]}
|
|
87
|
+
<div class="funnel__feld">
|
|
88
|
+
<label for={id(name)}
|
|
89
|
+
>{f.label}{#if f.required}<span aria-hidden="true"> *</span>{/if}</label
|
|
90
|
+
>
|
|
91
|
+
{#if f.type === 'select'}
|
|
92
|
+
<select
|
|
93
|
+
id={id(name)}
|
|
94
|
+
bind:value={values[name]}
|
|
95
|
+
required={f.required}
|
|
96
|
+
aria-invalid={error ? 'true' : undefined}
|
|
97
|
+
aria-describedby={error ? `${id(name)}-fehler` : undefined}
|
|
98
|
+
onfocus={() => lead.prepare()}
|
|
99
|
+
>
|
|
100
|
+
<option value="">Bitte wählen</option>
|
|
101
|
+
{#each f.options ?? [] as option (option)}
|
|
102
|
+
<option value={option}>{option}</option>
|
|
103
|
+
{/each}
|
|
104
|
+
</select>
|
|
105
|
+
{:else}
|
|
106
|
+
<input
|
|
107
|
+
id={id(name)}
|
|
108
|
+
type={f.type === 'email' || f.type === 'tel' ? f.type : 'text'}
|
|
109
|
+
inputmode={name === 'wohnflaeche' || name === 'plz' || name === 'baujahr'
|
|
110
|
+
? 'numeric'
|
|
111
|
+
: undefined}
|
|
112
|
+
bind:value={values[name]}
|
|
113
|
+
required={f.required}
|
|
114
|
+
placeholder={f.placeholder}
|
|
115
|
+
aria-invalid={error ? 'true' : undefined}
|
|
116
|
+
aria-describedby={error ? `${id(name)}-fehler` : undefined}
|
|
117
|
+
onfocus={() => lead.prepare()}
|
|
118
|
+
/>
|
|
119
|
+
{/if}
|
|
120
|
+
{#if error}
|
|
121
|
+
<p class="funnel__fehler" id="{id(name)}-fehler">{error}</p>
|
|
122
|
+
{/if}
|
|
123
|
+
</div>
|
|
124
|
+
{/each}
|
|
125
|
+
</div>
|
|
126
|
+
|
|
127
|
+
<LeadHoneypot client={lead} />
|
|
128
|
+
|
|
129
|
+
<div aria-live="polite">
|
|
130
|
+
{#if lead.status === 'captcha'}
|
|
131
|
+
<p>Die Sicherheitsprüfung läuft. Ihre Angaben werden gleich gesendet.</p>
|
|
132
|
+
{:else if lead.status === 'sending'}
|
|
133
|
+
<p>Ihre Angaben werden gesendet.</p>
|
|
134
|
+
{/if}
|
|
135
|
+
</div>
|
|
136
|
+
|
|
137
|
+
{#if result && !result.ok && result.reason !== 'validation'}
|
|
138
|
+
<div role="alert">
|
|
139
|
+
<p><strong>Ihre Angaben wurden nicht gesendet.</strong> {result.message}</p>
|
|
140
|
+
{#if result.fallback.phone || result.fallback.email}
|
|
141
|
+
<p>
|
|
142
|
+
Sie erreichen uns auch direkt:
|
|
143
|
+
{#if result.fallback.phone}<a href="tel:{result.fallback.phone.replace(/[^+0-9]/g, '')}"
|
|
144
|
+
>{result.fallback.phone}</a
|
|
145
|
+
>{/if}
|
|
146
|
+
{#if result.fallback.phone && result.fallback.email}oder{/if}
|
|
147
|
+
{#if result.fallback.email}<a href="mailto:{result.fallback.email}">{result.fallback.email}</a
|
|
148
|
+
>{/if}
|
|
149
|
+
</p>
|
|
150
|
+
{/if}
|
|
151
|
+
</div>
|
|
152
|
+
{/if}
|
|
153
|
+
|
|
154
|
+
<div class="funnel__knoepfe">
|
|
155
|
+
{#if !funnel.isFirst}
|
|
156
|
+
<button type="button" onclick={zurueck}>Zurück</button>
|
|
157
|
+
{/if}
|
|
158
|
+
{#if funnel.isLast}
|
|
159
|
+
<button type="button" onclick={absenden} aria-disabled={lead.status !== 'idle'}
|
|
160
|
+
>Einschätzung anfragen</button
|
|
161
|
+
>
|
|
162
|
+
{:else}
|
|
163
|
+
<button type="button" onclick={weiter}>Weiter</button>
|
|
164
|
+
{/if}
|
|
165
|
+
</div>
|
|
166
|
+
<Text
|
|
167
|
+
key="bewertung.hinweis.text"
|
|
168
|
+
as="p"
|
|
169
|
+
class="funnel__hinweis"
|
|
170
|
+
default="Wir nennen Ihnen keinen automatisch errechneten Preis. Wir sehen uns Ihre Angaben an und melden uns mit einer Einschätzung."
|
|
171
|
+
/>
|
|
172
|
+
{/if}
|
|
173
|
+
</section>
|
|
174
|
+
|
|
175
|
+
<style>
|
|
176
|
+
.funnel {
|
|
177
|
+
max-width: 36rem;
|
|
178
|
+
}
|
|
179
|
+
.funnel :focus-visible {
|
|
180
|
+
outline: 3px solid var(--color-focus, #1a56db);
|
|
181
|
+
outline-offset: 2px;
|
|
182
|
+
}
|
|
183
|
+
progress {
|
|
184
|
+
width: 100%;
|
|
185
|
+
height: 0.5rem;
|
|
186
|
+
accent-color: var(--color-primary, #1a1a1a);
|
|
187
|
+
}
|
|
188
|
+
.funnel__feld {
|
|
189
|
+
margin-bottom: 1.25rem;
|
|
190
|
+
}
|
|
191
|
+
.funnel__feld label {
|
|
192
|
+
display: block;
|
|
193
|
+
margin-bottom: 0.375rem;
|
|
194
|
+
font-weight: 600;
|
|
195
|
+
}
|
|
196
|
+
input,
|
|
197
|
+
select {
|
|
198
|
+
display: block;
|
|
199
|
+
width: 100%;
|
|
200
|
+
box-sizing: border-box;
|
|
201
|
+
min-height: 44px;
|
|
202
|
+
padding: 0.5rem 0.75rem;
|
|
203
|
+
font: inherit;
|
|
204
|
+
}
|
|
205
|
+
.funnel__fehler {
|
|
206
|
+
color: var(--color-error, #b3261e);
|
|
207
|
+
}
|
|
208
|
+
.funnel__knoepfe {
|
|
209
|
+
display: flex;
|
|
210
|
+
gap: 0.75rem;
|
|
211
|
+
margin-top: 1.5rem;
|
|
212
|
+
}
|
|
213
|
+
button {
|
|
214
|
+
min-height: 44px;
|
|
215
|
+
padding: 0.5rem 1.25rem;
|
|
216
|
+
font: inherit;
|
|
217
|
+
font-weight: 600;
|
|
218
|
+
cursor: pointer;
|
|
219
|
+
}
|
|
220
|
+
</style>
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: funnel-mehrstufig
|
|
3
|
+
description: Ein mehrstufiges Formular mit eigener Oberfläche bauen (Funnel, Rechner, Quiz), z. B. „Immobilie bewerten lassen“. Verwenden, wenn der Kunde mehr will als ein einfaches Kontaktformular, etwa Schritte mit Fortschrittsanzeige.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Mehrstufiges Formular (Funnel)
|
|
7
|
+
|
|
8
|
+
Nachschlagen: `node_modules/@dealsystem/site/docs/komponenten.md` (Abschnitte „createLeadClient“,
|
|
9
|
+
„createFunnelState“, „LeadHoneypot“) und `konfiguration.md` (Felder, `hidden`, `crm`).
|
|
10
|
+
|
|
11
|
+
Für ein einfaches Formular reicht `<LeadForm>` (Skill `formular-anbinden`). Eine eigene Oberfläche baust du
|
|
12
|
+
mit `createLeadClient()` und `createFunnelState()`. Nie mit eigenem `fetch`, nie mit eigenem Captcha.
|
|
13
|
+
|
|
14
|
+
## Ablauf
|
|
15
|
+
|
|
16
|
+
1. Formular in `dealsystem.config.ts` unter `funnels` anlegen, mit allen Feldern aller Schritte. Ein Feld mit
|
|
17
|
+
`standardField: 'email'` oder `'phone'` ist Pflicht. Versteckte Felder (`type: 'hidden'`) füllt das SDK
|
|
18
|
+
selbst, z. B. `{ name: 'partner', type: 'hidden', from: { query: 'partner' } }` für `?partner=…`.
|
|
19
|
+
2. Optional `crm` am Formular: Vorschlag, was im CRM passiert (`createDeal`, `pipeline`, `stage`,
|
|
20
|
+
`dealName`, `tags`, `leadSource`, `confirmation`). Namen müssen so im CRM existieren; das CRM legt nichts an
|
|
21
|
+
und meldet Unbekanntes beim Hochladen. Der Kunde kann jede Angabe im CRM ändern, dann gilt seine.
|
|
22
|
+
3. Die Oberfläche als Komponente unter `src/lib/` bauen, nach dem Beispiel `BewertungFunnel.svelte` in diesem
|
|
23
|
+
Ordner. Pflicht darin:
|
|
24
|
+
- `createLeadClient('<schlüssel>')` und `onMount(() => () => lead.destroy())`
|
|
25
|
+
- `lead.prepare()` beim ersten Feld (startet die Sicherheitsprüfung unsichtbar im Hintergrund)
|
|
26
|
+
- `<LeadHoneypot client={lead} />` (Bot-Falle)
|
|
27
|
+
- bei jedem Fehler außer `validation` den Text `result.message` und den Ausweichkontakt `result.fallback`
|
|
28
|
+
zeigen (`QUA-008` warnt sonst)
|
|
29
|
+
- bei `result.dryRun` (Vorschau) einen Hinweis „geprüft, aber nicht gespeichert“
|
|
30
|
+
4. Barrierefreiheit:
|
|
31
|
+
- Jeder Schritt hat eine Überschrift mit `tabindex="-1"`; nach „Weiter“ und „Zurück“ bekommt sie den Fokus.
|
|
32
|
+
- Fortschritt sichtbar und vorlesbar: „Schritt 2 von 4“ und `<progress>`.
|
|
33
|
+
- „Zurück“ auf jedem Schritt außer dem ersten. Die Antworten bleiben erhalten (`funnel.values`).
|
|
34
|
+
- Fehler am Feld (`aria-invalid`, `aria-describedby`), Fokus auf das erste fehlerhafte Feld.
|
|
35
|
+
- Status in einem `aria-live="polite"`-Bereich (`lead.status`: `captcha`, `sending`).
|
|
36
|
+
- Jeder Schritt darf ein eigenes `<form onsubmit={…}>` sein: Enter sendet bzw. geht weiter, der Browser prüft
|
|
37
|
+
`required`. Ohne `action` (oder `action="#"`), kein `method="post"`, kein `target`; abgeschickt wird nur im
|
|
38
|
+
Code mit `lead.submit()` (`SEC-007`). Beispiel: Abschnitt „createLeadClient“ in `komponenten.md`.
|
|
39
|
+
5. Danach eine Seite, die die Komponente zeigt, mit `<Seo>`, genau einer `h1` und Texten als `<Text>`.
|
|
40
|
+
6. Prüfen und hochladen wie im Skill `veroeffentlichen`. Nach dem Hochladen steht das Formular im CRM unter
|
|
41
|
+
Eigene Website → Formulare.
|
|
42
|
+
|
|
43
|
+
## Immobilie bewerten lassen
|
|
44
|
+
|
|
45
|
+
**Rechne keinen Wert aus und erfinde keine Spanne.** DealSystem liefert keine Marktdaten. Am Ende steht ehrlich
|
|
46
|
+
„Wir melden uns mit einer Einschätzung“. Will der Kunde eine Spanne zeigen, muss er eigene Werte liefern
|
|
47
|
+
(z. B. Quadratmeterpreise je PLZ als Sammlung im CMS) und den Hinweis „unverbindliche Orientierung des Anbieters“
|
|
48
|
+
akzeptieren; frag ihn dann zuerst.
|
|
49
|
+
|
|
50
|
+
Formular für das Beispiel (`dealsystem.config.ts`, unter `funnels`):
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
bewertung: {
|
|
54
|
+
label: 'Bewertung',
|
|
55
|
+
fields: [
|
|
56
|
+
{ name: 'objektart', type: 'select', label: 'Art der Immobilie', required: true,
|
|
57
|
+
options: ['Wohnung', 'Haus', 'Mehrfamilienhaus', 'Grundstück'] },
|
|
58
|
+
{ name: 'wohnflaeche', type: 'text', label: 'Wohnfläche in m²', required: true, maxLength: 6, placeholder: 'z. B. 85' },
|
|
59
|
+
{ name: 'plz', type: 'text', label: 'Postleitzahl', required: true, maxLength: 5 },
|
|
60
|
+
{ name: 'zustand', type: 'select', label: 'Zustand', required: true,
|
|
61
|
+
options: ['Neuwertig', 'Gepflegt', 'Renovierungsbedürftig', 'Sanierungsbedürftig'] },
|
|
62
|
+
{ name: 'baujahr', type: 'text', label: 'Baujahr (ungefähr)', maxLength: 4 },
|
|
63
|
+
{ name: 'firstName', type: 'text', label: 'Vorname', standardField: 'firstName' },
|
|
64
|
+
{ name: 'lastName', type: 'text', label: 'Nachname', standardField: 'lastName', required: true },
|
|
65
|
+
{ name: 'email', type: 'email', label: 'E-Mail', standardField: 'email', required: true },
|
|
66
|
+
{ name: 'phone', type: 'tel', label: 'Telefon', standardField: 'phone' },
|
|
67
|
+
{ name: 'quelle', type: 'hidden', from: { value: 'Bewertungsrechner' } },
|
|
68
|
+
{ name: 'partner', type: 'hidden', from: { query: 'partner' } },
|
|
69
|
+
],
|
|
70
|
+
crm: { createDeal: true, dealName: 'Bewertung {{lastName}}', tags: ['Bewertung'] },
|
|
71
|
+
},
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Seite `src/routes/bewertung/+page.svelte`:
|
|
75
|
+
|
|
76
|
+
```svelte
|
|
77
|
+
<script lang="ts">
|
|
78
|
+
import { Seo, Text } from '@dealsystem/site';
|
|
79
|
+
import BewertungFunnel from '$lib/BewertungFunnel.svelte';
|
|
80
|
+
</script>
|
|
81
|
+
|
|
82
|
+
<Seo
|
|
83
|
+
title="Immobilie bewerten lassen"
|
|
84
|
+
description="In vier kurzen Schritten zur persönlichen Einschätzung."
|
|
85
|
+
/>
|
|
86
|
+
<section class="section">
|
|
87
|
+
<div class="page">
|
|
88
|
+
<Text
|
|
89
|
+
key="bewertung.titel"
|
|
90
|
+
default="Was ist Ihre Immobilie wert?"
|
|
91
|
+
as="h1"
|
|
92
|
+
label="Überschrift"
|
|
93
|
+
group="Bewertung"
|
|
94
|
+
/>
|
|
95
|
+
<BewertungFunnel />
|
|
96
|
+
</div>
|
|
97
|
+
</section>
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
`pipeline` und `stage` setzt du nur, wenn der Kunde sie genau so benannt hat; sonst lässt du sie weg und er
|
|
101
|
+
wählt sie im CRM. Erfinde keine Namen.
|