Sessió A2: Sistema de Control de Versions

2 d'Octubre

Objectius

• Apendre a manegar i entendre la utilitat d'un sistema de control de versions
• Elaboració del glossari de domini
• Conèixer eines CASE que suportin diagrames UML

Introducció teòrica: el document de requeriments

El glossari

Els stakeholders poden fer servir diferents termes per referir-se a un mateix concepte o fan servir els mateixos termes per identificar conceptes amb diferents matisos.

Un glossari és un bon complement del document de requeriments perquè redueix aquest tipus d'ambigüetats. Per un costat, el fet de definir els conceptes del domini ens obliga a entendre-ho, per un altre costat, amb una definició clara, els stakeholders ens poden corregir als analistes si anem errats.

Actors primaris y actors de suport

Actor: Quelcom (persona, sistema extern...) que interactua amb el sistema en consideració. En un determinat cas d'ús, els actors que intervenen són:

• Actor primari: Si és l'actor qui inicia la interacció amb el sistema en consideració.
• Actor de suport: Si és el sistema en consideració qui inicia la interacció amb ell.

Eines CASE

• svn (subversion) i kdesvn(un client grafic). Us hem preparat aquest tutorial.
• dia i umbrello per editar diagrames UML
• kate (o kwrite) i eclipse per editar fitxers de text pla amb coloració de sintaxis.
  El text plà és la forma més ràpida d'escriure documentació...

  ja que ens despreocupem de molts temes de sintaxi del format. Per altra banda, la visualització del document és més monòtona i no podem posar links més anllà de simples etiquetes i referències.

  Una bona estratègia és començar amb format de text i quan es té el contingut, passar-ho a html o a LaTeX.

• kate (o kwrite) i quanta per editar html
  Intenteu escriure el codi html més net possible

  Us recomanem que no us preocupeu gaire pel formateig i molt més per l'estructura i contingut del document.

  Ara, si voleu personalitzar l'estil, us recomanem que no feu servir altra cosa que estils CSS. Feu una ullada al codi font d'aquesta web si busqueu un exemple. També us pot servir de cara a un exemple de com fer links dins el document (a la pàgina principal index.html n'hi ha uns quants).

Tasques

Treballant amb Subversion:

A partir d'aquesta sessió, haureu de treballar la pràctica amb el subversion. És important que aneu fent commits sovintejats (és un criteri que evaluarem).

1. SVN Feu aquest tutorial de subversion que hem posat a la wiki. Recordeu que la wiki és editable, podeu completar el tutorial amb troballes vostres.
2. A classe posareu en comú els dubtes (punts foscos) que teníem sobre el sistema. Els professors us donaran les respostes dels stakeholders.
3. Redacteu la llista de stakeholders, tot indicant en forma de fitxa:
   • Nom y email de contacte (us ho inventeu)
   • Càrrec o rol que exerceix
   • Justificació com a stakeholder (informació que ens pot donar, responsabilitat, paper en el sistema...)
   • Motivacions i viaix (Allò que pot afectar la veracitat de les seves respostes)
   • (Opcional) Guió per una possible entrevista
4. Elaboreu un glossari de termes del domini
5. Identifiqueu els casos d'ús del sistema indicant quins actors (primaris i de suport) té.
6. Afegiu una descripció acurada del cas d'ús.

Nota:

Com que a l'enunciat no tenim gaire informació concreta haureu de fer servir la imaginació. Fent servir el sentit comú, això sí.

Al món real també té sentit "inventar-se" alguns requeriments no funcionals, ja que serveix com a proposta concreta que el client haurà de validar (o no).