Importa progetti Structurizr, LikeC4 e IcePanel in Archyl con un solo clic - Archyl Blog

Migra la tua documentazione di architettura da Structurizr DSL, LikeC4 o IcePanel ad Archyl in pochi minuti. Importa sistemi, container, componenti, relazioni e tecnologie automaticamente.

Importa progetti Structurizr, LikeC4 e IcePanel in Archyl con un solo clic

Se hai mai provato a spostare un progetto di architettura da uno strumento a un altro, conosci la procedura: ricreare ogni sistema a mano, ridisegnare ogni relazione, riscrivere ogni etichetta di tecnologia, e sperare di non aver dimenticato nulla. Per un codebase non banale, sono giorni di lavoro noioso — e un modo garantito per introdurre errori.

Questa frizione è la vera ragione per cui i team restano bloccati su strumenti che non li soddisfano più. Non perché lo strumento sia eccellente, ma perché andarsene è doloroso.

Oggi, tutto cambia. Archyl ora importa progetti di architettura direttamente da Structurizr DSL, LikeC4 e IcePanel — convertendo automaticamente il tuo intero modello C4 in un progetto Archyl completamente popolato in pochi minuti.

Tre formati, un unico flusso di importazione

La funzionalità di importazione di Archyl supporta i tre formati di modellazione C4 più diffusi, ciascuno con piena fedeltà strutturale.

Structurizr DSL

Structurizr, creato da Simon Brown (l'inventore del modello C4), è lo strumento più consolidato nell'ecosistema. I suoi file .dsl sono lo standard de facto per la modellazione architetturale basata su testo.

Archyl analizza il Structurizr DSL ed estrae:

  • Sistemi software e persone/attori con descrizioni complete
  • Container e componenti annidati all'interno dei sistemi
  • Rilevamento dei sistemi esterni basato sui tag
  • Tutte le relazioni usando la sintassi ->, con descrizioni e tecnologie
  • Tecnologie dagli argomenti posizionali
  • Tag dalle stringhe di tag separate da virgole

Se hai un workspace Structurizr esistente, puoi portarlo in Archyl senza perdere un singolo elemento o connessione.

LikeC4

LikeC4 è un approccio più recente e orientato agli sviluppatori per la modellazione C4, che utilizza file .c4 e .likec4 con un sistema di tipi flessibile. Sta crescendo rapidamente tra i team che vogliono qualcosa di più espressivo del DSL puro.

Ecco cosa rende notevole l'importazione LikeC4 di Archyl: nessun altro strumento importa file LikeC4. Archyl è il primo.

L'importatore gestisce le caratteristiche uniche di LikeC4:

  • Tipi di elementi personalizzati mappati ai concetti C4
  • Gerarchie di elementi annidati risolte in container e componenti
  • Rilevamento del tag #external per la classificazione dei confini
  • Proprietà technology: estratte e applicate
  • Sintassi #hashtag convertita in tag standard
  • Etichette e tecnologie delle relazioni completamente preservate

IcePanel

IcePanel è una piattaforma di modellazione C4 a orientamento visuale che esporta l'architettura come JSON. I team che utilizzano IcePanel per la creazione collaborativa di diagrammi possono ora portare i propri modelli in Archyl per una gestione dell'architettura più approfondita.

L'importatore di IcePanel mappa:

  • Tipi system a sistemi software, tipi actor a persone
  • Tipi app e store a container, tipi component a componenti
  • Campi external: true alla classificazione come sistema esterno
  • modelConnections a relazioni con metadati completi
  • Riferimenti tagIds risolti in nomi di tag

Come funziona

Il processo di importazione è progettato per essere veloce e flessibile.

Passo 1 — Apri il modale di importazione in un qualsiasi progetto Archyl (o creane uno nuovo).

Passo 2 — Seleziona il formato sorgente e carica il file oppure incolla il suo contenuto direttamente.

Passo 3 — Archyl valida l'input, analizza la struttura e ti mostra un'anteprima di ciò che verrà creato.

Passo 4 — Un clic. Il tuo progetto viene popolato con ogni sistema, container, componente, relazione e tecnologia dal file sorgente.

L'intero processo richiede meno di un minuto per la maggior parte dei progetti.

Per i flussi di lavoro con agenti IA

Se stai usando l'integrazione MCP di Archyl con Claude Code, Cursor, Windsurf, o qualsiasi altro agente di codifica IA, la stessa funzionalità di importazione è disponibile tramite lo strumento import_dsl.

Cosa ottieni dopo l'importazione

Importare il tuo modello è solo il punto di partenza. Una volta che la tua architettura vive in Archyl, sblocchi funzionalità che gli strumenti di origine semplicemente non offrono.

Rilevamento della deriva con IA — Archyl confronta continuamente la tua architettura documentata con il tuo codebase reale.

Regole di conformità dell'architettura — Definisci regole e Archyl le applica automaticamente, segnalando le violazioni.

Monitoraggio delle metriche DORA — Collega la tua architettura alle performance di delivery.

Architecture Decision Records — Documenta il perché dietro le tue scelte architetturali.

Gestione dei contratti API — Allega specifiche OpenAPI, gRPC e GraphQL ai tuoi container e componenti.

Gestione dei canali di eventi — Mappa i tuoi topic Kafka, gli exchange RabbitMQ e gli altri canali di comunicazione asincrona.

Integrazione MCP — Ogni agente di codifica IA del tuo team condivide lo stesso contesto architetturale.

Perché abbiamo costruito questo

Abbiamo parlato con decine di team che stavano valutando Archyl. Lo schema era sempre lo stesso: adoravano la piattaforma, ma temevano la migrazione.

Alcuni competitor offrono soluzioni parziali. IcePanel importa Structurizr JSON (non DSL). Ma nessuno importa LikeC4. E nessuno importa tutti e tre.

Abbiamo deciso di eliminare completamente la barriera alla migrazione. La funzionalità di importazione è disponibile su tutti i piani, incluso quello gratuito.

Inizia a importare oggi

Se hai un workspace Structurizr, un progetto LikeC4, o un'esportazione IcePanel nel tuo repository in questo momento, sei a pochi minuti da un progetto Archyl completamente operativo.

Prova la funzionalità di importazione — crea un account gratuito, apri il modale di importazione e porta con te la tua architettura.

La tua documentazione di architettura è troppo preziosa per essere riscritta. Importala.