Instal·lació — Clasp (desenvolupadors)¶

Guia per desplegar una nova instància de Reserves ATECA des del codi font.

Prerequisits: Node.js, git, terminal, compte Google Workspace

Pas 1 — Instal·lar clasp i autenticar-se¶

npm install -g @google/clasp
clasp login

Pas 2 — Preparar el Google Sheets¶

Crea un nou Google Sheets al Drive del compte administrador
Anota l'ID del document (a la URL: spreadsheets/d/{ID}/)

Pas 3 — Configurar el projecte GAS¶

Obre el Google Sheets → Extensions → Apps Script
Copia el scriptId de la URL del projecte GAS (/projects/{scriptId}/)
Crea el fitxer .clasp.json a l'arrel del repositori:

{
  "scriptId": "EL_TEU_SCRIPT_ID",
  "fileExtension": "gs"
}

.clasp.json està al .gitignore. No el cometes mai.

Pas 4 — Pujar el codi¶

clasp push

Pas 5 — Desplegar com a webapp¶

A l'editor GAS: Desplegar → Nova implementació → Webapp
Configuració recomanada:
Executar com: Jo (l'usuari administrador)
Qui pot accedir: Qualsevol (fins i tot usuaris anònims)
Copia la URL de la webapp

Pas 6 — Executar el wizard d'instal·lació¶

Obre la URL de la webapp
Apareixerà la pantalla d'inicialització (ActivacionSistema.html)
Fes clic a Inicializar Sistema
El wizard crearà tots els fulls de Sheets amb l'esquema correcte i les dades de mostra

Dades de mostra instal·lades:

Recursos: ESPAI-1 (Prototipatge), ESPAI-2 (Ideació), ESPAI-3 (Simulació), CAM-360
Tramos: 12 trams horaris (M01–M06 matí, T01–T06 tarda)
Dispositius: 9 dispositius associats als espais
Cursos: SMX2-L1, SMX2-L2, DAM2

Pas 7 — Configuració inicial¶

Obre el Google Sheets → full Config
Modifica les claus bàsiques:
nombre_centro → nom del teu centre
idioma_ui → ca o es
Afegeix el primer usuari administrador al full Usuarios (email del compte Google)

Flux de treball habitual (actualitzacions)¶

# 1. Editar fitxers .gs o .html localment
# 2. Pujar els canvis a GAS
clasp push

# 3. Verificar a la webapp (URL de development)
clasp open

# 4. Si és una versió de producció, crear un nou deployment
clasp deploy

clasp push sobreescriu el codi de l'editor GAS. Els fulls de dades no es modifiquen.

Comandes Clasp de referència¶

Comanda	Descripció
`clasp push`	Puja tots els fitxers locals a GAS
`clasp pull`	Baixa el codi de GAS al directori local
`clasp open`	Obre el projecte a l'editor GAS al navegador
`clasp deploy`	Crea un nou deployment (nova versió pública)
`clasp deployments`	Llista els deployments existents
`clasp logs`	Mostra els logs d'execució recents

Versions i deployments¶

GAS distingeix entre:

Editor (HEAD): el codi que acabes de pujar amb clasp push. Accessible via URL de tipus /dev.
Deployment: una versió publicada i fixada. Accessible via URL de tipus /exec.

Per al professorat, sempre s'ha d'usar la URL de deployment (no la de dev).

Solució de problemes habituals¶

Problema	Causa probable	Solució
`Usuari no autoritzat` en entrar	Email no al full Usuarios	Afegir-lo manualment al Sheets
Les hores dels trams surten com a decimals	Format de cel·la incorrecte	Forçar format text a les columnes Hora_Inicio/Hora_Fin
El wizard no apareix	Codi no pujat	Executar `clasp push` i tornar a desplegar

Veure també: Desplegament i actualitzacions · Instal·lació amb plantilla (no tècnics)