Repte 1.4 · XatBot TalentFP · GitHub + Google Colab
Preparació de
l’Entorn de Treball
Procés complet de preparació de l’entorn de treball per al XatBot TalentFP: Fork del repositori, canvi de noms, vinculació Colab–GitHub i actualització de la documentació tècnica.
Objectiu de l’apartat
Introducció
Aquest apartat mostra tot el procés de preparació de l’entorn de treball utilitzat per desenvolupar el XatBot TalentFP. L’objectiu principal ha estat crear una estructura organitzada que permeti treballar de manera més eficient, segura i professional utilitzant eines de desenvolupament col·laboratiu com GitHub i Google Colab.
Duplicació del repositori · Fork
Procés de Fork
Per començar el projecte, he reutilitzat el repositori creat al repte anterior (1.3) per aprofitar part del treball ja desenvolupat. Mitjançant la funció “Fork” de GitHub, he creat una còpia personal del repositori per adaptar-lo al nou context TalentFP sense modificar el projecte original.
Canvi de nom dels fitxers principals
Nomenclatura establerta per la rúbrica
Una vegada creat el nou repositori, s’han modificat els noms dels fitxers principals seguint exactament la nomenclatura indicada a la rúbrica del projecte. Per modificar els noms, s’ha utilitzat l’opció d’edició de GitHub mitjançant la icona del llapis.
Vinculació Google Colab ↔ GitHub
Connexió via OAuth
Després de reorganitzar el repositori, s’ha connectat Google Colab amb GitHub mitjançant OAuth. Aquesta connexió és molt important perquè permet guardar automàticament els canvis realitzats al notebook i mantenir una sincronització constant amb el repositori oficial del projecte. També facilita el treball en equip, evita pèrdues d’informació i millora la traçabilitat dels canvis.
La vinculació Colab ↔ GitHub permet guardar canvis directament al repositori sense descarregar ni pujar fitxers manualment, garantint la traçabilitat completa del codi durant el desenvolupament del xatbot.
README.md
Adaptació del Repte 1.4. Aquest repositori conté l’evolució d’un xatbot d’intel·ligència artificial inicialment creat per a la LAN Party, ara convertit en un assistent virtual per al projecte TalentFP per al web WordPress.
Eines: Google Colab · GitHub OAuth · Gemini API · WordPress Integration
Fitxers principals: XatBot_talent_2026.ipynb · Widget_talent.html · README.md
- Informació detallada sobre el projecte TalentFP i les eines utilisades
- Estructura completa del repositori i objectius principals del xatbot
- Instruccions de connexió amb la Gemini API de manera segura
- Membres de l’equip i enllaç al portafolis oficial
CONTRIBUTING.md
- Totes les modificacions s’han de realitzar des de Google Colab i sincronitzar-se amb GitHub via OAuth
- Els missatges de commit han de ser clars i descriptius per facilitar la traçabilitat
- Les claus API no es poden escriure directament dins del codi
- És obligatori usar els Secrets de Google Colab per protegir la informació sensible
- Abans de donar una tasca per finalitzada, cal revisar el funcionament i actualitzar la documentació
CHANGELOG.md
Totes les modificacions rellevants d’aquest projecte s’anotaran aquí.
- [1.0.0] – 2026-03-18 — Creació del repositori mitjançant Fork 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
Eines del projecte
Control de versions
GitHub
Fork, control de versions, commits, documentació del repositori i traçabilitat completa del codi.
Entorn de desenvolupament
Google Colab
Desenvolupament del motor d’intel·ligència artificial en Python amb connexió OAuth a GitHub.
Motor d’IA
Gemini API
Model de llenguatge de Google per gestionar la lògica conversacional del xatbot TalentFP.
Publicació web
WordPress
Integració del xatbot al web TalentFP mitjançant un widget personalitzat HTML.
Justificació i Reflexió
L’ús de GitHub i Google Colab no només facilita el desenvolupament tècnic del projecte, sinó que també millora l’organització i la qualitat del treball en equip. GitHub permet mantenir un control de versions professional, registrar tots els canvis i recuperar versions anteriors si apareixen errors.
La connexió amb Google Colab permet treballar directament sobre el notebook sense necessitat de descarregar ni pujar fitxers manualment, sincronitzant automàticament amb el repositori oficial.
La documentació del repositori (README.md, CONTRIBUTING.md, CHANGELOG.md) és una part essencial del projecte perquè facilita la comprensió del codi, el manteniment futur i la coordinació entre membres de l’equip. Gràcies a aquesta organització, el desenvolupament del xatbot és més segur, eficient i professional.
Conclusió
Fork i estructura del repositori
Repositori creat correctament des del projecte anterior, adaptat al nou context TalentFP sense modificar l’original.
Nomenclatura correcta dels fitxers
XatBot_talent_2026.ipynb i Widget_talent.html seguint exactament la rúbrica del Repte 1.4.
Vinculació Colab ↔ GitHub via OAuth
Sincronització automàtica garantida. Traçabilitat completa de tots els canvis del notebook.
Documentació tècnica completa
README.md, CONTRIBUTING.md i CHANGELOG.md actualitzats amb tota la informació del projecte TalentFP.