🤖 Projecte Xatbot - TalentFP (Adaptació Repte 1.4)

Open in Visual Studio Code

Aquest repositori conté l'evolució i adaptació del xatbot d'intel·ligència artificial desenvolupat originalment per a la LAN Party, ara transformat en un assistent virtual per al projecte TalentFP 2026. L'objectiu és oferir suport interactiu als usuaris que visiten el nostre lloc web.

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

Per a aquest repte, hem optimitzat el nostre flux de treball per garantir la qualitat del programari i la col·laboració eficient:

• Google Colab: Desenvolupament del motor de la IA en Python.
• GitHub (OAuth): Connexió directa amb Colab per mantenir la traçabilitat dels canvis i el control de versions real.
• Gestió de Fitxers: Organització neta del repositori seguint la nomenclatura oficial de la rúbrica.

📂 Estructura del Repositori (Nomenclatura Rúbrica)

Seguint els requeriments del Repte 1.4, els fitxers principals són:

• XatBot_talent_2026.ipynb : Quadern de Google Colab amb la lògica de la IA i connexió amb l'API de Gemini.
• Widget_talent.html : Codi de la interfície (Frontend) per a la integració web.
• README.md : Documentació general i justificació de l'entorn (aquest fitxer).
• CHANGELOG.md : Registre detallat de l'evolució i versions del projecte.
• CONTRIBUTING.md : Normes d'equip per garantir la qualitat del codi.

🎯 Objectius del Projecte Talent 2026

• Contextualització: Resoldre dubtes sobre la fira de talent, empreses participants i funcionament dels reptes.
• Seguretat: Gestió estricta de l'API Key mitjançant variables d'entorn (user_data) per evitar filtracions al repositori públic.
• Interactivitat: Disseny d'un widget més net i fluid per a una navegació millorada.

👥 Membres de l'Equip

• Tarik Aberdane (Responsable del Repositori i Documentació)

🔗 Documentació Completa

Podeu trobar tota la justificació del projecte, les captures de pantalla de la configuració de l'entorn i el diari de treball al nostre portafolis oficial: 👉 https://taberdane.inscastellbisbal.net

📌 Registre de Canvis (CHANGELOG)

[Repte 1.4 - XatBot Talent 2026] · Grup: Equip 4 (Actualitzat)

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

• Migració del Repositori: He realitzat un Fork del repositori anterior per començar la nova fase del projecte "Talent 2026" de manera independent.
• Organització de l'entorn: He canviat el nom del repositori a SMX-Repte1.4.xatbot per mantenir una millor traçabilitat del programari.
• Actualització de fitxers: He reanomenat els fitxers principals seguint la rúbrica PRO+:
  • XatBot2026.ipynb ➔ XatBot_talent_2026.ipynb
  • widget.html ➔ Widget_talent.html
• Neteja d'autoria: He començat a documentar els canvis per assegurar que l'historial del projecte sigui real i propi d'aquest nou repte.

🕒 [2026-03-17] - Millores del Repte anterior (Heretat)

• Millora del codi HTML i del widget per a Google Sites.
• Proves amb diferents models de Gemini (1.5 Flash, 2.0, etc.) per solucionar problemes de quotes i tokens.
• Connexió entre Backend (Colab/Ngrok) i Frontend (HTML) establerta correctament.

🤝 Guia de Contribució - XatBot Talent 2026

Per mantenir la qualitat del programari i la traçabilitat en aquest equip, seguim aquestes normes bàsiques de treball:

📌 Flux de treball amb Google Colab

Tota modificació del codi s'ha de fer seguint aquests passos per no perdre res:

• Es treballa directament des de Google Colab.
• Un cop provat que el codi funciona, es guarda a GitHub mitjançant la vinculació OAuth.
• Important: Mai es guarda el quadern amb l'API Key a la vista; fem servir els Secrets de Colab.

📝 Qualitat i Missatges de Commit

Perquè el professor vegi qui ha fet què (traçabilitat), cada vegada que guardis un canvi a GitHub:

• El missatge del "Commit" ha de ser descriptiu (Exemple: "Actualitzat el CSS del widget" en comptes de "Canvis").
• Ens assegurem que els noms dels fitxers segueixen l'estructura: XatBot_talent_2026.ipynb i Widget_talent.html.

🤝 Com col·laborar?

Si algú de l'equip vol fer una millora:

• Obrir un Issue: Primer comentem la idea o l'error trobat a l'apartat d'Issues de GitHub.
• Pull Requests: Si algú treballa en una branca a part, cal fer una Pull Request perquè la resta de l'equip revisi el codi abans de fusionar-lo a la branca principal (main).