Licentia

Licentia — это чешское веб- и десктоп-приложение для работы с каталогом SPDX License List 3.28.0. Оно помогает быстро найти лицензию, сравнить её метаданные и разобраться в обязательствах без необходимости вручную просматривать сотни текстов.

Руководство является ориентировочным вспомогательным инструментом для принятия решений, а не юридической консультацией.

Возможности

• офлайн-каталог из 727 лицензий и 84 лицензионных исключений;

• полнотекстовый поиск по названию, SPDX ID и полному тексту;

• фильтрация по типу записи, актуальности, метаданным OSI/FSF и профилю лицензии;

• детальное отображение канонического текста и обязательств;

• сравнение лицензий и сохранение элементов в личное рабочее пространство;

• шестишаговый гид по выбору распространённого лицензионного направления;

• публичное REST API /v1;

• Streamable HTTP MCP endpoint /mcp;

• валидация SPDX-выражений, ориентировочная проверка совместимости и анализ SPDX/CycloneDX SBOM;

• веб-вариант, десктоп-вариант на Tauri и общий вариант на Apache/PHP.

Related MCP server: mcp-spdx-license

Примеры приложения

Каталог лицензий

Гид по выбору

Поиск в каталоге

Разработка веб-приложения

Требуемая версия Node.js: >=22.13.0.

npm install
npm run dev

Продакшен-сборка:

npm run build

Проверка стиля и статических правил:

npm run lint

Десктоп: Linux, Windows и macOS

Десктоп использует Tauri 2 и отдельную статическую Vite-сборку с теми же React-компонентами и локальной копией всех данных.

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

Установщики собираются на целевой системе. Для Linux требуется WebKitGTK 4.1, для macOS — Xcode Command Line Tools, а для Windows — Microsoft C++ Build Tools и WebView2. Точные актуальные требования указаны в официальной документации Tauri.

Общий Apache-хостинг

Требования: Apache 2.4 с mod_rewrite, HTTPS, PHP 8.2+, расширение PDO SQLite (или PDO MySQL), cURL и JSON.

npm run build:apache

Получившийся каталог apache-dist/ загрузите в корень сайта. Для входа через Google/GitHub скопируйте api/config.example.php как api/config.php, добавьте OAuth-ключи и настройте callback на:

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

Без OAuth-конфигурации работают учётные записи через e-mail и пароль. База данных создаётся при первом запросе в api/var/; каталог должен быть доступен для записи из PHP.

После загрузки проверьте /v1, /v1/licenses?q=MIT и инициализацию MCP через POST /mcp. Файл checksums.sha256 позволяет проверить полноту передачи.

Обновление данных

Генератор ожидает checkout фиксированной версии spdx/license-list-data и github/choosealicense.com:

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

Результат содержит каталог метаданных, детальный JSON каждой позиции и полнотекстовый индекс. Десктоп упаковывает его непосредственно в приложение; веб-версия отдаёт его как версионированные статические данные.

Структура

• app/ — веб-вход для Sites/Vinext;

• components/ и lib/ — общий пользовательский интерфейс и движок правил;

• desktop/ — статический Vite-вход для Tauri;

• src-tauri/ — нативная обёртка и конфигурация пакетов;

• public/data/ — офлайн-каталог;

• docs/ECOSYSTEM.md — API, MCP и сопутствующие инструменты;

• docs/screenshots/ — скриншоты актуальной десктопной веб-сборки;

• apache-server/ — PHP-рантайм и конфигурация безопасности для общего хостинга;

• apache-dist/ — артефакт, создаваемый командой npm run build:apache.