@pzeta/utils

Getting Started

Guida introduttiva a @pzeta/postgrest. Installazione, architettura DDD, quick start con PostgRESTClient e service pattern con BasePostgrestService.

Da dove iniziare

Questa sezione raccoglie tutto ciò che serve per iniziare a usare @pzeta/postgrest: installazione, modello architetturale, esempi end-to-end e il pattern canonico per integrare la libreria nei progetti PZeta.

Se è la prima volta che integri @pzeta/postgrest, segui le pagine in ordine: Installazione → Architettura → Quick Start → Service Pattern.

Indice

  • Installazione — npm install, peer dependencies opzionali, subpath exports . e /mfe, verifica setup
  • Architettura — Layer Clean Architecture + DDD (domain, application, infrastructure), Strategy Pattern per auth e cache, Repository e Factory
  • Quick Start — Tre approcci: facade PostgRESTClient, setup manuale con EnhancedPostgRESTRepository, service pattern con BasePostgrestService
  • Service Pattern (BasePostgrestService) — Pattern di adozione canonico nei progetti PZeta, integrazione con Inversify DI, RPC helpers

Architettura

Modello Clean Architecture + DDD a tre layer (domain, application, infrastructure). Dependency Rule, Strategy Pattern per auth e cache, Repository Pattern, Factory Pattern, Facade Pattern.

Installazione

Installazione di @pzeta/postgrest, peer dependencies opzionali (axios, vue, @pzeta/mfe-contracts), subpath exports core e /mfe, verifica con esempio minimo.

Quick Start

Tre approcci per iniziare con @pzeta/postgrest - facade PostgRESTClient (semplice), setup manuale con EnhancedPostgRESTRepository (controllo), service pattern con BasePostgrestService (consigliato per progetti strutturati).

Service Pattern (BasePostgrestService)

Classe base astratta per service applicativi PostgREST. CRUD omogeneo, error messages italiani, RPC helpers, integrazione Inversify DI. Pattern di adozione canonico nei progetti PZeta.

PostgREST

Libreria TypeScript per l'integrazione con PostgREST seguendo Clean Architecture e DDD. Client HTTP, caching multi-strategia, autenticazione (JWT, Cookie, ApiKey), filtering type-safe, repository pattern e service base per progetti standalone o microfrontend.

Architettura

Modello Clean Architecture + DDD a tre layer (domain, application, infrastructure). Dependency Rule, Strategy Pattern per auth e cache, Repository Pattern, Factory Pattern, Facade Pattern.