Skip to content

Commit 894cd08

Browse files
mgiustinianimgiustiniani
committed
IT translation
1 parent eddde72 commit 894cd08

19 files changed

+11450
-0
lines changed

‎IT/asciidoc/arc42-template.adoc

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
// header file for arc42-template,
2+
// including all help texts
3+
//
4+
// ====================================
5+
6+
= image:arc42-logo.png[arc42] Template
7+
// toc-title definition MUST follow document title without blank line!
8+
:toc-title: Table of Contents
9+
10+
//additional style for arc42 help callouts
11+
ifdef::backend-html5[]
12+
++++
13+
<style>
14+
.arc42help {font-size:small; width: 14px; height: 16px; overflow: hidden; position: absolute; right: 0; padding: 2px 0 3px 2px;}
15+
.arc42help::before {content: "?";}
16+
.arc42help:hover {width:auto; height: auto; z-index: 100; padding: 10px;}
17+
.arc42help:hover::before {content: "";}
18+
@media print {
19+
.arc42help {display:none;}
20+
}
21+
</style>
22+
++++
23+
endif::backend-html5[]
24+
25+
// configure EN settings for asciidoc
26+
include::src/config.adoc[]
27+
28+
29+
include::src/about-arc42.adoc[]
30+
31+
// horizontal line
32+
***
33+
34+
[role="arc42help"]
35+
****
36+
[NOTE]
37+
====
38+
This version of the template contains some help and explanations.
39+
It is used for familiarization with arc42 and the understanding of the concepts.
40+
For documentation of your own system you use better the _plain_ version.
41+
====
42+
****
43+
44+
45+
// numbering from here on
46+
:numbered:
47+
48+
<<<<
49+
// 1. Introduction and Goals
50+
include::src/01_introduction_and_goals.adoc[]
51+
52+
<<<<
53+
// 2. Architecture Constraints
54+
include::src/02_architecture_constraints.adoc[]
55+
56+
<<<<
57+
// 3. System Scope and Context
58+
include::src/03_system_scope_and_context.adoc[]
59+
60+
<<<<
61+
// 4. Solution Strategy
62+
include::src/04_solution_strategy.adoc[]
63+
64+
<<<<
65+
// 5. Building Block View
66+
include::src/05_building_block_view.adoc[]
67+
68+
<<<<
69+
// 6. Runtime View
70+
include::src/06_runtime_view.adoc[]
71+
72+
<<<<
73+
// 7. Deployment View
74+
include::src/07_deployment_view.adoc[]
75+
76+
<<<<
77+
// 8. Concepts
78+
include::src/08_concepts.adoc[]
79+
80+
<<<<
81+
// 9. Design Decisions
82+
include::src/09_design_decisions.adoc[]
83+
84+
<<<<
85+
// 10. Quality Scenarios
86+
include::src/10_quality_scenarios.adoc[]
87+
88+
<<<<
89+
// 11. Technical Risks
90+
include::src/11_technical_risks.adoc[]
91+
92+
<<<<
93+
// 12. Glossary
94+
include::src/12_glossary.adoc[]
95+
96+

