Concetti

ConfigService (deprecato)

ConfigService è stato rimosso in v2. Usare initializePostgRESTClient() per configurare il client e PostgRESTDataSourceOptions per il resto.

Rimosso in v2.0. Il configService singleton non esiste più. Configura il client PostgREST con initializePostgRESTClient() (legge le variabili d'ambiente Vite) e personalizza endpoint/schema/PK con PostgRESTDataSourceOptions.

Cosa è cambiato

v1.x	v2.x
`configService.setConfig({ apiBaseUrl })`	`await initializePostgRESTClient()` (legge `VITE_APP_API_URL`)
`configService.getApiUrl()`	non più necessario — il client è singleton interno
`configService.getFullApiUrl()`	rimosso — `@pzeta/attivita` configurato a livello app
Override URL/schema centralizzato	Override per-istanza via `new PostgRESTDataSource({ schema, endpoints, primaryKeys })`

Migrazione

Prima (v1)

// main.ts
import { configService } from '@pzeta/vue-kanban'

configService.setConfig({
  apiBaseUrl: import.meta.env.VITE_APP_API_URL,
})

Dopo (v2)

// main.ts
import { initializePostgRESTClient } from '@pzeta/vue-kanban'

await initializePostgRESTClient()
// Legge automaticamente VITE_APP_API_URL, VITE_APP_SCHEMA, VITE_APP_DISABLE_CACHE

Per override programmatico di URL/schema/endpoint, non è più una configurazione globale: passa un PostgRESTDataSource custom a useBoardService:

import { PostgRESTDataSource, useBoardService, usePostgRESTClient } from '@pzeta/vue-kanban'

const customDataSource = new PostgRESTDataSource({
  client: usePostgRESTClient(),
  schema: 'public',
  endpoints: {
    board: '/projects',
    columns: '/project_columns',
    items: '/project_cards',
    // ...
  },
})

const service = useBoardService('PROJECT-X', { dataSource: customDataSource })

Variabili d'ambiente

Variabile	Descrizione	Default
`VITE_APP_API_URL`	URL base PostgREST	`window.location.origin`
`VITE_APP_SCHEMA`	Schema PostgreSQL	`fasi`
`VITE_APP_DISABLE_CACHE`	Disabilita cache PostgREST	`false`
`VITE_APP_SERVICES_URL`	URL servizi versionamento form	dev: `/git`, prod: `https://services.pzeta.it/git`

Vedi anche

KanbanDataSource — Strategy pattern per backend pluggable
Installazione — Setup initializePostgRESTClient()

Tipi Scrittura

Payload per operazioni POST e PATCH sulle entità dello schema fasi.

ItemAdapter (NormalizedItem)

View-model normalizzato delle card. Disaccoppia ElementCard dalla forma del backend, eliminando alias di campo (priorita vs priority vs priorita_nome).