6. Documentació

Documents d’interés

Introducció i govern de la plataforma

• DoR i DoD a la PTD: llistat de criteris/evidències a tenir en compte abans de començar un projecte a la PTD (Definition of Ready) i quins són elements comuns a tots els projectes per donar un projecte per acabat (Definition of Done).

• Welcome pack: un document introductori que explica els conceptes clau, funcionalitats i beneficis de la PTD.

• Catàleg de serveis: relació de serveis que presta l’Oficina Tècnica tant per a usuaris de la plataforma com per a proveïdors que duen a terme projectes sobre la mateixa. Es detallen també els dos canals oberts per a rebre peticions i quin s’ha de fer servir segons perfil i casuística. [Nou maig 2026]

Qualitat i govern de la dada

• El cami de la dada: una presentació que detalla el recorregut que segueixen les dades dins de la plataforma i com es gestionen de manera eficient.

• Qualitat de la dada: el document estableix criteris per garantir la qualitat de les dades a la Plataforma Transversal de Dades, incloent-hi estàndards de nomenclatura, validació, correcció i enriquiment, així com mesures de seguretat i privacitat. [Actualitzat gener 2026]

• Estandards tècnics: aquest document detalla les múltiples capes de validacions i transformacions que passa la dada abans d’emmagatzemar-se per després fer una anàlisi eficient, i el conjunt de guies i estàndards que s’apliquen per definir els noms dels actius analítics.[Actualitzat abril 2026]

• Funcions de govern de dades: document que presenta el model de governança de dades de la Generalitat, els rols implicats i els processos per gestionar i aprofitar les dades de forma eficient. Inclou guies pràctiques per a l’execució de casos d’ús amb enfocament col·laboratiu i tècnic.

Arquitectura, infraestructura, seguretat

• Document d’arquitectura: document d’arquitectura de la PTD.

• Infraestructura i DevOps: l’objectiu d’aquest document és proporcionar informació als diferents proveïdors que treballin a la Plataforma Transversal de Dades per a poder integrar els seus productes a la PTD des del punt de vista d’Infraestructura i DevOps.

• Directrius de seguretat: el document estableix directrius de seguretat i privacitat per a la gestió de dades a la Plataforma Transversal de Dades, incloent-hi control d’accés, permisos i privacitat de les dades.

• Directrius d’Integració—Seguretat: el document estableix les directrius bàsiques que han de seguir totes les aplicacions per poder treballar amb la PTD de forma segura.

• Tallatge de clústers aprovisionats: document que descriu les mides estàndard de clústers aprovisionats per la Plataforma Transversal de Dades segons el tipus de recurs: còmput, emmagatzematge i memòria. S’estableixen tallatges per defecte i el procediment per sol·licitar ampliacions segons necessitats.

• Guia de desplegaments a Databricks : manual que té per objecte descriure, de manera clara i estructurada, el procés de treball relacionat amb la integració de desenvolupaments, l’execució dels workflows automàtics i la generació dels artefactes corresponents. També s’hi presenten els rols implicats, les activitats principals i els resultats esperats de cada fase.[Nou març 2026]

Guies d’eines específiques

• Guia d’ús de Denodo: manual per entendre com s’ha disponibilitzat l’eina per a que la puguin fer servir diferents proveïdors, així com aspectes tècnics lligats a la nomenclatura, seguretat, desplegaments i bones pràctiques.

• Manual d’Usuari per al Consum de la API Dades de Referència: guia sobre l’ús de l’API per tal d’integrar i consultar dades de referència de manera segura i eficient. Permet accedir a versions actuals i històriques de les dades, subscriure’s a canvis i garantir la coherència i qualitat de la informació en tots els processos organitzatius, i compta amb funcionalitats avançades com la gestió de versions i la subscripció a notificacions.

• Manual d’Usuari per al Consum de la API Regles Qualitat: guia sobre l’ús de la API, així com les regles de qualitat associades a la seva utilització. Es detallen les funcionalitats, els requisits per accedir-hi i els estàndards que garanteixen un ús correcte i eficaç. Així mateix, el manual ofereix orientacions sobre la validació de les respostes i el possible motiu dels errors més comuns.

• Guia de recomanacions i bons pràctiques dades geoespacials PTD: descripció de les recomanacions i bones pràctiques per l’ús de dades geoespacials a Databricks. Inclou enllaços a documentació addcional.

• Guia d’ús per connectar eina QGIS a la PTD: descripció del procés amb les instruccions essencials de com connectar la PTD (Databricks) amb l’eina QGIS (Sistema d’Informació Geogràfica). Inclou algun exemple d’ús tant de visualització de dades com la part d’analítica avançada amb el component genie chat de Databricks.

Analítica avançada i IA

• Tota la informació referent a serveis específics, arquitectura, fitxes de casos d’ús, etc d’analítica avançada i IA la trobareu en aquesta pàgina dedicada: 5. Analítica avançada i IA