‎IT/asciidoc/src/01_introduction_and_goals.adoc

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
[[section-introduction-and-goals]]
2+
== Introduzione e obiettivi
3+
4+
[role="arc42help"]
5+
****
6+
Descrive i requisiti rilevanti e le forze trainanti che gli architetti del software e il team di sviluppo devono considerare. Questi includono
7+
8+
* obiettivi di business sottostanti, caratteristiche essenziali e requisiti funzionali per il sistema
9+
* obiettivi di qualità per l'architettura
10+
* stakeholder rilevanti e le loro aspettative
11+
****
12+
13+
=== Panoramica dei requisiti
14+
15+
[role="arc42help"]
16+
****
17+
.Contenuti
18+
Breve descrizione dei requisiti funzionali, forze trainanti, estratto (o abstract) dei requisiti.
19+
Collegamento ai documenti dei requisiti (si spera esistenti)
20+
(con il numero di versione e le informazioni su dove trovarlo).
21+
22+
.Motivazione
23+
Dal punto di vista degli utenti finali un sistema viene creato o modificato per
24+
migliorare il supporto di un'attività di business e/o migliorare la qualità.
25+
26+
.Forma
27+
Breve descrizione testuale, casi d'uso in forma tabellare.
28+
Se esistono documenti sui requisiti, questa panoramica dovrebbe fare riferimento a questi documenti.
29+
30+
Mantieni questi estratti il ​​più brevi possibile.
31+
Bilancia la leggibilità di questo documento con la potenziale ridondanza rispetto ai documenti dei requisiti.
32+
****
33+
34+
=== Obiettivi di qualità
35+
36+
[role="arc42help"]
37+
****
38+
.Contenuti
39+
I principali tre (massimo cinque) obiettivi di qualità per l'architettura
40+
la cui realizzazione è della massima importanza per i principali stakeholder,
41+
Intendiamo davvero obiettivi di qualità per l'architettura.
42+
Non confonderli con gli obiettivi del progetto. Non sono necessariamente identici.
43+
44+
.Motivazione
45+
Dovresti conoscere gli obiettivi di qualità dei tuoi stakeholder più importanti,
46+
poiché influenzeranno le decisioni architettoniche fondamentali.
47+
Assicurati di essere molto concreto su queste qualità, evita le parole d'ordine.
48+
Se tu come architetto non sai come verrà giudicata la qualità del tuo lavoro
49+
50+
.Forma
51+
Una tabella con obiettivi di qualità e scenari concreti, ordinati per priorità
52+
****
53+
54+
=== Stakeholders
55+
56+
[role="arc42help"]
57+
****
58+
.Contenuti
59+
60+
Panoramica esplicita degli stakeholder del sistema, ovvero tutte le persone, i ruoli o le organizzazioni che
61+
62+
* dovrebbero conoscere l'architettura
63+
* devono essere convinti dell'architettura
64+
* devono lavorare con l'architettura o con il codice
65+
* necessitano della documentazione dell'architettura per il loro lavoro
66+
* devono prendere decisioni sul sistema o sul suo sviluppo
67+
68+
.Motivazione
69+
È necessario conoscere tutte le parti coinvolte nello sviluppo del sistema o interessate dal sistema.
70+
Altrimenti, potresti ricevere brutte sorprese più avanti nel processo di sviluppo.
71+
Questi stakeholder determinano la portata e il livello di dettaglio del tuo lavoro e dei suoi risultati.
72+
73+
.Forma
74+
Tabella con i nomi dei ruoli, i nomi delle persone e le loro aspettative rispetto all'architettura e alla sua documentazione
75+
****
76+
77+
[options="header",cols="1,2,2"]
78+
|===
79+
|Rouolo/Nome|Contatto|Aspettative
80+
| _<Ruolo-1>_ | _<Contatto-1>_ | _<Aspettatiive-1>_
81+
| _<Ruolo-2>_ | _<Contatto-2>_ | _<Aspettatiive-2>_
82+
|===

‎IT/asciidoc/src/02_architecture_constraints.adoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
[[section-architecture-constraints]]
2+
== Vincoli di architettura
3+
4+
5+
[role="arc42help"]
6+
****
7+
.Contenuti
8+
Qualsiasi requisito che limiti gli architetti del software nella loro libertà di decisioni di progettazione
9+
e implementazione o decisione sul processo di sviluppo.
10+
Questi vincoli a volte vanno oltre i singoli sistemi e sono validi per intere organizzazioni e aziende.
11+
12+
.Motivazione
13+
Gli architetti dovrebbero sapere esattamente dove sono liberi nelle loro decisioni di progettazione e dove devono aderire ai vincoli.
14+
I vincoli devono essere sempre affrontati; possono essere negoziabili però.
15+
16+
.Forma
17+
Semplici tabelle di vincoli con spiegazioni.
18+
Se necessario puoi suddividerli in file
19+
vincoli tecnici, vincoli organizzativi e politici e
20+
convenzioni (ad es. linee guida di programmazione o di controllo delle versioni, documentazione o convenzioni di denominazione)
21+
****

