Diese Seite wurde via Python MCP-Server erzeugt.
Vollständige alphabetische Liste der aktuell in ki-web vorhandenen Slugs. Anzahl: 773.
Der MCP-Server (Multi-Cloud Platform) ist ein zentraler Bestandteil der Qwen-Infrastruktur, der die Kommunikation zwischen verschiedenen Cloud-Diensten und -Ressourcen verwaltet. Diese Anleitung erklärt, wie Sie einen MCP-Server in Qwen konfigurieren.
\n\nFühren Sie den folgenden Befehl aus, um den MCP-Server zu starten:
\n\n\nPrüfen Sie den Status des MCP-Servers mit:
\n\n\nSeverity: must. Bereich: schreibstil.
Texte DÜRFEN keine rhetorischen Antithesen oder Steigerungs-Schablonen enthalten, deren Funktion Dramatik statt Präzision ist. Diese Muster sind klassische LLM-Floskeln und werden ausnahmslos entfernt oder umformuliert. Detektion erfolgt über die unten gelisteten Patterns, Korrektur durch nüchterne, direkte Aussage. . VERBOTEN (Beispiel-Patterns, keine vollständige Liste): . 1. Antithese-Schablone: \"Das ist kein X, das ist (ein) Y.\" \"Das ist nicht X, sondern Y.\" \"Es ist nicht nur X, es ist Y.\" \"Mehr als nur X.\". 2. Steigerungs-Triplets: \"Schnell. Einfach. Mächtig.\" \"Klein. Robust. Universell.\" \"X. Y. Z.\" als rhetorische Schluss-Salve.. 3. Theatralische Eröffnung oder Abschluss: \"Willkommen zu X.\" \"Hier beginnt der eigentliche Weg.\" \"Das ändert alles.\" \"Lang lebe Y.\" \"Eine Wahrheit, drei Hüllen.\". 4. Marketing-Verstärker ohne Inhalt: \"Genau hier glänzt X.\" \"Bestechend einfach.\" \"Der eigentliche Trick ist Y.\" \"Genau dort, wo X aufhört, beginnt Y.\". ERLAUBT bleibt die nüchterne Sachaussage: \"X macht A. Y macht B. Beides zusammen ergibt C.\" \"Wir nutzen X, weil Y.\". Antithesen sind nur dann zulässig, wenn sie eine echte fachliche Unterscheidung treffen (\"PUT ersetzt, PATCH ändert teilweise.\") und nicht der Steigerung dienen.
check:\n reflect:\n fields:\n - contains_antithesis_template\n - contains_dramatic_triplet\n - contains_theatrical_opener_or_closer\n - contains_empty_marketing_intensifier\n object: text_artifacthallo Torsten
","created_at":"2026-05-21T14:54:32+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":4,"konversionen":4},{"id":63,"slug":"code/css/rules","title":"Regeln, css","meta_description":"Liste der 51 Regeln im Bereich css, sortiert nach ID.","content":"51 Regeln in /var/www/code/css/rules.yaml.
hallo Tim
","created_at":"2026-05-21T14:55:00+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":69,"konversionen":11},{"id":1188,"slug":"sascha","title":"Hallo Sascha","meta_description":"Hallo Sascha","content":"hallo Sascha
","created_at":"2026-05-21T14:55:50+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":89,"konversionen":22},{"id":70,"slug":"code/css/rules/css-007-maxloc-rule-block","title":"CSS_007_MAXLOC_RULE_BLOCK:","meta_description":"CSS_007_MAXLOC_RULE_BLOCK (major): .","content":"Severity: major. Bereich: css.
(kein Regeltext)
check:\n fail: Ein Selectorblock enthaelt viele Layout-, Typografie-, Farb-, State- und Responsive-Deklarationen\n zugleich.\n pass: Ein Rule Block bleibt bei <= 20 LOC Zielwert, <= 35 LOC Hard Limit und <=\n 16 Deklarationen.\n remediation: Basis, Variante, State, Responsive und Theme-Regeln trennen; Tokens\n statt Wiederholung nutzen.\n type: css_rule20 Quellen in /var/www/code/js/sources.yaml.
| ID | Titel | URL / Referenz | Publisher | Typ | Relevanz |
|---|---|---|---|---|---|
| MDN_JS_MODULES | MDN: JavaScript modules | https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules | Native ES-Module, import/export, type=module und Import Maps fuer moderne Vanilla-JS-Struktur. | ||
| MDN_STRICT_MODE | MDN: Strict mode | https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Strict_mode | Striktere JavaScript-Ausfuehrung; Module sind automatisch strict, Legacy-Skripte brauchen explizites strict/IIFE. | ||
| MDN_ADD_EVENT_LISTENER | MDN: EventTarget.addEventListener | https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener | Standard-API fuer Event-Binding, Optionen und AbortSignal-basierte Listener-Verwaltung. | ||
| MDN_ABORT_CONTROLLER | MDN: AbortController | https://developer.mozilla.org/en-US/docs/Web/API/AbortController | Abbruch von Fetches und Event-Listenern fuer stale Requests und Komponenten-Cleanup. | ||
| MDN_FETCH | MDN: Using the Fetch API | https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch | Fetch-Requests, Response-Handling, Fehlerbehandlung und Request-Abbruch. | ||
| MDN_DOMCONTENTLOADED | MDN: DOMContentLoaded event | https://developer.mozilla.org/en-US/docs/Web/API/Document/DOMContentLoaded_event | Korrektes Bootstrapping abhaengig von classic/defer/module scripts und Dokumentzustand. | ||
| MDN_PROGRESSIVE_ENHANCEMENT | MDN Glossary: Progressive Enhancement | https://developer.mozilla.org/en-US/docs/Glossary/Progressive_Enhancement | Baseline-Funktion zuerst; moderne Browser erhalten zusaetzliche Verbesserung per Feature Detection. | ||
| MDN_JS_ACCESSIBILITY | MDN: CSS and JavaScript accessibility best practices | https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/Accessibility/CSS_and_JavaScript | Unobtrusive JavaScript, Semantik, native Controls und zugaengliche dynamische Inhalte. | ||
| WEBDEV_RESOURCE_LOADING | web.dev: Optimize resource loading | https://web.dev/learn/performance/optimize-resource-loading | Script-Loading, Parser-Blocking, Async/Defer/Module und Page-Performance. | ||
| WEBDEV_THIRD_PARTY_JS | web.dev: Efficiently load third-party JavaScript | https://web.dev/articles/efficiently-load-third-party-javascript | Drittanbieter-Skripte begrenzen, asynchron/deferred laden und Performance-Kosten sichtbar machen. | ||
| OWASP_DOM_XSS | OWASP DOM based XSS Prevention Cheat Sheet | https://cheatsheetseries.owasp.org/cheatsheets/DOM_based_XSS_Prevention_Cheat_Sheet.html | Untrusted Data nicht als Markup/Code behandeln; sichere DOM-Erzeugung mit createElement, setAttribute und appendChild. | ||
| OWASP_XSS | OWASP Cross Site Scripting Prevention Cheat Sheet | https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html | Unsafe sinks wie innerHTML minimieren; textContent/value bevorzugen und kontextgerecht encoden. | ||
| WCAG22 | Web Content Accessibility Guidelines 2.2 | https://www.w3.org/TR/WCAG22/ | Keyboard, Fokus, Statusmeldungen, Kontrast, Name/Role/Value, Eingabe und Vorhersagbarkeit. | ||
| WAI_STATUS | Understanding WCAG 4.1.3 Status Messages | https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html | Dynamische Statusmeldungen duerfen ohne Fokuswechsel erscheinen, muessen aber programmatisch bestimmbar sein. | ||
| COCKBURN_HEXAGONAL | Alistair Cockburn: Hexagonal Architecture | https://alistair.cockburn.us/hexagonal-architecture | Ports and Adapters: UI ist Adapter; Application bleibt unabhaengig von UI, Datenbank und externen Technologien. | ||
| FOWLER_PRESENTATION_DOMAIN | Martin Fowler: Presentation Domain Separation | https://martinfowler.com/bliki/PresentationDomainSeparation.html | Domainlogik und Praesentationslogik muessen getrennt bleiben. | ||
| FOWLER_SEPARATED_PRESENTATION | Martin Fowler: Separated Presentation | https://martinfowler.com/eaaDev/SeparatedPresentation.html | Praesentationscode manipuliert Praesentation; Domain- und Datenquellenlogik liegen getrennt. | ||
| FOWLER_MVC | Martin Fowler: Model View Controller | https://martinfowler.com/eaaCatalog/modelViewController.html | MVC als Muster zur Trennung von Input Controller, Model und View. | ||
| DDD_REFERENCE | Domain Language: Domain-Driven Design Reference | https://www.domainlanguage.com/ddd/reference/ | DDD-Bausteine wie Entity, Value Object, Aggregate, Repository, Domain Service und Bounded Context. | ||
| LOCAL_GUI_RULES | Lokale GUI-YAML-Libraries | file:/var/www/code/gui | Projektinterne GUI-Regeln fuer Formulare, Tabellen, Suche, Feedback, Theme, Drag/Drop, Uploads, Auth und Modal-Verbot. |
hallo Heiko
","created_at":"2026-05-21T14:57:05+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":45,"konversionen":11},{"id":79,"slug":"code/css/rules/css-016-design-tokens-semantic","title":"CSS_016_DESIGN_TOKENS_SEMANTIC:","meta_description":"CSS_016_DESIGN_TOKENS_SEMANTIC (major): .","content":"Severity: major. Bereich: css.
(kein Regeltext)
check:\n fail: Raw Hex-, px-, shadow- oder z-index-Werte werden in vielen Komponenten wiederholt.\n pass: Farben, Abstaende, Radii, Schatten, Fontgroessen, Motion und Z-Indices nutzen\n semantische Custom Properties.\n remediation: Semantische Tokens definieren, z.B. --color-surface, --color-danger-text,\n --space-3, --focus-ring.\n type: design_tokenhallo Andreas
","created_at":"2026-05-21T14:57:48+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":84,"konversionen":95},{"id":86,"slug":"code/css/rules/css-023-focus-visible-never-removed","title":"CSS_023_FOCUS_VISIBLE_NEVER_REMOVED:","meta_description":"CSS_023_FOCUS_VISIBLE_NEVER_REMOVED (blocker): .","content":"Severity: blocker. Bereich: css.
(kein Regeltext)
check:\n fail: 'outline: none ohne gleichwertigen Ersatz oder Fokus nur durch schwachen Schatten.'\n pass: Fokus ist per :focus-visible sichtbar, ausreichend gross und kontrastreich.\n remediation: Token fuer Focus-Ring definieren; outline/box-shadow mit >= 3:1 Zustandskontrast\n pruefen.\n type: accessibility_styleSeverity: major. Bereich: css.
(kein Regeltext)
check:\n fail: Komponente hat feste Farben oder nur Dark/Light ohne Systempfad.\n pass: Styles funktionieren fuer Light, Dark und System; color-scheme/meta-Vertrag\n wird nicht durch CSS unterlaufen.\n remediation: Theme-Tokens mit prefers-color-scheme und [data-theme] kombinieren;\n beide Modi messen.\n type: component_styleSeverity: blocker. Bereich: css.
(kein Regeltext)
check:\n fail: CSS zeigt Fehler nur als rote Border oder Placeholder ersetzt Label.\n pass: Fehler, Hinweise, Pflichtstatus, disabled/readonly und success sind inline\n sichtbar und nicht nur farblich.\n remediation: Fehlertext, aria-invalid, describedby und semantische Icons/Text visuell\n unterstuetzen.\n type: component_styleAls Zulieferer, Komponentenfertiger oder Logistikdienstleister haengt Ihre Wettbewerbsfaehigkeit wesentlich von exzellenten Logistikprozessen ab: zuverlaessige, termingerechte Lieferung in exakter Menge, vereinbarter Qualitaet und vorgeschriebener Verpackung an die richtige Abladestelle.
Unternehmen, die ihre Prozesse vom Auftragseingang ueber Kommissionierung, Verpackung, Transportzusammenstellung und Etikettierung bis zum Versand durchgaengig IT-gestuetzt steuern, haben die Nase vorn. Bei komplexen Ablaeufen wie Streckenabwicklung, Lohnbearbeitung oder Just-in-Sequence (JIS) zahlt sich diese Durchgaengigkeit besonders aus.
WSW Software plant und realisiert gemeinsam mit Ihnen eine massgeschneiderte Loesung mit mehr als 30 Jahren Logistikerfahrung, die sich rasch amortisiert und Effizienz, Flexibilitaet und Transparenz Ihrer Logistik nachhaltig erhoeht.
","created_at":"2026-05-21T15:06:15+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":22,"konversionen":73},{"id":115,"slug":"code/css/sources","title":"Quellen, css","meta_description":"Quellen des Bereichs css, 27 Eintraege.","content":"27 Quellen in /var/www/code/css/sources.yaml.
| ID | Titel | URL / Referenz | Publisher | Typ | Relevanz |
|---|---|---|---|---|---|
| W3C_CSS_CASCADE_6 | CSS Cascading and Inheritance Level 6 | https://www.w3.org/TR/css-cascade-6/ | Cascade, origins, importance, cascade layers und @scope als Grundlage fuer wartbare CSS-Architektur. | ||
| MDN_LAYER | MDN: @layer | https://developer.mozilla.org/en-US/docs/Web/CSS/@layer | Cascade Layers zur Steuerung von Prioritaet ohne Spezifitaetskaempfe. | ||
| MDN_CUSTOM_PROPERTIES | MDN: Using CSS custom properties | https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties | CSS Custom Properties fuer semantische Design Tokens, DRY und Theme-Faehigkeit. | ||
| MDN_CONTAINER_QUERIES | MDN: CSS container queries | https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_container_queries | Komponenten koennen sich an ihre Container statt nur an Viewport-Breakpoints anpassen. | ||
| MDN_NESTING | MDN: Using CSS nesting | https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_nesting/Using_CSS_nesting | Native CSS Nesting kann Wartbarkeit verbessern, erhoeht aber Spezifitaets- und Tiefenrisiko. | ||
| MDN_WHERE | MDN: :where() | https://developer.mozilla.org/en-US/docs/Web/CSS/:where | Niedrige Spezifitaet fuer Basis-/Reset-/Layout-Selektoren. | ||
| MDN_HAS | MDN: :has() | https://developer.mozilla.org/en-US/docs/Web/CSS/:has | Relationale Selektoren koennen JS reduzieren, muessen aber bewusst und performant eingesetzt werden. | ||
| MDN_SUPPORTS | MDN: @supports | https://developer.mozilla.org/en-US/docs/Web/CSS/@supports | Feature Detection und progressive CSS-Verbesserung ohne Browser-Sniffing. | ||
| MDN_LOGICAL_PROPERTIES | MDN: CSS logical properties and values | https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values | Richtungsunabhaengige Layouts fuer Internationalisierung und robuste Schreibmodi. | ||
| MDN_PREFERS_COLOR_SCHEME | MDN: prefers-color-scheme | https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme | Systempraeferenz fuer Light/Dark Mode. | ||
| MDN_COLOR_SCHEME | MDN: color-scheme | https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme | UA-Controls und initiale Farbschema-Verhandlung, inkl. Vermeidung falscher Erstfarben. | ||
| MDN_PREFERS_REDUCED_MOTION | MDN: prefers-reduced-motion | https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion | Nutzerpraeferenz fuer reduzierte Bewegung. | ||
| MDN_FORCED_COLORS | MDN: forced-colors | https://developer.mozilla.org/en-US/docs/Web/CSS/@media/forced-colors | High-Contrast/Forced-Colors-Kompatibilitaet. | ||
| MDN_HOVER | MDN: hover media feature | https://developer.mozilla.org/en-US/docs/Web/CSS/@media/hover | Hover-Styles nur einsetzen, wenn Hover-Eingabe tatsaechlich verfuegbar ist. | ||
| MDN_POINTER | MDN: pointer media feature | https://developer.mozilla.org/en-US/docs/Web/CSS/@media/pointer | Touch-/Pointer-Zielgroessen und Eingabemodalitaeten. | ||
| MDN_CSS_CONTAINMENT | MDN: Using CSS containment | https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_containment/Using_CSS_containment | Containment und content-visibility fuer Performance bei grossen Seiten. | ||
| MDN_CSS_PERFORMANCE | MDN: CSS performance optimization | https://developer.mozilla.org/en-US/docs/Learn_web_development/Extensions/Performance/CSS | CSS-Dateigroessen, ungenutzte Regeln, render-blocking CSS und optimierte Auslieferung. | ||
| WEBDEV_RENDER_BLOCKING_CSS | web.dev: Render-blocking CSS | https://web.dev/critical-rendering-path-render-blocking-css/ | CSS ist render-blocking; kritisches CSS klein halten und Auslieferung bewusst planen. | ||
| WCAG22 | Web Content Accessibility Guidelines 2.2 | https://www.w3.org/TR/WCAG22/ | Kontrast, Fokus, Reflow, Text Spacing, Motion, Pointer, Status und Name/Role/Value. | ||
| WCAG_CONTRAST_MINIMUM | Understanding WCAG 1.4.3 Contrast (Minimum) | https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html | Textkontrast fuer alle Theme- und State-Farbpaare. | ||
| WCAG_NON_TEXT_CONTRAST | Understanding WCAG 1.4.11 Non-text Contrast | https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html | Fokus, Borders, Icons, Controls und Zustandsmarker brauchen ausreichenden Kontrast. | ||
| WCAG_USE_OF_COLOR | Understanding WCAG 1.4.1 Use of Color | https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html | Farbe darf nicht einzige Informationsquelle sein. | ||
| WCAG_FOCUS_APPEARANCE | Understanding WCAG 2.4.13 Focus Appearance | https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html | Fokusindikatoren muessen ausreichend sichtbar und kontrastreich sein. | ||
| COCKBURN_HEXAGONAL | Alistair Cockburn: Hexagonal Architecture | https://alistair.cockburn.us/hexagonal-architecture | UI und Styling sind Adapter an der Aussenseite; Application bleibt unabhaengig von Praesentation. | ||
| FOWLER_PRESENTATION_DOMAIN | Martin Fowler: Presentation Domain Separation | https://martinfowler.com/bliki/PresentationDomainSeparation.html | Praesentations- und Domainlogik getrennt halten. | ||
| LOCAL_GUI_RULES | Lokale GUI-YAML-Libraries | file:/var/www/code/gui | Projektinterne GUI-Regeln fuer Formulare, Tabellen, Suche, Feedback, Theme, Uploads, Auth und Modal-Verbot. | ||
| LOCAL_JS_RULES | Lokale Vanilla-JS-YAML-Library | file:/var/www/code/js | JS setzt State/Verhalten; CSS reagiert auf Klassen, data-state, aria-* und Tokens. |
In der dynamischen Geschäftswelt von heute hängt Ihre Wettbewerbsfähigkeit davon ab, dass alle Geschäftsprozesse durchgängig und reibungslos ablaufen. Weil sich die Anforderungen ständig ändern, müssen Prozesse laufend optimiert, weiterentwickelt und modernisiert werden.
Unternehmen mit SAP-Lösungen profitieren besonders dann von unserer Beratung, wenn sie als Zulieferer oder Komponentenfertiger im Just-in-Sequence-Verfahren beliefern, Prozessabbildungen jenseits des SAP-Standards benötigen oder konkrete Vorhaben in Business Analytics oder SAP Global Trade Services umsetzen wollen.
Egal ob SAP ERP oder SAP S/4HANA: WSW Software begleitet Sie mit betriebswirtschaftlicher, prozessorientierter und technologischer Beratungskompetenz aus mehr als 30 Jahren Erfahrung, ergänzt um eigene Add-ons wie SPEEDI und JUNIQ, die den SAP-Standard modifikationsfrei erweitern.
","created_at":"2026-05-21T14:59:27+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":52,"konversionen":7},{"id":121,"slug":"code/deployment-config/rules/deploy-004-secret-rotation","title":"DEPLOY_004_SECRET_ROTATION: Secrets haben Rotation und Fallback","meta_description":"DEPLOY_004_SECRET_ROTATION (should): Secrets haben Rotation und Fallback. Kritische Secrets SOLLTEN Rotation, Verbraucheruebersicht und Fallback-Policy definieren, bevor sie produktiv genutzt we","content":"Severity: should. Bereich: deployment-config.
Kritische Secrets SOLLTEN Rotation, Verbraucheruebersicht und Fallback-Policy definieren, bevor sie produktiv genutzt werden.
check:\n reflect:\n fields:\n - rotation_policy\n - fallback_policy\n object: secret_configAnalyse der Landingpage wsw.de/leistungen/jis-beratung entlang des Komponenten-Modells nach Karl Kratz (Quelle: komponenten-modell_gesamt.pdf). Aufgeführt sind alle für eine Konversion relevanten Komponenten und ihre jeweilige Ausprägung auf der untersuchten Seite.
| Komponente | Ausprägung auf der WSW JIS-Beratungs-Seite |
|---|---|
| Logo | WSW Software im Header |
| Überschrift | Just-in-Sequence (JIS)-Beratung mit Sub-Headline „Gebündelte Kompetenz für Ihren JIS-Erfolg\" |
| Bild | Keyvisual sowie Bebilderung der einzelnen Beratungsphasen-Module |
| Einleitungs-Text | Kontext für Zulieferer: Menge, Zeit, Ort und Reihenfolge exakt einhalten; interne Prozessoptimierung als Voraussetzung |
| Informations-Text | Was ist JIS, Abgrenzung zu Just-in-Time, größte Probleme intern und extern, FAQ-Abschnitt |
| Aufzählungs-Liste | Externe Faktoren (Materialknappheit, Supply-Chain-Störungen, Produktionsausfälle, Fachkräftemangel) und interne Probleme (EDI-Kommunikation, sequenzgerechte Produktion, Systemausfälle, fehlende Ressourcen) |
| Handlungsaufforderung | „Lassen Sie sich beraten!\", „Lernen Sie unsere Experten persönlich kennen\", „Terminanfrage\" |
| Konversion-Element | Terminanfrage-Formular für 60-minütiges Kennenlerngespräch |
| Referenzen | Case Eurofit/Radsystem Mosel (JIS-Serienbelieferung Reifen-Rad-Baugruppen), Kundenauszug der WSW |
| Vertrauensbildende Elemente | 30+ Jahre JIS-Erfahrung, JIS Competence Center, ITIL-konformer Support, „Partner auf Augenhöhe\", technologieoffen mit und ohne SAP |
| Konditionen | Implizit über Leistungspakete von OEM-Ausschreibung über Strategieberatung, Planung, Softwareauswahl, Implementierung bis Betrieb und Update |
| AGB | Footer-Verlinkung |
| Social-Media-Elemente | Footer-Verlinkung |
| Impressum | Footer-Verlinkung |
| Datenschutz | Footer-Verlinkung |
Severity: must. Bereich: deployment-config.
Produktive Datenbanken MUESSEN Backup-Frequenz, Retention, Verschluesselung und regelmaessig getestete Wiederherstellung dokumentieren.
check:\n reflect:\n object: backup_policyAnwendung des Ebenen-Modells nach Karl Kratz auf das Thema Just-in-Sequence-Belieferung. Grundlage ist die öffentliche Darstellung auf wsw.de/leistungen/jis-beratung. Aufgeführt sind die dominanten Perspektiven, jeweils mit Leitfrage und beobachteten Resonanzpunkten.
| Ebene / Perspektive | Leitfrage | Resonanzpunkte aus der Quelle |
|---|---|---|
| Strategisch-wettbewerblich | Wie sichert JIS-Kompetenz langfristig den Marktzugang zum OEM? | Liefertreue, Lieferantenbewertung, Risiko des Lieferantenwechsels |
| OEM- und Kunden-Perspektive | Welche Erwartungen hat der OEM an Menge, Zeit, Ort und Reihenfolge? | Montagereihenfolge am Band, minutengenaue Anlieferung, OEM-spezifische Sonderanforderungen |
| Prozess- und Logistik-Perspektive | Wie bilden wir Sequenzbelieferung intern reibungslos ab? | Sequenzgerechte Produktion, Monitoring, Streckenabwicklung, Abgrenzung zu Just-in-Time |
| Technologisch (SAP / IT) | Mit welcher Software setzen wir die Logik um? | SAP-JIT-Modul, User Exits und BADIs, EDI-Datenempfang, SAP- und Non-SAP-Pfade |
| Risiko- und Krisen-Perspektive | Was passiert beim Bandstillstand des Kunden? | Produktionsstillstand beim OEM, Reputationsverlust, Vertragsstrafen |
| Wirtschaftlich-finanziell | Was kosten Sonderfahrten, Zusatzschichten und externe Dienstleister? | Sonderfahrten, Zusatzschichten, externe Sequenzierer als teure Alternative |
| Organisation und Menschen | Wer trägt im Unternehmen die JIS-Last, mit welchen Ressourcen? | Supply-Chain-Manager als „Feuerwehr\", Fachkräftemangel, Schulungsbedarf |
| Supply-Chain / externe Faktoren | Wie reagieren wir auf Störungen jenseits des eigenen Werks? | Materialknappheit, Supply-Chain-Störungen, Produktionsausfälle vorgelagerter Stufen |
| Daten- und Informations-Perspektive | Welche Datenflüsse machen den Prozess transparent? | EDI-Empfang, Lieferavise, Feinabrufe, Monitoring-Dashboards |
| Service- und Betriebs-Perspektive | Wie bleibt die Lösung über Jahre stabil und konform? | ITIL-konformer Support, Wartung, Updates, langfristige Partnerschaft |
| Methodisch-Beratungs-Perspektive | In welcher Projektphase steigen wir ein? | OEM-Ausschreibung, Strategieberatung, Projektplanung, Softwareauswahl, Implementierung, Betrieb |
Severity: must. Bereich: deployment-config.
Rollbacks MUESSEN mit Datenbankmigrationen, Feature Flags, Cache und laufenden Jobs kompatibel geplant werden; reine Code-Rollbacks reichen bei Schemaaenderungen nicht aus.
check:\n reflect:\n objects:\n - deployment_step\n - migration_deploySeverity: must. Bereich: http-api.
Jeder Endpunkt MUSS Zugriff, Tenant-Scope und Objektberechtigung serverseitig pruefen; ausgeblendete UI-Elemente ersetzen niemals Autorisierung.
check:\n reflect:\n fields:\n - auth_required\n - tenant_scope\n object: endpointSieben konkrete Marktbegleiter und thematisch verwandte Anbieter im Just-in-Sequence-Umfeld. Jeder Eintrag verlinkt nicht auf die generische Startseite, sondern auf die JIS-spezifische Detail-, Produkt- oder Lexikon-Seite. Alle URLs wurden gegen den Live-Status geprüft (HTTP 200). Sprachvarianten der URLs sind bevorzugt deutsch.
| Marktbegleiter | Sitz | Schwerpunkt im JIS-Umfeld | JIS-Detailseite |
|---|---|---|---|
| amotIQ automotive GmbH | Heilbronn | JIT/JIS-Produkt JITplant: modulares Sequenzsystem für Montagesteuerung in Automotive und Manufacturing | amotiq.de/kompetenzen-leistungen/jit-jis/ |
| nemetris GmbH | Bietigheim-Bissingen | JIS Software Solutions für die Automobilbranche; Produktübersicht über alle JIS-Varianten (Produktion, Montage, Logistik, SaaS); 20+ Jahre JIS-Erfahrung | nemetris.com/de/jis-software-loesungen/ |
| JITpro GmbH | Leipzig | Individualprogrammierung von Lager- und Dispositionssoftware für JIS-Zulieferer; wickelt rund 5.000 Modulmontagen pro Tag ab | jitpro.de/leistungen/automotive |
| Prisma Software Engineering GmbH | Papenburg | Eigenes JIS-System mit EDI-Schnittstellen zu OEMs zur Organisation und Steuerung der Produktion | prisma-software.de/?menu=jis-system |
| Aimtec a.s. | Pilsen (CZ) | JIS/JIT-Plattform mit automatischer EDI-Nachrichtenverarbeitung, Sequenzierung, Versand und Abrechnungskontrolle | aimtecglobal.com/de/just-in-sequence |
| LIS AG | Greven | Transportmanagement-Software; JIS-Lexikoneintrag mit Begriffsklärung, Herausforderungen und Anbieterperspektive | lis.eu/lexikon/just-in-sequence/ |
| Symestic GmbH | Bremen | MES-Anbieter; thematisiert JIS als Anwendungsfall: Unterschied zu JIT, EDI-Ablauf vom OEM-Abruf bis zur Linie und IT-Anforderungen | symestic.com/de-de/was-ist/jis |
amotIQ, nemetris, Prisma und JITpro sind direkte Wettbewerber von WSW Software mit eigenem JIS-Produkt oder Individualentwicklung. Aimtec deckt eine breitere JIT/JIS-Plattform inklusive EDI-Stack ab. LIS und Symestic sind nicht im engen Sinne JIS-Beratungswettbewerber, sondern angrenzende Anbieter (Transportmanagement bzw. MES), deren öffentliche Lexikon-/Themenseiten den JIS-Diskurs prägen.
","created_at":"2026-05-21T15:38:39+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":56,"konversionen":22},{"id":1201,"slug":"marktbegleiter-komponenten","title":"JIS-Marktbegleiter + WSW – Komponenten-Matrix (0/1)","meta_description":"Binäre Komponenten-Analyse von 5 JIS-Marktbegleitern: Vereinigungsmenge aller gefundenen Komponenten als Zeilen, Anbieter-URLs als Spalten, Zellwerte 0/1, Zeilen- und Spaltensummen.","content":"Binäre Komponenten-Analyse von fünf Just-in-Sequence-Marktbegleitern, ergänzt um WSW Software als Referenz-Anker. Spalten = Anbieter-Detailseiten (5 Marktbegleiter + WSW als 6. Spalte). Zeilen = Vereinigungsmenge aller auf mindestens einer der 6 Seiten tatsächlich identifizierten Komponenten (datengetrieben). Zellwerte: 1 = vorhanden, 0 = nicht vorhanden. Ausgeschlossen: LIS und Symestic (Lexikon-Seiten, keine Konversion) sowie AGB / Impressum / Datenschutz (Footer-Pflicht, analytisch irrelevant).
| Komponente | amotIQ | nemetris | JITpro | Prisma | Aimtec | WSW | Σ_row |
|---|---|---|---|---|---|---|---|
| Logo (Header-Marke) | 1 | 1 | 1 | 1 | 1 | 1 | 6 |
| Hauptüberschrift | 1 | 1 | 1 | 1 | 1 | 1 | 6 |
| Einleitungs-Text | 1 | 1 | 1 | 1 | 1 | 1 | 6 |
| Informations-Text | 1 | 1 | 1 | 1 | 1 | 1 | 6 |
| Aufzählungs-Liste | 1 | 0 | 1 | 1 | 1 | 1 | 5 |
| Sub-Headline / Claim | 1 | 0 | 0 | 1 | 1 | 1 | 4 |
| Handlungsaufforderung (textueller CTA) | 1 | 1 | 0 | 1 | 0 | 1 | 4 |
| Vertrauensbildende Elemente (Erfahrung / Kennzahlen) | 1 | 0 | 1 | 0 | 1 | 1 | 4 |
| Konversion-Element (Kontakt-Link / -Formular) | 0 | 1 | 0 | 1 | 0 | 1 | 3 |
| Referenzen / Kundenliste | 0 | 0 | 0 | 1 | 1 | 1 | 3 |
| Fallstudie / Case-Study | 0 | 0 | 0 | 0 | 1 | 1 | 2 |
| 24/7-Support-Hinweis | 1 | 0 | 0 | 0 | 0 | 0 | 1 |
| Σ_col | 9 | 6 | 6 | 9 | 9 | 11 | Σ_total = 50 |
Σ aller Zeilensummen = 6+6+6+6+5+4+4+4+3+3+2+1 = 50. Σ aller Spaltensummen = 9+6+6+9+9+11 = 50. Beide Wege liefern denselben Σ_total → Matrix konsistent.
alt-Text) können fälschlich als 0 gezählt sein.Binäre Ebenen-Analyse nach dem Ebenen-Modell von fünf Just-in-Sequence-Marktbegleitern plus WSW Software als Referenz-Anker. Spalten = Anbieter-Detailseiten (5 Marktbegleiter + WSW). Zeilen = datengetriebene Vereinigungsmenge aller Ebenen, die auf mindestens einer der 6 Seiten mit eigenem Abschnitt oder mehreren Sätzen explizit adressiert werden (Sharp-Kriterium). Zellwerte: 1 = Ebene auf der Seite eigenständig adressiert, 0 = nicht oder nur beiläufig. Ausgeschlossen: LIS und Symestic (Lexikon-Seiten, keine Anbieter-Frame).
| Ebene / Perspektive | amotIQ | nemetris | JITpro | Prisma | Aimtec | WSW | Σ_row |
|---|---|---|---|---|---|---|---|
| Technologisch / Produkt | 1 | 1 | 1 | 1 | 1 | 1 | 6 |
| Prozess- und Logistik-Perspektive | 1 | 0 | 1 | 1 | 1 | 1 | 5 |
| Daten- und Informations-Perspektive (EDI / Schnittstellen) | 0 | 0 | 0 | 1 | 1 | 1 | 3 |
| Risiko- und Kontroll-Perspektive (Sicherheits-/Audit-Mechanismen) | 0 | 0 | 0 | 1 | 1 | 1 | 3 |
| OEM- und Kunden-Perspektive | 0 | 0 | 0 | 0 | 1 | 1 | 2 |
| Service- und Betriebs-Perspektive (Support / Wartung) | 1 | 0 | 0 | 0 | 0 | 1 | 2 |
| Wirtschaftlich-finanzielle Perspektive | 1 | 0 | 0 | 0 | 0 | 0 | 1 |
| Methodisch-Beratungs-Perspektive (Phasenmodell) | 0 | 0 | 0 | 0 | 0 | 1 | 1 |
| Strategisch-wettbewerbliche Perspektive | 0 | 0 | 0 | 0 | 0 | 1 | 1 |
| Supply-Chain / externe Faktoren | 0 | 0 | 0 | 0 | 0 | 1 | 1 |
| Organisation und Menschen | 0 | 0 | 0 | 0 | 0 | 1 | 1 |
| Branchen- / Marktumfeld-Perspektive | 0 | 0 | 1 | 0 | 0 | 0 | 1 |
| Integrations- / Vernetzungs-Perspektive (SAP / Drittsysteme) | 0 | 0 | 0 | 0 | 1 | 0 | 1 |
| Σ_col | 4 | 1 | 3 | 4 | 6 | 10 | Σ_total = 28 |
Σ aller Zeilensummen = 6+5+3+3+2+2+1+1+1+1+1+1+1 = 28. Σ aller Spaltensummen = 4+1+3+4+6+10 = 28. Beide Wege liefern denselben Σ_total → Matrix konsistent.
Beleg: „Die Automobilindustrie gehört zu den volkswirtschaftlich bedeutendsten Industriezweigen in Deutschland. Zu ihrer Erfolgsstrategie in Bezug auf Preisbereitschaft bei den Kunden und Deckungsbeiträge zählt maßgeblich die Abstimmung der Fahrzeuge auf die Bedürfnisse der Kunden.\" sowie „Eine der bedeutendsten Entwicklungen im Automotive-Bereich ist die zunehmende Einbindung softwarebasierter Lösungen.\"
Mechanik: JITpro öffnet die Seite nicht mit dem eigenen Produkt, sondern mit der makroökonomischen Bedeutung der Branche. Die eigene Software wird damit als Beitrag zu einem volkswirtschaftlich relevanten Sektor positioniert – nicht als Werkzeug unter vielen.
Resonanz: Adressiert Entscheider, die ihre Tätigkeit über die Bedeutung der Branche legitimieren (Geschäftsführung, Vorstand, Standortleitung in Zuliefererbetrieben). Das Software-Investment wird Teil eines größeren Narrativs („Wir tragen die deutsche Automobilindustrie mit\").
Wirkung: Status-Aufladung statt Funktions-Argumentation. Wer mit JITpro arbeitet, arbeitet an etwas Bedeutendem – die Software wird emotional aufgewertet, bevor sie überhaupt beschrieben wird.
Lücke bei den anderen: Alle übrigen Anbieter starten mit „Was kann das Produkt?\" oder „Was ist JIS?\". Niemand verankert das Thema im Bedeutungsraum der Zielbranche.
Beleg: Eigener H2-Block „Vernetzen Sie JIS/JIT mit weiteren Systemen und Technologien\" mit dem expliziten Satz „Eine umfassende Nutzung aller Möglichkeiten der JIS/JIT-Lösung wird erst durch die Vernetzung mit einem EDI-System, Informations- und Steuerungssystemen sowie technologischen Anlagen ermöglicht.\" Darunter zwei klar getrennte Architektur-Pfade: SAP-Lösung („JIS/JIT im System SAP – Lösung unter Nutzung des vorhandenen SAP-Systems\") und eigenständige Lösung („Aimtec DCIx\"). Plus konkreter Hardware-Block „Erweitern Sie Ihre JIS/JIT-Lösung um Zebra-Geräte\".
Mechanik: Aimtec nimmt den Architektur-Vorbehalt von IT-Entscheidern direkt vorweg. Statt das Produkt isoliert zu beschreiben, wird es als integrationsfähiger Baustein in der bestehenden IT- und Hardware-Landschaft gezeigt. Die binäre Wahl SAP-eingebettet vs. standalone räumt die größte Architektur-Sorge im SAP-dominierten Zuliefer-Umfeld aus.
Resonanz: Adressiert IT-Architekten, CIOs und SAP-Verantwortliche, die wissen, dass JIS-Insellösungen langfristig scheitern. Auch Logistik-Leiter, die die Hardware-Realität (Drucker, Scanner, RF-Geräte) im Blick haben – Zebra ist als Marke konkret und unmittelbar erkennbar.
Wirkung: Senkt Risiko-Wahrnehmung („passt das in unsere IT?\") und erweitert die Käufer-Persona vom Logistik-Verantwortlichen auf das IT-Buying-Center.
Lücke bei den anderen: WSW erwähnt zwar „technologieunabhängig (mit oder ohne SAP)\" in einem Service-Punkt, aber ohne eigenen Architektur-Block. Bei amotIQ, nemetris, JITpro und Prisma fehlt das Integrations-Narrativ ganz – sie überlassen die Architektur-Frage dem Erstgespräch.
Beleg: Sub-Headline „Maximale Effizienz – null Lagerbestand.\" Plus Vorteilsblock mit fünf wirtschaftlich aufgeladenen Bullets: „Reihengenau synchronisierte Serienfertigung; Ideal für hochwertige Bauteile mit kurzen Lieferzeiten; Minimale Lagerhaltung beim OEM; Geringere Kapitalbindung; Weniger Fehler durch klar strukturierte Prozesse\".
Mechanik: amotIQ übersetzt JIS-Funktion in betriebswirtschaftliche Wirkung. „Kapitalbindung\" und „Lagerhaltung\" sind Buchhaltungs- und Bilanz-Begriffe – sie aktivieren ein anderes Hirn als „Sequenzgenauigkeit\" oder „EDI\". JIS wird zum Bilanz-Hebel.
Resonanz: Adressiert CFOs, kaufmännische Leiter, Einkauf, Geschäftsführung – Rollen, die JIS sonst als reines Logistik-Thema delegieren würden. Es macht JIS zum Investitions-Thema mit erwartbarer Rendite, nicht zum Prozesskosten-Thema.
Wirkung: Erweitert das Buying-Center um die kaufmännische Seite und erhöht die wahrgenommene Priorität – ein Produkt, das Kapital freisetzt, hat im Budget-Wettbewerb eine andere Position als eines, das „Prozesse verbessert\".
Lücke bei den anderen: WSW operiert stark mit Risiko-Framing (Bandstillstand, Lieferantenbewertung, Sonderfahrten). Das ist Verlustvermeidung. Es fehlt die Gewinn-Argumentation – sichtbare ROI-Treiber wie Bestandsreduktion oder Kapitalfreisetzung. Bei Prisma, nemetris, JITpro und Aimtec ebenfalls nicht vorhanden.
WSW dominiert die Matrix mit 10 von 13 Ebenen – die strukturelle Beratungs-Signatur (Methodik, Strategie, Supply-Chain, Organisation) ist klar und differenzierend. Die drei Lücken sind die drei Exklusiv-Frames der Wettbewerber. Sie zu schließen, ohne die Beratungs-Klammer zu verwässern, ergibt drei konkrete, gezielte Hebel:
Mit diesen drei Hebeln wäre WSW auf allen 13 Ebenen vertreten – ohne die bestehende Beratungs-Klammer zu verlieren, sondern indem die Beratungslogik in drei zusätzliche Stakeholder-Welten erweitert wird: Strategie/Branche (Geschäftsführung), Architektur (CIO/IT), Wirtschaftlichkeit (CFO/Einkauf). Die heutige Stärke (Methodik, Strategie, Risiko, Organisation, Supply-Chain) bleibt unangetastet; die Lücken zu den drei Tech-/Produkt-Anbietern werden geschlossen, indem die Beratung explizit jene Frames bedient, die heute nur über das Produkt erzählt werden.
Reihenfolge der Umsetzung: Hebel 3 (Business-Case) zuerst – größte Buying-Center-Wirkung bei geringstem inhaltlichen Risiko, weil eigene Cases bereits existieren. Dann Hebel 2 (Architektur) – stärkster Konkurrenz-Differenzierer im B2B-IT-Vergleich. Hebel 1 (Branche) zuletzt – wirkt nur, wenn er pointiert genug ist, nicht als Lehrbuch-Einleitung.
","created_at":"2026-05-21T16:08:10+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":62,"konversionen":81},{"id":251,"slug":"code/performance/rules/perf-002-core-web-vitals-targets","title":"PERF_002_CORE_WEB_VITALS_TARGETS: Core Web Vitals sind Zielmetriken","meta_description":"PERF_002_CORE_WEB_VITALS_TARGETS (should): Core Web Vitals sind Zielmetriken. Nutzerrelevante Seiten SOLLTEN LCP, INP und CLS messen und Regressionen gegen definierte Schwellen verhindern.","content":"Severity: should. Bereich: performance.
Nutzerrelevante Seiten SOLLTEN LCP, INP und CLS messen und Regressionen gegen definierte Schwellen verhindern.
check:\n reflect:\n fields:\n - target_lcp_ms\n - target_inp_ms\n - target_cls\n object: route_budgetWenn das Band beim OEM stillsteht, ist Ihr Geschäft in Gefahr. Wir kennen diese Verantwortung seit über 30 Jahren.
Die deutsche Automobil-Zulieferindustrie ist das Rückgrat eines der wertvollsten Wirtschaftszweige Europas: hunderttausende Arbeitsplätze, dreistellige Milliarden-Umsätze, eine Lieferkette, in der Sequenzgenauigkeit über den OEM-Auftrag von morgen entscheidet. Wer in diesem Umfeld die Just-in-Sequence-Belieferung verantwortet, hat keinen Spielraum für Lernkurven. Ein falsch sequenziertes Modul am Band kostet nicht nur Sonderfracht – es kostet Lieferantenbewertung. Und eine schlechte Lieferantenbewertung kostet beim nächsten Vergabezyklus den Auftrag.
WSW Software begleitet seit mehr als drei Jahrzehnten Zulieferer und Komponentenfertiger, die im JIS- und JIT-Verfahren an deutsche und internationale OEMs liefern. Wir haben die spezifischen Anforderungen der großen Marken im Detail durchgearbeitet – von Sequenznummern-Prüfungen über User-Exits im SAP-JIT-Modul bis zur Gelangensbestätigung bei Kreuz-Grenzen-Belieferungen.
Wir wissen, was passiert, wenn ein Feinabruf zu spät kommt. Wir kennen die Spielregeln der Lieferantenportale aller großen OEMs. Wir bauen Prozesse, die auch dann tragen, wenn Materialknappheit, Streiks oder Produktionsverlagerungen den Plan über den Haufen werfen. Und wir bringen Erfahrung aus Werken in der DACH-Region, in Osteuropa und in Asien – dort, wo Ihre Kunden produzieren.
Eurofit ist ein Joint Venture von Michelin und Continental mit 18 Werken in Europa, Afrika und Asien und 1.200 Mitarbeitenden. WSW Software hat die Just-in-Sequence-Serienbelieferung der Reifen-Rad-Baugruppen (TWAs) runderneuert: vom EDI-Abruf des OEMs über die sequenzgerechte Produktion bis zur Bandanlieferung in der vorgegebenen Reihenfolge.
Jeder OEM kocht sein eigenes Süppchen. Wir kennen die Rezepte. Vereinbaren Sie ein 60-minütiges Erstgespräch mit unseren JIS-Experten – wir hören uns Ihre Situation an und zeigen, welche Stellschrauben in Ihrem konkreten Fall den größten Hebel haben.
→ Termin für ein Erstgespräch anfragen
","created_at":"2026-05-21T16:30:55+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":90,"konversionen":5},{"id":157,"slug":"code/http-api/rules/http-002-method-semantics","title":"HTTP_002_METHOD_SEMANTICS: HTTP-Methoden behalten ihre Semantik","meta_description":"HTTP_002_METHOD_SEMANTICS (must): HTTP-Methoden behalten ihre Semantik. GET MUSS lesend bleiben, POST erzeugt oder startet nicht-idempotente Aktionen, PUT/PATCH aktualisieren und DELETE loesch","content":"Severity: must. Bereich: http-api.
GET MUSS lesend bleiben, POST erzeugt oder startet nicht-idempotente Aktionen, PUT/PATCH aktualisieren und DELETE loescht oder deaktiviert nach fachlicher Definition.
check:\n reflect:\n fields:\n - method\n object: mutation_contractSonderfrachten. Sicherheitsbestände. Reaktive Disponenten. Sinkende Lieferantenbewertung. Vier Reibungen, die parallel an Ihrer Bilanz und Ihrer Auftragsbasis arbeiten. Gleichzeitig. Jeden Tag.
Jeden Tag, an dem Ihre Sequenzlogik nicht trägt, passiert mehreres parallel. Disponenten verbringen Stunden mit Notfall-Telefonaten statt mit Planung. Ein Express-Frachtdienstleister fährt eine Lieferung in den roten Bereich, damit das Band beim OEM weiterläuft. Im Lager steht Material, das niemand abgerufen hat – als Sicherheit gegen die nächste Eskalation. Und im Lieferantenportal des OEMs verdichten sich diese Auffälligkeiten zu einer Bewertung, die in 18 Monaten über die nächste Ausschreibung entscheidet.
Das passiert nicht spektakulär. Es passiert leise, jede Woche, jeden Monat. Bis die Summe – auf der Logistik-Kostenstelle, in der Lagerbestands-Rechnung, im Krankenstand der Disposition und in der OEM-Bewertungs-Mail – nicht mehr zu übersehen ist. JIS-Reibung ist keine operative Unbequemlichkeit. Sie ist ein Bilanz-Hebel, der nach unten zeigt – und am Ende eine Vertrags-Frage.
Just-in-Sequence-Belieferung ist eines der wenigen Logistik-Themen, bei denen sich Investitionen direkt in der Bilanz nachweisen lassen. Wer Lieferreihenfolge, Sequenzgenauigkeit und Datenflüsse beherrscht, baut Bestände ab, senkt die Kapitalbindung und vermeidet die teuren Eskalationen, die bei jedem Sequenzfehler drohen. Die wirtschaftliche Gretchenfrage liegt offen auf dem Tisch: Wie viel Kapital ist in Ihren Vor- und Halbfertigprodukten gebunden, weil die Sequenzlogik nicht trägt? Und wie viele Sonderfrachten pro Quartal sind nichts anderes als kompensierte Prozessschwäche?
Die Wirtschaftlichkeit eines JIS-Prozesses entscheidet sich an vier Hebeln. Wir analysieren sie in Ihrem konkreten Fall und übersetzen sie in ein belastbares Business Case mit nachvollziehbaren Annahmen, Quellen und Vergleichswerten:
Bei einem Reifen-Rad-Modul-Lieferanten haben wir die Just-in-Sequence-Belieferung an einen großen deutschen OEM so stabilisiert, dass Sonderfahrten und Eskalations-Lieferungen über das Jahr hinweg deutlich zurückgingen – mit einem direkten, sichtbaren Effekt auf die jährliche Logistik-Kostenstelle und auf die Sicherheitsbestände auf Werks-Ebene.
Wir zeigen Ihnen die vier Hebel in Ihrer konkreten Situation – mit nachvollziehbaren Annahmen, Vergleichswerten und einer ehrlichen Einschätzung, was wirklich erreichbar ist. Vereinbaren Sie ein 60-minütiges Erstgespräch mit unserer Beratung.
→ Termin für ein Business-Case-Erstgespräch anfragen
","created_at":"2026-05-21T16:31:24+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":49,"konversionen":35},{"id":166,"slug":"code/http-api/rules/http-011-schema-documentation","title":"HTTP_011_SCHEMA_DOCUMENTATION: Schemas sind maschinenlesbar","meta_description":"HTTP_011_SCHEMA_DOCUMENTATION (should): Schemas sind maschinenlesbar. JSON-Requests und -Responses SOLLTEN per OpenAPI 3.1 und JSON Schema beschrieben werden, inklusive Pflichtfeldern, Forma","content":"Severity: should. Bereich: http-api.
JSON-Requests und -Responses SOLLTEN per OpenAPI 3.1 und JSON Schema beschrieben werden, inklusive Pflichtfeldern, Formaten, Enums und Fehlervarianten.
check:\n reflect:\n fields:\n - schema_ref\n object: representationSeverity: should. Bereich: http-api.
Zahlungs-, Import-, Versand- und aehnlich riskante POST-Aktionen SOLLTEN einen Idempotency-Key oder eine gleichwertige serverseitige Deduplizierung nutzen.
check:\n reflect:\n fields:\n - idempotency_key\n object: mutation_contractMit SAP oder ohne. Standard oder Add-on. Wir bauen JIS in die Architektur, die Sie heute betreiben – nicht daneben.
Eine JIS-Software, die nicht sauber in das ERP, den EDI-Stack und die Hardware-Welt der Logistik integriert ist, verursacht das, was sie eigentlich vermeiden soll: Doppelpflege, Schnittstellen-Brüche, Datenstaus und im Krisenfall keinen, der noch den Überblick hat. WSW Software begleitet JIS-Projekte deshalb von Anfang an als Integrationsthema. Wir denken nicht in „unserem System\" gegen „Ihre Landschaft\", sondern bauen JIS dort ein, wo Ihre Daten heute leben und wo Ihre Werker und Disponenten morgen damit arbeiten.
Wir arbeiten technologieoffen mit den beiden Architektur-Pfaden, die heute im Markt relevant sind. Beide haben wir vielfach umgesetzt – und wir beraten ehrlich, welcher in Ihrem konkreten Fall trägt.
Im SAP-Umfeld – ob klassisch ECC oder S/4HANA – nutzen wir das vorhandene JIT-Modul, schneiden mit User Exits und BADIs die OEM-spezifischen Sonderwege passgenau zu und greifen, wo sinnvoll, auf unsere eigenen, modifikationsfreien SAP-Add-ons SPEEDI und JUNIQ zurück. Damit bleiben Sie release-fähig, ohne auf JIS-Funktionalität zu verzichten, die der SAP-Standard nicht liefert.
Setzen Sie Best-of-Breed-Komponenten ein oder fahren Sie eine Non-SAP-ERP-Landschaft, binden wir JIS sauber an: ERP-System, EDI-Provider, MES, WMS, Lagerverwaltung und die Hardware-Welt der Sequenz-Realität. Wir bauen Schnittstellen, die auch unter Last halten – und nicht nur im Lastenheft funktionieren.
Bei Eurofit / Radsystem Mosel haben wir die Just-in-Sequence-Serienbelieferung in eine heterogene IT-Architektur eingebettet – mit OEM-spezifischen EDI-Strecken, Sequenz-Logik bis zur Bandanlieferung und durchgängigem Datenfluss von der Reifen-Rad-Baugruppe bis zur Versandbestätigung.
Senden Sie uns eine kurze Skizze Ihrer IT-Landschaft oder vereinbaren Sie ein 60-minütiges Architektur-Gespräch. Wir zeigen, wie JIS in Ihrem konkreten Setup tragen kann – mit klaren Empfehlungen für SAP-eingebettete oder Non-SAP-Integration.
→ Termin für ein Architektur-Erstgespräch anfragen
","created_at":"2026-05-21T16:32:28+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":69,"konversionen":34},{"id":174,"slug":"code/js/rules","title":"Regeln, js","meta_description":"Liste der 48 Regeln im Bereich js, sortiert nach ID.","content":"48 Regeln in /var/www/code/js/rules.yaml.
14 Quellen in /var/www/code/gui/datentabellen-crud/sources.yaml.
| ID | Titel | URL / Referenz | Publisher | Typ | Relevanz |
|---|---|---|---|---|---|
| WCAG22 | Web Content Accessibility Guidelines 2.2 | https://www.w3.org/TR/WCAG22/ | Normative A/AA/AAA Success Criteria fuer Tabellen, Links, Fokus, Pointer-Ziele, Fehler und Statusmeldungen. | ||
| WAI_WCAG_OVERVIEW | WCAG 2 Overview | https://www.w3.org/WAI/standards-guidelines/wcag/ | Stand 2026, Rueckwaertskompatibilitaet und EN-301-549-Hinweis. | ||
| WAI_TABLES | WAI Tables Tutorial | https://www.w3.org/WAI/tutorials/tables/ | Datentabellen-Semantik, th/td, scope, id/headers, caption und komplexe Header. | ||
| W3C_DESIGN_TABLES | W3C Design System: Tables | https://design-system.w3.org/styles/tables.html | Praktische W3C-Pattern fuer Tabellen, Captions, responsive Scroll-Regionen und Header-Scope. | ||
| APG_GRID | WAI-ARIA APG: Grid Pattern | https://www.w3.org/WAI/ARIA/apg/patterns/grid/ | Interaktive Data Grids, Fokusmodell, Tastaturnavigation und Rollen. | ||
| W3C_ARIA | Using ARIA | https://www.w3.org/TR/using-aria/ | Native HTML vor ARIA; Custom Controls nur mit vollstaendiger Semantik und Tastaturbedienung. | ||
| WAI_TARGET_SIZE | Understanding WCAG 2.5.8 Target Size Minimum | https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html | 24px AA, 44px Enhanced/AAA und Spacing-Ausnahmen fuer Actions in Tabellen. | ||
| WAI_FOCUS_APPEARANCE | Understanding WCAG 2.4.13 Focus Appearance | https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html | Enhanced Fokusgroesse und Kontrast fuer Zellen, Links und Row Actions. | ||
| WAI_STATUS | Understanding WCAG 4.1.3 Status Messages | https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html | Dynamische Meldungen fuer Laden, Speichern, Loeschen, Filter, Sortierung und Pagination. | ||
| ISO_9241_110 | ISO 9241-110 Interaction principles | https://www.iso.org/standard/75258.html | Task suitability, self-descriptiveness, conformity with expectations, controllability und use error robustness. | ||
| MARCHIONINI_ETABLES_2003 | User studies informing E-table interfaces | https://doi.org/10.1016/S0306-4573(02)00043-2 | User Studies zu elektronischen Tabellen und Table-Browser-Interfaces. | ||
| TAGGLE_2020 | Taggle: Combining overview and details in tabular data visualizations | https://doi.org/10.1177/1473871619878085 | Interaktive Tabellennutzung, Sortieren, Filtern, Gruppieren und Overview/Details fuer grosse Tabellen. | ||
| BAYMARD_PRODUCT_LISTS | E-Commerce Product Lists and Filtering UX | https://baymard.com/research/ecommerce-product-lists | Gross angelegte UX-Studie zu Scannen, Filtern und Sortieren von Listen/Result-Sets. | ||
| NIELSEN_HEURISTICS | 10 Usability Heuristics for User Interface Design (Nielsen) | https://www.nngroup.com/articles/ten-usability-heuristics/ | Heuristik 2 Match between system and the real world und Heuristik 4 Consistency and standards - Such-Reichweite muss dem entsprechen, was als Daten sichtbar gerendert wird. |
Severity: major. Bereich: js.
(kein Regeltext)
check:\n fail: JS parst sichtbaren Text, CSS-Klassen oder DOM-Reihenfolge als fachliche Datenquelle.\n pass: PHP View/Action und JS stimmen ueber explizite data-* Attribute, JSON-DTOs\n oder dokumentierte Response-Shapes ueberein.\n remediation: Datenvertrag in data-* Attributen, application/json script oder Endpoint-DTO\n sichtbar machen.\n type: php_contractSeverity: blocker. Bereich: css.
(kein Regeltext)
check:\n fail: Button oder Link ist per display:none/hidden Klasse verborgen, aber serverseitig\n erreichbar oder im DOM vorhanden.\n pass: Nicht erlaubte Aktionen werden serverseitig nicht gerendert oder serverseitig\n gesperrt; CSS versteckt sie nicht als Schutz.\n remediation: Autorisierung in PHP pruefen; DOM nur erlaubte Aktionen rendern; CSS\n darf optionale Sichtbarkeit nicht als Sicherheitsgrenze nutzen.\n type: php_css_contractSeverity: must. Bereich: http-api.
Suche, Filter, Exporte, Uploads und Mutationen MUESSEN serverseitige Limits fuer Rate, Seitengroesse, Payload und Laufzeit besitzen.
check:\n reflect:\n objects:\n - query_contract\n - endpointSeverity: major. Bereich: css.
(kein Regeltext)
check:\n applies_when: overlay_style_present == true\n fail: Overlay blockiert Seite oder imitiert Modal-Verhalten.\n pass: Overlay ist nicht-blockierend oder technisch notwendig, z.B. Video-Layer/Loading,\n und verdeckt keine Bedienung ohne Alternative.\n remediation: Overlay entfernen oder als inline/section loading state umsetzen; Fokus\n und Bedienbarkeit erhalten.\n type: component_styleDies ist ein Model Context Protocol-Server, der den drei lokal installierten AI-CLIs (Claude Code, Codex, qwen-code) Werkzeuge zum Verwalten von Seiten auf ki.karlkratz.com bereitstellt. Wenn der KI z. B. mitgeteilt wird „lege eine Seite an\", ruft sie das Tool create_page auf, der Server schreibt in die Datenbank, die Seite ist sofort live.
| Tool | Wirkung |
|---|---|
| list_pages | Alle Seiten, mit Suche, Sortierung, Pagination |
| get_page | Eine Seite per Slug |
| create_page | Neue Seite anlegen |
| update_page | Felder einer bestehenden Seite überschreiben |
| delete_page | Seite per Slug löschen |
Beide Codebases, die PHP-App und der Python-MCP, folgen demselben Muster, jede Datei unter 100 Zeilen.
Ausschließlich in der PHP-Schicht. Der Python-MCP ist ein dünner HTTP-Adapter. Slug-Regex, Längen-Limits und die HTML-Tag-Whitelist (h1, h2, h3, p, ol, ul, li, a, strong, table, pre, code) leben ausschließlich im PHP-Code. Das Python-Modul kennt diese Regeln nicht und muss sie auch nicht kennen, fügt man später eine zweite Schnittstelle hinzu (CLI-Tool, Webhook), bleibt die Regel weiterhin an genau einer Stelle.
Der DomHtmlSanitizer in PHP parst den eingehenden Body mit DOMDocument, läuft den Baum rückwärts ab und entfernt jeden Tag, der nicht auf der Whitelist steht. Das a-Tag darf nur die Attribute href und title behalten; href muss http(s), mailto oder ein relativer Pfad sein. Damit kann auch eine halluzinierende KI keinen Schaden anrichten, ein eingeschleustes Script-Tag wird vor dem INSERT entfernt.
| Pfad | Inhalt |
|---|---|
| /var/www/mcp/ | Python-MCP-Quellen |
| /var/www/ki.karlkratz.com/src/ | PHP-Codebase |
| /var/www/ki.karlkratz.com/public/index.php | Front-Controller |
| /var/www/_credentials/ki_web/credentials.json | DB-Zugang für PHP-App |
| /usr/local/bin/ki-web | Wrapper, startet den MCP über venv-Python |
Diese Seite fasst zusammen, wie wir auf ki.karlkratz.com MCP-Server in Python bauen. Grundlage sind die Architektur-Prinzipien aus /var/www/code/projektcharakteristika/ (DDD, Hexagonal, SRP, SoC, DRY, SOLID, Clean Code, Max-LoC), übersetzt auf die Eigenheiten des Model-Context-Protocol-stdio-Transports.
Keine ungewollten Schreibvorgänge auf stdout. Der stdio-Transport nutzt stdout exklusiv für JSON-RPC-Frames; jedes print() oder unbuffered Logging zerstört das Protokoll. Konsequenz:
Jedes Tool ist eine Funktion mit dem mcp.tool()-Decorator. Vier Pflichten:
Wie in /var/www/code/projektcharakteristika/architecture_layers.yaml beschrieben, übertragen auf Python:
| Schicht | Inhalt | Darf NICHT enthalten |
|---|---|---|
| domain/ | Dataclasses (frozen, slots), Domain-Errors, Ports als typing.Protocol | HTTP-Calls, DB-Treiber, JSON-Parsing, mcp-SDK-Imports |
| application/ | Use Cases, orchestrieren Ports, kein I/O | httpx, psycopg, Dateipfade hartcodiert |
| infrastructure/ | Adapter: HTTP-Clients, DB-Connections, Filesystem, externe APIs, Config-Loader | fachliche Regeln, Validierungs-Algorithmen |
| presentation/ | server.py, Tool-Funktionen, JSON-Mapper | fachliche Wahrheit, Domain-Regeln |
Abhängigkeiten zeigen nur nach innen, Infrastructure kennt Application, Application kennt Domain. Niemals umgekehrt.
| Datei-Typ | Hartes Limit (LoC) |
|---|---|
| domain (Dataclasses, Errors, Ports) | 80 |
| application (Use Cases) | 120 |
| infrastructure (Adapter) | 200 |
| server.py (Composition + Tools) | 150 |
| Test-Dateien | 300 |
Überschreitung ist Blocker, bevor das Limit angehoben wird, prüfen ob die Datei mehrere Verantwortungen mischt.
Use Cases werfen Domain-Errors. Die Tool-Funktion fängt sie ab und mappt sie auf MCP-Fehlerantworten. Eine generische except Exception ist nur an genau einer Stelle erlaubt: am äußersten Rand. Stack-Traces gehen auf stderr, NICHT in die Tool-Antwort, damit das LLM keine internen Pfade sieht.
Das vom SDK aus den Type-Hints generierte JSON-Schema wird dem LLM gezeigt und definiert, welche Argumente es schicken darf. Konsequenz:
| Pfad | Inhalt |
|---|---|
| server.py | Composition-Root: instanziiert Config, Adapter, Use Cases; registriert Tools |
| domain/ | Dataclasses, Errors, Ports (typing.Protocol) |
| application/ | Use Cases, dünne Orchestrierung |
| infrastructure/ | HTTP-Clients, DB-Adapter, Config-Loader |
| tests/ | pytest mit Fakes |
| pyproject.toml | Metadaten, Versionen via Lockfile fixiert |
Diese Seite zeigt Schritt für Schritt, wie der MCP-Server ki-web entstanden ist: ein stdio-MCP in Python, der die Verwaltung der Seiten auf ki.karlkratz.com an das PHP-Backend unter /api/pages delegiert. Diese Anleitung beschreibt jeden Schritt, sodass vergleichbare Adapter mit überschaubarem Aufwand nachgebaut werden können.
Die hier verwendeten Konventionen sind formal hinterlegt in /mcp-server-erstellen-regeln und maschinenlesbar unter /var/www/code/python-mcp/.
Fünf Tools, alle über stdio erreichbar für Claude Code, qwen-code und Codex:
| Tool | Wirkung |
|---|---|
| list_pages | Suche, Sortierung, Pagination |
| get_page | Eine Seite per Slug |
| create_page | Neue Seite anlegen |
| update_page | Partial-Update, nur geänderte Felder |
| delete_page | Seite per Slug löschen |
Jeder Tool-Aufruf landet als HTTP-Request bei /api/pages; Slug-Regex, Length-Limits und HTML-Sanitization passieren ausschließlich im PHP-Backend. Der Python-Code ist nur ein Adapter, die fachlichen Regeln liegen damit nur einmal vor.
/var/www/mcp/\n pyproject.toml\n requirements.lock\n README.md\n ki_web_mcp/\n __init__.py\n server.py # FastMCP + Tool-Registrierung\n composition.py # Composition-Root\n config.py # Frozen Config + Env-Loader\n schemas.py # Literal-Enums, Annotated-Bounds, TypedDicts\n domain/\n __init__.py\n page.py # Page-Dataclass\n errors.py # BackendError, TransportError\n application/\n __init__.py\n ports.py # PagesPort als typing.Protocol\n use_cases.py # PageUseCases, orchestriert den Port\n infrastructure/\n __init__.py\n pages_client.py # httpx-Adapter, implementiert PagesPort\n page_mapper.py # JSON <-> Page-Mapping\n tests/\n __init__.py\n conftest.py # FakePages-Port + Fixtures\n test_use_cases.py # Use-Case-Unit-Tests\n test_schema.py # tools/list-Drift via Subprocess\n test_e2e.py # Lifecycle gegen Live-BackendEchtes Python-Package, keine sys.path-Hacks. Entry-Point heißt ki-web, der Wrapper unter /usr/local/bin/ki-web ruft ihn unbuffered auf.
[build-system]\nrequires = [\"setuptools>=68\", \"wheel\"]\nbuild-backend = \"setuptools.build_meta\"\n\n[project]\nname = \"ki-web-mcp\"\nversion = \"0.2.0\"\nrequires-python = \">=3.13\"\ndependencies = [\n \"mcp>=1.27,<2\",\n \"httpx>=0.28,<0.29\",\n \"pydantic>=2.13,<3\",\n]\n\n[project.scripts]\nki-web = \"ki_web_mcp.server:main\"\n\n[tool.setuptools.packages.find]\ninclude = [\"ki_web_mcp*\"]Nur Datentypen, keine Imports von HTTP, JSON oder mcp-SDK. So bleibt die Domain testbar und ersetzbar.
from __future__ import annotations\nfrom dataclasses import dataclass\nfrom typing import Optional\n\n@dataclass(frozen=True, slots=True)\nclass Page:\n slug: str\n title: str\n meta_description: str\n content: str\n id: Optional[int] = None\n created_at: Optional[str] = None\n updated_at: Optional[str] = Nonefrom __future__ import annotations\nfrom dataclasses import dataclass\nfrom typing import Any, Optional\n\n@dataclass(slots=True)\nclass BackendError(Exception):\n status: int\n error_code: str\n message: str\n payload: Optional[dict[str, Any]] = None\n\n@dataclass(slots=True)\nclass TransportError(Exception):\n status: int\n detail: strDer Port ist die einzige Schnittstelle, die die Anwendung kennt. Use Cases orchestrieren, keine I/O, kein Mapping.
from __future__ import annotations\nfrom typing import Optional, Protocol\nfrom ki_web_mcp.domain.page import Page\n\nclass PagesPort(Protocol):\n def list(self, search, sort, direction, limit, offset) -> dict: ...\n def get(self, slug: str) -> Page: ...\n def create(self, slug, title, meta_description, content) -> Page: ...\n def update(self, slug, *, title, meta_description, content) -> Page: ...\n def delete(self, slug: str) -> dict: ...\n def ping(self) -> bool: ...\n def close(self) -> None: ...from dataclasses import asdict\nfrom ki_web_mcp.application.ports import PagesPort\nfrom ki_web_mcp.domain.page import Page\n\nclass PageUseCases:\n def __init__(self, pages: PagesPort):\n self._pages = pages\n\n def list_pages(self, *, search, sort, direction, limit, offset):\n r = self._pages.list(search, sort, direction, limit, offset)\n return {\"total\": r[\"total\"], \"items\": r[\"items\"]}\n\n def get_page(self, slug):\n return asdict(self._pages.get(slug))\n\n def create_page(self, slug, title, meta_description, content):\n return asdict(self._pages.create(slug, title, meta_description, content))\n\n def update_page(self, slug, *, title, meta_description, content):\n return asdict(self._pages.update(\n slug, title=title, meta_description=meta_description, content=content))\n\n def delete_page(self, slug):\n return self._pages.delete(slug)Hier passiert die einzige I/O. Der Adapter implementiert den Port, mappt JSON auf Domain-Objekte, kümmert sich um Retries, atexit-Cleanup und Request-Id-Propagation.
from ki_web_mcp.domain.page import Page\n\nclass PageMapper:\n @staticmethod\n def from_api(data: dict) -> Page:\n return Page(\n slug=data[\"slug\"], title=data[\"title\"],\n meta_description=data[\"meta_description\"],\n content=data[\"content\"],\n id=data.get(\"id\"),\n created_at=data.get(\"created_at\"),\n updated_at=data.get(\"updated_at\"),\n )import atexit, uuid, logging\nimport httpx\nfrom ki_web_mcp.domain.errors import BackendError, TransportError\nfrom ki_web_mcp.infrastructure.page_mapper import PageMapper\n\nlog = logging.getLogger(__name__)\n\nclass PagesClient:\n def __init__(self, base_url: str, timeout_seconds: float, retries: int):\n self._client = httpx.Client(\n base_url=base_url,\n timeout=timeout_seconds,\n headers={\"Accept\": \"application/json\"},\n follow_redirects=True,\n transport=httpx.HTTPTransport(retries=retries),\n )\n atexit.register(self._client.close)\n\n def _request(self, method, path, **kw):\n request_id = uuid.uuid4().hex[:12]\n headers = kw.pop(\"headers\", {}) | {\"X-Request-Id\": request_id}\n try:\n r = self._client.request(method, path, headers=headers, **kw)\n except httpx.HTTPError as exc:\n raise TransportError(599, f\"{type(exc).__name__}: {exc}\") from exc\n ct = r.headers.get(\"content-type\", \"\")\n if not ct.startswith(\"application/json\"):\n raise TransportError(r.status_code, f\"non-JSON content_type={ct!r}\")\n payload = r.json()\n if r.status_code >= 400:\n raise BackendError(\n status=r.status_code,\n error_code=str(payload.get(\"error\", \"unknown\")),\n message=str(payload.get(\"message\", \"\")),\n payload=payload,\n )\n return payloadWichtige Disziplin: bei nicht-JSON-Antworten (Reverse-Proxy-HTML-Errors, Caddy 502-Seiten) wird der Body NICHT in die Tool-Antwort gereicht, sonst sieht das LLM Stack-Traces.
Diese Datei ist der Vertrag zwischen Tool und LLM. Das mcp-SDK liest die Type-Hints und erzeugt daraus das JSON-Schema, das die KI vor jedem Aufruf sieht.
from __future__ import annotations\nfrom typing import Annotated, Literal, Optional, TypedDict\nfrom pydantic import Field\n\nSortField = Literal[\"slug\", \"title\", \"meta_description\", \"updated_at\", \"created_at\"]\nSortDirection = Literal[\"asc\", \"desc\"]\nLimit = Annotated[int, Field(ge=1, le=200)]\nOffset = Annotated[int, Field(ge=0)]\n\nclass PageDict(TypedDict, total=False):\n id: Optional[int]\n slug: str\n title: str\n meta_description: str\n content: str\n created_at: Optional[str]\n updated_at: Optional[str]\n\nclass PageListResult(TypedDict):\n total: int\n items: list[PageDict]\n\nclass DeleteResult(TypedDict):\n deleted: strMit dieser Datei kann das LLM bei sort nur noch die fünf erlaubten Werte schicken, und limit bekommt automatisch eine Schranke 1..200.
Composition ist die einzige Stelle, an der konkrete Klassen verdrahtet werden. Tests können sie mit Fake-Ports überschreiben.
from typing import Optional\nfrom ki_web_mcp.application.ports import PagesPort\nfrom ki_web_mcp.application.use_cases import PageUseCases\nfrom ki_web_mcp.config import Config\nfrom ki_web_mcp.infrastructure.pages_client import PagesClient\n\nclass Composition:\n def __init__(self, config: Config, pages: Optional[PagesPort] = None):\n self.config = config\n self._pages = pages or PagesClient(\n base_url=config.api_base,\n timeout_seconds=config.timeout_seconds,\n retries=config.retries,\n )\n self.use_cases = PageUseCases(self._pages)\n\n def close(self):\n self._pages.close()import logging, sys\nfrom typing import Optional\nfrom ki_web_mcp.composition import Composition\nfrom ki_web_mcp.config import Config\nfrom ki_web_mcp.schemas import (\n DeleteResult, Limit, Offset, PageDict, PageListResult,\n SortDirection, SortField,\n)\n\ndef _configure_logging(level: str) -> None:\n logging.basicConfig(stream=sys.stderr,\n level=getattr(logging, level.upper(), logging.WARNING),\n format=\"%(asctime)s %(levelname)s %(name)s %(message)s\")\n\ndef build_server(composition):\n from mcp.server.fastmcp import FastMCP\n mcp = FastMCP(\"ki-web\")\n uc = composition.use_cases\n\n @mcp.tool()\n def list_pages(search: str = \"\",\n sort: SortField = \"updated_at\",\n direction: SortDirection = \"desc\",\n limit: Limit = 50,\n offset: Offset = 0) -> PageListResult:\n '''List pages with optional search, sort and pagination.'''\n return uc.list_pages(search=search or None, sort=sort,\n direction=direction, limit=limit, offset=offset)\n\n @mcp.tool()\n def update_page(slug: str,\n title: Optional[str] = None,\n meta_description: Optional[str] = None,\n content: Optional[str] = None) -> PageDict:\n '''Partial update, provide only the fields you want to change.'''\n return uc.update_page(slug, title=title,\n meta_description=meta_description, content=content)\n\n # ... get_page, create_page, delete_page analog\n return mcp\n\ndef main() -> int:\n if \"--health\" in sys.argv:\n cfg = Config.from_env()\n _configure_logging(cfg.log_level)\n c = Composition(cfg)\n try:\n ok = c.use_cases.ping()\n finally:\n c.close()\n print(\"ok\" if ok else \"fail\", file=sys.stderr)\n return 0 if ok else 1\n cfg = Config.from_env()\n _configure_logging(cfg.log_level)\n c = Composition(cfg)\n try:\n build_server(c).run()\n finally:\n c.close()\n return 0\n\nif __name__ == \"__main__\":\n raise SystemExit(main())Beachte die Goldene stdio-Regel: logging.basicConfig(stream=sys.stderr) muss vor jedem Tool-Aufruf konfiguriert sein, sonst landet ein Library-Log auf stdout und korrumpiert die JSON-RPC-Frames.
#!/bin/sh\nexec env PYTHONUNBUFFERED=1 /opt/venv/main/bin/python -u -m ki_web_mcp.server \"$@\"Beide Schalter zusammen, PYTHONUNBUFFERED=1 und python -u, verhindern, dass Python stdout/stderr puffert.
chmod 0755 /usr/local/bin/ki-web\n/opt/venv/main/bin/pip install -e /var/www/mcp\n/opt/venv/main/bin/pip freeze | sort > /var/www/mcp/requirements.lockimport pytest\nfrom ki_web_mcp.application.ports import PagesPort\nfrom ki_web_mcp.application.use_cases import PageUseCases\nfrom ki_web_mcp.domain.errors import BackendError\nfrom ki_web_mcp.domain.page import Page\n\nclass FakePages(PagesPort):\n def __init__(self):\n self._store: dict[str, Page] = {}\n def create(self, slug, title, meta, content):\n if slug in self._store:\n raise BackendError(409, \"already_exists\", slug)\n p = Page(slug=slug, title=title, meta_description=meta, content=content)\n self._store[slug] = p\n return p\n # list/get/update/delete/ping/close analog\n def close(self): pass\n\n@pytest.fixture\ndef use_cases(): return PageUseCases(FakePages())import pytest\nfrom ki_web_mcp.domain.errors import BackendError\n\ndef test_create_then_get_roundtrip(use_cases):\n use_cases.create_page(\"foo\", \"Foo\", \"Meta\", \"<h1>x</h1>\")\n page = use_cases.get_page(\"foo\")\n assert page[\"slug\"] == \"foo\"\n\ndef test_create_duplicate_raises_already_exists(use_cases):\n use_cases.create_page(\"foo\", \"Foo\", \"Meta\", \"<p>x</p>\")\n with pytest.raises(BackendError) as exc:\n use_cases.create_page(\"foo\", \"Foo\", \"Meta\", \"<p>x</p>\")\n assert exc.value.status == 409Stellt sicher, dass jeder Tool-Name und jedes Schema-Detail (Literal-Enums, Range-Bounds, Optional-Felder bei update_page) erhalten bleibt:
import json, subprocess, sys\n\ndef _send(p, m): p.stdin.write(json.dumps(m) + \"\\n\"); p.stdin.flush()\ndef _rpc(p, m):\n _send(p, m); return json.loads(p.stdout.readline())\n\ndef test_tools_list_matches_contract():\n p = subprocess.Popen(\n [sys.executable, \"-u\", \"-m\", \"ki_web_mcp.server\"],\n stdin=subprocess.PIPE, stdout=subprocess.PIPE,\n stderr=subprocess.PIPE, text=True,\n )\n try:\n _rpc(p, {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\n \"params\":{\"protocolVersion\":\"2025-03-26\",\n \"capabilities\":{},\n \"clientInfo\":{\"name\":\"t\",\"version\":\"0\"}}})\n _send(p, {\"jsonrpc\":\"2.0\",\"method\":\"notifications/initialized\"})\n resp = _rpc(p, {\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\"})\n finally:\n try: p.stdin.close()\n except BrokenPipeError: pass\n try: p.wait(timeout=2)\n except subprocess.TimeoutExpired: p.kill(); p.wait(timeout=2)\n tools = {t[\"name\"]: t for t in resp[\"result\"][\"tools\"]}\n assert set(tools) == {\"list_pages\",\"get_page\",\"create_page\",\n \"update_page\",\"delete_page\"}\n assert \"enum\" in json.dumps(tools[\"list_pages\"][\"inputSchema\"][\"properties\"][\"sort\"])Wichtig: Notifikationen (notifications/initialized) liefern KEINE Antwort, also nicht readline() darauf anwenden, sonst blockt der Test.
Schreibweise je CLI mit den jeweiligen kleinen Unterschieden:
# Claude Code, separator vor dem Command\nclaude mcp add ki-web -- /usr/local/bin/ki-web\n\n# Codex, ebenfalls separator\ncodex mcp add ki-web -- /usr/local/bin/ki-web\n\n# qwen-code, KEIN separator\nqwen mcp add ki-web /usr/local/bin/ki-webVerifizieren mit claude mcp list, codex mcp list bzw. qwen mcp list, der Eintrag sollte überall als connected auftauchen.
Wenn ein Client meldet, der Server bricht ab, fährt ein Hand-Test schneller zur Diagnose als Logs:
printf '%s\\n' \\\n '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"t\",\"version\":\"0\"}}}' \\\n '{\"jsonrpc\":\"2.0\",\"method\":\"notifications/initialized\"}' \\\n '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\"}' \\\n | /usr/local/bin/ki-web | jq ./usr/local/bin/ki-web --health # exit 0/1, Trockenlauf gegen /api/pagesWenn das Backend ein Feld umbenennt, fällt der pytest test_schema sofort um, Pflicht-Bestandteil jedes CI-Laufs.
Wenn die JSON-RPC-Antwort kaputt ankommt, ist meistens ein Library-Log das Problem. Test: vom CLI-Wrapper aus print() oder Log-Output durch dieses Kommando schicken, alles, was nicht mit { beginnt, ist Pollution:
/usr/local/bin/ki-web < /dev/null 2>/dev/null | head -5\n# Erwartet: nichts (Server wartet auf Input). Kommt da Text raus,\n# stammt er aus stdout-Pollution einer Dependency.Diese Seite vergleicht drei Arten, einen Dienst nach außen anzubieten. Sie schließen sich nicht aus, sie sind verschiedene Schnittstellen zur selben Funktion. Die Wahl hängt davon ab, wer durch die Tür kommt: ein KI-Assistent, ein anderer Server oder ein Mensch am Terminal.
| Tür | Kurzdefinition |
|---|---|
| KI-Werkzeug-Steckplatz (MCP, Model Context Protocol) | Ein KI-Assistent (z. B. Claude Code) startet das Programm und kann während des Gesprächs Werkzeuge daraus aufrufen. Das Programm beschreibt sich selbst, der Assistent sieht, was es kann. |
| Web-Schnittstelle (HTTP-API, oft als REST-API gebaut) | Ein dauerhaft laufender Server beantwortet Anfragen über das Web. Jeder, der die Adresse kennt und die Berechtigung hat, kann zugreifen, Browser, Handy-App, ein anderer Server. |
| Kommandozeilen-Tool (CLI, Command-Line Interface) | Ein Programm, das man im Terminal aufruft, Argumente übergibt und dessen Text-Ausgabe liest. Standard-Werkzeug auf Linux- und Mac-Systemen, gut mit anderen kombinierbar. |
Eine Zeile pro Vergleichs-Kriterium, drei Spalten, so steht alles nebeneinander.
| Vergleichs-Kriterium | MCP | HTTP-API | CLI |
|---|---|---|---|
| Wer ruft das auf? (Aufrufer-Typ) | Ein KI-Assistent (LLM-Agent) wie Claude Code, Codex, qwen-code | Browser-Frontend, Handy-App, anderer Server, Skript | Mensch am Terminal, Shell-Skript, CI-Pipeline |
| In welcher Form gehen Daten hin und zurück? (Wire-Format) | Strukturierte Nachrichten über die Standard-Ein-/Ausgabe (JSON-RPC via stdio) oder über Web (HTTP/SSE) | Strukturierte Daten über das Web (JSON über HTTP), oft im REST-Stil | Kommandozeilen-Argumente rein, Text raus, Fehler-Ausgabe und Erfolgs-Signal extra (argv, stdout, stderr, Exit-Code) |
| Wie erfährt der Aufrufer, was es überhaupt gibt? (Discovery) | Selbstauskunft: der Server liefert eine Liste aller Werkzeuge mitsamt Beschreibung und Eingabe-Bauplan (tools/list mit JSON-Schema) | Per externer Dokumentation, in der Regel eine Spec-Datei (OpenAPI / Swagger). Kein Laufzeit-Abfragen. | --help, Handbuch-Seite (manpage), README |
| Gibt es ein Gedächtnis zwischen Aufrufen? (State / Session) | Ja, Werkzeug-Aufrufe sind in ein laufendes Gespräch mit dem KI-Assistenten eingebettet (Session) | Nein, jede Anfrage steht für sich; ein Gedächtnis muss künstlich nachgebaut werden (Stateless + Token / Cookie / Session-Store) | Nein, jeder Aufruf ist ein neuer Vorgang (Stateless); Persistenz nur über Dateien, Umgebungsvariablen, Sperrdateien |
| Wie schnell antwortet es? (Latenz-Profil) | Mittel, der Server muss als Hilfsprogramm gestartet werden (Subprozess), dann sind viele Werkzeug-Aufrufe schnell hintereinander möglich | Niedrig, die Web-Welt ist dafür optimiert (Zwischenspeicherung / Caching, dauerhafte Verbindungen / Keep-Alive, Auslieferungs-Netzwerke / CDN) | Sehr niedrig, direkter Programm-Aufruf, kein Netzwerk dazwischen |
| Wie viele gleichzeitige Nutzer sind möglich? (Durchsatz / Skalierung) | Pro Client ein eigenes Hilfsprogramm (Subprocess); für mehrere Nutzer am besten mit Web-Variante (HTTP/SSE) hinter Last-Verteiler | Beliebig viele dank Last-Verteiler (Load-Balancer) und Skalierung über mehr Server (horizontale Skalierung) | Ein Aufruf nach dem anderen; Parallel-Aufrufe über Hilfen wie xargs -P oder GNU parallel |
| Wem wird vertraut? (Trust-Boundary) | Wer das Programm starten darf, darf alle Werkzeuge nutzen, Trust = Datei-Berechtigung auf demselben Rechner | Trust = gültige Eintritts-Marke (Token) im HTTP-Kopf, optional delegierte Anmeldung (OAuth) oder gegenseitige Zertifikate (mTLS); funktioniert auch über das öffentliche Netz | Trust = wer das Programm aufrufen darf; über System-Rechte (sudo, Linux-capabilities, Zugriffs-Listen / ACL) |
| Wie stabil bleibt die Schnittstelle? (Vertrags-Stabilität) | Dynamisch, die Werkzeug-Liste kann sich pro Sitzung ändern, der KI-Assistent fragt zur Laufzeit ab | Stabil und versioniert (z. B. /v1/, /v2/); abwärts-inkompatible Änderungen (Breaking Changes) bekommen einen Übergangs-Pfad | Versioniert über die Programm-Version; veraltete Flags werden in einem Übergangs-Zeitraum (Deprecation) markiert |
| Lässt sich mit anderen Tools verketten? (Kompositionsfähigkeit) | Niedrig, kein Daten-Weiterleitungs-Modell (Pipe), jeder Aufruf ist eine eigene Nachricht (JSON-RPC-Call) | Mittel, mit Helfern wie curl + jq machbar, aber nicht das natürliche Modell | Hoch, die Unix-Philosophie ist genau dafür gemacht: Daten-Weiterleitung (Pipe), Verkettung (&&, ;), Build-Werkzeuge (make), Zeitsteuerung (cron) |
| Wie wird vor Missbrauch geschützt? (Sicherheit / Sandbox) | Tool-Eingaben werden im Server gegen eine Positiv-Liste (Whitelist) geprüft; Werte sind im Bauplan auf Bereiche oder feste Auswahl gebunden (Literal, Range-Bounds) | Anmeldung im HTTP-Kopf (Header-Auth), Anfrage-Begrenzung (Rate-Limit), Web-Schutz-Firewall (WAF), Schutz vor Querverweis-Angriffen (CORS, CSRF) | Datei-System-Berechtigungen, sudo-Regeln, Sicherheits-Profile (AppArmor), Linux-Capabilities |
| Was kann man im Nachhinein sehen? (Observability / Logs) | Aufzeichnung der JSON-RPC-Nachrichten, MCP-Inspector, Fehler-Ausgabe (stderr) des Hilfsprogramms | Zugriffs-Logs des Web-Servers, OpenTelemetry-Spuren, Header-basiertes Tracing | Fehler-Ausgabe (stderr), Erfolgs-Signal (Exit-Code), System-Logs (journal / syslog), Audit-Log |
| Wie wird es installiert und betrieben? (Deployment) | Ein Wrapper-Programm auf dem Suchpfad ($PATH) + ein Eintrag in der Config des KI-Assistenten | Dauerhaft laufender Dienst (Long-running Service) hinter einem vorgelagerten Proxy (Reverse-Proxy) | Programm-Datei auf dem Suchpfad ($PATH); pro Rechner installiert |
| Was passiert, wenn ich dasselbe zweimal aufrufe? (Idempotenz) | Im Werkzeug-Docstring beschrieben; die KI sollte sich daran halten, keine harte Garantie | Durch die HTTP-Methode definiert: GET, PUT, DELETE sind wiederholbar ohne Nebeneffekte; POST nicht | Konvention pro Werkzeug; oft als Flag (--idempotent, --retry) |
| Häufiger Denkfehler (Anti-Pattern) | Aus jeder vorhandenen Web-API automatisch einen MCP machen, die Werkzeug-Liste wird unüberschaubar | Ein lokales CLI-Programm in einen Web-Server umhüllen, viel Aufwand, wenig Nutzen | Aus dem CLI heraus selbst Server starten, um parallel zu skalieren, gehört dann in eine API |
Lesehilfe: (+) erste Wahl, (o) möglich, (-) ungeeignet.
| Situation | MCP | HTTP-API | CLI |
|---|---|---|---|
| Hauptnutzer ist ein KI-Assistent (LLM-Agent) | (+) | (o) als Backend dahinter | (o) wenn der Assistent Shell-Tools nutzen darf |
| Mehrere Konsumenten teilen sich dieselbe Logik | (o) als Hülle | (+) | (-) nur lokal |
| Mensch am Terminal, ad-hoc | (-) | (o) via curl | (+) |
| Build- oder CI-Pipeline | (-) klobig | (+) | (+) |
| Browser-Frontend | (-) | (+) | (-) |
| Werkzeug-Liste situativ / kontextspezifisch | (+) | (-) starr | (-) starr |
| Compliance verlangt formales Schnittstellen-Verzeichnis (OpenAPI) | (o) JSON-RPC-Schema | (+) | (-) |
| Auf demselben Rechner, Trust = Datei-Berechtigungen | (+) | (o) Overhead | (+) |
| Aufrufer kommt über das öffentliche Netz | (-) außer HTTP-Transport | (+) | (-) |
| Hohe Anfrage-Frequenz, niedrige Antwort-Zeit | (o) | (+) | (+) |
| Lange Gesprächs-Sitzungen mit Gedächtnis | (+) | (o) mit Session-Store | (-) |
| Verkettung mit jq / grep / xargs / make | (-) | (o) via curl | (+) |
Wenn die Tabellen schon helfen, kann diese Liste übersprungen werden. Falls nicht, fünf Fragen, in dieser Reihenfolge beantwortet:
| Schicht | Verantwortung | In diesem Projekt |
|---|---|---|
| Geschäftslogik (Kern, Use Cases) | Eingaben-Prüfung (Validierung), HTML-Bereinigung (Sanitization), Datenspeicherung (Persistence) | PHP-Code in /var/www/ki.karlkratz.com/src/ |
| Web-Schnittstelle (HTTP-API) | Stabile, versionierbare Außenseite | /api/pages, Anlegen / Lesen / Ändern / Löschen (POST / GET / PATCH / DELETE) |
| KI-Werkzeug-Steckplatz (MCP-Adapter) | Werkzeug-Schemata bereitstellen, Selbstbeschreibung, Kommunikation per stdio | /var/www/mcp/, startbar via /usr/local/bin/ki-web |
| Kommandozeilen-Tool (CLI, optional) | Skript-, Cron- oder Pipe-Zugriff | Nicht implementiert; würde denselben HTTP-Aufruf gegen /api/pages machen |
Drei Schnittstellen über einer gemeinsamen Geschäftslogik. Mehr zur Architektur unter /mcp-ki-web, die Regeln, an denen wir messen, in /mcp-server-erstellen-regeln.
Keine dieser Schnittstellen ersetzt das Nachdenken darüber, welche Operation überhaupt erlaubt sein soll. Die Prüf- und Positiv-Listen-Logik (Validierung und Whitelist) gehört unabhängig von der Hülle an genau eine Stelle, sonst entsteht das klassische Problem, dass das CLI strenger prüfen als die API, oder dass der MCP einen Pfad freigibt, den der Browser nicht aufrufen darf. Wer alle drei Hüllen baut, baut sie um einen einzigen, sauber abgegrenzten Kern.
","created_at":"2026-05-21T03:09:01+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":10,"konversionen":22},{"id":32,"slug":"web-scraping","title":"Web-Scraping im Karl-Kratz-System","meta_description":"Wie ki-web und kw-scrape zusammenspielen, welche Schnittstellen sie anbieten und welches Architekturmuster dahinter steht.","content":"Diese Seite beschreibt, wie Web-Scraping unter ki.karlkratz.com eingebettet ist: die beiden fachlichen Bausteine ki-web und kw-scrape, ihre Schnittstellen und das gemeinsame Architekturmuster dahinter.
Verwaltet die Seiten dieser Domain (Slug, Titel, Meta-Description, HTML-Content). Die Geschäftslogik (Slug-Regex, HTML-Sanitization, Längen-Limits) liegt einmalig in der PHP-Schicht unter /api/pages und schreibt nach Postgres. Alle weiteren Zugriffsformen sind dünne Adapter über diese eine API.
Eine eigenständige Python-Engine. Sie holt externe URLs mit httpx ab, extrahiert mit trafilatura den Hauptinhalt plus Metadaten (Titel, Autor, Datum, Sprache, Sitename) und gibt eine ScrapeResult-Datenstruktur zurück. JavaScript-gerenderte Seiten werden in dieser Ausbaustufe bewusst nicht unterstützt, weil dafür Playwright nötig wäre und der zusätzliche Aufwand sich für die aktuellen Anwendungsfälle nicht rechnet.
Jeder Baustein wird über dieselbe Logik aus mehreren Richtungen bedient. Die Klassen sind komplementär und adressieren unterschiedliche Aufrufer.
| Klasse | Wer ruft auf | ki-web | kw-scrape |
|---|---|---|---|
| HTTP-API | Browser, andere Server | /api/pages (PHP) | noch nicht exponiert |
| CLI | Mensch am Terminal, Skripte, CI | ki-web-cli | scrape-cli |
| MCP-Server | Claude Code, Codex, qwen-code | ki-web | in Planung |
Beide Codebasen folgen dem gleichen DDD-Hexagonal-Schnitt mit drei Schichten.
Die Application-Schicht spricht ausschließlich mit Ports. Konkrete Adapter werden in einem Composition-Root injiziert, sodass Tests den Fetcher gegen einen FakeFetcher tauschen können, ohne das Netzwerk zu berühren. Die gleiche Technik erlaubt, später eine PlaywrightFetcher-Implementierung der FetcherPort hinterzulegen, ohne die Use Cases zu ändern.
Geschäftsregeln existieren genau einmal. Für ki-web liegen sie in der PHP-API. Für kw-scrape im Python-Paket unter /var/www/scrape/. CLI und MCP sind Adapter über diese Engines. Wenn eine Validierung ergänzt werden muss, geschieht das an einer Stelle, nicht parallel in mehreren Clients.
Sowohl ki-web-cli als auch scrape-cli kennen drei Output-Formate, gesteuert über --format.
Über --columns slug,title,updated_at lassen sich in table und plain einzelne Felder herausziehen. In json hat das Flag keine Wirkung, weil dort die volle Struktur ohnehin verfügbar ist.
ki-web-cli list --search mcp --limit 5\nki-web-cli get hallo-welt\nki-web-cli --format plain --columns slug list\necho '<h1>Demo</h1>' | ki-web-cli create --slug demo \\\n --title \"Demo\" --meta-description \"Test\" --content-file -scrape-cli fetch https://ki.karlkratz.com/mcp-vs-api-vs-cli\nscrape-cli fetch URL | jq -r '.markdown'\nscrape-cli --format table --columns title,sitename,status fetch URL\nscrape-cli batch --file urls.txt -c 20| Pfad | Inhalt |
|---|---|
| /var/www/ki.karlkratz.com/src/ | PHP-Backend mit /api/pages |
| /var/www/mcp/ | MCP-Server ki-web (Python, stdio) |
| /var/www/cli/shared/ | Wiederverwendbare CLI-Infrastruktur (PresenterFactory, Streams, Exit-Codes, Help-Aliasse) |
| /var/www/cli/ki-web/ | CLI ki-web-cli |
| /var/www/scrape/ | Engine kw-scrape |
| /var/www/cli/scrape/ | CLI scrape-cli |
| /var/www/mcp.scrape/ | geplanter MCP-Server für kw-scrape |
Diese Seite beschreibt die kw-scrape-Komponente im Detail. Die Einbettung ins Gesamtsystem (Beziehung zu ki-web, gemeinsames Architekturmuster, Schreib- und DRY-Regeln) steht auf der Seite /web-scraping.
kw-scrape holt eine oder viele externe URLs, extrahiert den Hauptinhalt als Markdown plus strukturierte Metadaten und gibt das Ergebnis als JSON-serialisierbare Datenstruktur zurück. Das Paket ist in drei Schichten aufgeteilt: eine Engine-Library, ein klassisches CLI und ein MCP-Server für AI-Tools.
Bewusst nicht enthalten: JavaScript-Rendering. Dynamisch nachgeladener Inhalt wird in dieser Ausbaustufe nicht gesehen.
| Schicht | Pfad | Zugriff |
|---|---|---|
| Engine (Library) | /var/www/scrape/ | direkter Python-Import: from kw_scrape.composition import Composition |
| CLI (scrape-cli) | /var/www/cli/scrape/ | Wrapper /usr/local/bin/scrape-cli |
| MCP-Server | /var/www/mcp/scrape/ | Wrapper /usr/local/bin/scrape (stdio JSON-RPC) |
Die CLI- und MCP-Schichten sind dünne Adapter um dieselbe Engine. Geschäftslogik liegt einmalig in der Engine.
Die drei Tools sind in CLI und MCP semantisch identisch, nur die Aufrufform unterscheidet sich.
| Tool | Zweck | Hauptargumente |
|---|---|---|
fetch_url (CLI: fetch) | Eine URL holen, Hauptinhalt plus Metadaten | url, want_markdown, want_text, include_raw_html |
extract_html (CLI: extract) | Markdown aus rohem HTML, ohne Netzwerk-Aufruf | html, base_url, want_markdown, want_text |
scrape_urls (CLI: batch) | Viele URLs parallel, getrennte Erfolg- und Fehlerlisten | urls, concurrency (1 bis 50), want_markdown, want_text |
Bei fetch_url und jedem Eintrag in scrape_urls.items:
scrape-cli fetch https://lisa-sundermeyer.de\nscrape-cli --format table --columns title,sitename,date,language fetch https://lisa-sundermeyer.de\nscrape-cli fetch https://lisa-sundermeyer.de | jq -r '.markdown'cat seite.html | scrape-cli extract --base-url https://example.com/\nscrape-cli extract --file seite.html --base-url https://example.com/printf '%s\\n' \\\n https://ki.karlkratz.com/hallo-welt \\\n https://ki.karlkratz.com/mcp-demo \\\n https://ki.karlkratz.com/missing \\\n | scrape-cli batch -c 3 \\\n | jq '{total, ok: (.items | length), fail: (.errors | length)}'scrape-cli fetch https://lisa-sundermeyer.de \\\n | jq -r '.markdown' \\\n | grep -oE '\\(https://lisa-sundermeyer\\.de/[^)#]+\\)' \\\n | tr -d '()' \\\n | sort -u | head -5 \\\n | scrape-cli --format plain --columns url,title batch -c 5Der MCP-Server ist als kw-scrape in allen drei lokalen AI-CLIs registriert: Claude Code, Codex und qwen-code. Tool-Aufrufe laufen über stdio JSON-RPC durch /usr/local/bin/scrape.
// ~/.claude.json, je Projekt unter mcpServers\n\"kw-scrape\": {\n \"type\": \"stdio\",\n \"command\": \"/usr/local/bin/scrape\",\n \"args\": [],\n \"env\": {}\n}# ~/.codex/config.toml\n[mcp_servers.kw-scrape]\ncommand = \"/usr/local/bin/scrape\"// ~/.qwen/settings.json, top-level mcpServers\n\"kw-scrape\": {\n \"command\": \"/usr/local/bin/scrape\",\n \"args\": []\n}Eine Seite kostet ungefähr 200 ms Fetch und 30 bis 50 ms Extraktion. Mit Concurrency 10 erreicht das CLI 30 bis 50 Seiten pro Sekunde, bis die Höflichkeit gegen den Zielserver greift. Die typische Decke ist nicht das Tool, sondern die Rate-Limits der Gegenseite.
| Variable | Default | Wirkung |
|---|---|---|
| KW_SCRAPE_TIMEOUT | 15.0 | HTTP-Timeout in Sekunden |
| KW_SCRAPE_RETRIES | 1 | Transport-Retries bei netzseitigen Fehlern |
| KW_SCRAPE_USER_AGENT | kw-scrape/0.1 (+https://ki.karlkratz.com) | User-Agent-Header |
| KW_SCRAPE_MAX_BYTES | 5000000 | Hartes Limit pro Response (5 MB) |
| KW_SCRAPE_CONCURRENCY | 10 | Default-Parallelität für Batch |
| Code | Bedeutung |
|---|---|
| 0 | OK |
| 1 | Generischer Fehler |
| 2 | Usage-Fehler (argparse) |
| 3 | HTTP 404 |
| 4 | Validierung oder Extract-Fehler |
| 5 | Backend 5xx |
| 6 | Transport-Fehler (DNS, Timeout, non-JSON) |
/api/scrape-Endpoint folgt erst, wenn ein nicht-Python-Konsument hinzukommt.Die FetcherPort-Schnittstelle ist genau eine Methode: fetch(url) plus fetch_many(urls, concurrency). Eine zukünftige Playwright-Implementierung lässt sich an dieser Stelle einhängen, ohne UseCases oder die anderen Adapter zu ändern. Der Composition-Root entscheidet, welcher Fetcher genutzt wird.
| Pfad | Inhalt |
|---|---|
| /var/www/scrape/ | Engine kw-scrape, Library |
| /var/www/cli/scrape/ | CLI scrape-cli |
| /var/www/mcp/scrape/ | MCP-Server kw-scrape |
| /usr/local/bin/scrape-cli | CLI-Wrapper |
| /usr/local/bin/scrape | MCP-Wrapper (stdio) |
| /etc/bash_completion.d/scrape-cli | Bash-Completion für das CLI |
Die JSON-API von ki.karlkratz.com verwaltet die Seiten, die unter / sowie unter den jeweiligen Slug-URLs ausgeliefert werden. Diese Seite beschreibt jeden Endpoint, das Eingabe-Schema, mögliche Antworten und die Validierungsregeln, die serverseitig durchgesetzt werden.
| Aspekt | Wert |
|---|---|
| Basis-URL | https://ki.karlkratz.com/api/pages |
| Format Anfrage | application/json, UTF-8 |
| Format Antwort | application/json; charset=utf-8 |
| Authentifizierung | keine (Demo-System, durch Hetzner-Firewall öffentlich für 0.0.0.0/0 auf Port 443 erreichbar) |
| Versionierung | keine; das Schema steht im PHP-Quelltext unter /var/www/ki.karlkratz.com/src/ |
Erlaubte HTML-Tags im Feld content | h1, h2, h3, p, ol, ul, li, a (mit href und title), strong, table, thead, tbody, tr, th, td, pre, code |
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /api/pages | Liste mit Suche, Sortierung, Pagination |
| POST | /api/pages | Neue Seite anlegen, alle Felder erforderlich |
| GET | /api/pages/<slug> | Eine Seite lesen |
| PATCH | /api/pages/<slug> | Felder einzeln aktualisieren |
| PUT | /api/pages/<slug> | Alias auf PATCH, identische Semantik |
| DELETE | /api/pages/<slug> | Seite löschen |
Jede Seite hat folgende Felder. Pflicht beim Anlegen sind slug, title, meta_description und content.
| Feld | Typ | Pflicht beim Anlegen | Regeln |
|---|---|---|---|
| id | Integer | nein | wird serverseitig vergeben (BIGSERIAL) |
| slug | String | ja | Regex ^[a-z0-9][a-z0-9-]{0,63}$, eindeutig |
| title | String | ja | 1 bis 200 Zeichen |
| meta_description | String | ja | 1 bis 200 Zeichen, SEO-Empfehlung 50 bis 160 |
| content | String (HTML) | ja | wird per DOMDocument auf die Tag-Whitelist gefiltert |
| created_at | ISO-8601-Timestamp | nein | serverseitig gesetzt |
| updated_at | ISO-8601-Timestamp | nein | Trigger aktualisiert bei jedem Schreibvorgang |
| Parameter | Default | Erlaubt |
|---|---|---|
| q | leer | Volltext über slug, title, meta_description (case-insensitive Substring) |
| sort | updated_at | slug, title, meta_description, updated_at, created_at |
| dir | desc | asc, desc |
| limit | 50 | 1 bis 200 |
| offset | 0 | 0 oder positiv |
curl -sS 'https://ki.karlkratz.com/api/pages?q=mcp&sort=updated_at&dir=desc&limit=10'{\n \"total\": 7,\n \"items\": [\n {\n \"id\": 16,\n \"slug\": \"mcp-anleitung\",\n \"title\": \"MCP-Server bauen, die ki-web-Anleitung\",\n \"meta_description\": \"...\",\n \"content\": \"<h1>...</h1>...\",\n \"created_at\": \"2026-05-21T03:33:52+02:00\",\n \"updated_at\": \"2026-05-21T11:42:18+02:00\"\n }\n ]\n}curl -sS https://ki.karlkratz.com/api/pages/mcp-anleitung | jq .Antwort: identische Struktur wie ein einzelnes Item aus dem Listen-Endpoint. Status 200 oder 404, wenn der Slug nicht existiert.
{\n \"slug\": \"neue-seite\",\n \"title\": \"Neue Seite\",\n \"meta_description\": \"Kurze Beschreibung der Seite, 50 bis 160 Zeichen.\",\n \"content\": \"<h1>Überschrift</h1><p>Inhalt mit <strong>Hervorhebung</strong>.</p>\"\n}201 Created mit dem angelegten Datensatz inklusive id, created_at, updated_at409 Conflict wenn der Slug bereits vergeben ist422 Unprocessable Entity bei Validierungsfehlern (zum Beispiel Slug-Regex verletzt, Titel zu kurz)curl -sS -X POST https://ki.karlkratz.com/api/pages \\\n -H 'Content-Type: application/json' \\\n -d '{\"slug\":\"hallo\",\"title\":\"Hallo\",\"meta_description\":\"Eine Begruessung.\",\"content\":\"<h1>Hallo</h1>\"}'Der Request-Body enthält nur die Felder, die geändert werden sollen. Nicht gelieferte Felder bleiben unverändert. PUT verhält sich identisch.
curl -sS -X PATCH https://ki.karlkratz.com/api/pages/hallo \\\n -H 'Content-Type: application/json' \\\n -d '{\"title\":\"Hallo Welt\"}'Antworten: 200 mit aktualisiertem Datensatz, 404 wenn der Slug nicht existiert, 422 bei Validierungsfehlern.
curl -sS -X DELETE https://ki.karlkratz.com/api/pages/halloAntwort:
{\"deleted\": \"hallo\"}Status 200 bei Erfolg, 404 wenn der Slug nicht existiert.
Fehlerantworten haben einheitliche Struktur:
{\n \"error\": \"validation\",\n \"message\": \"Title length must be 1..200, got 0\"\n}| error | Status | Bedeutung |
|---|---|---|
| not_found | 404 | Slug existiert nicht, oder Pfad ist unbekannt |
| already_exists | 409 | POST mit bereits vergebenem Slug |
| validation | 422 | Eingabe verletzt eine Regel (Slug-Regex, Längen, Content-Sanitization) |
| method_not_allowed | 405 | HTTP-Methode ist auf diesem Pfad nicht unterstützt |
| internal | 500 | interner Fehler, Details stehen im Server-Log /var/log/frankenphp/access.log |
Beim Schreiben (POST und PATCH) wird das Feld content per DOMDocument geparst und alle Tags ausserhalb der Whitelist werden entfernt. Das a-Tag akzeptiert nur die Attribute href und title; href muss ein gültiges Schema sein: http, https, mailto oder ein relativer Pfad beginnend mit / oder #. Andere Werte wie javascript: werden ohne Warnung entfernt.
Code-Beispiele innerhalb von pre oder code müssen vom Aufrufer mit HTML-Entities geliefert werden (< für <, > für >), damit der Sanitizer sie nicht als Markup missversteht.
Jede Aenderung an einer bestehenden Zeile in pages archiviert die alte Version datenbankseitig vor dem Schreiben. Das passiert ueber einen PostgreSQL-Trigger pages_archive_trigger und ist fuer die Anwendung unsichtbar. DELETE folgt derselben Logik: die Zeile verschwindet aus pages, bleibt in pages_history erhalten und kann ueber den Restore-Endpoint zurueckgeholt werden. Es gibt keinen Weg, eine Aenderung oder Loeschung am Trigger vorbei zu fahren.
| Spalte | Typ | Bedeutung |
|---|---|---|
| history_id | Integer | Primaerschluessel der History-Tabelle |
| page_id | Integer | id der urspruenglichen Zeile in pages |
| slug, title, meta_description, content | wie pages | Snapshot des Zustands VOR der Mutation |
| created_at, updated_at | ISO-8601 | kopiert aus dem urspruenglichen Datensatz |
| archived_at | ISO-8601 | Zeitpunkt der Archivierung, also der Mutation auf pages |
| archive_op | update oder delete | ausloesendes Ereignis |
| archive_actor | String | wer hat geschrieben; bei API-Aufrufen php-api |
| request_id | String | 16-stellige Hex-ID pro PHP-Request, identisch zum HTTP-Header X-Request-Id |
Liefert alle History-Eintraege fuer den angegebenen Slug, sortiert nach archived_at absteigend. Optionale Query-Parameter limit (1 bis 200, Default 50) und offset (ab 0, Default 0).
curl -sS https://ki.karlkratz.com/api/pages/<slug>/history | jq{\n \"slug\": \"<slug>\",\n \"total\": 3,\n \"items\": [\n {\n \"history_id\": 7,\n \"page_id\": 42,\n \"slug\": \"<slug>\",\n \"title\": \"alter Titel\",\n \"meta_description\": \"alte Beschreibung\",\n \"content\": \"<p>alter Inhalt</p>\",\n \"created_at\": \"2026-05-21T10:00:00+02:00\",\n \"updated_at\": \"2026-05-21T10:05:12+02:00\",\n \"archived_at\": \"2026-05-21T10:07:33+02:00\",\n \"archive_op\": \"update\",\n \"archive_actor\": \"php-api\",\n \"request_id\": \"367c5efc0d1c\"\n }\n ]\n}Stellt einen Slug aus der History wieder her. Ohne Body wird der zuletzt archivierte Snapshot dieses Slugs verwendet. Mit {\"history_id\": N} wird genau dieser Eintrag wiederhergestellt; gehoert er zu einem anderen Slug, antwortet der Server mit 404.
Wenn der Slug aktuell noch in pages existiert, wird die heutige Zeile vor der Wiederherstellung archiviert (UPDATE-Pfad). Wenn der Slug geloescht ist, geht der Restore als INSERT durch und erzeugt keinen zusaetzlichen History-Eintrag.
# Restore des juengsten Snapshots\ncurl -sS -X POST https://ki.karlkratz.com/api/pages/<slug>/restore \\\n -H 'Content-Type: application/json' -d '{}'\n\n# Restore eines bestimmten Snapshots\ncurl -sS -X POST https://ki.karlkratz.com/api/pages/<slug>/restore \\\n -H 'Content-Type: application/json' -d '{\"history_id\": 7}'Antwort: 200 mit dem wiederhergestellten Datensatz; 404 wenn keine History fuer diesen Slug existiert oder die angegebene history_id nicht zu dem Slug gehoert.
Die API bietet keinen Hard-Delete an. Wer einen Slug endgueltig entfernen will, muss zusaetzlich DELETE FROM pages_history WHERE slug = ... direkt auf der Datenbank ausfuehren. Das ist bewusst so getrennt, damit kein API-Aufruf versehentlich Daten unwiederbringlich loescht.
Content-Type: application/jsonDiese Seite dokumentiert das Postgres-Werkzeug auf diesem Server. Das System folgt KISS und YAGNI: ein Cluster, ein Admin-Konto, eine Engine, je ein dünner Adapter als CLI und MCP. Backups und Multi-Cluster-Unterstützung sind bewusst weggelassen.
kw-db ist eine Python-Library um den lokalen Postgres-Cluster (17.10). Sie kann Datenbanken auflisten, Tabellen introspizieren, Lese-Queries ausführen, Schreib-Operationen mit Schutz, sowie DDL und destruktive Operationen unter einem Admin-Gate. Eine kleine Migrations-Funktion ist enthalten (nur up, keine downs).
| Schicht | Pfad | Zugriff |
|---|---|---|
| Engine (Library) | /var/www/db/ | from kw_db.composition import Composition |
| CLI (db-cli) | /var/www/cli/db/ | Wrapper /usr/local/bin/db-cli |
| MCP-Server | /var/www/mcp/db/ | Wrapper /usr/local/bin/db (stdio JSON-RPC) |
Es gibt einen dedizierten Postgres-Rollen-Account kw_admin mit den Flags LOGIN, CREATEDB und CREATEROLE. Keine Superuser-Rechte: das Tool darf Datenbanken und Rollen anlegen und ändern, aber nicht beispielsweise pg_hba.conf umschreiben.
Credentials liegen ausschließlich unter /var/www/_credentials/kw_admin/credentials.json mit Modus 0640 und Gruppe www-data. Das ist die einzige Stelle, an der das Passwort steht. Es wird nicht in Repos, Env-Variablen oder anderen Dateien dupliziert.
Drei Schranken greifen ineinander:
KW_DB_ADMIN=1 gesetzt ist. Default ist 0.ki_web ist hartcodiert geschützt. Schreibzugriffe und DDL werden mit einer eigenen Fehlerklasse abgelehnt, weil diese DB ihre Validierung über die PHP-API erhält. Lesen ist erlaubt.Audit-Log: jedes erfolgreiche write- oder DDL-Statement landet als JSON-Zeile in /var/log/kw_db/audit.log. Felder: Zeitstempel, Operation, Datenbank, Erfolg, Detail (z. B. rows=2), erste 1000 Zeichen des SQL. Reads werden nicht geloggt.
| Subcommand | Klasse | Bedingung |
|---|---|---|
list-databases | read | - |
list-tables [-d db] [-s schema] | read | - |
describe TABLE [-d db] [-s schema] | read | - |
query --sql ... oder stdin | nur read | refused bei DML/DDL |
execute --sql ... --yes | write | --yes; ki_web ist geschützt |
admin --sql ... --yes | ddl / destructive | --yes + KW_DB_ADMIN=1 |
migrate status bzw. migrate up | migration | nur up wendet an |
ping | read | - |
| Tool | Bedingung |
|---|---|
list_databases, list_tables, describe_table | jederzeit |
query(sql, database?) | nur read |
execute_sql(sql, database?) | nur DML; ki_web geschützt |
execute_admin_sql(sql, database?) | DDL / destructive; nur mit KW_DB_ADMIN=1 |
migrate_status, migrate_up | up wendet pending Migrations an |
Der MCP-Server ist als kw-db in Claude Code, Codex und qwen-code registriert. Tool-Aufrufe laufen via stdio JSON-RPC durch /usr/local/bin/db.
Sowohl db-cli als auch scrape-cli und ki-web-cli kennen vier Formate, gesteuert über --format: json (Default, für jq-Pipes), table (interaktive Shell), plain (eine Zeile je Record, Tab-separiert, für xargs und cut), csv (neu, mit Header-Zeile, CSV-Escaping nach stdlib). Mit --columns slug,title,updated_at lassen sich in table, plain und csv einzelne Felder herausziehen.
Migration-Files leben unter /var/www/db/migrations/ und heißen NNNN_beschreibung.sql. Eine Buchhaltungstabelle kw_db_migrations(name PRIMARY KEY, applied_at) in der Default-DB (postgres) hält fest, welche Files schon angewendet wurden. migrate up wendet alles in Datei-Reihenfolge an, was noch nicht in der Tabelle steht. Jede Anwendung läuft in einer impliziten Transaktion.
Es gibt bewusst keine down-Migrations und kein Versions-Skipping. Wer eine Migration zurückfahren will, schreibt eine neue Migration, die das Gegenteil tut.
db-cli ping\ndb-cli list-databases\ndb-cli --format csv --columns name,owner,size_bytes list-databases\ndb-cli list-tables -d ki_web\ndb-cli --format table --columns name,data_type,is_nullable describe pages -d ki_webdb-cli --format json query --sql \"SELECT count(*) AS n FROM pages\" -d ki_web\ndb-cli execute -d kw_demo --yes --sql \"INSERT INTO t (name) VALUES ('hi')\"KW_DB_ADMIN=1 db-cli admin --yes --sql \"CREATE TABLE t (id serial primary key, name text)\" -d kw_demo\nKW_DB_ADMIN=1 db-cli admin --yes --sql \"DROP TABLE t\" -d kw_demodb-cli migrate status\ndb-cli migrate upGleicher DDD-Hexagonal-Schnitt wie ki-web und kw-scrape:
DatabaseInfo, TableInfo, ColumnInfo, RowSet, MigrationRecord, Fehlerklassen, der SQL-Klassifizierer.SqlExecutorPort, IntrospectorPort, MigrationRunnerPort, AuditLogPort), Use Cases (DbUseCases) mit den drei Guards.Psycopg3Executor (psycopg 3.3, short-lived Connections, autocommit aus, commit nach jedem write), PgIntrospector (Queries gegen pg_catalog), MigrationRunner (nur up), FileAuditLog (append-only JSONL).| Variable | Default | Wirkung |
|---|---|---|
| KW_DB_ADMIN | 0 | Auf 1 setzen, um DDL und destruktive Statements zu erlauben |
| KW_DB_AUDIT_LOG | /var/log/kw_db/audit.log | Pfad zur Audit-Log-Datei |
| KW_DB_MIGRATIONS_DIR | /var/www/db/migrations | Verzeichnis mit Migrations-Files |
| Code | Bedeutung |
|---|---|
| 0 | OK |
| 2 | Usage-Fehler (z. B. fehlendes --yes) |
| 4 | Validierung oder Guard-Verletzung (ki_web protected, Admin-Gate) |
| 5 | Backend-Fehler (psycopg-Exception, fehlgeschlagene Migration) |
pg_dump und pg_restore stehen als Shell-Tools weiter zur Verfügung.| Pfad | Inhalt |
|---|---|
| /var/www/db/ | Engine kw-db |
| /var/www/db/migrations/ | Versionierte SQL-Migrationen |
| /var/www/cli/db/ | CLI db-cli |
| /var/www/mcp/db/ | MCP-Server kw-db |
| /var/www/_credentials/kw_admin/credentials.json | Login für kw_admin |
| /var/log/kw_db/audit.log | Audit-Log für writes, DDL und Migrationen |
| /usr/local/bin/db-cli | CLI-Wrapper |
| /usr/local/bin/db | MCP-Wrapper (stdio) |
Test mit strong und Link.
","created_at":"2026-05-21T02:35:09+02:00","updated_at":"2026-05-21T17:39:08+02:00","ranking_position":42,"konversionen":88}]}