Bloc 4 - Documentació i Presentació¶

Total tasques: 20
Durada aprox: 6 setmanes
Dates orientatives: Setmana 21–28

Índex¶

• Visió general
• Enllaços ràpids a enunciats
• Sprints
• Resum de sprints - Taula comparativa
• Artefactes i ubicacions
• Checklist final Bloc 4

Visió general¶

Objectiu: documentar l'arquitectura, instal·lació, APIs i manuals d'usuari; preparar informes i presentació final amb demo.

Enllaços ràpids a enunciats¶

• Tasca 4.1 - Manual tècnic - Arquitectura
• Tasca 4.2 - Manual tècnic - Instal·lació
• Tasca 4.3 - Manual tècnic - Configuració
• Tasca 4.4 - Manual tècnic - Base de dades
• Tasca 4.5 - Manual tècnic - APIs
• Tasca 4.6 - Manual d'usuari - Introducció
• Tasca 4.7 - Manual d'usuari - Funcionalitats
• Tasca 4.8 - Manual d'usuari - Troubleshooting
• Tasca 4.9 - Manual d'usuari - Casos d'ús
• Tasca 4.10 - Documentació codi - Comentaris
• Tasca 4.11 - README.md
• Tasca 4.12 - API docs Swagger
• Tasca 4.13 - Diagrames tècnics actualitzats
• Tasca 4.14 - Informe final - Resum executiu
• Tasca 4.15 - Informe final - Metodologia
• Tasca 4.16 - Informe final - Resultats
• Tasca 4.17 - Informe final - Conclusions
• Tasca 4.18 - Informe final - Millores futures
• Tasca 4.19 - Presentació executiva
• Tasca 4.20 - Demo interactiva

Sprints¶

Sprint 1 - Manuals tècnics i README¶

• Dates: Setmana 21–22
• Tasques principals:
  • 4.2, 4.3, 4.5, 4.11
• Entregables:
  • docs/manuals/instalacio.md, docs/manuals/configuracio.md, docs/api/swagger.yaml, README.md
• Criteris d'acceptació: instruccions reproductibles, Swagger funcional, README complet

Sprint 2 - Manuals d'arquitectura i BD¶

• Dates: Setmana 23–24
• Tasques principals:
  • 4.1, 4.4, 4.13
• Entregables:
  • docs/manuals/arquitectura.md, docs/bd/, docs/diagrams/
• Criteris d'acceptació: diagrames fidel a la implementació, scripts BD complets

Sprint 3 - Manuals d'usuari, presentació i demo¶

• Dates: Setmana 24–26
• Tasques principals:
  • 4.6, 4.7, 4.8, 4.9, 4.19, 4.20
• Entregables:
  • docs/user_manuals/, presentation/, demo/
• Criteris d'acceptació: manuals amb captures, presentació 15–20 min, demo preparada

Sprint 4 - Informes finals i millores futures¶

• Dates: Setmana 26–28
• Tasques principals:
  • 4.14, 4.15, 4.16, 4.17, 4.18
• Entregables:
  • reports/final/ (PDFs), roadmap de millores
• Criteris d'acceptació: informes complets, roadmap prioritzat

Resum de sprints - Taula comparativa¶

Artefactes i ubicacions¶

• docs/manuals/ (instal·lació, configuració, arquitectura, user manuals)
• docs/api/swagger.yaml i docs/api/swagger-ui/
• docs/diagrams/ (UML finals)
• presentation/ (slides PPTX/PDF)
• demo/ (scripts, dades i vídeo)

Checklist final Bloc 4¶

• docs/manuals/ completes (instal·lació, configuració, arquitectura, BD)
• README.md complet amb badges i instruccions
• Swagger / OpenAPI disponible i funcional (docs/api/)
• Manuals d'usuari amb captures i guies pas a pas
• Diagrames UML finals a docs/diagrams/
• Presentació preparada i demo provada
• Informes finals (resum executiu, metodologia, resultats, conclusions, millores) generats en reports/final/