Vai al contenuto principale

TypeORM – Lista Idee per Google Summer of Code (GSoC)

Traduzione Beta Non Ufficiale

Questa pagina è stata tradotta da PageTurner AI (beta). Non ufficialmente approvata dal progetto. Hai trovato un errore? Segnala problema →

Questo documento descrive le potenziali idee di progetto GSoC per TypeORM. Ogni idea include una descrizione, obiettivi, risultati attesi e livello di difficoltà.

Relazioni Polimorfiche di Prima Classe in TypeORM​

Descrizione​

TypeORM attualmente non supporta nativamente le relazioni polimorfiche (una singola relazione che punta a più tipi di entità). Gli utenti ricorrono a soluzioni alternative difficili da tipizzare, soggette a errori e inconsistenti tra database diversi.

Mentor​

Obiettivi​

  • Progettare un'API di prima classe per relazioni polimorfiche in TypeORM

  • Garantire compatibilità con i decoratori di relazione esistenti

  • Fornire supporto per migrazioni e sincronizzazione dello schema

Risultati attesi​

  • Nuovi decoratori per relazioni polimorfiche

  • Supporto per join polimorfici in QueryBuilder

  • Documentazione chiara ed esempi pratici

  • Implementazione retrocompatibile

Difficoltà​

Media - Previste 175 ore

Competenze richieste​

TypeScript, funzionamento interno ORM, progettazione schema SQL

Miglioramento della Type Safety e Inferenza in TypeORM​

Descrizione​

Nonostante sia scritto in TypeScript, TypeORM presenta diverse aree debolmente tipizzate (relazioni, risultati del QueryBuilder, metodi del Repository). Migliorare l'inferenza dei tipi aumenterebbe significativamente l'esperienza dello sviluppatore e la correttezza del codice.

Mentor​

Obiettivi​

  • Migliorare l'inferenza dei tipi per le relazioni (eager e lazy)

  • Tipizzare fortemente i risultati del QueryBuilder

  • Ridurre l'uso di any nelle API pubbliche

  • Migliorare i generici per Repository ed EntityManager

Risultati attesi​

  • Maggiori garanzie in fase di compilazione

  • Meno errori a runtime

  • Miglioramenti incrementali e non breaking

  • Documentazione sui pattern di tipizzazione consigliati

Difficoltà​

Media - Previste 175 ore

Competenze richieste​

TypeScript avanzato, generics, progettazione API libreria

Supporto Vettoriale: Tipi, Indicizzazione e Ricerca su Database Diversi​

Descrizione​

Gli embedding vettoriali sono sempre più comuni nelle applicazioni moderne (AI, ricerca, raccomandazioni). Sebbene TypeORM abbia un supporto parziale per i tipi di colonna vettoriale, manca una soluzione unificata e completa per archiviazione, indicizzazione e query vettoriali tra database diversi.

Questo progetto mira a fornire un supporto end-to-end per i vettori in TypeORM, coprendo tipi di colonna vettoriale, mapping specifici per database, indicizzazione vettoriale e astrazioni di alto livello per la ricerca vettoriale.

Mentor​

Obiettivi​

  • Aggiungere supporto per colonne vettoriali nei database mancanti (es. Oracle)

  • Investigare limitazioni di SQLite e supportare i vettori libsql dove possibile

  • Definire un'API coerente per colonne vettoriali cross-database

  • Implementare il supporto per gli indici vettoriali dove consentito dai database

  • Esporre le query di similarità vettoriale tramite QueryBuilder

  • Implementare un'astrazione di alto livello per lo storage vettoriale basato sui repository

  • Opzionale: esplorare query in stile knowledge-graph (es. API ispirate a SPARQL)

Risultati attesi​

  • Nuovo supporto per @Column({ type: "vector" }) su tutti i database

  • Mappature vettoriali specifiche per database, fallback e limitazioni

  • Supporto cross-database per gli indici vettoriali

  • API di alto livello per ricerche vettoriali e query di similarità

  • Architettura estensibile per future funzionalità IA e di ricerca

  • Documentazione chiara ed esempi pratici

Difficoltà​

Media — Previste 175 ore

Competenze richieste​

Dialetti SQL, internals dei database, architettura driver di TypeORM, strategie di indicizzazione, ottimizzazione query, design API

Modularizzazione delle API di definizione delle entità​

Mentor​

Descrizione​

TypeORM attualmente supporta due approcci per definire le entità: entità basate su classi (decoratori) e schemi entità. Nel tempo, questi approcci hanno divergito, con lo schema entità spesso in ritardo sulle funzionalità e sulla type safety rispetto alle classi.

Questo progetto si concentra sull'estrazione e modularizzazione degli stili di definizione delle entità in componenti più chiari e isolati, con l'obiettivo di sincronizzare entrambi gli approcci e abilitare miglioramenti architetturali futuri. Piuttosto che una completa ristrutturazione monorepo, ci si concentra su un sottoinsieme ben definito e realizzabile.

Obiettivi​

  • Estrarre la logica di definizione entità in moduli/pacchetti separati

  • Migliorare la parità tra entità class-based e schemi entità

  • Esplorare un'API di definizione entità basata su funzioni con forte type inference

  • Ridurre la duplicazione tra gli stili di definizione entità

  • Preparare il terreno per future modularizzazioni (CLI, logging, caching)

Risultati attesi​

  • Migliore sincronizzazione delle funzionalità tra schemi entità e classi

  • Astrazioni interne più pulite per la definizione dei metadati entità

  • Type inference migliorata per definizioni entità non basate su classi

  • Confini chiari per rendere più sicuri futuri refactoring e modularizzazioni

Difficoltà​

Difficile - Previste 350 ore

Competenze richieste​

TypeScript, sistema metadati di TypeORM, design API, refactoring di codebase grandi

Astrazione SQL Dialect per lo sviluppo di driver personalizzati​

Descrizione​

Aggiungere o mantenere driver di database in TypeORM è attualmente complesso e strettamente accoppiato alle implementazioni esistenti. Un'astrazione chiara dei dialect SQL semplificherebbe il supporto a nuovi database e ridurrebbe la duplicazione tra driver.

Questo progetto mira a definire un layer di SQL dialect che incapsuli il comportamento SQL specifico di ciascun database, facilitando lo sviluppo di nuovi driver e una migliore separazione delle responsabilità.

Mentor​

Obiettivi​

  • Progettare un'astrazione SQL dialect per comportamenti database-specifici

  • Estrarre la logica comune di generazione SQL dai driver esistenti

  • Definire punti di estensione chiari per implementare nuovi dialect

  • Documenta come creare un driver personalizzato utilizzando il sistema dei dialetti

Risultati attesi​

  • Un'interfaccia per i dialetti SQL ben definita

  • Riduzione della duplicazione nei driver esistenti

  • Miglioramento della manutenibilità dei driver correnti

  • Percorso chiaro per driver di database forniti dalla community

Difficoltà​

Difficile - Previste 350 ore

Competenze richieste​

Dialetti SQL, internals dei database, TypeScript, architettura dei driver di TypeORM

Invito aperto a idee proposte dalla community​

TypeORM accoglie con favore idee per progetti Google Summer of Code proposte da contributori e membri della community.

Se hai esperienza con TypeORM e hai identificato punti critici, funzionalità mancanti o miglioramenti architetturali, ti incoraggiamo a suggerire un'idea per un progetto GSoC.

Le idee suggerite possono includere (ma non sono limitate a):

  • Miglioramenti ai driver esistenti o al supporto dei database

  • Ottimizzazioni delle prestazioni

  • Miglioramenti all'esperienza dello sviluppatore e agli strumenti

  • Miglioramenti alla documentazione o all'infrastruttura di testing

  • Nuove funzionalità

Le idee proposte dovrebbero includere:

  • Una breve descrizione del problema

  • Risultati attesi e ambito

  • Difficoltà stimata

  • Aree tecniche rilevanti (TypeScript, SQL, driver, ecc.)

Le idee proposte dalla community saranno valutate dai maintainer e potranno essere aggiunte all'elenco ufficiale dei progetti GSoC.

Strumenti Moderni per Migrazioni e Snapshot​

Descrizione​

Il flusso di lavoro delle migrazioni in TypeORM è attualmente centrato sulla CLI, che può risultare macchinosa nei progetti TypeScript e limita casi d'uso avanzati. Inoltre, i progetti con lunghe cronologie di migrazioni affrontano un'inizializzazione del database lenta e soggetta a errori durante la configurazione di nuovi ambienti.

Questo progetto mira a modernizzare gli strumenti di migrazione di TypeORM introducendo un'API programmatica per la generazione di migrazioni e snapshot opzionali dello schema. Insieme, questi miglioramenti renderanno la generazione delle migrazioni più flessibile e permetteranno un'inizializzazione più rapida di nuovi database senza rieseguire tutte le migrazioni storiche.

Mentor​

Obiettivi​

  • Introdurre un'API programmatica per generare migrazioni senza dipendere dalla CLI

  • Abilitare template di migrazione personalizzabili

  • Progettare un meccanismo di snapshot dello schema che rappresenti la struttura finale del database

  • Permettere l'inizializzazione di nuovi database utilizzando snapshot preservando la cronologia delle migrazioni

  • Garantire compatibilità con i flussi di lavoro di migrazione esistenti

Risultati attesi​

  • Migliore esperienza per sviluppatori nei workflow TypeScript e non-CLI

  • Setup del database più veloce e affidabile per progetti di grandi dimensioni

  • Generazione migrazioni e templating più flessibili

  • Documentazione chiara e pattern d'uso raccomandati

Difficoltà​

Media - Previste 175 ore

Competenze richieste​

TypeScript, SQL, sistema migrazioni TypeORM, funzionamento interno CLI, design API e strumenti

Come iniziare​

Agli studenti interessati a contribuire a TypeORM nell'ambito di Google Summer of Code si consiglia di coinvolgersi in anticipo. La familiarità con la codebase, il flusso di contribuzione e le pratiche della community è fortemente raccomandata prima di inviare una proposta.

Per iniziare:

  • Unisciti al nostro server Discord

  • Leggi CONTRIBUTING.md

  • Esplora la repository e la documentazione di TypeORM per comprenderne l'architettura e i database supportati

  • Prova a risolvere un piccolo issue o migliorare la documentazione per familiarizzare con il processo di contribuzione