Projecte XatBot TalentFP — Documentació

📁 Repte 1.4 · GitHub Documentation

🤖 Projecte XatBot
TalentFP

Adaptació del Repte 1.4 · Equip TalentFP

◆ DOCUMENTACIÓ OFICIAL ◆

Repositori

XatBot2026.ipynb

Versió

1.0.0 — 2026-03-18

Commits

18 Commits

Estat

✔ Operatiu

⚡

Objectiu del projecte

Assistent Virtual Especialitzat en TalentFP

Justificació i Reflexió

💡

Aquest repositori és el resultat de l’evolució tècnica del xatbot originalment creat per a la LAN Party. Per al nou Repte 1.4, hem realitzat una reconfiguració integral del sistema per transformar-lo en un assistent virtual especialitzat en el projecte TalentFP.

La necessitat d’organitzar l’entorn amb GitHub + Google Colab via OAuth no és simplement “per penjar fitxers” — és per garantir traçabilitat real de cada canvi, qualitat del programari i una coordinació efectiva en equip. Cada commit documenta el progrés, cada fitxer reanomenat segueix la rúbrica oficial, i cada mesura de seguretat protegeix les claus d’API del codi públic.

Entorn de Treball i Traçabilitat

🛠️

🐍

Google Colab

Motor principal de desenvolupament en Python per a la lògica de la IA. Tot el codi s’executa i es prova aquí abans de sincronitzar-se amb el repositori.

🔗

GitHub (OAuth)

Connexió directa via OAuth que permet mantenir la traçabilitat de cada canvi sense pèrdua d’informació. Qualsevol modificació al Colab es desa automàticament al repositori.

🧠

Gemini API

Integració del model de llenguatge per dotar l’assistent d’intel·ligència interactiva. La clau s’emmagatzema de forma segura amb userdata.get() i mai es publica al codi.

🌐

WordPress Integration

Implementació final mitjançant un widget HTML personalitzat per a una experiència d’usuari fluida al lloc web oficial del projecte TalentFP.

Estructura del Repositori

📁

D’acord amb els requisits de la rúbrica, els fitxers han estat reanomenats per a la seva correcta identificació:

.ipynb

XatBot_talent_2026.ipynb

Quadern principal amb la lògica de la IA i integració de Gemini

.html

Widget_talent.html

Codi de l’interfície per a la integració al WordPress

.md

README.md

Documentació general i tècnica del projecte

.md

CHANGELOG.md

Registre de totes les modificacions rellevants

.md

CONTRIBUTING.md

Normes de treball i contribució per a l’equip

.json

faqs.json

Base de dades de preguntes freqüents del TalentFP

Changelog

📋

⚙ [1.0.0] — 2026-03-18 · Versió Inicial

Totes les modificacions rellevants s’anoten per mantenir la traçabilitat del desenvolupament:

Fork Inicial Fork del projecte original (LAN Party) per adaptar-lo al nou entorn TalentFP. Configuració del repositori privat a GitHub Classroom.

Nomenclatura Canvi de nom dels fitxers a XatBot_talent_2026.ipynb i Widget_talent.html seguint la rúbrica oficial del Repte 1.4.

OAuth Establiment de la sincronització directa entre Google Colab i GitHub per al control de versions. Cada modificació queda registrada com a commit.

Seguretat API Configuració del sistema per gestionar la clau de Gemini mitjançant variables d’entorn (Secrets) de Google Colab. La clau mai apareix al codi públic.

Guia de Contribució

📜

Sincronització Obligatòria

Tota modificació del codi s’ha de realitzar des de Google Colab i desar-se directament a GitHub mitjançant la connexió OAuth per evitar conflictes de versions.

Missatges de Commit

Els missatges de confirmació (Commits) han de ser descriptius i explicar clarament quina millora o canvi s’ha realitzat. Exemple: Update Widget_talent.html — afegit estil responsive

Seguretat de les Claus

