Salta al contenuto principale
Storie

Un sistema di organizzazione tutto nuovo

La storia di come il team di capgo ha aggiunto un sistema di organizzazione

Un nuovissimo sistema di organizzazione Capgo illustrazione del blog

Introduzione

Ciao, sono WcaleNieWolny - lead software engineer di Capgo.

Negli ultimi 8 mesi, ho sviluppato il sistema di organizzazione, e dal 14 aprile sono lieto di annunciare che il sistema è stato completato 🎉 🎊

Finalmente, dopo 8 mesi, ogni singola parte di Capgo è accessibile ai membri dell'organizzazione. Questo include:

  • app
  • statistiche
  • fatturazione
  • supporto completo per CLI
  • e molto altro!

Non è stato facile arrivare fin qui; ci sono state 3 revisioni principali dei sistemi.

Organizzazioni v1

Gli inizi sono stati difficili… Inizialmente, ho iniziato a lavorare su questo progetto 2 settimane dopo essere entrato a far parte del progetto. All'epoca, avevo poca o nessuna conoscenza della codebase né un'idea più chiara su come implementarlo.

Questo ha portato a implementare la soluzione più hacky, che supportava solo l'accesso alle app, ai canali e alle versioni. Non permetteva nemmeno all'utente invitato di accedere alle statistiche.

Poi ho aspettato che Martin facesse la review. Ho aspettato e aspettato, ma non è successo nulla. Tre mesi dopo, ho deciso di tornarci e risolvere tutti i merge conflict. Ho anche deciso di testare, e si è rivelata un'ottima idea. Come previsto, la soluzione hacky è fallita completamente. A quel punto ho deciso di correggere tutti i bug e scrivere un test E2E approfondito. Ho dovuto lavorare con un code molto rotto e con molte pessime decisioni prese dal me del passato, ma dopo 2 settimane difficili sono finalmente riuscito a farlo funzionare.

Questo non significa, tuttavia, che fosse perfetto. Il proprietario dell'organizzazione aveva comunque molti più permessi persino dell'utente invitato con il livello più alto. Anche l'esperienza utente lasciava parecchio a desiderare. L'utente invitato non poteva nemmeno vedere le statistiche dell'applicazione, gestire la fatturazione, e il CLI era limitato al solo upload.

Nonostante tutte queste sfide, Martin aveva fatto la review della PR e una settimana dopo è stata rilasciata in produzione.

Organizzazioni v2

Il sistema di organizzazione funzionava piuttosto bene nonostante tutte le sfide. Gli utenti lo stavano usando e ha spinto davvero l'intero progetto in avanti. Tuttavia, dovevo ancora:

  • sistemare il disastro creato in row level security
  • aggiungere il supporto per l'intero CLI
  • assicurarmi che gli utenti admin abbiano gli stessi accessi del proprietario

Dopo aver molte discussioni con Martin abbiamo deciso che il modo migliore per andare avanti era riscrivere da zero tutte le regole di sicurezza e spostare la proprietà di tutte le risorse dagli utenti alle organizzazioni. Questo avrebbe permesso un'integrazione più semplice con il nuovo sistema di organizzazioni e avrebbe anche rimosso parecchio legacy code.

Scrivere i nuovi code RLS è stato molto noioso, ma dopo una settimana e mezza la migrazione era pronta.

Questa volta, però, abbiamo deciso di non scrivere i test E2E, il che ci ha costretti a testare tutto manualmente. Dopo tre call lunghissime, io e Martin abbiamo finalmente deciso di fare il push in produzione sperando in bene 🙏

Non è andata così... È venuto fuori che ho rotto la registrazione utenti e i nuovi utenti non riuscivano a creare un account 😅

Dopo una chiamata d'emergenza, ho pushato velocemente alcune modifiche in prod e sono andato a dormire. Purtroppo, le mie modifiche hanno solo creato altri problemi 😰

Quando mi sono svegliato, ho scoperto che gli utenti avevano un sacco di organizzazioni vuote. Non dovrebbe succedere, dato che è consentita una sola organizzazione per utente. Ci è voluto un po' di brainstorming per rimuovere tutte le org duplicate e vuote, ma a parte questo è andata piuttosto liscia.

Organizzazioni v3

Ma neanche questo bastava. Mancava ancora un pezzo enorme: il billing.

Finora solo il proprietario poteva gestire il billing. Questo ha creato problemi piuttosto curiosi, con utenti che acquistavano un piano pensando di comprarlo per l'organizzazione. Abbiamo risolto subito il problema manualmente, ed è stato proprio allora che abbiamo deciso che questa situazione era inaccettabile.

La migrazione è stata piuttosto fluida. Ci è voluta una settimana di lavoro, ma rispetto a V1 e V2 non è stato affatto difficile 🚀

Organizations v4 - il futuro

Dopo tutto questo duro lavoro, credo sia il momento di concentrarmi su altro per ora 😎

Non è stato facile, ma ho imparato molto e capgo ha ricevuto una feature davvero bella e importante. Devo ancora deprecare le funzioni legacy, migliorare la UX della webapp e monitorare i bug, ma non dovrebbero esserci grandi cambiamenti a questo sistema.


Grazie per la lettura 🚀

Continua la lettura da A brand new organization system

Se stai usando Un sistema di organizzazione tutto nuovo per pianificare le operazioni della dashboard e di API, collegalo a Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione delle chiavi API, Dispositivi per i dettagli di implementazione in Devices, e Bundle per il dettaglio di implementazione in Bundles.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.