> Dicembre 2025: l architettura dell ORM

Separare le responsabilita

A dicembre 2025 l ORM ha subito una ristrutturazione architetturale profonda. Il commit chiave — restructure ORM architecture with ActiveQuery and separated builder/executor — racconta la scelta di separare le responsabilita in componenti specializzati.

ActiveQuery e diventata l interfaccia fluent per le query. L AbstractBuilder genera SQL. Il QueryExecutor gestisce PDO. Il ModelHydrator trasforma le righe in istanze del modello. Ogni pezzo ha un ruolo chiaro.

Architettura risultante

• ActiveQuery — API fluent usata dal codice applicativo
• AbstractBuilder + driver specifici — generazione SQL per MySQL, PostgreSQL, SQLite
• QueryExecutor — preparazione e esecuzione PDO
• ModelHydrator — conversione righe DB in modelli tipizzati
• QueryBuilderFactory — selezione del builder in base a DB_DRIVER

Questa separazione ha reso possibile aggiungere nuovi driver database senza toccare la logica di query. Il pattern e rimasto stabile da allora.