Preparació de l'entorn de treball - Joel Aranda Cardenas SMX 1r

1. Justificació i Reflexió

Per desenvolupar un projecte d’IA amb èxit, no n’hi ha prou amb escriure codi; cal un entorn professional que ens permeti treballar en equip. He triat les següents eines per aquests motius:

GitHub: L’utilitzem per garantir la traçabilitat del codi. Això vol dir que sabem exactament quins canvis ha fet cada membre de l’equip i podem recuperar versions anteriors si alguna cosa falla.
Google Colab: Ens permet programar en Python al núvol sense dependre de la potència del nostre ordinador, facilitant l’execució de models d’IA.
Connexió OAuth: Hem vinculat ambdues eines perquè el flux de treball sigui àgil: el que programem a Colab es guarda directament al repositori de GitHub de l’equip.

2. Configuració de l’entorn (Implementació)

He seguit els passos per establir una base sòlida de treball:

A. Repositori a GitHub

He creat/clonat el repositori del projecte i m’he assegurat que els fitxers tinguin la nomenclatura exacta que demana el centre. Els fitxers principals són:

XatBot_talent_2026.ipynb
Widget.html

B. Vinculació Google Colab i GitHub (OAuth)

He configurat el permís d’accés per permetre que Google Colab pugui escriure en el meu repositori de GitHub. D’aquesta manera, cada vegada que fem una millora al Xatbot, podem fer un “Save a copy in GitHub”.

Gestió de Projecte: README, CHANGELOG i CONTRIBUTING

Perquè el meu repositori sigui professional i qualsevol persona pugui entendre el projecte o col·laborar-hi, hem implementat els tres fitxers estàndard de la indústria:

README.md: És la carta de presentació. Inclou el títol del projecte, la descripció del xatbot i les instruccions bàsiques per fer-lo servir.
CHANGELOG.md: Aquí registrem tots els canvis i versions. És vital per a la traçabilitat que demana la rúbrica, ja que permet veure com ha evolucionat el codi des del primer dia.
CONTRIBUTING.md: Aquí és on defineixo les “regles del joc” per a l’equip. Explico com s’ha d’informar dels errors, enviar canvis bàsicament quin protocol seguim per no trepitjar-nos la feina.

Reflexió: El poder del Xatbot i l’Entorn de Treball

“En aquest repte hem après que un Xatbot no és només un programa que respon preguntes; és una eina d’Intel·ligència Artificial que requereix un entorn de desenvolupament molt ben estructurat per funcionar. La preparació d’aquest entorn (GitHub + Colab) ens demostra que:

La IA és col·laborativa: Un xatbot modern té milers de línies de codi i molts ajustos en els “prompts”. Sense GitHub, seria impossible que un equip treballés en el mateix cervell del bot sense espatllar-lo.
L’automatització és clau: Connectar Colab via OAuth ens permet centrar-nos a entrenar la IA i millorar la seva lògica, mentre el sistema s’encarrega de guardar i gestionar les versions de manera segura.
Ordre i Qualitat: Un xatbot “intel·ligent” neix d’un entorn “intel·ligent”. Si no som capaços d’organitzar els nostres fitxers (Widget_talent.html i XatBot_talent_2026.ipynb), mai podrem implementar solucions d’IA reals i professionals a escala.”