Come raccogliere il caos da repository e note su un'unica tela infinita

Vista familiare: apri il browser la mattina e ci sono trenta schede in attesa. Una ha un'attività da GitLab, un'altra mostra un bug report di GitHub Issues, una terza ha una nota di Notion aperta, e accanto ci sono una dozzina di altri link a documentazione e mockup. Tutte queste informazioni sono così sparse tra i servizi che ci vogliono circa quindici minuti per ripristinare il contesto prima di poter iniziare a lavorare.

Recentemente mi sono imbattuto in un progetto interessante chiamato Ideon. È una tela self-hosted per l'organizzazione spaziale dei progetti. L'autore ha deciso di abbandonare le usuali cartelle nidificate e le directory ad albero, proponendo invece di posizionare tutti gli elementi di sviluppo su un'unica mappa infinita.

Perché sostituire le liste con una mappa

Di solito, gli strumenti per prendere appunti e gestire le attività ci costringono a incastrare i pensieri in gerarchie. Creiamo cartelle, facciamo sottocartelle dentro di esse, poi pagine e liste. Il problema è che i progetti reali raramente si adattano a un albero rigoroso. Un repository frontend è collegato al backend, che ha anche ticket di bug allegati, link ad API di partner e schizzi dell'architettura.

Ideon usa il principio della prossimità spaziale. Se due blocchi giacciono uno accanto all'altro sulla lavagna, sono correlati per significato. Puoi semplicemente trascinare le card sulla tela, raggruppandole come è più comodo per te o per il tuo team, piuttosto che come detta la struttura del file system.

Cosa c'è dentro

Il progetto è scritto in TypeScript e distribuito sotto la licenza AGPLv3. Le funzionalità principali ruotano attorno all'integrazione con la codebase e alla collaborazione.

Integrazioni live con le piattaforme Git

La differenza principale tra Ideon e le normali lavagne virtuali come Miro o Excalidraw è la connessione diretta al codice. Puoi incorporare repository e aprire ticket da quattro sistemi popolari:

• GitHub
• GitLab
• Gitea
• Forgejo

Incolli un link a un'attività o repository, e il blocco si trasforma in una card interattiva con stato e dettagli. Puoi raggruppare i servizi backend in un angolo della tela, appendere le card delle issue aperte lì vicino, e allegare un file markdown con la descrizione del contratto API proprio lì.

Note, media e file

La tela non è limitata solo ai link al codice. Puoi lanciare sulla tela note con supporto Markdown, immagini, documenti e file. Se stai progettando un servizio, puoi posizionare il testo con le decisioni architetturali e gli screenshot degli errori dai log proprio accanto allo schema del database.

Collaborazione in tempo reale

Il progetto ha il multiplayer integrato. Più persone possono simultaneamente spostare card, scrivere note e discutere dell'architettura sulla stessa tela. I cursori dei colleghi sono visibili direttamente sullo schermo.

Snapshot di stato e macchina del tempo

Durante lo sviluppo attivo, la lavagna cambia rapidamente. Per non perdere decisioni importanti, Ideon ha aggiunto un meccanismo di snapshot. Puoi viaggiare indietro nel tempo e vedere come appariva lo spazio di lavoro una settimana fa, quando stavi solo scegliendo lo stack tecnologico o discutendo della prima release.

Come eseguire il deployment da solo

Lo sviluppatore ha impacchettato tutto in Docker Compose, quindi lanciarlo sul proprio server richiede un paio di minuti.

Avrai bisogno di Docker e Docker Compose installati. Clona il progetto e configura le variabili d'ambiente:

git clone https://github.com/3xpyth0n/ideon.git
cd ideon
cp env.example .env

Nel file .env, devi generare e specificare una chiave segreta, ad esempio usando il comando openssl rand -hex 32, e anche modificare le credenziali del database se necessario.

Dopo la configurazione, avvia i container:

docker compose up -d

L'interfaccia sarà disponibile nel browser all'indirizzo http://localhost:3000.

Se il deployment locale sembra troppo impegnativo in questo momento, l'autore ha configurato una demo pubblica all'indirizzo https://demo.theideon.com. Puoi accedere con username ideon-demo e password ideon-demo.

A chi il progetto è utile e a chi no

Ideon sembra attraente per piccoli team e sviluppatori singoli che lavorano su più progetti personali in parallelo. Quando passi da un progetto all'altro una volta a settimana, una mappa spaziale ti aiuta a ricordare istantaneamente dove ti sei fermato e cosa avevi pianificato di fare. Il supporto per Gitea e Forgejo locali è particolarmente gradito, e sarà apprezzato dai fan degli ambienti di sviluppo completamente autonomi.

D'altra parte, il progetto è ancora giovane, con circa seicento stelle nel repository. Se hai bisogno di board Kanban rigidi con scadenze strette, burndown chart e integrazione con tracker aziendali come Jira, le capacità di Ideon non saranno sufficienti. Ma come pannello di controllo visivo per gestire progetti personali o di team, sembra piuttosto unico. Vale sicuramente la pena provarlo, almeno attraverso la demo.