Scriverò il documento di progettazione del sistema, l'architettura software e le specifiche tecniche
Documentazione tecnica e automazione dei dati per team di sviluppo software
Informazioni su questo servizio
Scrivimi pure in italiano.
Tra sei mesi qualcuno chiederà perché il sistema funziona in questo modo. Se nessuno ha scritto la ragione, il team o lo ricostruirà o avrà paura di toccarlo.
Scrivo il documento che risponde a quella domanda prima che venga posta.
COSA OTTIENI
- Il problema che il sistema risolve e i vincoli a cui è soggetto
- Componenti, responsabilità e come comunicano tra loro
- Modello dei dati e i principali flussi attraverso il sistema
- Diagrammi: context, container e sequence, in C4 o UML semplice
- Obiettivi non funzionali: scalabilità, latenza, disponibilità, costi
- Le opzioni che non hai scelto e perché - architetture decision records (Premium)
CHI ACQUISTA QUESTO
Fondatori che hanno bisogno di qualcosa di credibile per un investitore tecnico o un candidato CTO. Team che consegnano un sistema a un altro team. Agenzie che devono mostrare a un cliente cosa è stato costruito.
Sono un ingegnere del software, non uno scrittore che ha letto di architettura. Se il tuo progetto ha un problema, lo sentirai da me prima di sentirlo in produzione.
Tipo di documento:
Documentazione
•
Specifiche tecniche
Settore:
Software
Lingua:
Inglese
•
Italiana
Preferenza per lo stile di consegna
Informa il freelance di eventuali preferenze o preoccupazioni relative all'uso di strumenti di IA nel completamento e/o nella consegna dell'ordine.
Il mio portfolio
FAQ
Traduzione automatica.
Puoi scrivere un ADR per una decisione già presa?
Sì, e questa è la maggior parte del lavoro. Intervisto chi ha preso la decisione, ricostruisco le opzioni e i vincoli come erano all'epoca, e registro le conseguenze che hai visto da allora. Gli ADR compilati successivamente sono comunque utili.
Decidi l'architettura o la documenti solo?
Documenterò la tua decisione. Indicherò un compromesso che non hai scritto, o una conseguenza che sembra sottovalutata, ma la scelta rimane tua. Se preferisci consulenza sull'architettura, scrivimi e ti dirò se sono la persona giusta.
Quale strumento usi per i diagrammi?
Di default Mermaid o PlantUML, così il diagramma vive nel repository come testo e rimane revisionabile nelle pull request. Se preferisci draw.io o Excalidraw, consegno il file sorgente modificabile per quelli.

