O projektu a architektuře

PgArachne™ slouží jako lehký, vysoce výkonný webový server, který stojí mezi vašimi HTTP klienty a databází PostgreSQL. Eliminuje potřebu tradičních backendových jazyků (jako Python, Node.js nebo PHP) tím, že mapuje HTTP požadavky přímo na databázové funkce.

Klíčové technické schopnosti

  • Brána JSON-RPC 2.0: Veškeré interakce s API se řídí striktní specifikací JSON-RPC 2.0. Nemusíte navrhovat žádné REST endpointy; jednoduše voláte SQL funkce jménem pomocí POST požadavků.
  • Nativní DB autentizace: Žádné oddělené tabulky uživatelů. Uživatelé se přihlašují svými skutečnými PostgreSQL přihlašovacími údaji a získají JWT. Služby mohou alternativně využívat trvalé API Tokeny.
  • Maskování rolí (Role Masquerading): PgArachne™ se připojuje jako proxy uživatel, ale každý požadavek provádí pomocí SET LOCAL ROLE, čímž se přepne do identity ověřeného uživatele. Zabezpečení na úrovni řádků (RLS) funguje automaticky.
  • Server statických souborů: PgArachne™ může servírovat statické assety (HTML, JS, CSS), což vám umožní hostovat Single Page Aplikace (SPA) nebo přímo nástroj Explorer.
  • Real-time notifikace (SSE): Odebírejte PostgreSQL NOTIFY kanály přes SSE pro živé aktualizace bez pollingu.

Tato architektura dramaticky zjednodušuje stack: Databáze ↔ PgArachne ↔ Frontend.

Formát API endpointu: Všechny databázové funkce jsou vystaveny na:
POST http://{server}:{port}
/api
/{nazev_databaze}
Metoda se uvádí v JSON-RPC těle požadavku.