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.

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 tecnics de govern: 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 gener 2026]

• Manual per a la Generació de Descripcions automàtiques a Databricks mitjançant la IA: Aquest manual explica com utilitzar eines d’intel·ligència artificial per generar descripcions clares i coherents dels camps en taules i datasets dins de Databricks, millorant la documentació i la comprensió de les dades. [Nova febrer 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: El document 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.

Servei d’Analítica Avançada

• Guia per al desenvolupament de casos d’ús de Machine Learning: guia per implementar casos d’ús de classificació, regressió i predicció amb ML dins la plataforma MLOps a Azure Databricks. Inclou bones pràctiques per a científics de dades, enginyers de ML i equips DevOps, i defineix un procés estructurat de desplegament des del desenvolupament fins a la producció.

• Guia per desenvolupar casos d’ús de GenAI: guia per implementar un xatbot amb RAG i càrrega de documents en temps real a Azure Databricks, seguint bones pràctiques i un desplegament estructurat fins a producció.

• Guia d’explicabilitat del models d’IA: el document que té com a objectiu principal proporcionar un marc tècnic i pràctic comprensiu sobre l’explicabilitat en sistemes d’intel·ligència artificial.

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.

• Mètodes d’ingesta de dades a la PTD: Guia que inclou tant consideracions prèvies a tenir en compte, com les fases del disseny d’un procés d’ingesta, o les diferents eines per a dur-lo a terme tant natives de Databricks com altres eines de l’ecosistema de la PTD. [Nova febrer 2026]

• Guia per a l’actualització o publicació de dades obertes des de la PTD: Descripció del procés de publicació i actualitzacio de dades a Socrata (Portal de dades obertes) a partir de dades de la PTD (Databricks), i exemple pas a pas. [Nova febrer 2026]