michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
7d3bede792
netgescon-day0/docs/91-database/README.md

5.8 KiB
Executable File
Raw Blame History

🗄️ NETGESCON DATABASE STRUTTURA

Organizzazione sistematica del database NetGescon

📅 Versione: 3.0 - 5 Agosto 2025

🎯 Obiettivo: Database strutturato per amministratori con codice univoco 8 cifre

🔑 CONNESSIONE DATABASE SVILUPPO

Credenziali Standard NetGescon:

# Database di sviluppo
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=netgescon
DB_USERNAME=netgescon_user
DB_PASSWORD=NetGescon2024!

# Path Laravel
DB_CONFIG_PATH=/var/www/netgescon/.env
DB_MIGRATIONS_PATH=/var/www/netgescon/database/migrations/

Test Connessione:

# Verifica connessione database
mysql -u netgescon_user -p netgescon
# Password: NetGescon2024!

# Oppure via Laravel
cd /var/www/netgescon
php artisan tinker
DB::connection()->getPdo();

🏗️ ARCHITETTURA DATABASE

🎯 Principio Fondamentale:

Ogni amministratore ha un CODICE UNIVOCO di 8 CIFRE alfanumeriche che identifica la sua "bolla" di dati

Vantaggi Architettura:

  • ✅ Isolamento dati per amministratore
  • ✅ Portabilità database per singolo amministratore
  • ✅ Backup selettivo per codice amministratore
  • ✅ Scalabilità e distribuzione facilitata
  • ✅ Security multi-tenant nativa

📂 STRUTTURA CARTELLE DATABASE

📋 Organizzazione File:

01-struttura-principale/

  • README.md - Tabelle core del sistema
  • amministratori.md - Tabella amministratori (codice 8 cifre)
  • users.md - Utenti sistema (collegati ad amministratore)
  • roles-permissions.md - Sistema ruoli e permessi
  • schema-completo.md - Schema ER completo

02-tabelle-collegate/

  • stabili.md - Condomini e stabili
  • gestioni.md - Gestioni annuali
  • unita-immobiliari.md - Unità immobiliari
  • soggetti.md - Anagrafica persone/aziende
  • contabilita.md - Movimenti e piano conti
  • documenti.md - Sistema documentale

03-archivi-specifici/

  • comuni-italiani.md - Anagrafica comuni (8100 record)
  • codici-catastali.md - Codici catastali
  • tabelle-millesimali.md - Template millesimi
  • piano-conti-standard.md - Piano conti default

04-migrations-seeds/

  • migration-order.md - Ordine esecuzione migrations
  • seeder-data.md - Dati iniziali sistema
  • import-scripts.md - Script importazione dati
  • backup-restore.md - Procedure backup/restore

🎯 TABELLE PRINCIPALI IDENTIFICATE

✅ Core Sistema (con codice amministratore):

-- Tabella master con codice 8 cifre
amministratori (
    id,
    codice_univoco CHAR(8) UNIQUE,  -- ES: A1B2C3D4
    nome, cognome, email,
    created_at, updated_at
)

-- Utenti collegati ad amministratore
users (
    id,
    amministratore_id,  -- FK verso amministratori
    name, email, password,
    created_at, updated_at
)

-- Stabili con filtro amministratore
stabili (
    id,
    amministratore_id,  -- FK verso amministratori
    denominazione, indirizzo,
    created_at, updated_at
)

✅ Tabelle Collegate (filtrate per amministratore):

  • gestioni → collegate a stabili → filtrate per amministratore
  • unita_immobiliari → collegate a stabili → filtrate per amministratore
  • soggetti → collegati a stabili → filtrati per amministratore
  • contabilita_registrazioni → collegate a gestioni → filtrate per amministratore
  • documenti → collegati a stabili → filtrati per amministratore

✅ Tabelle Condivise (senza filtro):

  • comuni_italiani → anagrafica nazionale
  • roles → ruoli sistema
  • permissions → permessi sistema

🔄 FLUSSO CREAZIONE DATABASE

Step 1: Struttura Principale

  1. Leggi 01-struttura-principale/README.md
  2. Crea tabelle core (amministratori, users, roles)
  3. Implementa sistema codice 8 cifre

Step 2: Tabelle Collegate

  1. Leggi 02-tabelle-collegate/README.md
  2. Crea tabelle business (stabili, gestioni, unita)
  3. Implementa foreign keys con amministratore

Step 3: Archivi Specifici

  1. Leggi 03-archivi-specifici/README.md
  2. Importa comuni italiani (8100 record)
  3. Configura dati master

Step 4: Migrations e Seeds

  1. Leggi 04-migrations-seeds/README.md
  2. Esegui migrations in ordine corretto
  3. Popola con dati iniziali

🔍 QUERY PATTERN STANDARD

Filtro per Amministratore:

-- Pattern base per tutte le query
SELECT s.*, a.codice_univoco as admin_code
FROM stabili s
JOIN amministratori a ON s.amministratore_id = a.id
WHERE a.codice_univoco = 'A1B2C3D4';

-- Pattern Laravel
$stabili = DB::table('stabili')
    ->join('amministratori', 'stabili.amministratore_id', '=', 'amministratori.id')
    ->where('amministratori.codice_univoco', auth()->user()->amministratore->codice_univoco)
    ->get();

Backup per Amministratore:

# Backup dati singolo amministratore
mysqldump -u netgescon_user -p netgescon \
    --where="amministratore_id IN (SELECT id FROM amministratori WHERE codice_univoco='A1B2C3D4')" \
    stabili gestioni unita_immobiliari > backup_A1B2C3D4.sql

🎯 PROSSIMI PASSI

Ora Procediamo Con:

  1. 📖 Leggi 01-struttura-principale/README.md per tabelle core
  2. 🏗️ Implementa sistema amministratori con codice 8 cifre
  3. 🔗 Collega tutte le tabelle business con foreign key
  4. 📊 Verifica filtri e query pattern
  5. 🧪 Testa con dati demo per 2-3 amministratori

File da Studiare in Ordine:

  1. 01-struttura-principale/amministratori.md
  2. 01-struttura-principale/users.md
  3. 02-tabelle-collegate/stabili.md
  4. 02-tabelle-collegate/gestioni.md
  5. 03-archivi-specifici/comuni-italiani.md

🎯 DATABASE ORGANIZZATO E STRUTTURATO
Ogni file contiene la documentazione completa per implementazione sistematica

📖 Inizia dalla lettura di 01-struttura-principale/README.md