Preparació entorn XatBot - Documentació final - SMX - Tarik Aberdane

Justificació i Reflexió · Per què aquest entorn?

Utilitat de les eines i organització de l'entorn per al XatBot:

Google Colab + OAuth: Permet desenvolupar el model de llengua (Gemini) amb acceleració GPU i connectar-lo directament amb GitHub per mantenir la traçabilitat de cada versió. Això garanteix que cada canvi quedi registrat i es pugui revertir si cal.
GitHub com a sistema central: Necessari per treballar en equip, gestionar conflictes de codi i demostrar l'evolució del projecte. El fork del repositori anterior assegura que partim d'una base sòlida però adaptada al nou context de TalentFP 2026.
Estructura de fitxers estandarditzada: Els noms exactes (XatBot_talent_2026.ipynb, Widget_talent.html) faciliten la correcció i l'avaluació per part del professor, seguint la nomenclatura oficial de la rúbrica.
Markdown com a llenguatge de documentació: README, CHANGELOG i CONTRIBUTING en format Markdown permeten una documentació professional, llegible directament des de GitHub i fàcil de mantenir.

Connexió amb la qualitat del programari: Un entorn ben organitzat redueix els errors, facilita la incorporació de nous membres a l'equip i demostra responsabilitat professional. Aquests hàbits són clau en el sector TIC, on la traçabilitat i el control de versions són imprescindibles.

Configuració, gestió de fitxers i treball en equip

✅ Còpia a GitHub amb els noms exactes segons rúbrica:

Repositori creat a partir del Fork del projecte anterior: SMX-Repte1.4.xatbot
Fitxer principal del quadern: XatBot_talent_2026.ipynb (vinculat via OAuth amb Google Colab)
Fitxer del widget frontend: Widget_talent.html
El quadern Colab està configurat amb Secrets de Colab (API Key de Gemini) per evitar filtracions al repositori públic.
La vinculació OAuth es reflecteix netament al repositori: cada vegada que es guarda des de Colab, es genera un commit amb l'autoria identificada.

Traçabilitat demostrada: L'historial de commits mostra la data 23/03/2026 amb el missatge "Fork i adaptació del repositori per a TalentFP 2026". Els fitxers segueixen exactament la nomenclatura exigida.

README.md Actualitzat

Presentació del projecte, justificació de l'entorn i estructura del repositori

🤖 Projecte Xatbot - TalentFP 2026 (Repte 1.4)

Open in Visual Studio Code | GitHub Classroom

Aquest repositori conté l'adaptació del xatbot d'intel·ligència artificial per a la Fira TalentFP 2026. L'objectiu és oferir un assistent virtual que resol dubtes sobre empreses participants, reptes i horaris.

🛠️ Entorn de Treball i Traçabilitat (Criteri PRO+)

Google Colab: Desenvolupament del motor de la IA en Python, amb connexió a l'API de Gemini.
GitHub (OAuth): Vinculació directa amb Colab per mantenir la traçabilitat dels canvis i el control de versions real.
Gestió de Secrets: L'API Key s'emmagatzema a les variables d'entorn de Colab (user_data) per garantir la seguretat.

📂 Estructura del Repositori (Nomenclatura Rúbrica)

XatBot_talent_2026.ipynb : Quadern de Google Colab amb la lògica de la IA.
Widget_talent.html : Codi de la interfície per a la integració web.
README.md : Documentació general (aquest fitxer).
CHANGELOG.md : Registre detallat de l'evolució i versions.
CONTRIBUTING.md : Normes de col·laboració per a l'equip.

🎯 Objectius del Projecte Talent 2026

Contextualització per a la fira de talent i empreses col·laboradores.
Seguretat en la gestió de claus API mitjançant variables d'entorn.
Disseny responsive i millora de l'experiència d'usuari.

🔗 Enllaç al portafolis

Més informació i evidències completes: 👉 taberdane.inscastellbisbal.net

CHANGELOG.md Actualitzat

