Les exposicions són el nivell principal de contingut. Cada exposició representa un museu o espai expositiu.

Camps principals

• URL: Identificador únic per a la URL (ex: exposicio-principal). Un cop creat, millor no canviar-lo perquè afecta les URLs i QRs.
• Imatge de portada: Imatge principal que es mostra a la Home.
• Ordre: Número per ordenar les exposicions a la Home (menor = primer).
• Visible: Si està desactivada, no es mostra al públic però es manté a l'admin.

Traduccions (per idioma)

Cada exposició té traduccions en 4 idiomes (CA, ES, EN, FR) amb:

• Títol i descripció de l'exposició
• Informació de contacte: adreça, telèfon, email
• Enllaços: web, Facebook, Instagram

Si deixes el títol buit en un idioma, la traducció no es guardarà.

Documents / Fulls de sala

PDFs descarregables per idioma (fulls de sala, guies en paper, etc.). Cada document té títol, descripció opcional, fitxer PDF i ordre.

Crear una exposició nova

1. Anar a Contingut → Exposicions → Crear
2. Omplir el slug (minúscules, guions)
3. Pujar la imatge de portada
4. Omplir les traduccions (mínim català)
5. Afegir informació de contacte
6. Opcionalment afegir documents PDF
7. Desar

Les peces (o sales) són els elements individuals dins d'una exposició. Cada peça representa una sala, obra o punt d'interès amb el seu àudio i informació.

Camps principals

• Exposició: A quina exposició pertany (obligatori).
• URL: Identificador únic per a la URL dins de l'exposició.
• Ordre: Per ordenar les peces dins l'exposició. Es pot reordenar arrossegant.
• Visible: Mostra/oculta al públic.

Galeria d'imatges

• Fins a 20 imatges per peça (JPG, PNG, màx. 5MB)
• Reordenables arrossegant
• La primera imatge es mostra com a miniatura al llistat

Traduccions (per idioma)

Cada peça té traduccions en 4 idiomes amb:

• Títol: Nom de la peça/sala
• Subtítol: Autor, artista, o informació secundària
• Subtítol 2: Dates o època (ex: "1920-1925")
• Descripció: Text complet explicatiu
• Àudio: Fitxer MP3/WAV de l'audioguia (màx. 30MB)

Indicadors a la taula

Al llistat de peces, veuràs icones indicadores:

• AD (blau): Té audiodescripció per a persones cegues
• LSC (verd): Té vídeo en llengua de signes
• TXT (groc): Té transcripció de l'audiodescripció

Crear una peça nova

1. Anar a Contingut → Sales/Peces → Crear
2. Seleccionar l'exposició
3. Omplir slug
4. Pujar imatges a la galeria
5. Omplir traduccions per cada idioma (mínim títol en català)
6. Pujar àudios de l'audioguia per cada idioma
7. Opcionalment afegir audiodescripcions i materials
8. Desar

Idiomes disponibles

Com funciona

• L'idioma es guarda en una cookie al navegador del visitant (durada 30 dies).
• El visitant pot canviar l'idioma amb el selector d'idioma que apareix a cada pàgina.
• Les URLs inclouen el prefix d'idioma: /ca/, /es/, /en/, /fr/
• Si un idioma no té traducció, es mostra el contingut en català com a fallback.

A l'admin

Cada exposició i peça té pestanyes per idioma. El contingut en català és el mínim recomanat. Si deixes el títol buit en un idioma, aquella traducció no es guardarà.

Consell

Intenta mantenir totes les traduccions al dia. Les estadístiques d'idiomes al dashboard et mostren quins idiomes fan servir els visitants.

Àudio principal (audioguia)

• Cada peça pot tenir un àudio per idioma (MP3 o WAV, màx. 30MB)
• És l'àudio que escolten els visitants quan visiten la peça
• Es puja des de la pestanya de l'idioma corresponent

Audiodescripció (accessibilitat visual)

Per a visitants amb discapacitat visual:

• Àudio d'audiodescripció: Un àudio específic que descriu visualment l'obra
• Transcripció: Text alternatiu per a qui no pot escoltar l'àudio
• S'accedeix amb el paràmetre ?ad=1 a la URL o amb QR específics d'audiodescripció

Llengua de signes (Mirada Tàctil)

• Vídeos en LSC (Llengua de Signes Catalana) proporcionats per Mirada Tàctil
• S'afegeixen com a material addicional de tipus "Signes"
• Apareixen amb una icona especial a la pàgina de la peça

Materials addicionals