Està totalment prohibit escriure l’API Key directament al codi. S’han d’utilitzar obligatòriament els “Secrets” (userdata) de Google Colab per protegir les credencials.

Validació del Widget

Qualsevol canvi al fitxer Widget_talent.html ha de ser provat prèviament al WordPress de l’equip per garantir-ne la funcionalitat abans del commit.

Adaptació al Nou Context

🎯

A diferència de la versió anterior (LAN Party), aquest assistent està optimitzat per a:

Context TalentFP Resolució de dubtes sobre la fira de talent i empreses participants. El faqs.json conté les respostes específiques del projecte.

Seguretat Avançada Gestió estricta de l’API Key mitjançant userdata.get('GEMINI_API_KEY') per evitar filtracions al codi públic.

Millora d’Interactivitat Disseny d’un widget més net i intuïtiu per a la navegació dins del lloc web oficial. Interfície responsiva i accessible.

Com ho vaig fer — Evidències Pas a Pas

📸

🔗 Pas 1 — Creació del Fork

Per no haver de crear un repositori nou des de zero, vaig aprofitar el Chatbot del repte anterior (LAN Party). Vaig entrar al repositori original de l’Institut i vaig fer clic a “Fork” — aquesta opció crea una còpia del repositori al meu compte personal, mantenint tot l’historial de commits. Aquí es pot veure la pantalla de creació del fork i com el sistema ja detectava que el meu compte (imannoor-wq) tenia un fork existent.

Pantalla “Create a new fork” — seleccionant el compte imannoor-wq com a propietari

El sistema detecta que el fork ja existeix al compte imannoor-wq

📁 Pas 2 — Repositoris Resultants

Un cop creat el fork, van quedar dos repositoris: el de l’Institut (xatbot-2026-equip-6) com a repositori oficial del grup, i la còpia personal (imannoor-wq/XatBot2026.ipynb) on treballem des de Google Colab. El llistat de repositoris del perfil confirma tota l’activitat del projecte.

Repositori oficial de l’Institut — xatbot-2026-equip-6 — 18 commits, tots els fitxers

Fork personal imannoor-wq/XatBot2026.ipynb — 15 commits, branca main activa

Perfil imannoor-wq mostrant tots els repositoris del projecte

✏️ Pas 3 — Canvi de Nom dels Fitxers (Rúbrica)

Un cop dins el repositori, calia adaptar els noms dels fitxers als requisits de la rúbrica del Repte 1.4. Per fer-ho, vaig fer clic al fitxer i després a la icona de llapis (Edit this file) a la part superior dreta. Això permet editar tant el nom com el contingut directament des de GitHub. A continuació es veu la barra d’edició amb el nom nou ja aplicat, i el botó de commit per guardar el canvi.

⬛ Nom Original

Botó “Edit this file” — icona de llapis per editar nom i contingut

✅ Nom Canviat

Barra d’edicio mostrant el nou nom: XatBot_talent_2026.ipynb llest per fer commit

📄 Pas 4 — Actualització de la Documentació Markdown

Com que el repositori ja tenia els fitxers de documentació del repte anterior, els vaig editar directament per adaptar-los al nou context TalentFP. Vaig actualitzar els tres fitxers obligatoris: README.md amb la descripció del projecte i l’entorn de treball, CHANGELOG.md amb el registre de canvis de la versió 1.0.0, i CONTRIBUTING.md amb les normes de treball de l’equip. Cada edició es va guardar com un commit descriptiu visible a l’historial del repositori.

README.md — Estructura del projecte, entorn de treball, membres i adaptació TalentFP

CHANGELOG.md — Versio 1.0.0 amb Fork, nomenclatura, OAuth i seguretat API

CONTRIBUTING.md — 4 normes: OAuth, commits descriptius, seguretat API, validacio widget

Membres de l’Equip

👥

Iman

inoor.inscastellbisbal.net

Edgar

ealba.inscastellbisbal.net

Mario

mfernandez.inscastellbisbal.net