Dati

Dati PharmaX: struttura chiara e uso operativo

PharmaX espone un dataset farmaco normalizzato, pensato per software clinici, gestionali e logistici. Qui trovi copertura, campi principali, metriche e controlli di qualita su tutti i farmaci autorizzati in Italia.

Il runtime attuale usa build attivo importato da NursingBrain v2.4 e search index derivato dallo stesso import.

Metriche principali dataset

Record normalizzati--

Record indicizzati--

Equivalenze13039

Classi ATC7201

Versione dataset--

Cluster--

Stato servizio e verifiche live

GET /ready: stato DB, cache, indice e dataset.
GET /v1/dataset: versione dataset e conteggi pubblicati.
GET /public/changes: feed incrementale degli AIC aggiornati.

Questo set permette di monitorare runtime e propagare aggiornamenti nei software client senza full refresh.

Origine e normalizzazione

Fonte primaria: basi ufficiali AIFA sui farmaci autorizzati in Italia.
Normalizzazione: campi uniformati per ridurre ambiguità tra sistemi software e per supportare calcoli SaaS più robusti.
Unita dosabili normalizzate: mg, ml, gocce, fiale, UI, litri di O2.
Indicizzazione ricerca: query performanti su nome commerciale, principio attivo e AIC.
Versioning: ogni rilascio dati è tracciato per confronto, audit e promozione controllata del build attivo.

Governance build-based

Import attivo

Il portale non scrive più in place sul dataset runtime: espone un import build attivo, validato e tracciabile.

Search build

L’indice di ricerca nasce dallo stesso import attivo e viene verificato sui conteggi prima della promozione operativa.

Audit e rollback

Il modello build-based rende più semplice confrontare release, fare rollback e tenere separata la responsabilità tra authoring e runtime.

Policy Open Data AIFA e regole di distribuzione

PharmaX adotta una filiera di riuso conforme alle regole Open Data AIFA: accesso pubblico, riuso anche commerciale, attribuzione obbligatoria e rispetto delle norme privacy sui dati personali.

Licenza AIFA indicata: CC BY 4.0 (attribuzione).
Riuso consentito anche commerciale con citazione fonte.
Necessario indicare eventuali modifiche o trasformazioni dei dati originali.
Dati personali riusabili solo secondo normativa vigente e finalita compatibili.

Fonti ufficiali: AIFA Open Data · CC BY 4.0

Struttura dati ad alto livello

Blocco	Descrizione	Esempi campi
`source_row`	Record sorgente normalizzato per consultazione rapida.	`aic_code`, `commercial_name`, `active_substance`, `fascia`
`normalized`	Struttura tecnica per motore e regole applicative.	`identity`, `composition`, `package`, `administration`
`registry`	Informazioni regolatorie, ATC, equivalenze, prezzi.	`atc`, `equivalents`, `pricing`, `regulatory`
`meta`	Metadata di versione, qualita e tracciabilita.	`dataset_version`, `imported_at`, `cluster_id`

Endpoint dati consigliati

GET /v1/dataset: stato e versione dataset.
GET /v1/search: discovery record con filtri.
GET /v1/drugs/{aic_code}: record completo per singolo farmaco.
GET /public/metrics e GET /public/insights: metriche pubbliche runtime.

Esempio risposta dataset

curl -H "X-API-Key: <CLIENT_KEY>" "https://pharmax.aipersonal.it/v1/dataset"

{
  "dataset": {
    "dataset_version": "2026-03-29",
    "imported_at": "2026-03-29T18:49:33.486Z",
    "parser_version": "v24",
    "schema_version": "2.4"
  },
  "counts": {
    "records": 158602,
    "clusters": 26
  }
}

Qualita e governance

Import e verifiche consistenza su schema e conteggi.
Rebuild indice ricerca dopo import.
Controlli readiness e smoke test prima del rilascio.
Monitoraggio continuo metriche runtime in esercizio.
Tracciabilita di dataset/versione per audit su output API e calcoli SaaS.

FAQ rapide

Posso usare questi dati solo per ricerca? No, anche per logistica, analytics e supporto operativo.
Come verifico aggiornamento dati? Controlla /v1/dataset e confronta la versione.
Quale endpoint usare in UI demo? Le route /public/* sono pensate per demo/prototipi.
Per produzione? Preferisci /v1/* con API key e gestione limiti/errori.