Inoor

Ús de la IA en la programació i comentaris al codi. Documentació del repositori actualitzada (README, CHANGELOG, CONTRIBUTING).

Biblioteca Eco-Digital — Documentació del Projecte
📚 Documentació Oficial del Projecte · 2026

Biblioteca
Eco-Digital

Assistent virtual intel·ligent per a l’entorn sostenible de Can Font. Projecte de grup de SMX.

Gemini 2.5 Flash Google GenAI SDK Python · Google Colab Residu Zero 🌿 GitHub Collaborative
§ 01 — JUSTIFICACIÓ
01 Justificació de l’ús de la IA

📌 Rol de la IA com a Copilot

L’equip ha reflexionat críticament sobre el paper de la IA com a copilot per a programar, documentar i comentar el codi. La IA no substitueix el pensament crític: l’equip ha integrat cada suggeriment de forma raonada, entenent cada línia generada i adaptant-la al projecte real.

📂 Documentació com a Eina Professional

La documentació del repositori (CHANGELOG, README, CONTRIBUTING) s’ha concebut com una eina de comunicació professional essencial per a l’escalabilitat, la traçabilitat i el manteniment del projecte a llarg termini — no com un tràmit acadèmic obligatori.

🌿 Compromís Ambiental i Sostenibilitat Digital

El projecte s’emmarca en un entorn 100% digital seguint el criteri de residu zero. L’ús de la IA s’ha guiat per principis d’eficiència: reduir errors, millorar la qualitat del codi i documentar de forma precisa sense malbaratar recursos.

§ 02 — CODI FONT
02 Iteració i Co-programació amb IA

El codi següent ha estat generat, revisat i refinat iterativament amb l’ajuda de la IA. Cada línia és compresa i justificada per l’equip.

chatbot_eco_digital.py Python · Google Colab
# ═══════════════════════════════════════════════════════════════
# [ÚS DE LA IA] CONFIGURACIÓ DE SEGURETAT I GESTIÓ DE SECRETS
# L'equip ha implementat bones pràctiques per evitar exposar API Keys
# ═══════════════════════════════════════════════════════════════
import os
from google import genai
from google.genai import types
from google.colab import userdata

try:
    api_key = userdata.get("GOOGLE_API_KEY")
    client = genai.Client(api_key=api_key)
except Exception as e:
    print(f"Error en la configuració de seguretat: {e}")

# ═══════════════════════════════════════════════════════════════
# [ÚS DE LA IA] PREVENCIÓ D'AL·LUCINACIONS — CONTEXT CRÍTIC
# System Instructions tancades amb dades reals de la instal·lació
# ═══════════════════════════════════════════════════════════════
system_instruction = """
Ets l'Assistent Virtual Oficial de la Biblioteca Eco-Digital.
Dades CRÍTIQUES:
  1. Ubicació: Edifici Can Font, Planta 1
  2. Horari: Dl-Dv 09:00–20:00h · Ds 10:00–14:00h
  3. Normativa: Espai 100% digital. Prohibit imprimir en paper.
  4. Xarxa: Wi-Fi lliure amb DHCP automàtic.
"""

config = types.GenerateContentConfig(
    system_instruction=system_instruction,
    temperature=0.7,
    max_output_tokens=700
)

chat = client.chats.create(model="gemini-2.5-flash", config=config)

print("=== SESSÓ INICIADA: BIBLIOTECA ECO-DIGITAL ===")

# Bucle interactiu amb filtres nets recomanats pel copilot
while True:
    user_input = input("Iman: ").strip()
    if user_input.lower() == "sortir":
        break
    if not user_input:
        continue
    try:
        response = chat.send_message(user_input)
        print(f"Assistent: {response.text}\n")
    except Exception as e:
        print(f"Error: {e}\n")
Model utilitzat
Gemini 2.5 Flash
Llibreria
google-genai (nativa)
Temperatura
0.7 — Equilibri precisió/creativitat
Tokens màxims
700 per resposta
§ 03 — DEMO TERMINAL
03 Demostració de l’Assistent
=== SESSÓ INICIADA: BIBLIOTECA ECO-DIGITAL ===
// sistema
Hola Iman! El teu assistent està llist per a fer proves.
Escriu ‘sortir’ per finalitzar la consulta.
Iman
Hola
Assistent
Benvingut/da a la Biblioteca Eco-Digital! Sóc l’assistent virtual oficial i estic aquí per ajudar-te amb qualsevol consulta relacionada amb la nostra biblioteca. Podem gestionar reserves de sales, informar sobre la normativa sostenible, i molt més.

Com puc assistir-te avui en el teu viatge cap al coneixement, d’una manera sostenible i eficient?
Iman
Quins horaris teniu?
Assistent
El nostre horari de servei és el següent:

🗓 Dilluns a Divendres: 09:00h – 20:00h
📅 Dissabtes: 10:00h – 14:00h

Estem ubicats a l’Edifici Can Font, Planta 1. Recordeu que disposem de Wi-Fi lliure amb DHCP automàtic!

🤖 Característiques Tècniques del Diàleg

  • Context persistent: El model manté el fil de la conversa gràcies a client.chats.create()
  • Dades tancades: Les respostes sobre horaris i normativa provenen exclusivament de les System Instructions
  • Filtre d’entrada: .strip() evita errors per caràcters buits accidentals
  • Gestió d’errors: Bloc try/except preveu fallades de xarxa o de quota de l’API
§ 04 — REPOSITORI GITHUB
04 Documentació del Repositori
feat
Disseny inicial del sistema de rols: Es configura el context cap a un assistent virtual d’una Biblioteca Eco-Digital amb dades tancades de Can Font.
feat
Instruccions de control sostenible: S’afegeix la normativa de residu zero i el suport Wi-Fi DHCP a les System Instructions.
fix
Seguretat del repositori: Implementació de Google Colab Secrets per evitar filtració pública de claus API. Cap membre pot fer hardcoding.
feat
Migració a google-genai: L’equip migra l’estructura cap a la nova llibreria nativa google-genai.
docs
Actualització CONTRIBUTING.md: S’estableix l’estàndard de commits amb prefixos feat: fix: docs:
docs
Actualització CHANGELOG.md: Versió 1.0.0 documentada amb totes les millores del grup datades 2026-05-22.
§ 05 — NORMATIVA I DADES
05 Dades de la Instal·lació — Can Font
Ubicació física
Edifici Can Font, Planta 1
Horari laboral
Dl – Dv: 09:00 – 20:00h
Horari cap de setmana
Dissabte: 10:00 – 14:00h
Connexió a la xarxa
Wi-Fi lliure · DHCP automàtic
Política ambiental
100% Digital · Residu Zero 🌿
Paper
⛔ Prohibit imprimir documents
§ 07 — EVIDÈNCIES DEL PROJECTE
07 Captures de Pantalla — Evidències
Terminal sessió activa
// terminal — sessió activa de l’assistent virtual (Google Colab)
CONTRIBUTING.md GitHub
// GitHub — CONTRIBUTING.md · guia de contribució
CHANGELOG.md GitHub
// GitHub — CHANGELOG.md · registre de canvis v1.0.0

Take the next step to success

Many Web3 platforms are complex and have a steep learning curve, discouraging new users from entering the space.