🤖 Preparació de l’entorn de treball
XatBot Talent 2026 · Araceli Saldaña · CFGM Sistemes Microinformàtics i Xarxes
Un entorn ben organitzat redueix els errors, facilita la incorporació de nous membres i demostra responsabilitat professional. Aquests hàbits de traçabilitat i control de versions són imprescindibles en qualsevol entorn laboral real del sector IT.
Permet desenvolupar el model de llengua amb GPU al núvol i connectar-lo amb GitHub per mantenir la traçabilitat de cada versió sense pujar fitxers manualment.
GitHub garanteix traçabilitat, reversibilitat i col·laboració paral·lela. El fork assegura una base sòlida adaptada al nou context de TalentFP 2026.
Els noms exactes dels fitxers faciliten la correcció i l’avaluació, i reflecteixen les bones pràctiques del sector TIC.
README, CHANGELOG i CONTRIBUTING en Markdown garanteixen documentació llegible des de GitHub, fàcil de mantenir per qualsevol membre.
- Fork:
xatbot-Repte1.4forcat deInstitut-Castellbisbal/xatbot-2026-equip-5 - Backend:
Araceli_XatBot_Talent2026.ipynb— vinculat via OAuth amb Google Colab - Frontend:
Widget_Araceli.html— interfície web del XatBot per a WordPress - Documentació:
README.md·CHANGELOG.md·CONTRIBUTING.md - Branca
main· tots els commits verificats · autoriaaraceliii-i
// estructura del repositori
| Fitxer | Funció |
|---|---|
Araceli_XatBot_Talent2026.ipynb | Backend principal — lògica de la IA |
Widget_Araceli.html | Frontend — widget per al WordPress |
Models_disponibles.ipynb | Comparativa de models de Gemini |
README.md | Documentació general del projecte |
CHANGELOG.md | Registre de versions i canvis |
CONTRIBUTING.md | Guia per a col·laboradors |
El README presenta el projecte de forma professional: descripció, objectius, requisits, estructura, posada en marxa, flux de dades Mermaid i seguretat de l’API Key.
// contingut destacat
- Descripció del projecte i context TalentFP 2026
- Objectius finals i procedimentals detallats
- Taula de requisits previs amb emojis i enllaços
- Taula d’estructura del repositori amb tots els fitxers
- Posada en marxa: Backend (Colab) i Frontend (Widget)
- Diagrama Mermaid del flux de dades renderitzat automàticament
- Secció de seguretat: API Key als Secrets de Colab
- Enllaç al portafolis de WordPress
// registre de canvis · [1.0.0] · 2026-03-25
- Fork del repositori mitjançant una còpia del projecte anterior
- Adaptació dels noms dels fitxers a la normativa del Repte 1.4
- Connexió via OAuth amb Google Colab per a la traçabilitat
- Configuració de seguretat per a l’API Key de Gemini als Secrets de Colab
// convenció de commits
✓ feat: afegida resposta per a preguntes fora de context ✓ fix: corregit error de connexió amb ngrok ✓ docs: actualitzat README amb flux de dades
✗ canvis✗ update✗ coses✗ arreglos
// normes clau
- Tot el codi s’edita i executa des de Google Colab
- Es desa a GitHub via OAuth — mai manualment
- Prohibit escriure l’API Key directament al codi
- Nomenclatura:
Araceli_XatBot_Talent2026.ipynbiWidget_Araceli.html - Millores via Issue → branca → Pull Request cap a
main
La vinculació entre Google Colab i GitHub via OAuth garanteix que cada modificació queda registrada automàticament com un commit verificat. El commit Created using Colab confirma la connexió OAuth activa.
- Colab autoritzat amb compte GitHub via OAuth
- Commit
Created using Colabconfirma la vinculació activa - Tots els commits marcats com a Verified
- API Key de Gemini als Secrets de Colab — cap credencial al repositori
| Criteri rúbrica | Evidència aportada | Nivell |
|---|---|---|
| Justificació i Reflexió | Explicació profunda de GitHub, Colab i organització professional | PRO+ |
| Configuració i fitxers | Fork · nomenclatura oficial · OAuth funcional · commits verificats | PRO+ |
| Documentació Markdown | README · CHANGELOG · CONTRIBUTING amb format impecable | PRO+ |
| Evidències | 5 captures pròpies · organitzades · rellevants · comentades | PRO+ |
araceliii-i/xatbot-Repte1.4
Branca main · commits verificats