Guia PES

Eines

Taiga i GitHub, configurats com cal des del primer dia

Són les dues eines que es miren a cada lliurament. Si les configureu bé a l'inici, us estalviareu feina (i punts) durant tot el curs.

Taiga, pas a pas

  1. Creeu el projecte amb la plantilla Scrum (a PES no es fa servir la Kanban) i marqueu-lo com a públic.
  2. Afegiu tots els membres a Settings → Members.
  3. Mòduls (Settings → Project → Modules): activeu Epics, Scrum, Issues i Wiki. A Scrum, poseu 3 sprints esperats i, si el teniu, el total de punts.
  4. Atributs (Settings → Attributes): estats, punts, prioritats, tipus i tags, com vulgueu. Els camps personalitzats sí que són obligatoris.
  5. Èpiques: identifiqueu-ne unes quantes, cadascuna amb el seu color.
  6. Product backlog: cada història amb la plantilla Com a… vull… de manera que…, lligada a una èpica (obligatori), amb punts i amb els criteris d'acceptació numerats (1., 2., 3.). Al product backlog els criteris encara poden estar buits.
  7. Ordeneu el backlog per prioritat.
  8. Sprint: Add sprint amb les dates, arrossegueu-hi les històries i obriu el Sprint taskboard.
  9. Tasques: dins de cada història, amb les hores estimades (Estimated Effort) i assignades a mesura que es fan.
  10. Tanqueu les tasques arrossegant-les a Closed i ompliu les hores reals (Actual Effort). Quan totes estan tancades, la història es tanca sola i el burndown s'actualitza.

Camps personalitzats obligatoris

Settings → Attributes → Custom fields.

OnCampTipus
User storyPriorityDropdown: Low, Medium, High
User storyAcceptance CriteriaRich text
TaskEstimated EffortNumber (hores)
TaskActual EffortNumber (hores)

Podeu afegir-ne més si us són útils, però expliqueu-los a la documentació.

Recomanacions

  • Configureu el nombre de sprints i els punts esperats: així Taiga dibuixa bé el gràfic del backlog.
  • Personalitzeu els estats de les històries i de les tasques perquè encaixin amb la vostra definició de fet.
  • Les integracions (GitHub, webhooks) i els plugins són opcionals: proveu-los quan el projecte ja rutlli.
No us oblideu de l'Actual Effort. Sense hores reals no hi ha comparació amb l'estimació, i és una de les coses que es revisen.

Com es lliura Taiga a cada Fag

Els professors no corregeixen el projecte on treballeu cada dia, sinó una còpia congelada de com estava en acabar l'sprint.

  1. En acabar l'sprint, Settings → Project → Export: es descarrega una còpia del projecte.
  2. New project → Import project → Taiga amb aquesta còpia, amb un nom que digui quin sprint és (p. ex. BiciVerda sprint 1).
  3. Compartiu el projecte restaurat amb els professors.
  4. No el toqueu mai més: els projectes lliurats han de quedar immutables. Seguiu treballant a l'original.

Abans de fer l'export

0/6

GitHub, pas a pas

  1. L'organització del vostre grup ja existeix i segueix el patró pes2627q1-<grup>-gei-upc (p. ex. pes2627q1-11-gei-upc). Demaneu al vostre professor que hi afegeixi tots els membres.
  2. Creeu el repositori dins l'organització (New repository). Públic o privat, com vulgueu.
  3. Afegiu-hi l'equip: Settings → Collaborators → Add people, amb el rol Write, Maintain o Admin.
  4. Una persona crea el projecte en local amb l'ordre del framework (flutter create, npm create vite, django-admin startproject...) i el puja.
  5. La resta el clona i ja podeu treballar en branques.
Un repositori o més? Si feu servir tecnologies diferents, millor més d'un: el cas típic és un per al frontend i un per al backend. Qualsevol opció és vàlida si la justifiqueu a la documentació.

Si l'eina ja ha creat la carpeta .git:

cd bici-verda-app
git remote add origin https://github.com/pes2627q1-11-gei-upc/bici-verda-app.git
git branch -M main
git push -u origin main

Canvieu el grup i el nom del repositori pels vostres.

Prova-ho

Revisor de missatges de commit

Cada commit ha de portar l'identificador de la tasca de Taiga, i tothom ha de fer commits sovint i de manera equilibrada, encara que programeu en parella. Escriviu un missatge i mireu quines regles compleix.

0/50

Les regles

    Lectura recomanada: How to Write a Git Commit Message.

    Gitflow o GitHub Flow?

    Trieu-ne un, escriviu-lo a la memòria i seguiu-lo. Tots dos funcionen a PES.

    Més estructura

    Gitflow

    main amb les versions lliurades, develop per integrar, i branques feature/*, release/* i hotfix/*. Encaixa amb lliuraments planificats com els finals d'sprint.

    Vegeu-ne el diagrama →

    Més simple

    GitHub Flow

    Només main i branques curtes: creeu la branca, feu commits, obriu una pull request, rebeu revisió, proveu i fusioneu. Ideal si teniu integració i desplegament continus.

    mainfeature commitsPRmerge