He utilitzat Gemini Pro com a copilot d’iteració. En lloc de copiar el codi directament, he refinat els prompts per passar d’un model genèric (entrenador) a un d’específic (LAN Party), supervisant la lògica de programació i la seguretat de les claus API.

En aquest repte, he integrat Gemini Pro no com un simple generador de codi, sinó com un copilot d’iteració i supervisió. El paper de la IA ha estat clau per estructurar la lògica de l’assistent i resoldre errors de configuració de l’API. No obstant això, la meva reflexió crítica és que la IA requereix una supervisió humana constant: jo he hagut de refinar els prompts per assegurar que les dades d’ubicació (Els Costals) i horaris fossin exactes, i he hagut d’aplicar criteris de seguretat (secrets de Colab) que la IA no sempre prioritza per defecte.

He implementat una documentació completa entenent-la com una eina de comunicació professional essencial per tres motius:

• Trasabilitat: El fitxer CHANGELOG.md permet seguir l’evolució del projecte (com el pivot d’entrenador a assistent de la LAN), entenent el “quan” i el “per què” de cada canvi.
• Escalabilitat: Amb un README.md i un CONTRIBUTING.md clars, el projecte deixa de ser un codi aïllat per convertir-se en un programari que qualsevol altre tècnic de l’equip pot entendre, instal·lar i ampliar sense haver de desxifrar el codi des de zero.

---

Com es podrà veure a continuació he utilitzat la IA en diferents ocasions per a generar el Xatbot.

Canvi de rol del Xatbot

En principi la primera versió del Xatbot era un entrenador que ajudava als esportistes amb els seus exercissis i creava rutines, però en el nostre cas el volíem com a ajudant de la LAN Party de Castellbisbal, llavors hem hagut de canviar el prompt per canviar-li la “identitat”.

Li he donat el següent prompt a la IA perquè m’ajudes a escriure la nova “identitat” del Xatbot, a part, he creat una nova Gem perquè m’ajudes només en la creació del Xatbot.

Aquest és el prompt que m’ha donat la IA per canviar el rol del Xatbot.

"""
Ets l'assistent virtual oficial de la LAN Party EcoTech 2026. 
La teva missió és ajudar els participants amb dubtes tècnics i organitzatius.

Informació CRÍTICA de l'esdeveniment:
1. Ubicació: Els Costals, Castellbisbal.
2. Horari d'Inici: Divendres, 10 d'abril a les 18:00h.
3. Horari de Finalització: Diumenge, 12 d'abril a les 18:00h.
4. Xarxa: Cada taula té una connexió RJ45. La IP s'assigna per DHCP. 
5. Sostenibilitat (EcoTech): Som una LAN residu zero. Prohibit el plàstic d'un sol ús.
6. Suport Tècnic: Qualsevol incidència de xarxa s'ha de reportar al HelpDesk.

To de veu: Tècnic (SMX), però amable i disposat a ajudar. 
Ets un expert de Castellbisbal i vols que la LAN surti perfecta.
"""

GEM creació d’un Xatbot

Aquí es pot veure la configuració del GEM el qual a partir d’ara utilitzaré per seguir amb la creació del Xatbot.

---

Una vegada fets aquests canvis i creada la GEM extra, he utilitzat la IA per fer la documentació dels canvis al fitxer CHANGELOG, README i CONTRIBITUNG

CHANGELOG

 Ara he d'actualitzat l'arxiu CHANGELOG i vull que m'ajudis amb la estructura, explica que la reorientació total del bot ha estat passar d'entrenador físic a Assistent Oficial de la LAN Party EcoTech 2026. Afegeix un punt sobre la "Nova Identitat", indicant que s'han configurat les "System Instructions" per donar-li un perfil tècnic de SMX. Indica que s'ha fixat la ubicació a Els Costals (Castellbisbal) i els horaris del 10 d'abril a les 18:00h al 12 d'abril a les 18:00h i menciona tres coses: la implementació de l'API de Gemini amb google-genai, la millora de seguretat usant userdata.get a Google Colab per no exposar claus privades, i que s'ha iterat amb una 'Gem' personalitzada per assegurar un to professional." 

Aquest ha sigut el resultat:

# 📋 Registre de Canvis - Xatbot LAN Party

Tots els canvis notables en aquest projecte es documentaran en aquest fitxer.

## [0.1.0] - 2026-03-10
### Afegit
- Creat el repositori a GitHub Classroom.
- Configuració inicial de l'entorn a Google Colab.
- Connexió amb Google AI Studio mitjançant API Key.
- Creació dels fitxers de documentació base (README, CHANGELOG, CONTRIBUTING).

