Salta el contingut

Contribuir

Flux de treball

  1. Clona el repositori: git clone git@gitlab.com:rnadalb/reserves_ateca.git
  2. Crea una branca per a la teva funcionalitat o correcció: git checkout -b feat/nom-funcionalitat
  3. Fes els canvis
  4. Comprova que no has introduït template literals niats a 3+ nivells (vegeu Restriccions de GAS)
  5. Puja els canvis: clasp push (opcional, per provar en producció)
  6. Crea un Merge Request a GitLab

Convencions de commits

Missatges en català, format imperatiu breu:

Afegir botó d'exportació CSV a les estadístiques
Corregir error de validació al formulari de reserva
Actualitzar traduccions CA per a la pestanya Admin

No usar prefixos tipus feat: / fix: — el projecte no segueix Conventional Commits.

Convencions de codi

  • Noms de funcions: camelCase, sovint en castellà (herència del fork original)
  • Comentaris: català o castellà (ambdós acceptables)
  • Claus i18n: camelCase, en català o castellà
  • IDs de Sheets: majúscules amb guions (ex. ESPAI-1, DIS-IMP3D)

Regles obligatòries

Canvis d'estructura del Sheets

Si el canvi afegeix columnes, fulls o claus de Config, cal crear una migració versionada:

→ Guia de migracions de schema

i18n

Qualsevol cadena visible a la UI ha de passar per el sistema i18n:

  1. Afegir la clau a i18n-es.html i i18n-ca.html (els dos fitxers, sempre)
  2. Usar window.t('clau') en JS o data-i18n="clau" en HTML
  3. Verificar la paritat a la consola del navegador

Template literals

No usar template literals niats a 3+ nivells. Vegeu Restriccions de GAS.

Fitxers .js

Els fitxers AdminFunctions.js, Codigo.js, etc. són artefactes antics. No cometre'ls.

Estructura de la documentació

La documentació viu a docs/. Quan fas un canvi que afecti la documentació:

  • Canvi de comportament d'usuari → actualitzar el fitxer corresponent a docs/manual/
  • Canvi tècnic → actualitzar el fitxer corresponent a docs/tech/
  • Canvi de configuració → actualitzar docs/manual/admin/configuracio.md i docs/tech/model-dades.md

Reportar problemes

  • Issues de GitLab: https://gitlab.com/rnadalb/reserves_ateca/-/issues
  • Service Desk: incoming+rnadalb-reserves-ateca-81343467-issue-@incoming.gitlab.com