Preparació de l'entorn de treball – XatBot Talent 2026 · Tarik Aberdane
CFGM · Sistemes Microinformàtics i Xarxes · IPOP

Preparació de l'entorn de treball

Tarik Aberdane · XatBot Talent 2026 · Repte 1.4
Documentació final · Fork + edició fitxers Markdown · Traçabilitat GitHub

🧠 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ó. Cada canvi queda registrat i es pot 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 assegura que es parteix d'una base sòlida adaptada al nou context de TalentFP 2026.
  • Estructura de fitxers estandarditzada: Els noms exactes (XatBot_talent_2026.ipynb, Widget_talent.html) faciliten la correcció seguint la nomenclatura oficial de la rúbrica.
  • Markdown com a documentació: README, CHANGELOG i CONTRIBUTING permeten una documentació professional, llegible des de GitHub i fàcil de mantenir.

🔗 Connexió amb la qualitat del programari: Un entorn ben organitzat redueix errors, facilita la incorporació de nous membres i demostra responsabilitat professional. La traçabilitat i el control de versions són imprescindibles en el sector TIC.

⚙️ 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: XatBot_talent_2026.ipynb (vinculat via OAuth amb Google Colab)
  • Fitxer widget frontend: Widget_talent.html
  • El quadern Colab utilitza Secrets de Colab (API Key de Gemini) per evitar filtracions al repositori públic.
  • La vinculació OAuth es reflecteix al repositori: cada guardat des de Colab genera un commit amb autoria identificada.
Traçabilitat demostrada: Historial de commits amb data 23/03/2026 i missatge "Fork i adaptació del repositori per a TalentFP 2026". Fitxers amb la nomenclatura exacta exigida.

📝 Documentació del Repositori (Markdown)

Tres fitxers Markdown creats i actualitzats amb format professional, llegibles directament des de GitHub.

📄

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'IA per a la Fira TalentFP 2026. L'objectiu és un assistent virtual que resol dubtes sobre empreses, reptes i horaris. ## 🛠️ Entorn de Treball i Traçabilitat Google Colab: Desenvolupament del motor IA en Python, connectat a l'API de Gemini. GitHub (OAuth): Vinculació directa amb Colab per a traçabilitat i control de versions. Gestió de Secrets: API Key en variables d'entorn de Colab (user_data) per seguretat. ## 📂 Estructura del Repositori XatBot_talent_2026.ipynb — Quadern Colab amb la lògica de la IA. Widget_talent.html — Interfície web del xatbot. README.md — Documentació general. CHANGELOG.md — Registre de l'evolució. CONTRIBUTING.md — Normes de col·laboració. ## 🔗 Portafolis 👉 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 Fork del repositori anterior: Còpia independent per al nou context TalentFP 2026. Renombratge: XatBot2026.ipynbXatBot_talent_2026.ipynb | widget.htmlWidget_talent.html Documentació actualitzada: README, CHANGELOG i CONTRIBUTING adaptats. Vinculació OAuth: Colab + GitHub per traçabilitat de commits. ### 🕒 [2026-03-17] - Base del projecte anterior Implementació inicial del xatbot amb Gemini 1.5 Flash. Proves de connexió Colab + Ngrok. Primera versió del widget HTML.
🤝

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 Modificacions del codi des de Google Colab. Guardar a GitHub via connexió OAuth. Prohibit pujar l'API Key al repo. Usar els Secrets de Colab. ### 📝 Missatges de Commit Missatge descriptiu en català o anglès tècnic. Exemple: "Millorada la gestió d'errors del widget" no pas "canvis". Mantenir nomenclatura: XatBot_talent_2026.ipynb i Widget_talent.html. ### 🤝 Proposar millores Obrir un Issue a GitHub descrivint el problema. Treballar en branca separada i fer Pull Request cap a main.

🤖 XatBot Talent 2026 – Assistent del Portafolis

El xatbot coneix el portafolis de Tarik Aberdane i respon preguntes sobre els reptes, les pàgines i el contingut del lloc web.

Hola! Soc el XatBot del portafolis de Tarik Aberdane. Pots preguntar-me sobre els reptes, apunts, o qualsevol cosa del lloc web taberdane.inscastellbisbal.net 🚀

📸 Evidències documentades – Captures pròpies

Documentació visual de tot el procés: captures reals de l'edició de l'entorn i la configuració del repositori.

Edició entorn Elementor

Edició de l'entorn amb Elementor

Captura pròpia de la preparació de la pàgina del projecte.

Organització dels blocs i integració del widget.

Configuració Elementor

Configuració avançada d'Elementor

Opcions de personalització per al desplegament del XatBot.

Coherència visual amb la identitat del projecte.

Vista final

Vista final de l'entorn

Certifica la correcta disposició dels elements.

Inclou el marcador de l'àrea de treball.

Ajustos tècnics

Ajustos tècnics de l'entorn

Configuració de permisos i integració amb GitHub.

Plantilles i codi

Plantilles i estructura de codi

Organització dels fitxers HTML i CSS.

Relacionat amb el Widget_talent.html.

Validació final

Validació de la preparació

Demostra el compliment dels requisits.

Data i hora evidencien que el treball és actual.

✅ Compliment integral de la rúbrica

✓ Justificació i Reflexió Utilitat de GitHub, Colab i organització de l'entorn per al treball en equip i la traçabilitat del codi.
✓ Configuració i fitxers Fork realitzat, noms exactes XatBot_talent_2026.ipynb i Widget_talent.html, OAuth funcional.
✓ Documentació Markdown README, CHANGELOG i CONTRIBUTING creats amb format professional.
✓ Evidències + XatBot funcional 6 captures pròpies integrades + XatBot que coneix el portafolis i respon en temps real.
🐙 Repositori: SMX-Repte1.4.xatbot · Branca main · 23/03/2026  |  🌐 taberdane.inscastellbisbal.net
Tarik Aberdane · CFGM SMX · Institut Castellbisbal · 2026
Preparació de l'entorn de treball · Fork + edició fitxers Markdown · Evidències pròpies
Tarik Aberdan | Asistente 🚀 ×
¡Hola! Soy el asistente de Tarik Aberdan. ¿En qué puedo ayudarte hoy?