@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.
Files changed (182) hide show
  1. package/README.md +145 -2
  2. package/agent-files/claude/skills/angebote-einbauen/SKILL.md +30 -0
  3. package/agent-files/claude/skills/bild-einbauen/SKILL.md +43 -0
  4. package/agent-files/claude/skills/domain-verbinden/SKILL.md +23 -0
  5. package/agent-files/claude/skills/extern-einbinden/SKILL.md +37 -0
  6. package/agent-files/claude/skills/formular-anbinden/SKILL.md +34 -0
  7. package/agent-files/claude/skills/funnel-mehrstufig/BewertungFunnel.svelte +220 -0
  8. package/agent-files/claude/skills/funnel-mehrstufig/SKILL.md +101 -0
  9. package/agent-files/claude/skills/neue-seite/SKILL.md +47 -0
  10. package/agent-files/claude/skills/prueffehler-beheben/SKILL.md +31 -0
  11. package/agent-files/claude/skills/termin-buchung/SKILL.md +51 -0
  12. package/agent-files/claude/skills/veroeffentlichen/SKILL.md +32 -0
  13. package/agent-files/cursor/rules/dealsystem.mdc +7 -0
  14. package/agent-files/manifest.json +93 -0
  15. package/contract/README.md +41 -0
  16. package/contract/ds-content.v1.json +2355 -0
  17. package/contract/external-presets.v1.json +65 -0
  18. package/contract/funnel-code-config.md +87 -0
  19. package/contract/site-api.v1.json +3916 -0
  20. package/dist/client/altcha-workers.d.ts +10 -0
  21. package/dist/client/attribution.d.ts +119 -0
  22. package/dist/client/attribution.js +341 -0
  23. package/dist/client/bookingClient.svelte.d.ts +166 -0
  24. package/dist/client/bookingClient.svelte.js +369 -0
  25. package/dist/client/bookingTime.d.ts +46 -0
  26. package/dist/client/bookingTime.js +109 -0
  27. package/dist/client/captcha.d.ts +26 -0
  28. package/dist/client/captcha.js +71 -0
  29. package/dist/client/captchaSession.d.ts +21 -0
  30. package/dist/client/captchaSession.js +105 -0
  31. package/dist/client/collections.d.ts +34 -0
  32. package/dist/client/collections.js +40 -0
  33. package/dist/client/externalScript.d.ts +20 -0
  34. package/dist/client/externalScript.js +36 -0
  35. package/dist/client/funnelState.svelte.d.ts +47 -0
  36. package/dist/client/funnelState.svelte.js +81 -0
  37. package/dist/client/leadClient.svelte.d.ts +131 -0
  38. package/dist/client/leadClient.svelte.js +250 -0
  39. package/dist/client/pageview.d.ts +7 -0
  40. package/dist/client/pageview.js +44 -0
  41. package/dist/client/siteApi.d.ts +211 -0
  42. package/dist/client/siteApi.js +320 -0
  43. package/dist/client/tracking.d.ts +18 -0
  44. package/dist/client/tracking.js +93 -0
  45. package/dist/client/validation.d.ts +10 -0
  46. package/dist/client/validation.js +66 -0
  47. package/dist/components/Booker.svelte +729 -0
  48. package/dist/components/Booker.svelte.d.ts +42 -0
  49. package/dist/components/CollectionList.svelte +122 -0
  50. package/dist/components/CollectionList.svelte.d.ts +65 -0
  51. package/dist/components/ConsentGate.svelte +68 -0
  52. package/dist/components/ConsentGate.svelte.d.ts +44 -0
  53. package/dist/components/CookieBanner.svelte +303 -0
  54. package/dist/components/CookieBanner.svelte.d.ts +29 -0
  55. package/dist/components/Datenschutz.svelte +84 -0
  56. package/dist/components/Datenschutz.svelte.d.ts +26 -0
  57. package/dist/components/Embed.svelte +263 -0
  58. package/dist/components/Embed.svelte.d.ts +41 -0
  59. package/dist/components/ExternalScript.svelte +94 -0
  60. package/dist/components/ExternalScript.svelte.d.ts +41 -0
  61. package/dist/components/Impressum.svelte +59 -0
  62. package/dist/components/Impressum.svelte.d.ts +25 -0
  63. package/dist/components/LeadForm.svelte +475 -0
  64. package/dist/components/LeadForm.svelte.d.ts +35 -0
  65. package/dist/components/LeadHoneypot.svelte +43 -0
  66. package/dist/components/LeadHoneypot.svelte.d.ts +18 -0
  67. package/dist/components/Link.svelte +48 -0
  68. package/dist/components/Link.svelte.d.ts +30 -0
  69. package/dist/components/MapEmbed.svelte +154 -0
  70. package/dist/components/MapEmbed.svelte.d.ts +28 -0
  71. package/dist/components/MediaImage.svelte +218 -0
  72. package/dist/components/MediaImage.svelte.d.ts +128 -0
  73. package/dist/components/MediaVideo.svelte +103 -0
  74. package/dist/components/MediaVideo.svelte.d.ts +20 -0
  75. package/dist/components/RichText.svelte +105 -0
  76. package/dist/components/RichText.svelte.d.ts +55 -0
  77. package/dist/components/Seo.svelte +89 -0
  78. package/dist/components/Seo.svelte.d.ts +45 -0
  79. package/dist/components/SiteFooterLegal.svelte +75 -0
  80. package/dist/components/SiteFooterLegal.svelte.d.ts +22 -0
  81. package/dist/components/SiteHead.svelte +79 -0
  82. package/dist/components/SiteHead.svelte.d.ts +32 -0
  83. package/dist/components/Text.svelte +100 -0
  84. package/dist/components/Text.svelte.d.ts +55 -0
  85. package/dist/components/Tracking.svelte +30 -0
  86. package/dist/components/Tracking.svelte.d.ts +14 -0
  87. package/dist/components/Zeitfenster.svelte +92 -0
  88. package/dist/components/Zeitfenster.svelte.d.ts +34 -0
  89. package/dist/components/legal.d.ts +12 -0
  90. package/dist/components/legal.js +27 -0
  91. package/dist/config/index.d.ts +121 -0
  92. package/dist/config/index.js +602 -0
  93. package/dist/config/static/index.d.ts +3 -0
  94. package/dist/config/static/index.js +5 -0
  95. package/dist/config/static/lines.d.ts +9 -0
  96. package/dist/config/static/lines.js +22 -0
  97. package/dist/config/static/literal.d.ts +45 -0
  98. package/dist/config/static/literal.js +175 -0
  99. package/dist/config/static/siteConfig.d.ts +39 -0
  100. package/dist/config/static/siteConfig.js +150 -0
  101. package/dist/consent/consent.svelte.d.ts +91 -0
  102. package/dist/consent/consent.svelte.js +221 -0
  103. package/dist/content/index.d.ts +123 -0
  104. package/dist/content/index.js +247 -0
  105. package/dist/contentBlock.d.ts +45 -0
  106. package/dist/contentBlock.js +78 -0
  107. package/dist/csp/index.d.ts +27 -0
  108. package/dist/csp/index.js +74 -0
  109. package/dist/external/csp.d.ts +25 -0
  110. package/dist/external/csp.js +104 -0
  111. package/dist/external/hosts.d.ts +30 -0
  112. package/dist/external/hosts.js +128 -0
  113. package/dist/external/presets.d.ts +54 -0
  114. package/dist/external/presets.js +212 -0
  115. package/dist/external/resolve.d.ts +39 -0
  116. package/dist/external/resolve.js +254 -0
  117. package/dist/index.d.ts +32 -0
  118. package/dist/index.js +32 -0
  119. package/dist/internal/consentNeed.d.ts +21 -0
  120. package/dist/internal/consentNeed.js +50 -0
  121. package/dist/internal/dealsystem-legal-imprint.d.ts +2 -0
  122. package/dist/internal/dealsystem-legal-imprint.js +5 -0
  123. package/dist/internal/dealsystem-legal-privacy.d.ts +2 -0
  124. package/dist/internal/dealsystem-legal-privacy.js +5 -0
  125. package/dist/internal/dealsystem-site-data.d.ts +3 -0
  126. package/dist/internal/dealsystem-site-data.js +2 -0
  127. package/dist/internal/imprint.d.ts +4 -0
  128. package/dist/internal/imprint.js +10 -0
  129. package/dist/internal/mediaImage.d.ts +15 -0
  130. package/dist/internal/mediaImage.js +22 -0
  131. package/dist/internal/privacy.d.ts +4 -0
  132. package/dist/internal/privacy.js +10 -0
  133. package/dist/internal/providers.d.ts +9 -0
  134. package/dist/internal/providers.js +44 -0
  135. package/dist/internal/reload.d.ts +2 -0
  136. package/dist/internal/reload.js +5 -0
  137. package/dist/internal/seo.d.ts +41 -0
  138. package/dist/internal/seo.js +79 -0
  139. package/dist/internal/siteData.d.ts +7 -0
  140. package/dist/internal/siteData.js +39 -0
  141. package/dist/internal/usage.d.ts +7 -0
  142. package/dist/internal/usage.js +13 -0
  143. package/dist/keys.d.ts +20 -0
  144. package/dist/keys.js +58 -0
  145. package/dist/leadmagnet.d.ts +16 -0
  146. package/dist/leadmagnet.js +28 -0
  147. package/dist/paths.d.ts +8 -0
  148. package/dist/paths.js +9 -0
  149. package/dist/richtext/escape.d.ts +4 -0
  150. package/dist/richtext/escape.js +18 -0
  151. package/dist/richtext/server.d.ts +16 -0
  152. package/dist/richtext/server.js +123 -0
  153. package/dist/schedule.d.ts +23 -0
  154. package/dist/schedule.js +67 -0
  155. package/dist/slots.d.ts +9 -0
  156. package/dist/slots.js +38 -0
  157. package/dist/snapshot.d.ts +14 -0
  158. package/dist/snapshot.js +214 -0
  159. package/dist/types.d.ts +550 -0
  160. package/dist/types.js +4 -0
  161. package/dist/version.d.ts +2 -0
  162. package/dist/version.js +2 -0
  163. package/dist/vite/index.d.ts +85 -0
  164. package/dist/vite/index.js +641 -0
  165. package/dist/vite/scan.d.ts +47 -0
  166. package/dist/vite/scan.js +355 -0
  167. package/dist/vite/zeitfenster.d.ts +18 -0
  168. package/dist/vite/zeitfenster.js +76 -0
  169. package/docs/ablauf.md +167 -0
  170. package/docs/agents-block.md +100 -0
  171. package/docs/befehle.md +103 -0
  172. package/docs/extern.md +143 -0
  173. package/docs/gestaltung.md +139 -0
  174. package/docs/inhalte.md +224 -0
  175. package/docs/komponenten.md +1273 -0
  176. package/docs/konfiguration.md +310 -0
  177. package/docs/llms.txt +19 -0
  178. package/docs/rechtstexte.md +84 -0
  179. package/docs/regeln.md +108 -0
  180. package/docs/seo.md +55 -0
  181. package/docs/termine.md +73 -0
  182. 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
@@ -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`).