Come documentare / verificare una stratificazione coerente?

Question

Come documentare / verificare una stratificazione coerente?

#1 da (6 voti)
#2 da (2 voti)

5

Recentemente sono passato al lato oscuro: ora sono un CLIENTE dello sviluppo del software, principalmente siti web. Con questo nuovo ruolo arrivano nuove preoccupazioni.

Come programmatore, conosco la solidità di un'applicazione quando è correttamente stratificata e desidero utilizzare questa conoscenza nel mio nuovo lavoro. Non voglio la logica aziendale nel mio livello di presentazione, e certamente non le presentazioni nel mio livello dati. Pertanto, voglio essere in grado di esigere dal mio supporto che essi documentino il livello di stratificazione e quanto sia precisa e coerente la stratificazione.

La grande domanda è: in che modo il livello di stratificazione mi è stato documentato come cliente, ed è un ragionevole demanda per me, quindi non devo cercare nel codice (non dovrei farlo più)?

design-patterns documentation layers

posta Morten 21.11.2011 - 10:31

fonte

2 risposte

2

Hai lavorato come programmatore, probabilmente hai visto i progetti fallire / impiegare più tempo del previsto e sai che non lo vuoi come client.

Hai tutto il diritto di esigere una cosa del genere.

Ciò che suggerirei è che, oltre a documentare i livelli dell'applicazione, far eseguire loro i test di unità / intergrazione di fronte a voi.

Come organizzano i loro test ti diranno di più sul codice oltre alla documentazione e non dovrai nemmeno vederlo.

risposta data 21.11.2011 - 10:47

fonte

Leggi altre domande sui tag design-patterns documentation layers

Devo restituire iteratori o oggetti più sofisticati? Calcolo delle pietre miliari / Elenco delle attività

score 6 · Accepted Answer

Questo è ragionevole: come cliente puoi richiedere tutto ciò che vuoi, e usare una buona stratificazione come indicazione della qualità del codice e della separazione delle preoccupazioni è un requisito valido.

Ci sono molti strumenti che aiuteranno questa documentazione - alcuni di loro produrranno un'immagine del Grafico Aciclico Diretto , mostrandoti che i livelli inferiori non stanno chiamando i livelli più in alto. Alcuni strumenti di analisi statici lo faranno anche.

Ottenere una rappresentazione del DAG è probabilmente ciò che ti darà la più grande idea di come funzioni la stratificazione nel codice base.

Nel mondo .NET, NDepend è un buon strumento commerciale che aiuterà a visualizzare l'architettura di alto livello e la stratificazione di un'applicazione.