Registre detallat de l'evolució del projecte amb data i responsables

📌 Registre de Canvis (CHANGELOG)

[Repte 1.4 - XatBot Talent 2026] · Responsable: Tarik Aberdane

🟢 [2026-03-23] - Inici del Repte 1.4 i Reestructuració

Fork del repositori anterior: He creat una còpia independent per treballar en el nou context de TalentFP 2026.
Renombratge de fitxers: XatBot2026.ipynb → XatBot_talent_2026.ipynb i widget.html → Widget_talent.html.
Actualització de la documentació: README, CHANGELOG i CONTRIBUTING adaptats al nou projecte.
Vinculació OAuth: Configuració de Colab amb GitHub per mantenir traçabilitat en cada commit.

🕒 [2026-03-17] - Base del projecte anterior (herència documentada)

Implementació inicial del xatbot amb Gemini 1.5 Flash.
Proves de connexió entre Colab i Ngrok per exposar el servei.
Primera versió del widget HTML amb estils bàsics.

CONTRIBUTING.md Actualitzat

Normes de col·laboració, seguretat i flux de treball per a l'equip

🤝 Guia de Contribució - XatBot Talent 2026

📌 Flux de treball amb Google Colab i GitHub

Totes les modificacions del codi es fan des de Google Colab.
Un cop validat el canvi, es guarda a GitHub mitjançant la connexió OAuth.
Prohibit pujar l'API Key al repositori. S'han d'utilitzar els Secrets de Colab (variables d'entorn).

📝 Qualitat i Missatges de Commit

Cada commit ha de tenir un missatge descriptiu en català o anglès tècnic.
Exemple: "Millorada la gestió d'errors del widget" en comptes de "canvis".
Els fitxers han de mantenir la nomenclatura: XatBot_talent_2026.ipynb i Widget_talent.html.

🤝 Com proposar millores?

Obrir un Issue a GitHub descrivint el problema o la millora.
Si es treballa en una branca separada, fer una Pull Request per a revisió prèvia a la fusió amb la branca principal (main).

Evidències documentades · Captures pròpies

Documentació visual de tot el procés: imatges reals de l'edició de l'entorn, els fitxers Markdown i la configuració del repositori.

Edició de l'entorn amb Elementor

✓ Captura pròpia on es visualitza la preparació de la pàgina del projecte.

✓ S'aprecia l'organització dels blocs i la integració del widget.

Configuració avançada d'Elementor

✓ Detall de les opcions de personalització per al desplegament del XatBot.

✓ Es mostra la coherència visual amb la identitat del projecte.

Vista final de l'entorn de treball

✓ Captura que certifica la correcta disposició dels elements.

✓ Inclou el marcador de l'àrea de treball del XatBot.

Ajustos tècnics de l'entorn

✓ Configuració de permisos i integració amb el repositori GitHub.

Plantilles i estructura de codi

✓ Evidència de l'organització dels fitxers HTML i CSS.

✓ Relacionat amb el Widget_talent.html.

Validació de la preparació

✓ Captura que demostra el compliment dels requisits de l'enunciat.

✓ Data i hora evidencien que el treball és actual.

✅ Compliment integral de la rúbrica PRO+

Justificació i Reflexió

Explicació clara de la utilitat de GitHub, Colab i l'organització de l'entorn per al treball en equip i la traçabilitat.

Configuració i fitxers

Fork realitzat, noms exactes XatBot_talent_2026.ipynb i Widget_talent.html, vinculació OAuth funcional.

Documentació Markdown

README, CHANGELOG i CONTRIBUTING creats i actualitzats amb format impecable i contingut professional.

Evidències visuals

Captures pròpies integrades, ben organitzades i rellevants per a cada fase del repte.

Repositori: SMX-Repte1.4.xatbot · Branca principal main · Historial de commits disponible i traçable.

Portafolis oficial: https://taberdane.inscastellbisbal.net

Preparació de l'entorn de treball