Els diagrames que es demanen, amb un exemple complet
L'àgil no gira al voltant dels models, però alguns aporten molt i formen part de la documentació. Tots els exemples són d'una mateixa app inventada que complementa el Bicing amb dades d'Open Data BCN.
Els conceptes principals del problema, independents de l'arquitectura i de la tecnologia. Es valora que hi hagi conceptes creatius i propis, no només els del conjunt de dades obertes.
Fixeu-vos: només Estació ve de les dades obertes. Trajecte i Insígnia són conceptes nous de l'equip, i és aquí on hi ha el valor del producte.
Restriccions d'integritat sempre a sota del diagrama, numerades: claus i regles que el diagrama no pot expressar.
Opcional · recomanat
Diagrama de classes de la capa de domini
La lògica de la solució dins una arquitectura en tres capes, ja amb patrons de disseny aplicats i operacions. Expliqueu quins patrons feu servir i per què.
Obligatori · Fag-2 i sprints
Diagrama físic (arquitectura)
Els nodes i subsistemes del sistema: app, servidor, base de dades, serveis externs i el servei que feu per a un altre equip. Un esbós a la incepció que aneu refinant a cada sprint.
Opcional
Diagrama de components (UML)
Una visió simplificada de tot el sistema i de les relacions entre components.
Obligatori · sprints
Esquema de la base de dades
Un diagrama de classes que descriu l'esquema. En relacional, la clau primària subratllada i les foranes entre parèntesis (FK). En NoSQL, feu servir composició per als documents incrustats i associació per a les referències.
L'esquema canviarà a cada sprint: gestioneu-ne l'evolució amb fitxers SQL de create i alter o amb un framework de migracions (Liquibase, migracions de Django o de Laravel, mysql-migrations per a Node). Més aspectes tècnics →
Errors típics als models
Posar tecnologia al model conceptual (tipus SQL, IDs autoincrementals, "Controller").
Fer servir un atribut on hi hauria d'haver una associació (un idEstacio dins de Trajecte).
Oblidar les multiplicitats o les restriccions d'integritat textuals.
Un model que és una còpia de les columnes del conjunt de dades obertes.
Diagrames que no s'actualitzen quan canvia el codi: forma part de la definició de fet.
Captures borroses: exporteu en SVG o PNG a bona resolució.