Skip to content

Millora del flux d'instal·lació Demo Docker i experiència d'usuari (UX)#353

Merged
amorilla merged 14 commits intoctrl-alt-d:masterfrom
rafatecno1:millora-demo
Feb 7, 2026
Merged

Millora del flux d'instal·lació Demo Docker i experiència d'usuari (UX)#353
amorilla merged 14 commits intoctrl-alt-d:masterfrom
rafatecno1:millora-demo

Conversation

@rafatecno1
Copy link
Contributor

🚀 Descripció
Aquesta PR introdueix una actualització profunda en el procés de desplegament de la demo mitjançant Docker. L'objectiu principal és eliminar la dependència de la intervenció manual de l'usuari durant la preparació de la base de dades i millorar la visibilitat del procés.

S'ha passat d'un sistema que "segrestava" la terminal amb logs en brut a un instal·lador assistit que monitoritza l'estat dels contenidors i finalitza automàticament quan el servei està llest.

✨ Canvis principals

  • Nou Script Llançador (install_demo_docker.sh): Substitueix l'antic script "quick". Ara utilitza una estructura de variables de ruta més sòlida (BASE_DIR) i gestiona la clonació de la branca específica de forma neta.
  • Monitorització de Logs Intel·ligent: S'ha implementat un bucle de lectura de logs en Bash que:
    • Mostra el progrés en un color diferenciat (gris) per separar els logs de l'aplicació dels missatges del script.
    • Detecta automàticament quan Django està "Ready" i finalitza el procés sense requerir CTRL+C per part de l'usuari.
  • Millora en carrega_inicial.sh: * S'ha substituït wait-for-it per una comprovació nativa amb pg_isready.
    • S'ha integrat una lògica de timeout (60s) i comptador de segons per informar exactament de quant triga la base de dades a estar operativa.
  • Correcció al Dockerfile: S'ha afegit el paquet postgresql-client per permetre que les comprovacions de salut de la base de dades funcionin correctament des del contenidor web.

🛠️ Com provar-ho

  1. Executar la nova comanda d'instal·lació:
mkdir demo-djau-docker && cd demo-djau-docker && wget -q -O install_demo_docker.sh https://raw.githubusercontent.com/rafatecno1/django-aula/refs/heads/millora-demo/docker/install_demo_docker.sh && chmod +x install_demo_docker.sh && bash ./install_demo_docker.sh
  1. Observar com els logs es mostren de forma elegant i el script ens torna el control de la terminal automàticament un cop la web és accessible.

📌 Notes addicionals
Aquesta és la primera de dues PRs previstes. En una segona fase es realitzarà la neteja de fitxers obsolets (.old, variants de Compose i Makefiles antics) i l'actualització de la documentació README per reflectir aquest nou flux simplificat.

Nota sobre les variables: He deixat les variables REPO_USER i REPO_BRANCA, a l'inici del script, apuntant al meu fork per facilitar el testejat directe. Un cop validat el funcionament, es poden revertir al repositori oficial abans del merge.

@amorilla amorilla self-requested a review February 7, 2026 09:15
Copy link
Collaborator

@amorilla amorilla left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Em sembla bé.
Millor fer els canvis definitius ara i no amb una PR posterior.
Fes un commit amb els canvis al README i al nom del repositori i la branca.

@amorilla amorilla merged commit 675e8a9 into ctrl-alt-d:master Feb 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants