Expert knowledge of the melosys-api Oracle database schema. Use when: (1) Writing SQL queries against the melosys database, (2) Understanding table relationships and foreign keys, (3) Debugging data issues by querying the database, (4) Understanding what data is stored where, (5) Creating or modifying Flyway migrations, (6) Mapping domain entities to database tables. Triggers: SQL against melosys DB, table/column lookup, FK relationships, "where is X stored", "what column stores X", "why is data missing", beh_resultat_id, behandlingsresultat_id, saksnummer, schema.
日本語の概要は準備中です。原文の説明を表示しています。
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
Oracle database schema for melosys-api. Connection: jdbc:oracle:thin:@//localhost:1521/FREEPDB1 (user: melosys).
FAGSAK (Case)
├── AKTOER (1:N) - Actors (citizen, employer, authorities)
├── KONTAKTOPPLYSNING (1:N) - Contact information
├── FULLMAKT (via AKTOER) - Power of attorney
├── SKJEMA_SAK_MAPPING (1:N) - Bridge to melosys-skjema-api (V152)
└── BEHANDLING (1:N) - Treatments/processing instances
├── MOTTATTEOPPLYSNINGER (1:N) - Received documents/info
├── SAKSOPPLYSNING (1:N) - Case data (JSON CLOBs)
├── BEHANDLINGSNOTAT (1:N) - Notes
├── BEHANDLINGSAARSAK (1:N) - Processing reasons
├── TIDLIGERE_MEDLEMSPERIODE (1:N) - Previous membership periods
├── PROSESSINSTANS (1:N) - Saga/workflow instances
└── BEHANDLINGSRESULTAT (1:1) - Result
├── LOVVALG_PERIODE (1:N) - Applicable legislation periods
├── MEDLEMSKAPSPERIODE (1:N) - Membership periods
├── ANMODNINGSPERIODE (1:N) - Exception request periods
├── UTPEKINGSPERIODE (1:N) - Designation periods (Art. 13)
├── TRYGDEAVGIFTSPERIODE (1:N) - Social security charge periods
├── AARSAVREGNING (1:1) - Annual reconciliation (årsavregning)
├── VEDTAK_METADATA (1:1) - Decision metadata
├── VILKAARSRESULTAT (1:N) - Condition results
├── AVKLARTEFAKTA (1:N) - Clarified facts
└── KONTROLLRESULTAT (1:N) - Control results
Recent changes (V144–V154, Jan–Apr 2026): New
skjema_sak_mappingtable (bridge to melosys-skjema-api).kildecolumn added tolovvalg_periode,medlemskapsperiode,helseutgift_dekkes_periode.aarsavregningcolumns renamed:*_fra_avgiftssystemet→*innbetalt_trygdeavgift. New PROSESS_TYPE for digital søknad-mottak. See Recent Migrations below.
Primary case entity. PK: SAKSNUMMER (format: MEL-{sequence}).
| Column | Type | Description |
|---|---|---|
| SAKSNUMMER | VARCHAR2(99) | Primary key, e.g., "MEL-12345" |
| GSAK_SAKSNUMMER | NUMBER | Archive case ID (Joark/GSAK) |
| FAGSAK_TYPE | VARCHAR2(99) | FK to FAGSAK_TYPE (EU_EOS, TRYGDEAVTALE, FTRL) |
| TEMA | VARCHAR2(20) | FK to FAGSAK_TEMA (MEDLEMSKAP_LOVVALG, UNNTAK, TRYGDEAVGIFT) |
| STATUS | VARCHAR2(99) | FK to FAGSAK_STATUS |
| BETALINGSVALG | VARCHAR2(99) | Payment choice |
Processing instance within a case. PK: ID.
| Column | Type | Description |
|---|---|---|
| ID | NUMBER | Primary key (sequence) |
| SAKSNUMMER | VARCHAR2(99) | FK to FAGSAK |
| STATUS | VARCHAR2(99) | FK to BEHANDLING_STATUS |
| BEH_TYPE | VARCHAR2(99) | FK to BEHANDLING_TYPE |
| BEH_TEMA | VARCHAR2(99) | FK to BEHANDLING_TEMA |
| BEHANDLINGSFRIST | DATE | Processing deadline |
| OPPGAVE_ID | VARCHAR2(10) | External task ID |
| INITIERENDE_JOURNALPOST_ID | VARCHAR2(99) | Initiating document ID |
| OPPRINNELIG_BEHANDLING_ID | NUMBER | FK to parent BEHANDLING (self-ref) |
Parties involved in a case. PK: ID.
| Column | Type | Description |
|---|---|---|
| ID | NUMBER | Primary key |
| SAKSNUMMER | VARCHAR2(99) | FK to FAGSAK |
| ROLLE | VARCHAR2(99) | FK to ROLLE_TYPE (BRUKER, ARBEIDSGIVER, etc.) |
| AKTOER_ID | VARCHAR2(99) | NAV actor ID (for BRUKER) |
| PERSON_IDENT | VARCHAR2(11) | Norwegian ID number |
| ORGNR | VARCHAR2(99) | Organization number |
| EU_EOS_INSTITUSJON_ID | VARCHAR2(99) | EU/EEA institution ID |
| TRYGDEMYNDIGHET_LAND | VARCHAR2(2) | Country code for authority |
Outcome of a treatment. PK: BEHANDLING_ID (1:1 with BEHANDLING).
| Column | Type | Description |
|---|---|---|
| BEHANDLING_ID | NUMBER | PK + FK to BEHANDLING |
| RESULTAT_TYPE | VARCHAR2(99) | FK to BEHANDLINGSRESULTAT_TYPE |
| BEHANDLINGSMAATE | VARCHAR2(99) | Processing method |
| FASTSATT_AV_LAND | VARCHAR2(99) | Country that determined result |
| BEGRUNNELSE_FRITEKST | VARCHAR2(4000) | Justification text |
| FAKTURASERIE_REFERANSE | VARCHAR2(40) | Billing series reference |
| TRYGDEAVGIFT_TYPE | VARCHAR2(99) | Social security charge type |
All periods belong to BEHANDLINGSRESULTAT via BEH_RESULTAT_ID — except
MEDLEMSKAPSPERIODE, whose FK column is BEHANDLINGSRESULTAT_ID (renamed in
V109). Both FK columns reference BEHANDLINGSRESULTAT(BEHANDLING_ID).
| Column | Type | Description |
|---|---|---|
| FOM_DATO / TOM_DATO | DATE | Period start/end |
| LOVVALGSLAND | VARCHAR2(99) | Country code |
| LOVVALG_BESTEMMELSE | VARCHAR2(99) | Legal provision |
| INNVILGELSE_RESULTAT | VARCHAR2(99) | Grant/denial result |
| MEDLEMSKAPSTYPE | VARCHAR2(99) | Membership type |
| TRYGDE_DEKNING | VARCHAR2(99) | Coverage type |
| Column | Type | Description |
|---|---|---|
| FOM_DATO / TOM_DATO | DATE | Period start/end |
| INNVILGELSE_RESULTAT | VARCHAR2(99) | Grant/denial |
| MEDLEMSKAPSTYPE | VARCHAR2(99) | Membership type |
| TRYGDE_DEKNING | VARCHAR2(99) | Coverage |
| BESTEMMELSE | VARCHAR2(99) | Legal basis |
| MEDLPERIODE_ID | NUMBER | MEDL external ID |
SELECT f.*, a.rolle, a.aktoer_id, a.orgnr, a.person_ident
FROM fagsak f
JOIN aktoer a ON a.saksnummer = f.saksnummer
WHERE f.saksnummer = 'MEL-12345';
SELECT b.*, f.saksnummer
FROM behandling b
JOIN fagsak f ON b.saksnummer = f.saksnummer
JOIN aktoer a ON a.saksnummer = f.saksnummer
WHERE a.rolle = 'BRUKER' AND a.person_ident = '12345678901'
AND b.status NOT IN ('AVSLUTTET');
SELECT mp.*
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.behandling_id
JOIN behandling b ON br.behandling_id = b.id
WHERE b.saksnummer = 'MEL-12345';
SELECT p.*, b.saksnummer, b.status as beh_status
FROM prosessinstans p
JOIN behandling b ON p.behandling_id = b.id
WHERE b.id = :behandlingId
ORDER BY p.registrert_dato DESC;
SELECT b.id, b.status, b.endret_dato, f.saksnummer
FROM behandling b
JOIN fagsak f ON b.saksnummer = f.saksnummer
WHERE b.status = 'IVERKSETTER_VEDTAK'
AND b.endret_dato < SYSDATE - INTERVAL '2' HOUR;
Latest migration is V155 (tekstblokker). Changes since V143:
| V | Date | What |
|---|---|---|
| V144 | 2026-01-07 | New PROSESS_STEG LAGRE_PERSONOPPLYSNINGER |
| V145 | 2026-01-15 | New PROSESS_STEG OPPRETTE_AARSAVREGNING_ENDRING (auto-opprett årsavregning tilbake i tid) |
| V146 | 2026-01-19 | saksopplysning_kilde adds versjon NUMBER(19) DEFAULT 0 — optimistic locking fix for orphanRemoval race condition |
| V147 | 2026-02-16 | New PROSESS_TYPE MELOSYS_MOTTAK_DIGITAL_SØKNAD + 4 nye steg (HENT_SØKNADSDATA, OPPRETT_SAK_OG_BEHANDLING_SØKNAD, OPPRETT_OG_FERDIGSTILL_JOURNALPOST_SØKNAD, LAGRE_SAKSOPPLYSNINGER_SØKNAD) |
| V148 | 2026-02-16 | kontaktopplysning.kontakt_telefon utvidet til VARCHAR2(255) |
| V149 | 2026-02-27 | Fjerner steg LAGRE_SAKSOPPLYSNINGER_SØKNAD (lagring nå i OPPRETT_SAK_OG_BEHANDLING_SØKNAD) |
| V150 | 2026-03-16 | New PROSESS_STEG AVSLUTT_AARSAVREGNINGER (lukker åpne årsavregninger ved annullering) |
| V151 | 2026-04-16 | helseutgift_dekkes_periode adds kilde VARCHAR2(30) DEFAULT 'MELOSYS' NOT NULL |
| V152 | 2026-04-20 | NEW TABLE skjema_sak_mapping (RAW(16) skjema_id ↔ saksnummer). New PROSESS_TYPE MELOSYS_MOTTAK_EKSISTERENDE_DIGITAL_SØKNAD. Steg fra V147 omdøpt til *_DIGITAL_SØKNAD-varianter (HENT_DIGITAL_SØKNADSDATA, OPPRETT_SAK_OG_BEHANDLING_DIGITAL_SØKNAD, OPPRETT_OG_FERDIGSTILL_JOURNALPOST_DIGITAL_SØKNAD) + nye HÅNDTER_EKSISTERENDE_SAK_DIGITAL_SØKNAD, SEND_SAKSNUMMER_TIL_MELOSYS_SKJEMA_API |
| V153 | 2026-04-23 | aarsavregning columns renamed: har_trygdeavgift_fra_avgiftssystemet → har_innbetalt_trygdeavgift, trygdeavgift_fra_avgiftssystemet → innbetalt_trygdeavgift |
| V154 | 2026-04-30 | medlemskapsperiode.kilde + lovvalg_periode.kilde added (VARCHAR2(30), nullable) |
| V155 | — | NEW TABLE tekstblokker (TEKSTBLOKK + TEKSTBLOKK_TAG, reusable text blocks with tags) |
Note on PROSESS_STEG renames (V152): Oracle doesn't support ON UPDATE CASCADE, so the pattern is INSERT new code → UPDATE child rows (PROSESSINSTANS.SIST_FULLFORT_STEG, PROSESSINSTANS_HENDELSER.STEG) → DELETE old code. Use this same pattern for any future PROSESS_STEG rename.
まだレビューはありません。使ってみた感想をお寄せください。
ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。
まだコメントはありません。最初のコメントを書いてみませんか。
Expert knowledge of Altinn A1 application processing for posted workers in melosys-api. Use when: (1) Understanding Altinn søknad/skjema processing, (2) Debugging MedlemskapArbeidEOS form mapping, (3) Understanding SoeknadMapper transformations, (4) Investigating posted worker application issues, (5) Understanding the MOTTAK_SOKNAD_ALTINN saga flow.
日本語の概要は準備中です。原文の説明を表示しています。
Expert knowledge of Employer/Employment integration (EREG/AAREG) in melosys-api. Use when: (1) Working with organization data from EREG (Enhetsregisteret), (2) Working with employment data from AAREG (Arbeidsforhold), (3) Understanding employer/organization lookup, (4) Debugging employer or employment issues, (5) Understanding the mapping between register data and domain models. Triggers: orgnummer, arbeidsforhold, EREG, AAREG, Enhetsregisteret, registeropplysninger, ansettelsesperiode, saksopplysning.
日本語の概要は準備中です。原文の説明を表示しています。
Modular monolith architecture overview for melosys-api. Use when needing to understand module structure, dependencies between modules, where to place new code, or when changes in one module might affect others. Triggers: "architecture", "module dependencies", "where should I put", "which modules", "dependency graph".
日本語の概要は準備中です。原文の説明を表示しています。
Expert knowledge of Behandling (case treatment) domain in melosys-api. Use when: (1) Understanding the behandling lifecycle and status transitions, (2) Debugging issues with behandling creation, status changes, or closure, (3) Understanding relationships between Fagsak, Behandling, and Behandlingsresultat, (4) Investigating why a behandling is stuck or has wrong status, (5) Understanding Behandlingstyper, Behandlingstema, Behandlingsstatus enums, (6) Debugging journalføring or SED-triggered behandling creation, (7) Understanding behandling creation via saksflyt sagas.
日本語の概要は準備中です。原文の説明を表示しています。
Expert knowledge of Behandlingsresultat (treatment result) domain in melosys-api. Use when: (1) Understanding result types and their meaning (FASTSATT_LOVVALGSLAND, MEDLEM_I_FOLKETRYGDEN, etc.), (2) Working with periods - Lovvalgsperiode, Medlemskapsperiode, Anmodningsperiode, Utpekingsperiode, (3) Debugging vedtak/decision metadata, criteria evaluation, or social insurance charges, (4) Understanding EU/EEA coordination logic and Article 16 exception handling, (5) Working with trygdeavgift (social insurance charge) calculations.
日本語の概要は準備中です。原文の説明を表示しています。
Expert knowledge of Brev (letter generation) in melosys-api. Use when: (1) Producing letters and decision documents (vedtaksbrev), (2) Understanding Dokgen templates and mapping, (3) Configuring letter recipients and distribution, (4) Debugging letter generation issues, (5) Adding new letter types or templates.
日本語の概要は準備中です。原文の説明を表示しています。