‎IT/asciidoc/src/03_system_scope_and_context.adoc

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
[[section-system-scope-and-context]]
2+
== Ambito e contesto del sistema
3+
4+
5+
[role="arc42help"]
6+
****
7+
.Contenuti
8+
L'ambito e il contesto del sistema, come suggerisce il nome, delimitano il sistema (ovvero l'ambito) da tutti i suoi partner di comunicazione
9+
(sistemi e utenti vicini, ovvero il contesto del tuo sistema). In tal modo specifica le interfacce esterne.
10+
11+
Se necessario, differenziare il contesto di business (input e output specifici del dominio) dal contesto tecnico (canali, protocolli, hardware).
12+
13+
.Motivazione
14+
Le interfacce di dominio e le interfacce tecniche per i partner di comunicazione sono tra gli aspetti più critici del sistema. Assicurati di capirli completamente.
15+
16+
.Forma
17+
Diverse opzioni:
18+
19+
* Diagrammi di contesto
20+
* Elenchi di partner di comunicazione e loro interfacce.
21+
****
22+
23+
24+
=== Contesto di Business
25+
26+
[role="arc42help"]
27+
****
28+
.Contenuti
29+
Specifica di *tutti* i partner di comunicazione (utenti, sistemi IT, ...) con spiegazioni di input e output specifici del dominio o interfacce.
30+
Facoltativamente è possibile aggiungere formati specifici del dominio o protocolli di comunicazione.
31+
32+
.Motivazione
33+
Tutti gli stakeholder dovrebbero capire quali dati vengono scambiati con l'ambiente del sistema.
34+
35+
.Forma
36+
Tutti i tipi di diagrammi che mostrano il sistema come una scatola nera e specificano le interfacce di dominio per i partner di comunicazione.
37+
38+
39+
In alternativa (o in aggiunta) puoi usare una tabella.
40+
Il titolo della tabella è il nome del sistema, le tre colonne contengono il nome del partner di comunicazione, gli ingressi e le uscite.
41+
****
42+
43+
**<Diagramma o Tabella>**
44+
45+
**<opzionale: spiegazione delle interfacce del dominio esterno>**
46+
47+
=== Contesto Tecnico
48+
49+
[role="arc42help"]
50+
****
51+
.Contenuti
52+
Interfacce tecniche (canali e mezzi di trasmissione) che collegano il sistema al suo ambiente.
53+
Oltre alla mappatura dell'input/output specifico del dominio sui canali di comunicazione, ad es. una spiegazione con I/O dell'utilizza del canale di comunicazione.
54+
55+
.Motivazione
56+
Spesso, gli stakeholders prendono decisioni architetturali in base alle interfacce tecniche tra il sistema e il suo contesto. Sono, principalmente i progettisti di infrastrutture o hardware che decidono queste interfacce tecniche.
57+
58+
.Forma
59+
Esempio: un deployment diagram UML che descrive i canali di comunicazione dei sistemi vicini,
60+
insieme a una tabella di mappatura che mostra le relazioni tra canali e input/output.
61+
62+
****
63+
64+
**<Diagramma o Tabella>**
65+
66+
**<opzionale: Spiegazione delle interfacce tecniche>**
67+
68+
**<Mappatura Input/Output sui canali di comunicazione>**

‎IT/asciidoc/src/04_solution_strategy.adoc

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
[[section-solution-strategy]]
2+
== Strategia della soluzione
3+
4+
5+
[role="arc42help"]
6+
****
7+
.Contenuti
8+
Un breve riassunto e spiegazione delle decisioni fondamentali e delle strategie di soluzione che modellano l'architettura del sistema. Questi includono
9+
10+
* decisioni tecnologiche
11+
* decisioni sulla scomposizione di primo livello del sistema, ad es. utilizzo di un modello architetturale o di un modello di progettazione
12+
* decisioni su come raggiungere gli obiettivi chiave di qualità
13+
* decisioni organizzative rilevanti, ad es. selezionare un processo di sviluppo o delegare determinati compiti a terzi.
14+
15+
.Motivazione
16+
Queste decisioni costituiscono le pietre angolari della tua architettura. Sono la base per molte altre decisioni dettagliate o regole di attuazione.
17+
18+
.Forma
19+
Mantieni breve la spiegazione di queste decisioni chiave.
20+
21+
Motiva ciò che hai deciso e perché lo hai deciso in questo modo,
22+
in base alla dichiarazione del problema, agli obiettivi di qualità e ai vincoli chiave.
23+
Fare riferimento ai dettagli nelle sezioni seguenti.
24+
****

0 commit comments

Comments
 (0)