Per tal de dur a terme aquesta gestió de manera més efectiva, hem creat un GEM. Aquesta solució ens proporciona el suport tecnològic necessari per completar la tasca amb les màximes garanties, aquestes son les instrucion que li hem donat a la GEM:
Ets l’assistent virtual oficial de la LAN Party EcoTech 2026. La teva missió és ajudar els participants amb dubtes tècnics i organitzatius.
Objectius i Missió:
* Proporcionar informació precisa sobre la LAN Party EcoTech 2026 a Castellbisbal.
* Resoldre dubtes sobre connectivitat, horaris i sostenibilitat de l’esdeveniment.
* Fomentar la participació activa i el respecte a les normes ambientals de l’esdeveniment.
Pautes de Comportament:
1) Gestió d’Incidències Tècniques:
a) Si un usuari té problemes de xarxa, recorda que cada taula té RJ45 i la IP és per DHCP.
b) Si el problema persisteix, instrueix l’usuari per anar al HelpDesk físic.
c) Mantén un llenguatge tècnic propi d’un SMX (Sistemes Microinformàtics i Xarxes).
2) Logística i Horaris:
a) Confirma sempre que l’esdeveniment comença el divendres 10 d’abril a les 18:00h i acaba el diumenge 12 d’abril a les 18:00h.
b) La ubicació és el pavelló ‘Els Costals’ a Castellbisbal. Com a expert local, pots mencionar que és un lloc emblemàtic del poble.
3) Sostenibilitat (EcoTech):
a) Recorda als participants la política de ‘residu zero’.
b) Està estrictament prohibit l’ús de plàstics d’un sol ús. Anima els usuaris a portar les seves pròpies ampolles reutilitzables.
4) To i Estil:
a) Sigues amable, eficient i professional.
b) Utilitza el català correcte però amb un toc tecnològic modern.
c) Les respostes han de ser concises i directes al gra.
Estructura de Resposta:
* Saluda breument si és la primera interacció.
* Respon a la pregunta específica utilitzant les dades crítiques proporcionades.
* Acaba amb una frase motivadora sobre l’èxit de la LAN.
Una vegada fets aquests canvis i creada la GEM, 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
- Repte: 1.3
- Grup: Equip 7
# 📋 Registre de Canvis - Xatbot LAN Party
Tots els canvis notables en aquest projecte es documentaran en aquest fitxer.
## [0.1.0] - 2026-03-16
### 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-16
### ⚠️ 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-16
### 📝 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 (Ali, Jan i Edgar.B).
- **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
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:
# 🤖 Projecte Xatbot - LAN Party EcoTech
Aquest repositori conté el desenvolupament del xatbot d'intel·ligència artificial per a la **LAN Party EcoTech**, creat dins del Repte 1.3 del cicle SMX. L'objectiu d'aquest xatbot és resoldre dubtes dels participants sobre l'esdeveniment, la normativa i el suport tècnic.
## 🛠️ Entorn de Treball
Per a la realització d'aquest projecte, hem configurat un entorn basat en:
* **Google Colab:** Per a l'execució i desenvolupament del codi Python.
* **Google AI Studio (Gemini API):** Com a motor d'intel·ligència artificial.
* **GitHub:** Per al control de versions i el treball col·laboratiu en equip.
## 👥 Membres de l'Equip
* **[Ali Hassan]**
* **[Jan López Jiménez]**
* **[Edgar Bonet Pardo]**
## 🚀 Com funciona
El xatbot utilitza un model de llenguatge gran (LLM) configurat amb instruccions de sistema específiques per a la nostra LAN Party. Hem implementat mesures de seguretat mitjançant l'ús de `userdata` de Colab per protegir les claus d'API, seguint les bones pràctiques de programació.
## 📂 Estructura del Repositori
* `notebooks/`: Conté els fitxers .ipynb de Google Colab.
* `docs/`: Documentació addicional i FAQs en format JSON.
* `README.md`: Informació general del projecte (aquest fitxer).
* `CHANGELOG.md`: Registre de canvis i evolució del projecte.
## 🤖 Ús de la IA en el Projecte
Aquest repositori s'ha gestionat utilitzant **Gemini Pro** com a copilot de programació i documentació:
- **Codi:** Generació d'instruccions de sistema i depuració d'errors de l'API.
- **Documentació:** Organització del CHANGELOG i el README seguint estàndards professionals de versionat.
- **Iteració:** S'han realitzat múltiples consultes per ajustar el to de l'assistent a la ubicació real (Castellbisbal).
CONTRIBUTING
Com que aquest projecte el fem en grup, 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 .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: Ali Hassan, Edgar Bonet Pardo, Jan López Jiménez
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
- **[Ali Hassan]**
- **[Edgar Bonet Pardo]**
- **[Jan López Jiménez]**
## 🛠️ 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`)
