diagnosekoder

Dette prosjektet publiserer en npm pakke (@navikt/diagnosekoder) og en java (kotlin) pakke (no.nav.helse.diagnosekoder), som inneholder diagnosekoder av type ICD-10 og ICPC-2.

Disse er tenkt brukt i diverse systemer utviklet i NAV.

Mer informasjon om disse data finnes her: https://www.ehelse.no/kodeverk-og-terminologi

Informasjonen (diagnosekodene) blir hentet fra api tilgjengeligjort her: https://fat.kote.helsedirektoratet.no/index.html

Det blir vanligvis publisert oppdatert versjon av diagnosekodene hvert år. Når det skjer vil vi publisere ny pakkeversjon.

Versjonsnr vil følge semver, det vil si at vanlige årlige oppdateringer som er bakoverkompatible blir oppdatert med minor versjonsnr.

Bruk diagnosekodene i ditt prosjekt

typescript/javascript

Du må allerede ha satt opp prosjektet ditt til å hente @navikt-scopet fra github packages.

yarn add @navikt/diagnosekoder

eller

npm install @navikt/diagnosekoder

Etter installasjon kan diagnosekoder importeres og brukes slik:

import ICD10 from '@navikt/diagnosekoder/ICD10';
import ICPC2 from '@navikt/diagnosekoder/ICPC2';

const myIcd10 = ICD10;
const myIcpc2 = ICPC2;

Java

Se instruksjoner for installasjon på pakke-siden.

Eksempel på bruk fra java:

import no.nav.helse.diagnosekoder.Diagnosekoder;
import java.util.Map;

public class Main {
   public static void main(String[] args) {
      Map<String, Diagnosekoder.ICD10> dk = Diagnosekoder.INSTANCE.getIcd10();
      int count = dk.size();
      System.out.println("Diagnosekode count: " + count);
   }
}

Oppdatering av publiserte diagnosekoder

Det kommer normalt ny versjon av diagnosekodene hvert år.

Urler som kodegenerator bruker må da oppdateres og det må publiseres ny pakkeversjon.

Publiseringsprosedyre

Via Github Actions

1. Opprett en ny branch på repoet.
2. Kjør github action workflow Generate diagnose codes på ny branch.
   • Fyll inn valid-after dato på formatet YYYY-mm-dd for å filtrere bort diagnosekoder utløpt etter denne dato.
3. Kjør github action workflow Increment package versions på branch du jobber på.
4. • Velg inkrementeringsmåte (patch eller year).
   • For årlig oppdatering av nye diagnosekoder, velg year og fyll inn korrekt årstall i inputfeltet for det.
   • For bugfikser eller andre bakoverkompatible endringer som ikke er en ny "årlig oppdatering", velg patch.
5. Lag PR med endringene actions har generert fra branch til master
6. Review og merge PR til master
7. Kjør github action workflow Publish @navikt/diagnosekoder npm på master. Dette publiserer ny versjon av npm pakken i github registry.

Lokalt

Hvis man ikke vil gjøre det via github actions kan nye koder og versjonsoppdatering også gjøres lokalt:

1. Sjekk ut koden
2. Oppdater urler i /configs/ katalogen
3. Kjør kodegenerator og test resultatet

   npm install --workspaces && 
   npm run build --workspace=@navikt/diagnosekoder &&
   npm run generate --workspace=diagnosekode-generator &&
   npm run test --workspace=@navikt/diagnosekoder &&
   cd java/diagnosekoder &&
   ./gradlew test &&
   cd ../..

4. Oppdater versjon på @navikt/diagnosekoder npm pakke med npm version viss ny versjon skal publiseres.
5. Oppdater versjon på no.nav.helse.diagnosekoder kotlin pakke viss ny versjon skal publiseres.
6. Commit og push endringer.

Henvendelser

Dette prosjeket er vedlikeholdt av navikt/k9saksbehandling

Spørsmål knyttet til koden eller prosjektet kan stilles som issues her på GitHub

For NAV-ansatte

Interne henvendelser kan sendes via Slack i kanalen #team-sykmelding eller #team-sykdom-i-familien