Justificació
L’ús combinat de Google Colab i GitHub ha estat indispensable per a l’èxit del projecte, ja que el primer ha facilitat l’execució directa del codi i el segon ha permès una coordinació segura i fluida entre els membres de l’equip. Aquesta bona organització es reflecteix en l’actualització de la documentació clau del repositori, on he editat personalment el README, el CHANGELOG i el CONTRIBUTING per garantir que el codi estigui ben explicat, els canvis registrats i les normes de cooperació ben definides.
Implementació
Primer de tot he duplicat el repositori del Xatbot de la LAN Party per aprofitar els arxius.
Una vegada dintre del repositori he fet clic a «Fork», aquesta opció crea una còpia del repositori.
Aquest es el repositori copiat
Actualització de README, CHANGELOG i CONTRIBUTING
Com previement he duplicat el directori del Repte anterior, els arxius ja estan creats, només he hagut d’edirat-los.
README
# 🤖 Projecte Xatbot - TalentFP (Adaptació del Repte 1.4)
## 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. L'objectiu és oferir suport interactiu als usuaris que visiten el nostre lloc web en WordPress.
#🛠️ Entorn de Treball i Traçabilitat
## 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.
Gemini API: Utilització del model de llenguatge per a la lògica de l'assistent.
WordPress Integration: Implementació del xatbot mitjançant un widget personalitzat.
# 📂 Estructura del Repositori (Nomenclatura Rúbrica)
## Seguint els requeriments de la rúbrica del Repte 1.4, els fitxers principals són:
XatBot_talent_2026.ipynb: Quadern de Google Colab amb la lògica de la IA.
Widget_talent.html: Codi de l'interfície per a la integració al WordPress.
README.md: Documentació general (aquest fitxer).
# 👥 Membres de l'Equip
[Marc Vaca Aguilera]
# 🚀 Adaptació al nou context
## A diferència de la versió anterior (LAN Party), aquest xatbot ha estat reconfigurat per:
Context TalentFP: Resoldre dubtes sobre la fira de talent, les empreses participants i el funcionament dels reptes.
Seguretat: Gestió estricta de l'API Key mitjançant variables d'entorn (userdata) per evitar filtracions.
Interactivitat: Disseny d'un widget més net per a una navegació fluida dins del WordPress.
# 🔗 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://mvaca.inscastellbisbal.net/
# 🤖 Xatbot TalentFP 2026 - Marc Vaca
Projecte de desenvolupament d'un assistent virtual intel·ligent basat en l'IA Gemini, adaptat per al portal de portafolis del centre i el projecte TalentFP.
# 🚀 Funcionalitats Principals
- **Scraping Recursiu:** Sistema d'extracció de dades automàtic que recorre tot el domini `pjimenez.inscastellbisbal.net`.
- **Base de Coneixement Dinàmica:** Generació automàtica de fitxers JSON amb el contingut actualitzat del WordPress.
- **Seguretat:** Gestió de claus d'API mitjançant Secrets de Google Colab (no exposades al codi).
- **Interfície Widget:** Integració mitjançant un Widget HTML personalitzat per a WordPress.
# 🛠️ Stack Tècnic
- **Llenguatge:** Python 3.x
- **Biblioteques de Scraping:** BeautifulSoup4, Requests
- **IA:** Google Gemini Pro via API Studio
- **Entorn:** Google Colab sincronitzat via OAuth amb GitHub
# 📂 Estructura del Repositori
- `XatBot_talent_2026.ipynb`: Quadern principal amb la lògica de la IA i el Scraper.
- `Widget_talent.html`: Codi del front-end per a la integració web.
- `dades_pau_total.json`: Base de dades extreta del WordPress.
- `CHANGELOG.md`: Historial de versions i millores.
- `CONTRIBUTING.md`: Normes de col·laboració i qualitat de codi.
CHANGELOG
# Changelog - Projecte Xatbot TalentFP
Totes les modificacions rellevants d'aquest projecte s'anotaran aquí.
## [1.0.0] - 2026-05-22
### Afegit
- Creació del repositori mitjançant un 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.CONTRIBUTING
# Guia de Contribució
Per mantenir la qualitat del programari en aquest equip, seguim aquestes normes:
1. Tota modificació del codi s'ha de fer des de Google Colab i guardar-se a GitHub via OAuth.
2. Els missatges de "Commit" han de ser descriptius.
3. No es pot escriure l'API Key directament al codi; cal usar els Secrets de Colab.