Dati e Multi-Tenant

Modello tenant

• Ogni record tenant-aware usa tenant_key.
• Control plane (host admin) puo vedere e gestire dati cross-tenant.
• Tenant host vede solo dati del proprio tenant_key.

Tabelle condivise vs tenant-aware

• Condivise (master data): comuni, province, stati, codici ATECO.
• Tenant-aware: clienti, ticket, documenti, relazioni operative.

Regole operative

• Evitare scritture su tenant_key=default fuori da control plane.
• Ogni migrazione massiva deve essere idempotente e con backup.
• Import legacy: mappature esplicite + report esito.

Coerenza dati

• Vincoli univoci cliente su (tenant_key, partita_iva) e (tenant_key, codice_fiscale).
• Guard-rail su sync/migrazioni per evitare duplicati cross-tenant.
• upgrade_all_tenants da usare dopo modifiche schema multi-db.