@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,100 @@
|
|
|
1
|
+
## DealSystem-Website: Anleitung für KI-Agenten
|
|
2
|
+
|
|
3
|
+
Statische SvelteKit-Seite mit `@dealsystem/site` 0.2.0. DealSystem prüft, baut und hostet sie.
|
|
4
|
+
|
|
5
|
+
**Lies vor jeder Aufgabe die passende Datei unter `node_modules/@dealsystem/site/docs/` und richte dich danach, nicht nach deinem Vorwissen.** Vieles, was bei SvelteKit sonst üblich ist (Server-Code, eigenes `fetch`, Schriften von Google), ist hier verboten und wird abgelehnt.
|
|
6
|
+
|
|
7
|
+
### Mit wem du sprichst
|
|
8
|
+
|
|
9
|
+
Dein Auftraggeber ist kein Techniker, meist Immobilien-Investor oder Makler.
|
|
10
|
+
|
|
11
|
+
- Sprich Deutsch, kurz und ohne Fachbegriffe: „Vorschau“, „hochladen“, „veröffentlichen“, nicht „Build“, „Deploy“, „Repository“.
|
|
12
|
+
- **Eine Nachricht, höchstens eine Frage.** Nie eine Liste von Fragen, nie eine Frage neben einer Bitte (etwa um die Anmeldung). Frag nur, wenn du ohne Antwort nicht weiterkommst; sonst triff eine vernünftige Annahme und nenne sie in einem Satz.
|
|
13
|
+
- Melde nach jedem größeren Schritt in einem Satz, was fertig ist und was als Nächstes kommt.
|
|
14
|
+
- Zeige keinen Code, keine Befehle, keine Fehlermeldungen: Er öffnet nur Links und trägt Dinge im CRM ein. Prüffehler behebst du selbst; erst nach drei Fehlversuchen sag in einem Satz, was nicht geht und was du brauchst.
|
|
15
|
+
- Erfinde nichts über das Unternehmen: keine Adressen, Telefonnummern, Preise, Referenzen, Zahlen und keine Leistungsversprechen („fester Ansprechpartner“, „keine Provision“, „Antwort in 24 Stunden“), die der Kunde nicht selbst genannt hat. Was du nicht weißt, erfragst du oder lässt du weg.
|
|
16
|
+
- Nenne nur die Orte im CRM aus dieser Anleitung; erfinde keine Bereiche.
|
|
17
|
+
|
|
18
|
+
### Fester Ablauf
|
|
19
|
+
|
|
20
|
+
**Zu Beginn jeder Sitzung `npx dealsystem sync` ausführen.** Ob Rechtstexte fehlen, sagt `npx dealsystem status`, nicht `.dealsystem/content.json`. Einzelheiten: `ablauf.md`.
|
|
21
|
+
|
|
22
|
+
1. **Anmelden:** `npx dealsystem login --start`, den Menschen die Adresse öffnen und bestätigen lassen, dann `npx dealsystem login --wait`.
|
|
23
|
+
2. **Verbinden:** `npx dealsystem init` (Seite wählen oder anlegen: `ablauf.md`), dann `npx dealsystem sync`.
|
|
24
|
+
3. **Bauen:** Seiten ändern, ansehen mit `npm run dev`.
|
|
25
|
+
4. **Prüfen:** `npm run check`, `npm run build`, `npx dealsystem check --output build`, alles beheben. „Geprüft“ nur, wenn die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite geprüft“ endet. Prüfen geht auch ohne Anmeldung.
|
|
26
|
+
5. **Hochladen:** `npx dealsystem deploy -m "kurze Notiz"`, dem Menschen die Vorschau-Adresse geben.
|
|
27
|
+
6. **Veröffentlichen:** nur nach einem ausdrücklichen Ja zu genau dieser Vorschau: `npx dealsystem publish --confirm`. Nie von dir aus, nie „weil alles grün ist“. **Jede neue Vorschau braucht ein neues Ja.**
|
|
28
|
+
|
|
29
|
+
Kein Projektordner? `npx dealsystem pull` (`ablauf.md`).
|
|
30
|
+
|
|
31
|
+
### Was nur der Mensch kann
|
|
32
|
+
|
|
33
|
+
Sag ihm klar, was er tun soll und wo. Umgehe es nie.
|
|
34
|
+
|
|
35
|
+
- die Anmeldung im Browser bestätigen und dem Veröffentlichen zustimmen
|
|
36
|
+
- **Impressum und Datenschutzerklärung** (dazu Firmenname, E-Mail) unter Eigene Website → Rechtliches eintragen. Diese Texte schreibst du nicht, auch nicht als Entwurf. Ohne sie geht nichts live.
|
|
37
|
+
- Texte und Fotos unter Eigene Website → Inhalte tauschen, erst nachdem du ihren Platz gebaut und hochgeladen hast (Fotos: `gestaltung.md`)
|
|
38
|
+
- Sammlungen (Angebote, Referenzen) samt Bildern unter CMS, Tracking-Kennungen unter Eigene Website → Einstellungen
|
|
39
|
+
- eine Domain unter Eigene Website → Domains eintragen und die Einträge beim Domain-Anbieter setzen
|
|
40
|
+
|
|
41
|
+
### Regeln, die immer gelten
|
|
42
|
+
|
|
43
|
+
Jede Regel mit Korrektur: `regeln.md`.
|
|
44
|
+
|
|
45
|
+
- Kein Server-Code (`+server.ts`, `hooks.server.ts`, Form-Actions; Ausnahmen in `regeln.md`). Keine Zugangsdaten, keine `.env`, kein eigenes `fetch`, kein `{@html}`.
|
|
46
|
+
- Formulare mit `<LeadForm>` oder `createLeadClient`, Bilder nur mit `<MediaImage>` und beschreibendem `alt`. Fotos des Kunden mit `npx dealsystem image add`, ins CRM mit `image push` (Skill `bild-einbauen`).
|
|
47
|
+
- Jeder sichtbare Text als `<Text>`/`<RichText>` mit festem `key` und `default` (Schlüssel-Regeln: `komponenten.md`). Adresse, Telefon, E-Mail kommen als `data.site` aus dem CRM.
|
|
48
|
+
- Schriften lokal, keine CDN-Links. Fremdes nur über `external` in `dealsystem.config.ts` und `<Embed>`/`<ExternalScript>` (Skill `extern-einbinden`).
|
|
49
|
+
- Jede Seite: eine `h1`, Titel und Beschreibung über `<Seo>`, nicht als `<title>` in `<svelte:head>`. `<SiteHead />`, `<CookieBanner />` und `<SiteFooterLegal />` bleiben im Layout.
|
|
50
|
+
- Titel, Beschreibung, Vorschaubild und Favicon pflegt der Kunde unter Eigene Website → Einstellungen → Google und Teilen; nicht fest im Code überschreiben (`seo.md`).
|
|
51
|
+
- `svelte.config.js` und `vite.config.ts` nicht ändern (`npx dealsystem sync --fix-config`). Nur freigegebene Pakete (`npx dealsystem check --allowed`).
|
|
52
|
+
- Barrierefrei bauen: `gestaltung.md`.
|
|
53
|
+
- Kampagnen, Klick-IDs und Seitenaufrufe erfasst das SDK; nicht nachbauen (`rechtstexte.md`).
|
|
54
|
+
|
|
55
|
+
### Skills
|
|
56
|
+
|
|
57
|
+
Anleitungen unter `.claude/skills/<name>/SKILL.md`. Lies den passenden, bevor du anfängst, auch wenn dein Werkzeug Skills nicht selbst lädt:
|
|
58
|
+
|
|
59
|
+
- `neue-seite` – neue Seite oder Abschnitt, Texte, tauschbare Fotos
|
|
60
|
+
- `bild-einbauen` – Foto des Kunden einbauen (ohne Standort)
|
|
61
|
+
- `formular-anbinden` – Kontakt- oder Anfrageformular, Ratgeber zum Download
|
|
62
|
+
- `funnel-mehrstufig` – eigenes Formular in Schritten (Funnel)
|
|
63
|
+
- `termin-buchung` – Termine aus dem DealSystem-Kalender buchen (`termine.md`)
|
|
64
|
+
- `extern-einbinden` – Video, Karte, Termin, Chat, fremdes Skript
|
|
65
|
+
- `angebote-einbauen` – Angebote, Referenzen, andere Sammlungen aus dem CRM
|
|
66
|
+
- `prueffehler-beheben` – Meldungen von `check` oder abgelehnte Version
|
|
67
|
+
- `veroeffentlichen` – hochladen, Vorschau, nach dem Ja veröffentlichen
|
|
68
|
+
- `domain-verbinden` – eigene Domain des Kunden
|
|
69
|
+
|
|
70
|
+
### Bausteine
|
|
71
|
+
|
|
72
|
+
Aus `@dealsystem/site`; Pflichtangaben und Beispiele in `komponenten.md`.
|
|
73
|
+
|
|
74
|
+
- Text: `<Text>`, `<RichText>`, `<Link>`
|
|
75
|
+
- Bild und Video: `<MediaImage>`, `<MediaVideo>`
|
|
76
|
+
- Formular und Listen: `<LeadForm>`, `<LeadHoneypot>`, `<Booker>`, `<CollectionList>`
|
|
77
|
+
- Fremde Dienste: `<MapEmbed>`, `<Embed>`, `<ExternalScript>`
|
|
78
|
+
- Einwilligung: `<CookieBanner>`, `<ConsentGate>`, `<Tracking>`
|
|
79
|
+
- Rechtliches: `<Impressum>`, `<Datenschutz>`, `<SiteFooterLegal>`
|
|
80
|
+
- Google und Teilen: `<Seo>`, `<SiteHead>`
|
|
81
|
+
- Zeitgesteuert: `<Zeitfenster>`
|
|
82
|
+
|
|
83
|
+
### Befehle
|
|
84
|
+
|
|
85
|
+
`npx dealsystem <befehl>`: `login`, `logout`, `init`, `sync`, `dev`, `check`, `deploy`, `publish`, `rollback`, `pull`, `image`, `status`. Was sie tun, Optionen und Exit-Codes: `befehle.md`.
|
|
86
|
+
|
|
87
|
+
### Nachschlagen
|
|
88
|
+
|
|
89
|
+
Unter `node_modules/@dealsystem/site/docs/`:
|
|
90
|
+
|
|
91
|
+
- `ablauf.md` – Weg bis zur veröffentlichten Seite
|
|
92
|
+
- `komponenten.md` – Bausteine mit Pflichtangaben und Beispielen
|
|
93
|
+
- `inhalte.md` – Angebote und andere Sammlungen laden
|
|
94
|
+
- `konfiguration.md` – Formulare und Sammlungen in dealsystem.config.ts
|
|
95
|
+
- `gestaltung.md` – Farben, Schrift, Bilder, Barrierefreiheit
|
|
96
|
+
- `rechtstexte.md` – Impressum, Datenschutz, Cookie-Hinweis
|
|
97
|
+
- `extern.md` – fremde Dienste: Videos, Widgets, Skripte
|
|
98
|
+
- `seo.md` – Titel, Beschreibung, Vorschaubild, Favicon, noindex
|
|
99
|
+
- `regeln.md` – Prüfregeln mit Korrektur
|
|
100
|
+
- `befehle.md` – Befehle mit Optionen
|
package/docs/befehle.md
ADDED
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
<!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
|
|
2
|
+
|
|
3
|
+
# Befehle der CLI (`npx dealsystem …`)
|
|
4
|
+
|
|
5
|
+
Alle Befehle laufen ohne Rückfragen. Mit `--json` kommt das Ergebnis als JSON. Weitere allgemeine
|
|
6
|
+
Optionen: `--dir <ordner>`, `--site <id>`, `--quiet`.
|
|
7
|
+
|
|
8
|
+
## `dealsystem login [--start | --wait] [--no-browser]`
|
|
9
|
+
|
|
10
|
+
Anmelden per Gerätecode (Bestätigung im Browser).
|
|
11
|
+
|
|
12
|
+
- `--start` – Code anfordern und sofort beenden (für Agenten)
|
|
13
|
+
- `--wait` – auf die Bestätigung einer mit --start begonnenen Anmeldung warten
|
|
14
|
+
- `--no-browser` – Browser nicht automatisch öffnen
|
|
15
|
+
|
|
16
|
+
## `dealsystem logout`
|
|
17
|
+
|
|
18
|
+
Abmelden und Token löschen.
|
|
19
|
+
|
|
20
|
+
## `dealsystem init [--site <id|slug>] [--create --name <Name> --slug <adresse>]`
|
|
21
|
+
|
|
22
|
+
Seite wählen oder anlegen, `siteId` in dealsystem.config.ts eintragen.
|
|
23
|
+
|
|
24
|
+
- `--site <id|slug>` – vorhandene Seite wählen
|
|
25
|
+
- `--create --name <Name> --slug <adresse>` – neue Seite anlegen
|
|
26
|
+
|
|
27
|
+
## `dealsystem sync [--offline] [--fix-config]`
|
|
28
|
+
|
|
29
|
+
Inhalte holen, CRM mit dealsystem.config.ts abgleichen, AGENTS.md-Block erneuern, fehlende Skills wiederherstellen.
|
|
30
|
+
|
|
31
|
+
- `--offline` – nicht ins Netz; Abgleich mit der vorhandenen .dealsystem/content.json
|
|
32
|
+
- `--fix-config` – svelte.config.js und vite.config.ts aus dem Starter wiederherstellen
|
|
33
|
+
|
|
34
|
+
## `dealsystem dev [--port <port>] [--media-origin <https://…>]`
|
|
35
|
+
|
|
36
|
+
Dev-Server starten; Formulare gehen als Probe an das CRM.
|
|
37
|
+
|
|
38
|
+
- `--port <port>` – Port des Vite-Dev-Servers
|
|
39
|
+
- `--media-origin <url>` – woher /_ds/media/* kommt (Standard: Hauptadresse der Seite)
|
|
40
|
+
|
|
41
|
+
## `dealsystem check [--output build] [--allowed] [--rules]`
|
|
42
|
+
|
|
43
|
+
Regeln lokal prüfen (Exit-Code 1 bei Fehlern).
|
|
44
|
+
|
|
45
|
+
- `--output <ordner>` – zusätzlich die gebaute Seite prüfen (nach `npm run build`)
|
|
46
|
+
- `--allowed` – freigegebene Pakete anzeigen
|
|
47
|
+
- `--rules` – Regelkatalog anzeigen
|
|
48
|
+
|
|
49
|
+
## `dealsystem deploy [-m <Notiz>] [--publish [--confirm]] [--no-wait] [--timeout <s>]`
|
|
50
|
+
|
|
51
|
+
Prüfen, lokal bauen, hochladen, Vorschau-URL ausgeben.
|
|
52
|
+
|
|
53
|
+
- `-m, --message <Notiz>` – Notiz zur Version
|
|
54
|
+
- `--publish` – danach live schalten (nur mit Bestätigung)
|
|
55
|
+
- `--confirm` – der Nutzer hat dem Live-Schalten zugestimmt
|
|
56
|
+
- `--no-wait` – nach dem Hochladen nicht auf den Build warten
|
|
57
|
+
- `--timeout <s>` – höchstens so lange warten (Standard 600)
|
|
58
|
+
|
|
59
|
+
## `dealsystem publish [--version <id|nummer>] [--confirm]`
|
|
60
|
+
|
|
61
|
+
Eine fertige Version live schalten (mit Bestätigung).
|
|
62
|
+
|
|
63
|
+
- `--version <id|nummer>` – Standard: neueste fertige Version
|
|
64
|
+
- `--confirm` – der Nutzer hat zugestimmt
|
|
65
|
+
|
|
66
|
+
## `dealsystem rollback [--version <id|nummer>] [--confirm]`
|
|
67
|
+
|
|
68
|
+
Auf eine frühere Version zurückschalten (mit Bestätigung).
|
|
69
|
+
|
|
70
|
+
- `--version <id|nummer>` – Standard: die vorige Freigabe
|
|
71
|
+
- `--confirm` – der Nutzer hat zugestimmt
|
|
72
|
+
|
|
73
|
+
## `dealsystem pull [ordner] [--site <id|slug>] [--version <nummer|id>]`
|
|
74
|
+
|
|
75
|
+
Quellcode einer Version in einen neuen Ordner holen (z. B. auf einem neuen Rechner); Standard: die Live-Version.
|
|
76
|
+
|
|
77
|
+
- `[ordner]` – neuer oder leerer Ordner (Standard: ./<slug der Seite>); vorhandene Dateien werden nie überschrieben
|
|
78
|
+
- `--site <id|slug>` – Seite wählen, wenn der Workspace mehrere hat
|
|
79
|
+
- `--version <nummer|id>` – diese Version statt der Live-Version
|
|
80
|
+
|
|
81
|
+
## `dealsystem image add <datei> [--name <name>] [--key <schlüssel>] [--alt "…"] [--force]
|
|
82
|
+
dealsystem image push <datei> --slot <schlüssel> --alt "…"`
|
|
83
|
+
|
|
84
|
+
Foto ins Projekt holen (add) oder als eigenes Bild eines Bild-Platzes in DealSystem setzen (push); beide verkleinern und entfernen Standort und Metadaten.
|
|
85
|
+
|
|
86
|
+
- `<datei>` – JPEG, PNG, WebP oder AVIF, höchstens 15 MB; wird auf 2560 px verkleinert, EXIF und GPS werden entfernt
|
|
87
|
+
- `--name <name>` – Dateiname im Projekt (Standard: aus dem Dateinamen), landet in src/lib/assets/bilder/
|
|
88
|
+
- `--key <schlüssel>` – Schlüssel des Bild-Slots im ausgegebenen Baustein (Standard: bilder.<name>)
|
|
89
|
+
- `--alt "…"` – Beschreibung des Bildes für den ausgegebenen Baustein
|
|
90
|
+
- `--force` – ein Bild gleichen Namens überschreiben
|
|
91
|
+
- `push: --slot <schlüssel>` – Bild-Platz aus <MediaImage key="…">; --alt "…" ist Pflicht; geht ohne Freigabe live, danach holt der Befehl die Inhalte für dev
|
|
92
|
+
|
|
93
|
+
## `dealsystem status`
|
|
94
|
+
|
|
95
|
+
Seite, Live-Version, Rechtstexte, letzte Versionen, Domains.
|
|
96
|
+
|
|
97
|
+
## Exit-Codes
|
|
98
|
+
|
|
99
|
+
- `0` – in Ordnung
|
|
100
|
+
- `1` – Prüfung oder Build fehlgeschlagen: Meldungen lesen, beheben, wiederholen
|
|
101
|
+
- `2` – falscher Aufruf, oder der Mensch muss erst zustimmen (`confirmation_required`)
|
|
102
|
+
- `3` – nicht angemeldet: `npx dealsystem login --start`
|
|
103
|
+
- `4` – DealSystem nicht erreichbar: später noch einmal versuchen
|
package/docs/extern.md
ADDED
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Fremde Dienste: Videos, Karten, Terminbuchung, Skripte
|
|
2
|
+
|
|
3
|
+
Eine Seite lädt von fremden Servern nur, was in `dealsystem.config.ts` unter `external` steht, und nur über
|
|
4
|
+
die Bausteine `<Embed>` und `<ExternalScript>`. Beides zusammen ergibt die Sicherheitsregeln der Seite (CSP)
|
|
5
|
+
und den Cookie-Hinweis. Vor der Einwilligung des Besuchers lädt nichts davon.
|
|
6
|
+
|
|
7
|
+
Ohne Eintrag unter `external` gehen weiterhin: `<MapEmbed>` (OpenStreetMap) und `<Tracking />` (Google Tag und
|
|
8
|
+
Meta Pixel mit den Kennungen aus dem CRM).
|
|
9
|
+
|
|
10
|
+
## Grundregeln
|
|
11
|
+
|
|
12
|
+
- `svelte.config.js` enthält `csp: dealsystemCsp()` und sonst keine Sicherheitsregeln. Hosts trägst du nie
|
|
13
|
+
dort ein, nur unter `external`. Fehlt die Zeile, stellt `npx dealsystem sync --fix-config` sie her.
|
|
14
|
+
- Jeder Dienst bekommt einen Schlüssel in Kleinbuchstaben (`video`, `chat`). Denselben Schlüssel nennst du im
|
|
15
|
+
Baustein: `<Embed id="video" …>`. Ein Tippfehler ist ein Typfehler.
|
|
16
|
+
- Hosts nur als `https://host.de`, ohne Pfad, ohne Schrägstrich am Ende. Ein Platzhalter `https://*.host.de`
|
|
17
|
+
geht nur in `connect`, `img`, `media`, `style` und `font`, nie in `script` oder `frame`.
|
|
18
|
+
- `category` ist `media` (Videos, Karten, Widgets), `marketing` (Werbung, Chat, Tag-Manager) oder `statistics`
|
|
19
|
+
(Reichweitenmessung). „Notwendig“ gibt es nicht: Fremdes lädt immer erst nach der Einwilligung.
|
|
20
|
+
- Kein Inline-Code. Ein Snippet des Anbieters (`<script>…</script>`) legst du als Datei unter
|
|
21
|
+
`static/scripts/` ab und lädst sie mit `<ExternalScript src="/scripts/datei.js">`.
|
|
22
|
+
- Verboten bleiben `unsafe-eval`, WebAssembly, Passwortfelder und Formulare, die an fremde Adressen schicken.
|
|
23
|
+
- Nenne den Dienst dem Kunden: Er muss ihn in seiner Datenschutzerklärung aufführen (Eigene Website →
|
|
24
|
+
Rechtliches). Den Text schreibst du nicht.
|
|
25
|
+
|
|
26
|
+
## YouTube-Video einbinden
|
|
27
|
+
|
|
28
|
+
```ts
|
|
29
|
+
// dealsystem.config.ts
|
|
30
|
+
export default defineSite({
|
|
31
|
+
siteId: '…',
|
|
32
|
+
external: { video: { preset: 'youtube' } },
|
|
33
|
+
});
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
```svelte
|
|
37
|
+
<Embed id="video" src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Rundgang durch das Haus" />
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
- Die Adresse darfst du so übernehmen, wie der Kunde sie schickt (`watch?v=`, `youtu.be/…`, `shorts/…`,
|
|
41
|
+
auch mit `&t=90`). Das SDK bettet sie ohne Cookies ein (`youtube-nocookie.com`).
|
|
42
|
+
- `title` ist Pflicht und beschreibt, was zu sehen ist.
|
|
43
|
+
- Vor der Einwilligung steht dort ein Platzhalter mit „Video laden“ und dem Link zum Video. Ein Vorschaubild
|
|
44
|
+
davor nur mit `poster="/bilder/vorschau.jpg"` aus `static/`, nie ein Bild von YouTube.
|
|
45
|
+
- Mehrere Videos von YouTube nutzen denselben Eintrag: `<Embed id="video" src="…">` beliebig oft.
|
|
46
|
+
|
|
47
|
+
## Vimeo, Google Maps, Calendly
|
|
48
|
+
|
|
49
|
+
Vorlagen (`preset`) gibt es für `youtube`, `vimeo`, `google-maps` und `calendly`. Sie legen Anbieter, Zweck,
|
|
50
|
+
Datenschutz-Link und Hosts fest; neben `preset` steht nichts.
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
external: {
|
|
54
|
+
rundgang: { preset: 'vimeo' },
|
|
55
|
+
anfahrt: { preset: 'google-maps' },
|
|
56
|
+
termin: { preset: 'calendly' },
|
|
57
|
+
},
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
```svelte
|
|
61
|
+
<Embed id="rundgang" src="https://vimeo.com/76979871" title="Rundgang" />
|
|
62
|
+
<Embed id="anfahrt" src="https://www.google.com/maps/embed?pb=…" title="Anfahrt zum Büro" />
|
|
63
|
+
<Embed id="termin" src="https://calendly.com/makler/erstgespraech" title="Termin für ein Erstgespräch" />
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
- Google Maps: nur die Adresse aus Google Maps → Teilen → Karte einbetten (`/maps/embed?pb=…`). Ohne sie nimm
|
|
67
|
+
`<MapEmbed>` (OpenStreetMap), der braucht keinen Eintrag.
|
|
68
|
+
- Calendly: die Adresse der Buchungsseite. Der Platzhalter ist 700 Pixel hoch; `height="900px"` ändert das.
|
|
69
|
+
|
|
70
|
+
## Anderer Dienst als Rahmen (Widget)
|
|
71
|
+
|
|
72
|
+
Ohne Vorlage beschreibst du den Dienst selbst:
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
external: {
|
|
76
|
+
bewertungen: {
|
|
77
|
+
category: 'media',
|
|
78
|
+
provider: 'Beispiel GmbH, Deutschland',
|
|
79
|
+
purpose: 'Zeigt Kundenbewertungen.',
|
|
80
|
+
privacyUrl: 'https://beispiel.de/datenschutz',
|
|
81
|
+
frame: ['https://widget.beispiel.de'],
|
|
82
|
+
},
|
|
83
|
+
},
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
```svelte
|
|
87
|
+
<Embed id="bewertungen" src="https://widget.beispiel.de/firma/123" title="Unsere Bewertungen" />
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
`provider` (mit Sitz), `purpose` und `privacyUrl` erscheinen im Cookie-Hinweis. Kennst du sie nicht sicher,
|
|
91
|
+
frag den Kunden; rate sie nicht (`PRV-008`).
|
|
92
|
+
|
|
93
|
+
## Eigenes Skript einbinden (Chat, Tag-Manager)
|
|
94
|
+
|
|
95
|
+
```ts
|
|
96
|
+
external: {
|
|
97
|
+
chat: {
|
|
98
|
+
category: 'marketing',
|
|
99
|
+
provider: 'HubSpot, Inc., USA',
|
|
100
|
+
purpose: 'Live-Chat mit dem Vertrieb',
|
|
101
|
+
privacyUrl: 'https://legal.hubspot.com/de/privacy-policy',
|
|
102
|
+
script: ['https://js.hs-scripts.com'],
|
|
103
|
+
connect: ['https://*.hubspot.com', 'https://*.hs-analytics.net'],
|
|
104
|
+
img: ['https://*.hubspot.com'],
|
|
105
|
+
},
|
|
106
|
+
},
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
```svelte
|
|
110
|
+
<!-- src/routes/+layout.svelte, damit der Chat auf jeder Seite steht -->
|
|
111
|
+
<ExternalScript
|
|
112
|
+
id="chat"
|
|
113
|
+
src="https://js.hs-scripts.com/1234567.js"
|
|
114
|
+
attrs={{ id: 'hs-script-loader', defer: true }}
|
|
115
|
+
/>
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
- `script` nennt den Host, von dem das Skript kommt. Was das Skript danach lädt oder wohin es Daten schickt,
|
|
119
|
+
gehört unter `connect`, `img`, `frame`, `style` oder `font`. Die Angaben stehen meist in der Hilfe des
|
|
120
|
+
Anbieters unter „Content Security Policy“. Fehlt ein Host, blockiert der Browser ihn; in der Konsole steht
|
|
121
|
+
dann „Refused to …“ mit dem Host.
|
|
122
|
+
- `attrs` kennt `async`, `defer`, `id`, `type`, `crossorigin`, `referrerpolicy` und `data-*`. Ohne Angabe lädt
|
|
123
|
+
das Skript `async`.
|
|
124
|
+
- Das Skript lädt einmal je Seite. Widerruft der Besucher, lädt die Seite neu, damit es weg ist.
|
|
125
|
+
- Ein Snippet mit Code (z. B. vom Google Tag Manager) legst du als `static/scripts/gtm.js` ab und schreibst
|
|
126
|
+
`<ExternalScript id="tags" src="/scripts/gtm.js" />`. Tracking-Code in einer Datei ist nur so erlaubt und nur
|
|
127
|
+
mit `category: 'marketing'` oder `'statistics'` (`PRV-003`).
|
|
128
|
+
- Google Tag und Meta Pixel gehen einfacher über `<Tracking />` und die Kennung im CRM.
|
|
129
|
+
- Eigene Skripte laufen nur auf Seiten mit eigener Domain. Unter der Adresse von DealSystem lehnt der Server
|
|
130
|
+
die Version ab (`SEC-011`): Seiten verschiedener Kunden teilen sich diese Adresse. Videos gehen überall.
|
|
131
|
+
|
|
132
|
+
## Wenn `check` meldet
|
|
133
|
+
|
|
134
|
+
| Regel | Bedeutung | Korrektur |
|
|
135
|
+
| --------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
|
136
|
+
| `SEC-005` | `external` ungültig oder `svelte.config.js` nicht `dealsystemCsp()` | Meldung lesen, Host in der Grundform eintragen; `npx dealsystem sync --fix-config` |
|
|
137
|
+
| `SEC-006` | `<script>` ohne `src`, `eval`, WebAssembly | Code als Datei unter `static/scripts/`, laden mit `<ExternalScript>` |
|
|
138
|
+
| `SEC-007` | `<form>` mit `action` auf eine andere Adresse, `method="post"`, `target` oder ohne `onsubmit` | `<form onsubmit={senden}>` ohne `action`, senden mit `createLeadClient()`; oder `<LeadForm>` |
|
|
139
|
+
| `SEC-008` | Dienst nicht deklariert, Adresse passt nicht zum Host, `<iframe>`/`<script>` ohne Baustein | Eintrag unter `external`, Baustein statt rohem Element |
|
|
140
|
+
| `SEC-009` | Passwortfeld | entfernen |
|
|
141
|
+
| `SEC-011` | eigenes Skript ohne eigene Domain | Domain verbinden oder Skript herausnehmen |
|
|
142
|
+
| `PRV-003` | Tracking-Code in einer Datei, die nicht über `<ExternalScript>` lädt | so laden wie oben, Kategorie `marketing` |
|
|
143
|
+
| `PRV-008` | Anbieter, Zweck oder Datenschutz-Link fehlt | ergänzen, im Zweifel den Kunden fragen |
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# Gestaltung, Bilder und Barrierefreiheit
|
|
2
|
+
|
|
3
|
+
## Farben und Schrift
|
|
4
|
+
|
|
5
|
+
Das Aussehen steuert `src/app.css` über Variablen. Ändere zuerst diese Werte, bevor du neue Regeln schreibst.
|
|
6
|
+
|
|
7
|
+
| Variable | Bedeutung |
|
|
8
|
+
| ----------------------------------------- | ------------------------------------ |
|
|
9
|
+
| `--color-background`, `--color-text` | Grundfarbe der Seite und Textfarbe |
|
|
10
|
+
| `--color-text-muted` | zurückhaltender Text |
|
|
11
|
+
| `--color-surface`, `--color-on-surface` | abgesetzte Flächen und Text darauf |
|
|
12
|
+
| `--color-primary`, `--color-on-primary` | Schaltflächen, Links und Text darauf |
|
|
13
|
+
| `--color-border` | Linien und Rahmen |
|
|
14
|
+
| `--font-sans`, `--radius`, `--width-page` | Schrift, Eckenradius, Seitenbreite |
|
|
15
|
+
|
|
16
|
+
Neue Farben bekommen denselben Aufbau: `--color-<name>` für die Fläche, `--color-on-<name>` für Text
|
|
17
|
+
darauf. `npx dealsystem check` rechnet den Kontrast jedes solchen Paars nach (`A11Y-006`): mindestens
|
|
18
|
+
4,5:1 für Text.
|
|
19
|
+
|
|
20
|
+
Die Bausteine von DealSystem (Formular, Cookie-Hinweis) übernehmen die Farben über `--ds-color-primary`,
|
|
21
|
+
`--ds-color-on-primary`, `--ds-color-text`, `--ds-color-surface`, `--ds-color-border`, `--ds-color-error`,
|
|
22
|
+
`--ds-color-focus` und `--ds-radius`. Der Starter verbindet sie in `app.css` mit den Farben der Seite.
|
|
23
|
+
|
|
24
|
+
## Schriften
|
|
25
|
+
|
|
26
|
+
Schriften liegen immer lokal im Projekt. Nie von Google Fonts oder einem CDN laden (`PRV-002`).
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
npm install @fontsource-variable/inter
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
```svelte
|
|
33
|
+
<!-- src/routes/+layout.svelte -->
|
|
34
|
+
<script lang="ts">
|
|
35
|
+
import '@fontsource-variable/inter';
|
|
36
|
+
</script>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Dazu in `app.css`: `--font-sans: 'Inter Variable', system-ui, sans-serif;`. Andere Schriften gibt es als
|
|
40
|
+
`@fontsource/<name>` und `@fontsource-variable/<name>`. Wechselst du die Schrift, entferne die alte mit
|
|
41
|
+
`npm uninstall @fontsource-variable/inter`, damit sie nicht ungenutzt im Projekt bleibt.
|
|
42
|
+
|
|
43
|
+
## Bilder
|
|
44
|
+
|
|
45
|
+
Nie `<img>` schreiben, immer `<MediaImage>` (`A11Y-002`).
|
|
46
|
+
|
|
47
|
+
- **Bilder aus dem CRM** (Angebote): `<MediaImage media={angebot.media.bilder[0]} sizes="…" />`. Größen und
|
|
48
|
+
Alternativtext kommen aus dem CRM.
|
|
49
|
+
- **Fotos ins Projekt holen:** `npx dealsystem image add <datei> --name haus --alt "…"`. Der Befehl prüft das
|
|
50
|
+
Format (JPEG, PNG, WebP, AVIF, höchstens 15 MB), dreht nach der Kamera-Angabe, verkleinert auf höchstens
|
|
51
|
+
2 560 px, **entfernt alle Metadaten samt Standort (GPS)** und schreibt nach `src/lib/assets/bilder/`. Er gibt
|
|
52
|
+
die Import-Zeile und einen fertigen `<MediaImage>` aus. Fotos nicht von Hand kopieren: Sonst gehen die
|
|
53
|
+
Standortdaten aus dem Handy mit auf die Seite. HEIC (iPhone) lässt sich nicht umwandeln; der Kunde schickt
|
|
54
|
+
es als JPEG.
|
|
55
|
+
- **Eigene Bilder im Projekt:** mit `import bild from '$lib/assets/bilder/haus.jpg'` einbinden und als
|
|
56
|
+
`<MediaImage src={bild} alt="…" width={1600} height={1067} />` ausgeben. `width` und `height` sind die
|
|
57
|
+
echten Maße der Datei; sie verhindern, dass die Seite beim Laden springt. Logos und kleine Grafiken als
|
|
58
|
+
SVG nach `static/` legen: `src="/logo.svg"`.
|
|
59
|
+
- `alt` beschreibt, was zu sehen ist („Sanierter Altbau mit roter Klinkerfassade“), nicht „Bild“ oder den
|
|
60
|
+
Dateinamen. Reiner Schmuck: `alt="" decorative`.
|
|
61
|
+
- `sizes` nennt die Anzeigebreite, z. B. `sizes="(min-width: 60rem) 33vw, 100vw"`. Das wichtigste Bild im
|
|
62
|
+
sichtbaren Bereich bekommt `priority`.
|
|
63
|
+
- Große Videos gehören ins CRM, nicht ins Projekt.
|
|
64
|
+
- **Fotos, die der Kunde selbst tauschen will** (Porträt für „Über uns“, Team, Titelbild): als Bild-Slot
|
|
65
|
+
einbauen, mit festem `key` und einem Bild aus dem Projekt als `default`:
|
|
66
|
+
`<MediaImage key="team.inhaber.foto" default={portrait} width={1200} height={1500} alt="…" label="Foto des Inhabers" group="Über uns" />`.
|
|
67
|
+
`key`, `label`, `group` und `help` stehen als feste Zeichenketten in Anführungszeichen, sonst scheitern
|
|
68
|
+
Build und Prüfung (`QUA-006`). Hat der Kunde noch kein Foto, nimm ein neutrales Platzhalterbild aus dem
|
|
69
|
+
Projekt und sag ihm das.
|
|
70
|
+
- **So erklärst du es dem Kunden, in dieser Reihenfolge:** Erst baust du den Platz für das Bild ein, dann
|
|
71
|
+
lädst du die Seite hoch, danach kann er das Bild im CRM unter Eigene Website → Inhalte selbst tauschen.
|
|
72
|
+
Vorher gibt es dort nichts zu tauschen. Einen anderen Ort im CRM dafür nennst du nicht.
|
|
73
|
+
- Bilder in Sammlungen (Angebote, Referenzen) pflegt er dagegen im CRM unter CMS, beim jeweiligen Eintrag.
|
|
74
|
+
|
|
75
|
+
## Barrierefreiheit (WCAG 2.1 AA)
|
|
76
|
+
|
|
77
|
+
Die Bausteine sind darauf ausgelegt. Für eigene Teile der Seite gilt:
|
|
78
|
+
|
|
79
|
+
- Genau eine `h1` je Seite, darunter `h2`, dann `h3`, ohne eine Ebene zu überspringen.
|
|
80
|
+
- Jede Seite hat einen eigenen Titel und eine eigene Beschreibung, gesetzt mit `<Seo>` (`seo.md`).
|
|
81
|
+
- Links und Schaltflächen haben einen Text, der für sich verständlich ist. Nicht „hier klicken“.
|
|
82
|
+
- Alles ist mit der Tastatur erreichbar. Den sichtbaren Fokus nie entfernen (`outline: none` ist verboten).
|
|
83
|
+
- Bedienelemente sind mindestens 44 × 44 Pixel groß.
|
|
84
|
+
- Farbe ist nie das einzige Merkmal für eine Bedeutung.
|
|
85
|
+
- Text lässt sich auf 200 % vergrößern, ohne dass etwas abgeschnitten wird. Kein `user-scalable=no`.
|
|
86
|
+
- Bewegung sparsam einsetzen und bei `prefers-reduced-motion` abschalten.
|
|
87
|
+
- Kein Video oder Ton startet von selbst.
|
|
88
|
+
|
|
89
|
+
Automatisch geprüft wird nur ein Teil. Sieh dir jede neue Seite einmal nur mit der Tastatur an.
|
|
90
|
+
|
|
91
|
+
## Links
|
|
92
|
+
|
|
93
|
+
Links auf eigene Seiten laufen über `resolve` aus `$app/paths`. Ein Tippfehler in der Adresse wird so zum
|
|
94
|
+
Fehler in `npm run check`, statt als toter Link auf der Seite zu landen.
|
|
95
|
+
|
|
96
|
+
```svelte
|
|
97
|
+
<script lang="ts">
|
|
98
|
+
import { resolve } from '$app/paths';
|
|
99
|
+
</script>
|
|
100
|
+
|
|
101
|
+
<a href={resolve('/kontakt')}>Kontakt</a>
|
|
102
|
+
<a href={resolve('/angebote/[slug]', { slug: angebot.slug })}>{angebot.data.titel}</a>
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Links nach außen sind gewöhnliche `<a href="https://…">`. Öffnen sie in einem neuen Tab, dann mit
|
|
106
|
+
`target="_blank" rel="noopener noreferrer"`.
|
|
107
|
+
|
|
108
|
+
## Karte
|
|
109
|
+
|
|
110
|
+
Für die Anfahrt gibt es genau eine Karte: `<MapEmbed>` mit OpenStreetMap.
|
|
111
|
+
|
|
112
|
+
```svelte
|
|
113
|
+
<script lang="ts">
|
|
114
|
+
import { MapEmbed, Text } from '@dealsystem/site';
|
|
115
|
+
|
|
116
|
+
let { data } = $props();
|
|
117
|
+
</script>
|
|
118
|
+
|
|
119
|
+
<Text key="kontakt.anfahrt.titel" default="Anfahrt" as="h2" label="Überschrift Anfahrt" group="Kontakt" />
|
|
120
|
+
{#if data.site.address}<p>{data.site.address}</p>{/if}
|
|
121
|
+
<MapEmbed lat={53.8676} lon={10.6866} title="Unser Büro in der Lübecker Altstadt" />
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
- `lat` und `lon` sind die Koordinaten als Dezimalzahlen. Kennst du sie nicht sicher, frag den Kunden: Er
|
|
125
|
+
findet sie auf openstreetmap.org (Adresse suchen, Rechtsklick auf den Ort, „Adresse anzeigen“). Rate sie
|
|
126
|
+
nicht; eine Markierung am falschen Haus ist schlimmer als keine Karte.
|
|
127
|
+
- Die Karte lädt erst nach „Karte anzeigen“. Der Link „Karte in OpenStreetMap öffnen“ steht immer da.
|
|
128
|
+
- Die Adresse daneben kommt aus dem CRM (`data.site.address`), nicht aus dem Code.
|
|
129
|
+
- Wünscht der Kunde ausdrücklich Google Maps, nimm `<Embed>` mit der Vorlage `google-maps` und der Adresse
|
|
130
|
+
aus Google Maps → Teilen → Karte einbetten (`extern.md`). Ohne diese Adresse bleibt es bei `<MapEmbed>`.
|
|
131
|
+
|
|
132
|
+
## Fremde Inhalte
|
|
133
|
+
|
|
134
|
+
Videos (YouTube, Vimeo), Google Maps, Terminbuchung, Widgets und fremde Skripte stehen in
|
|
135
|
+
`dealsystem.config.ts` unter `external` und kommen über `<Embed>` oder `<ExternalScript>` auf die Seite. Daraus
|
|
136
|
+
entstehen die Sicherheitsregeln (`csp: dealsystemCsp()` in `svelte.config.js`) und der Cookie-Hinweis; vor der
|
|
137
|
+
Einwilligung lädt nichts davon. Anleitung mit Beispielen: `extern.md`. Ohne Eintrag gehen nur Tracking über
|
|
138
|
+
`<Tracking />` (Kennungen im CRM) und die Karte über `<MapEmbed />`. Lockere nie die Regeln in
|
|
139
|
+
`svelte.config.js`; `npx dealsystem check` lehnt das ab (`SEC-005`, `SEC-008`).
|