Licentia

Licentia ist eine tschechische Web- und Desktop-Anwendung für die Arbeit mit dem Katalog der SPDX License List 3.28.0. Sie hilft, Lizenzen schnell zu finden, ihre Metadaten zu vergleichen und sich über Pflichten zu orientieren, ohne Hunderte von Texten manuell durchgehen zu müssen.

Der Leitfaden ist eine orientierende Entscheidungshilfe, keine Rechtsberatung.

Was die Anwendung kann

• Offline-Katalog von 727 Lizenzen und 84 Lizenzausnahmen;

• Volltextsuche nach Name, SPDX-ID und vollständigem Wortlaut;

• Filtern nach Datensatztyp, Aktualität, OSI/FSF-Metadaten und Lizenzprofil;

• detaillierte Anzeige des kanonischen Texts und der Pflichten;

• Vergleich von Lizenzen und Speichern von Einträgen im persönlichen Arbeitsbereich;

• sechsstufiger Leitfaden zur Auswahl der üblichen Lizenzrichtung;

• öffentliche REST-API /v1;

• Streamable-HTTP-MCP-Endpoint /mcp;

• Validierung von SPDX-Ausdrücken, orientierende Kompatibilitätsprüfung und Analyse von SPDX/CycloneDX-SBOM;

• Web-, Tauri-Desktop- und Shared-Apache/PHP-Variante.

Related MCP server: mcp-dependency-version

Anwendungsbeispiele

Lizenzkatalog

Leitfaden zur Lizenzauswahl

Suche im Katalog

Entwicklung der Web-Anwendung

Erforderliches Node.js: >=22.13.0.

npm install
npm run dev

Produktions-Build:

npm run build

Prüfung von Stil und statischen Regeln:

npm run lint

Desktop: Linux, Windows und macOS

Die Desktop-Version verwendet Tauri 2 und einen eigenständigen statischen Vite-Build mit denselben React-Komponenten und einer lokalen Kopie aller Daten.

npm run dev:desktop
npm run tauri:dev
npm run tauri:build

Die Installationsprogramme werden auf dem Zielsystem erstellt. Linux benötigt WebKitGTK 4.1, macOS die Xcode Command Line Tools und Windows die Microsoft C++ Build Tools sowie WebView2. Die genauen aktuellen Anforderungen finden Sie in der offiziellen Tauri-Dokumentation.

Shared-Apache-Hosting

Anforderungen: Apache 2.4 mit mod_rewrite, HTTPS, PHP 8.2+, die Erweiterungen PDO SQLite (oder PDO MySQL), cURL und JSON.

npm run build:apache

Laden Sie das resultierende Verzeichnis apache-dist/ in das Web-Root hoch. Für die Google-/GitHub-Anmeldung kopieren Sie api/config.example.php nach api/config.php, ergänzen Sie die OAuth-Schlüssel und setzen Sie den Callback auf:

https://vase-domena.cz/api/auth/oauth/callback

Ohne OAuth-Konfiguration funktionieren Konten über E-Mail und Passwort. Die Datenbank wird bei der ersten Anfrage in api/var/ erstellt; das Verzeichnis muss für PHP beschreibbar sein.

Überprüfen Sie nach dem Hochladen /v1, /v1/licenses?q=MIT und die MCP-Initialisierung über POST /mcp. Die Datei checksums.sha256 ermöglicht es, die Vollständigkeit der Übertragung zu überprüfen.

Aktualisierung der Daten

Der Generator erwartet Checkouts der festen Version von spdx/license-list-data und github/choosealicense.com:

node scripts/build-app-data.mjs /cesta/license-list-data /cesta/choosealicense public/data

Die Ausgabe enthält einen Metadatenkatalog, detailliertes JSON für jeden Eintrag und einen Volltextindex. Die Desktop-Version packt ihn direkt in die Anwendung; die Web-Version stellt ihn als versionierte statische Daten bereit.

Struktur

• app/ — Web-Einstiegspunkt für Sites/Vinext;

• components/ und lib/ — gemeinsame Benutzeroberfläche und Regel-Engine;

• desktop/ — statischer Vite-Einstiegspunkt für Tauri;

• src-tauri/ — native Hülle und Paketkonfiguration;

• public/data/ — Offline-Katalog;

• docs/ECOSYSTEM.md — API, MCP und zugehörige Werkzeuge;

• docs/screenshots/ — Screenshots des aktuellen Desktop-Web-Builds;

• apache-server/ — PHP-Runtime und Sicherheitskonfiguration für Shared-Hosting;

• apache-dist/ — Artefakt, das mit dem Befehl npm run build:apache erstellt wird.