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.ipynb → XatBot_talent_2026.ipynb | widget.html → Widget_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?