Technology Radar
Il Technology Radar ti offre una panoramica visiva di ogni tecnologia utilizzata nella tua architettura. Le tecnologie sono automaticamente categorizzate in quadranti e classificate per livello di adozione in base all'utilizzo effettivo nei tuoi elementi e relazioni C4.
Concetti Fondamentali
Tecnologie
Una tecnologia rappresenta qualsiasi strumento, linguaggio, framework o servizio utilizzato nella tua architettura. Ogni tecnologia ha:
| Campo | Descrizione |
|---|---|
| Nome | Nome visualizzato (es. PostgreSQL, React, Kubernetes) |
| Categoria | Classificazione che determina il quadrante del radar |
| Descrizione | Note opzionali sull'utilizzo o lo scopo |
| Icona | Logo opzionale per l'identificazione visiva |
Quadranti
Le tecnologie sono raggruppate in quattro quadranti basati sulla loro categoria:
| Quadrante | Categorie |
|---|---|
| Linguaggi | Linguaggi di programmazione, runtime |
| Framework | Framework, librerie |
| Dati | Database, message broker, object storage |
| Infrastruttura | Servizi cloud, strumenti DevOps, protocolli di trasporto, altro |
Anelli di Adozione
Ogni tecnologia è posizionata in un anello in base alla diffusione del suo utilizzo nella tua architettura:
| Anello | Criteri | Significato |
|---|---|---|
| Core | Usata in 4+ elementi/relazioni | Tecnologia fondamentale, profondamente integrata |
| Active | Usata in 2-3 elementi/relazioni | Attivamente adottata, utilizzo in crescita |
| Emerging | Usata in 1 elemento/relazione | Introdotta di recente, in fase di valutazione |
| Registered | Non ancora collegata a nessun elemento | Catalogata ma non in uso attivo |
Viste
Vista Radar
La vista predefinita. Le tecnologie appaiono come punti su un grafico radar, posizionate per quadrante e anello. Questo offre una visione d'insieme del tuo panorama tecnologico.
Interazioni:
- Passa il mouse su un punto per vedere il nome della tecnologia ed evidenziare le tecnologie correlate
- Clicca su un punto per aprire il pannello dettagli
- Clicca l'etichetta di un quadrante per filtrare quel quadrante
Vista Tabella
Una lista strutturata di tutte le tecnologie raggruppate per quadrante e anello. Ogni voce mostra il nome della tecnologia, l'icona e una barra di utilizzo che indica l'adozione relativa.
Passa alla vista tabella dal selettore di vista nell'intestazione. Questa vista è utile per revisionare le tecnologie sistematicamente o durante le riunioni di revisione architetturale.
Vista Gestione
La vista di amministrazione per creare, modificare ed eliminare tecnologie.
Accedi dal selettore di vista o naviga a /technologies/management.
Aggiungere Tecnologie agli Elementi
Le tecnologie sono collegate a elementi e relazioni C4, ed è questo che determina il posizionamento sul radar.
Dal Pannello Elemento
- Seleziona qualsiasi sistema, container o componente sul diagramma
- Apri il pannello dettagli dell'elemento
- Nella sezione Tecnologie, cerca e seleziona le tecnologie
- Le modifiche vengono salvate immediatamente
Dalle Relazioni
- Clicca su una relazione (arco) tra due elementi
- Nel pannello della relazione, trova Tecnologie
- Aggiungi tecnologie pertinenti (es. il protocollo o framework usato per la comunicazione)
Durante l'AI Discovery
Quando esegui la scoperta potenziata dall'AI su un repository, Archyl rileva automaticamente le tecnologie dal tuo codebase e le collega agli elementi scoperti.
Gestire le Tecnologie
Creare una Tecnologia
- Naviga a Tecnologie → vista Gestione
- Clicca su Aggiungi tecnologia
- Compila nome, categoria e descrizione opzionale
- Carica un'immagine logo se desiderato
- Clicca su Crea
Modificare una Tecnologia
- Nella vista Gestione, trova la tecnologia nella lista
- Clicca sul pulsante Modifica (icona matita)
- Modifica nome, categoria, descrizione o logo
- Clicca su Salva modifiche
Eliminare una Tecnologia
- Nella vista Gestione, clicca sul pulsante Elimina (icona cestino) sulla riga della tecnologia
- Conferma l'eliminazione
Eliminare una tecnologia la rimuove da tutti gli elementi e relazioni collegati.
Pannello Dettagli
Clicca su qualsiasi tecnologia nella vista radar o tabella per aprire il pannello dettagli. Mostra:
Statistiche di Utilizzo
- Elementi: Quanti elementi C4 usano questa tecnologia
- Relazioni: Quante relazioni la referenziano
- Livello di adozione: Una barra percentuale relativa alla tua tecnologia più utilizzata
Tecnologie Associate
Tecnologie che appaiono frequentemente insieme a quella selezionata. Questo rivela abbinamenti naturali nel tuo stack -- ad esempio, se React e TypeScript appaiono spesso insieme.
Elementi Correlati
Una lista di ogni sistema, container o componente che usa questa tecnologia. Clicca su qualsiasi elemento per navigare direttamente ad esso sul diagramma.
Ricerca delle Tecnologie
Dalla Pagina Radar
Usa il campo di ricerca nella barra dell'intestazione per filtrare le tecnologie per nome o categoria. Combina con i filtri quadrante e anello per restringere ulteriormente i risultati.
Dalla Ricerca Globale
Premi Cmd+K (o Ctrl+K) per aprire la ricerca globale. Digita il nome di una tecnologia -- le tecnologie corrispondenti appaiono con un badge Tecnologia. Selezionarne una ti porta alla pagina Tecnologie con la ricerca pre-compilata.
Filtraggio
Filtro Quadrante
Clicca sul dropdown del quadrante per mostrare solo le tecnologie di un quadrante specifico (Linguaggi, Framework, Dati o Infrastruttura).
Filtro Anello
Clicca su qualsiasi pillola dell'anello (Core, Active, Emerging, Registered) per filtrare per livello di adozione. La barra di distribuzione degli anelli nell'intestazione funziona anche come filtro cliccabile.
Filtri Combinati
Tutti i filtri funzionano insieme. Ad esempio, filtra per quadrante "Framework" + anello "Core" per vedere le tue dipendenze framework più critiche.
I filtri attivi appaiono come chip rimovibili sotto la barra dei filtri. Clicca su Cancella tutto per resettare.
Best Practice
Mantieni il Catalogo Aggiornato
- Aggiungi tecnologie man mano che le adotti
- Rimuovi tecnologie deprecate
- Aggiorna le categorie se il ruolo di uno strumento cambia
Collega le Tecnologie in Modo Consistente
- Applica le tecnologie al livello C4 giusto -- linguaggi e framework su container/componenti, infrastruttura sui sistemi
- Tagga le relazioni con il protocollo o trasporto usato (es. gRPC, REST, AMQP)
- Sii specifico -- preferisci "PostgreSQL" rispetto a "Database SQL"
Usa il Radar per la Governance
- Revisiona il radar durante le riunioni di revisione architetturale
- Le tecnologie nell'anello Emerging sono candidate per la valutazione del team
- Le tecnologie nell'anello Registered senza utilizzo potrebbero essere candidate per la rimozione
- Un radar sano ha la maggior parte delle tecnologie in Core o Active
Sfrutta le Tecnologie Associate
- Usa i dati "associata con" per comprendere il clustering tecnologico
- Identifica abbinamenti inaspettati che possono indicare inconsistenza
- Individua opportunità di standardizzazione quando tecnologie simili servono lo stesso scopo
Prossimi Passi
- Scoperta Potenziata dall'AI -- Rilevare automaticamente le tecnologie dal codice
- Insight Architetturali -- Ottenere raccomandazioni sulla tua architettura
- Elementi e Stili -- Scoprire gli elementi C4