BlackCat Frontend Marketplace

Platforma pro komunitní rozšíření front-end komponent (identity UI, governance console, analytics dashboards). Cílem je:

• umožnit developerům přidávat vlastní komponenty/layouty
• evidovat anonymizovaně použití komponent (GDPR friendly) pro revenue share
• vystavovat katalog pro AI/instalátor (výběr komponent)
• řešit licencování, payouty, reputaci

Struktura

• schema/component.schema.json – JSON schema popisující manifest komponenty.
• components/ – katalog komponent, každý soubor = jedna položka.
• tools/validate.php – jednoduchý validator manifestů před PR.
• docs/CONTRIBUTING.md – postup pro přispěvatele.

Usage data proudí do blackcat-usage a finanční logika přes blackcat-payout + blackcat-commerce.

CLI katalog

Součástí repozitáře je nástroj bin/catalog, který používá AI instalátor i lidé:

# výpis všech komponent v tabulce
php bin/catalog list

# filtrování podle tagu, výstup JSON (pro AI)
php bin/catalog list --tag=identity --format=json

# detail komponenty
php bin/catalog show identity-consent-card

# export do NDJSON (feed pro katalog API)
php bin/catalog export --format=ndjson > components.ndjson

# env hinty (lze přímo přesměrovat do .env)
php bin/catalog env identity-consent-card >> .blackcat/env.marketplace

Submission Flow & Integrace

Stage 1 přidává konfigurovatelný submission pipeline (config/example.marketplace.php) napojený na ostatní core repa:

• bin/submissions <config> submit|list|show|run – CLI pro správu komunitních komponent. Příkaz run vytváří schválené envelope a pushuje je do
  • blackcat-database (NDJSON buffer integrations.database_buffer),
  • blackcat-orchestrator (queue feed integrations.orchestrator_queue),
  • blackcat-payout (ledger feed integrations.payout_ledger).
• Security policy (config/security.policy.json) hlídá licence, tagy a velikosti balíčků, trust-store (config/trust-store.example.json) mapuje autorizační scopes z blackcat-auth.
• Telemetrie (var/metrics.prom) zapisuje Prometheus metriky (blackcat_marketplace_submissions_*) pro blackcat-observability.
• Podpis eventů využívá crypto_key_file, případně dostupný blackcat-crypto.

Příklad použití

# použití výchozí konfigurace
php bin/submissions config/example.marketplace.php list

# registrace nové komponenty a přeposlání do orchestrátoru + payout feedu
php bin/submissions config/example.marketplace.php submit docs/samples/component.json dev@example.com --tenant=demo
php bin/submissions config/example.marketplace.php run

Testing

Smoke scénář ověří submission pipeline + integrace:

php tests/SubmissionPipelineTest.php

Výsledek: schválený submission, aktualizovaný Prometheus soubor a nové položky v integračních feedech.