Cada peça pot tenir materials extra per idioma:

Widget d'accessibilitat al frontend

Els visitants tenen un botó d'accessibilitat (cantonada inferior dreta) que permet:

• Canviar la mida de la lletra (normal, gran, molt gran)
• Activar el mode d'alt contrast
• La configuració es guarda al navegador

Tipus de QR

Com generar QRs

1. Anar a l'edició d'una peça o exposició
2. Clicar el botó "QR" a la capçalera
3. Es mostren QRs per cada idioma (4 QRs estàndard + 4 QRs d'audiodescripció per peces)
4. Les exposicions permeten descarregar en PNG (500x500px) per imprimir

Com funciona el seguiment

• Quan un visitant escaneja un QR, el paràmetre ?qr=1 identifica la visita com a "QR scan"
• Això es registra automàticament a les estadístiques
• Permet diferenciar entre visitants que venen per QR i els que arriben pel web

Consells per imprimir QRs

• Utilitza la descàrrega PNG (500x500px) per a cartells
• Afegeix al costat del QR l'idioma al qual apunta
• Es recomana posar QRs en català i castellà com a mínim
• Per audiodescripció, indica-ho clarament al costat del QR

Les redireccions serveixen per mantenir les URLs antigues funcionant quan el contingut canvia de lloc.

Quan usar-les

• Si canvies el slug d'una peça o exposició
• Si migres contingut d'una web antiga
• Si vols crear URLs curtes que apuntin a contingut existent

Camps

• Origen: L'URL antiga, sense el domini (ex: /antiga-pagina)
• Destí: L'URL nova (ex: /ca/exposicio/la-meva-exposicio)
• Tipus:
  • 301 (Permanent): Per canvis definitius. Els cercadors actualitzen els seus índexs.
  • 302 (Temporal): Per canvis temporals. Els cercadors mantenen la URL original.
• Activa: Activa/desactiva la redirecció

Seguiment

Les visites via redirecció es registren com a tipus "Redirecció" a les estadístiques, per diferenciar-les de les visites directes.

Memòria cau

Les redireccions es guarden en memòria cau durant 5 minuts. Quan crees o modifiques una redirecció, la memòria cau s'esborra automàticament.

Què es registra

Cada visita d'un visitant real (no bots) es registra amb:

Tipus de visita

• QR El visitant ha escanejat un codi QR físic
• Web El visitant ha accedit directament per la web
• Redir El visitant ha arribat via una redirecció configurada

Filtrat de bots

El sistema filtra automàticament les visites de:

• Cercadors (Google, Bing, Yahoo, etc.)
• Xarxes socials (Facebook, Twitter, WhatsApp previsualitzacions)
• Eines de monitoratge (Lighthouse, PageSpeed, GTmetrix, Pingdom, UptimeRobot)
• Scripts automàtics (curl, wget, Python, etc.)

Això garanteix que les estadístiques reflecteixin visitants reals.

Deduplicació

Per evitar comptar la mateixa visita múltiples vegades:

• Cada visitant té un identificador anònim (cookie de 1 any)
• Si un visitant torna a la mateixa peça dins de 30 minuts, no es compta de nou
• Això evita inflació de números per refrescos de pàgina

Filtres disponibles

A la pàgina d'estadístiques pots filtrar per: tipus, idioma, dispositiu, exposició i peça. Les dades s'actualitzen automàticament cada 30 segons.

El dashboard mostra un resum visual de l'activitat. Els widgets estan ordenats per importància:

1. Resum general

Targetes amb les dades més importants:

• Avui: Total de visites d'avui (QR + web + redireccions)
• Visitants únics avui: Persones diferents que han visitat avui
• Última setmana: Total de la setmana
• Visitants únics setmana: Persones diferents de la setmana
• Total: Acumulat de totes les visites

2. Taxa de completitud

• Visitants únics (30 dies): Quantes persones han visitat en el darrer mes
• Mitjana peces visitades: Quantes peces visita de mitjana cada visitant (i percentatge del recorregut complet)
• Visitants amb recorregut: Quants visitants han vist 2 o més peces

Això és útil per saber si els visitants completen el recorregut o s'aturen aviat.

3. Gràfic de visites (30 dies)

Gràfic de línies amb l'evolució diària de QR scans (verd), visites web (blau) i redireccions (taronja).

4. Idiomes i dispositius

Dos gràfics circulars que mostren:

• Distribució d'idiomes: Quin percentatge de visitants fa servir cada idioma
• Dispositius: Mòbil vs escriptori vs tauleta (últims 30 dies)

5. Hores punta

Gràfic de barres amb les hores de més activitat (8h-21h, últims 30 dies). Útil per saber quan hi ha més visitants.

6. Top peces visitades

Taula amb les 10 peces més visitades, amb detall de visites QR, web, visitants únics i total.

7. Recorregut dels últims visitants

Mostra els últims 20 visitants amb el seu recorregut: data, idioma, dispositiu, peces visitades en ordre, si van usar QR, i total de pàgines vistes.

Com exportar

1. Anar a Estadistiques → Exportar (o des del botó "Exportar" a la llista d'estadístiques)
2. Seleccionar el rang de dates
3. Opcionalment aplicar filtres: exposició, tipus, idioma, dispositiu
4. Veuràs el nombre de registres que s'exportaran
5. Escollir format: Excel (.xlsx) o CSV (.csv)
6. Clicar Exportar

Camps exportats

Consells

• Excel és millor per anàlisi i gràfics
• CSV és millor per importar a altres sistemes
• Exporta periòdicament per tenir còpia de seguretat de les dades

Rols disponibles

Mesures de seguretat actives

• Protecció contra força bruta: Màxim 5 intents de login per minut per IP. Després es bloqueja temporalment.
• Contrasenyes segures: Xifratge bcrypt amb 12 rondes (estàndard de la indústria).
• HTTPS: Tota la comunicació web va xifrada amb SSL.
• CSRF: Protecció contra atacs de falsificació de peticions.
• Cookies segures: Sessions HTTP-only (no accessibles des de JavaScript maliciós).
• Privacitat de visitants: Les IPs es guarden com a hash SHA256, no en text pla. L'identificador de visitant és anònim.

Gestionar usuaris

Només els Super Admin poden accedir a Configuració → Usuaris per crear, editar o eliminar usuaris.

Bones pràctiques

• Fes servir contrasenyes fortes (mínim 12 caràcters)
• Crea un usuari editor per a persones que només necessiten editar contingut
• No comparteixis contrasenyes entre usuaris

Estructura de les pàgines

• Home: Llista de totes les exposicions actives amb imatge, títol i nombre de peces
• Exposició: Descripció de l'exposició, informació de contacte, documents descarregables, i llistat de peces
• Peça: Galeria d'imatges, àudio de l'audioguia, descripció, materials addicionals, audiodescripció (si disponible)

Navegació del visitant

1. El visitant arriba a la Home (o escaneja un QR d'una exposició)
2. Selecciona una exposició
3. Navega entre les peces de l'exposició
4. Escolta els àudios, veu les imatges i materials
5. Pot canviar l'idioma en qualsevol moment
6. Pot ajustar l'accessibilitat (mida lletra, contrast)

URLs

Les URLs segueixen aquesta estructura:

• Home: /
• Exposició: /{idioma}/exposicio/{slug}
• Peça: /{idioma}/peca/{slug}
• Canviar idioma: /idioma/{codi}

Responsiu

El disseny s'adapta a tots els dispositius: mòbils, tauletes i escriptori. La majoria de visitants (especialment al museu) faran servir el mòbil.

Contingut

• URLs: Un cop creada una URL i generat el QR, no la canviïs. Si ho fas, crea una redirecció.
• Imatges: Optimitza les imatges abans de pujar-les (màxim 2000px d'ample, format JPG).
• Àudios: Format MP3 és l'ideal. Intenta que no superin els 5-10 minuts per peça.
• Traduccions: Prioritza català i castellà. Anglès i francès si tens recursos.

Estadístiques

• Revisa el dashboard setmanalment per veure tendències.
• El gràfic d'idiomes t'indica si val la pena invertir en traduccions addicionals.
• El gràfic d'hores punta ajuda a planificar horaris de personal.
• La taxa de completitud indica si el recorregut és massa llarg o curt.
• Exporta les dades mensualment com a còpia de seguretat.

QR Codes

• Imprimeix els QR a mida suficient (mínim 3x3 cm).
• Col·loca'ls a prop de cada peça, a l'alçada dels ulls.
• Indica l'idioma al costat de cada QR.
• Si ofereixes audiodescripció, col·loca QRs addicionals amb indicació tàctil.

Rendiment

• Les redireccions es guarden en memòria cau (5 minuts).
• Les estadístiques del dashboard es calculen en temps real.
• Si el sistema va lent, revisa que no hi hagi massa registres d'estadístiques (pots exportar i netejar els antics).