### Seguretat
- Implementació de `google.colab.userdata` per gestionar la clau API de forma segura (Secret 🔑).

## [1.0.0] - 2026-03-13
### ⚠️ Canvi Major (Pivot de Projecte)
- **Reorientació total del bot:** S'ha eliminat la funcionalitat d'entrenador físic i s'ha transformat en l'**Assistent Oficial de la LAN Party EcoTech 2026**.
- **Nova Identitat:** Configuració de les "System Instructions" per dotar el bot d'un perfil tècnic de SMX i coneixement profund de l'esdeveniment.

### 📍 Actualització de Dades Crítiques
- **Ubicació:** S'ha fixat la localització oficial a **Els Costals (Castellbisbal)**.
- **Horaris oficials:** S'han programat les dates reals: Inici el **10 d'abril a les 18:00h** i tancament el **12 d'abril a les 18:00h**.

### 🛠️ Millores Tècniques
- **Implementació de l'API de Gemini:** Migració del codi base a la llibreria `google-genai` per a una gestió de xat més robusta.
- **Seguretat:** Integració de `userdata.get` per a la gestió de la clau API a Google Colab (evitant l'exposició de claus privades al codi).
- **Iteració amb IA:** S'ha utilitzat una "Gem" personalitzada per refinar la lògica de respostes i assegurar un to professional.

## [1.1.0] - 2026-03-14

### 📝 Afegit (Documentació i Flux de Treball)
- **Creació del fitxer `CONTRIBUTING.md`:** S'ha establert la guia oficial de col·laboració per a l'equip de desenvolupament (Pau, Ivan i Gerard).
- **Regles d'Or Tècniques:** S'han documentat les normatives crítiques per als col·laboradors: obligatorietat de protegir la API Key (ús de secrets de Colab), respecte absolut al context de la LAN Party (per evitar al·lucinacions de la IA) i l'estàndard professional de *commits*.
- **Workflow d'Equip:** S'ha definit el procés obligatori de revisió de codi a Google Colab i la centralització d'evidències al portafolis d'equip abans de donar qualsevol tasca per tancada.

README

 Ara he de fer el mateix, però actualitzant l'us de la IA en l'arxiu README, perquè així els meus companys o altres persones puguin entendre el seu treball en la creació del Xatbot, explica que he utilitzat Gemini com a copilot de programació, refinant els prompts per fer el pivot cap a l'assistent de la LAN Party EcoTech i fixant dades reals (Els Costals, Castellbisbal) per evitar al·lucinacions del model. Menciona que la IA m'ha ajudat a depurar errors de codi i a implementar bones pràctiques de ciberseguretat, com amagar la clau API utilitzant els secrets de Google Colab i justifica que he fet servir la IA per redactar aquest README i el CHANGELOG, ja que són eines de comunicació essencials per garantir l'escalabilitat, la traçabilitat i el manteniment del projecte a llarg termini. 

Aquest ha sigut el resultat:

## [1.0.0] - 2026-03-13
### ⚠️ Canvi Major (Pivot de Projecte)
- **Reorientació total del bot:** S'ha eliminat la funcionalitat d'entrenador físic i s'ha transformat en l'**Assistent Oficial de la LAN Party EcoTech 2026**.
- **Nova Identitat:** Configuració de les "System Instructions" per dotar el bot d'un perfil tècnic de SMX i coneixement profund de l'esdeveniment.

### 📍 Actualització de Dades Crítiques
- **Ubicació:** S'ha fixat la localització oficial a **Els Costals (Castellbisbal)**.
- **Horaris oficials:** S'han programat les dates reals: Inici el **10 d'abril a les 18:00h** i tancament el **12 d'abril a les 18:00h**.

### 🛠️ Millores Tècniques
- **Implementació de l'API de Gemini:** Migració del codi base a la llibreria `google-genai` per a una gestió de xat més robusta.
- **Seguretat:** Integració de `userdata.get` per a la gestió de la clau API a Google Colab (evitant l'exposició de claus privades al codi).
- **Iteració amb IA:** S'ha utilitzat una "Gem" personalitzada per refinar la lògica de respostes i assegurar un to professional.

CONTRIBUTING

Com que aquest projecte el fem en grup (Pau, Ivan i Gerard), necessitàvem establir unes regles clares per no trepitjar-nos el codi ni trencar la seguretat del xatbot. He utilitzat la IA per agafar les nostres normes bàsiques d’equip i transformar-les en un fitxer CONTRIBUTING.md professional, afegint-hi estàndards de la indústria com l’ús de secrets i el format dels commits.”

Tinc aquest text base per al fitxer CONTRIBUTING.md del nostre equip:

# 🤝 Col·laboració de l'Equip. 
Aquest document descriu com ens organitzem. 
Membres: Pau Jiménez Presas, Ivan Rodriguez Jiménez, Gerard Martin Parra. 
Flux de treball: Tota la feina es guarda a GitHub, un altre membre revisa el codi a Colab abans de tancar tasques, i les evidències van al portafolis'.

Necessito que el milloris amb un to més tècnic i professional afegint un apartat de '⚠️ Regles d'Or' amb 3 punts clau: 1. Prohibit fer hardcoding de la API Key (obligatori usar userdata.get). 2. Comentar amb # el codi generat per IA i revisar-lo manualment. 3. Utilitzar estàndards de commits (feat, fix, docs). Dóna'm el document sencer en Markdown."

i aquest ha sigut el resultat:

# 🤝 Guia de Contribució i Col·laboració de l'Equip

Aquest document descriu com ens organitzem, quins rols tenim en el desenvolupament del xatbot i quines són les regles tècniques per afegir-hi codi nou.

## 👥 Membres de l'Equip
- **[Pau Jiménez Presas]**
- **[Ivan Rodriguez Jiménez]**
- **[Gerard Martin Parra]**

## 🛠️ Flux de treball de l'Equip
1. Tota la feina es guarda al repositori compartit de GitHub.
2. Abans de donar una tasca per acabada, un altre membre de l'equip ha de revisar que el codi al Google Colab funcioni correctament.
3. Les imatges i evidències es pugen de forma centralitzada al portafolis d'equip.

---

## ⚠️ Regles d'Or per Modificar el Codi (Important)
Per garantir que l'Assistent de la LAN Party EcoTech funcioni sense problemes i mantenir la ciberseguretat del projecte, tots els membres han de complir això:

1. **🔒 Seguretat (Cap API Key al codi):** Està totalment prohibit escriure la clau de Gemini directament al codi font (*hardcoding*). Si fas proves, assegura't d'utilitzar sempre els secrets de Colab: `userdata.get("GOOGLE_API_KEY")`.
2. **📍 Respectar el Context Oficial:** Si modifiques les `system_instructions`, no alteris les dades crítiques de l'esdeveniment (Ubicació: Els Costals, Horaris: 10-12 d'abril) ni la normativa de "residu zero". Això evita que la IA pateixi al·lucinacions i doni informació falsa als assistents.
3. **🤖 Ús de la IA Documentat:** Si utilitzeu Gemini com a copilot per afegir noves funcions al xatbot, deixeu un comentari al codi (`#`) explicant què fa aquella línia. El codi generat per IA sempre ha de ser revisat manualment abans de pujar-lo a GitHub.
4. **📝 Estàndard de Commits:** Quan pugeu canvis a GitHub, utilitzeu missatges descriptius per mantenir la traçabilitat:
   - `feat:` per a noves funcions (ex: `feat: afegit suport per a preguntes de DHCP`)
   - `fix:` per a solucionar errors (ex: `fix: resolt error amb les majúscules`)
   - `docs:` per a documentació (ex: `docs: actualitzat el README`)

---

En aquestes anotacions he volgut deixar constància explícita de la traçabilitat de la IA, assenyalant els punts exactes on he utilitzat Gemini com a copilot per prendre decisions tècniques. Com es pot veure a continuació, he marcat amb l’etiqueta [ÚS DE LA IA] les millores aplicades en tres àmbits clau del programa:

• Ciberseguretat: L’ús de userdata.get per no exposar credencials.
• Prevenció d’al·lucinacions: La configuració estricta del prompt del sistema.
• Robustesa: La neteja de dades d’entrada (.strip().lower()) per evitar errors d’execució.

El que he fet ha sigut donar-li el codi que tenia del Xatbot a la IA (Gemini) perquè en digués on hauria de posar els comentaris i que escriure en ells.

Revisa el codi Python del meu xatbot i indica'm exactament en quines línies o blocs estratègics és millor que jo afegeixi els comentaris per documentar l'ús de la IA com a copilot. A més, vull estandarditzar-ho: indica'm on posar-los de manera que cada comentari comenci obligatòriament amb l'etiqueta [ÚS DE LA IA]. No em reescriguis el codi sencer, només assenyala'm els millors punts on hauria d'escriure aquestes acotacions amb aquesta estructura.

Seguidament, està ancorat el codi Python on es poden veure tots els comentaris a part del codi del Xatbot en si mateix.