melosys-api

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.

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.

Build and push multi-platform Docker images to Google Artifact Registry. Use when user asks to build, push, or deploy a Docker image with a tag. Triggers: "build and push", "push docker image", "build with tag", "deploy image".

Expert knowledge of EESSI integration via EUX/RINA in melosys-api. Use when: (1) Understanding BUC lifecycle and SED exchange (A-series A001-A012, X-series X001-X013, plus H_BUC/UB_BUC), (2) Debugging SED sending/receiving via EessiClient (opprettBucOgSed, sendSedPåEksisterendeBuc, X008 invalidation, X009 purring), (3) Understanding LA_BUC types and their purposes, (4) Investigating EUX API errors, RINA case (rina saksnummer / saksrelasjon) lookup, (5) Understanding mottakerinstitusjoner / institution catalog lookup.

Expert knowledge of EU/EEA social security coordination regulations in melosys-api. Use when: (1) Understanding EU Regulation 883/2004 and 987/2009 framework, (2) Understanding personal and material scope of coordination, (3) Understanding coordination principles (single legislation, lex loci laboris), (4) Understanding territorial scope (EU, EEA, Switzerland, UK), (5) Understanding the relationship between Sakstyper.EU_EOS and regulations, (6) Understanding how EESSI integrates with regulation procedures.

Expert knowledge of Fagsak (case) domain in melosys-api. Use when: (1) Understanding the fagsak lifecycle and status transitions, (2) Working with actors (aktører) - citizens, employers, authorities, (3) Debugging case creation, closure, or type/theme changes, (4) Understanding relationship between fagsak and behandling, (5) Working with EU/EEA authorities or bilateral treaty authorities. Triggers: "fagsak", "saksnummer", "MEL-", "aktør", "sakstype", "sakstema", "avslutt sak".

Expert knowledge of Flyway database migrations in melosys-api (Oracle DB). Use when: (1) Creating new database migrations, (2) Understanding migration versioning and naming, (3) Debugging migration failures, (4) Understanding Oracle-specific SQL patterns, (5) Adding tables, columns, or indexes. Triggers: "create migration", "new Flyway migration", "add column/table/index", "Flyway error", "checksum mismatch", "ORA-00955", "ORA-02292", "ORA-01430", "migration failed", "validate failed".

Expert knowledge of REST endpoint patterns in melosys-api's frontend-api module. Use when: (1) Creating new REST endpoints for melosys-web, (2) Understanding controller patterns and Swagger documentation, (3) Working with DTOs and request/response objects, (4) Understanding exception handling and HTTP status codes, (5) Adding access control to endpoints. Triggers: "new endpoint", "REST controller", "@RestController", "add a DTO", "ResponseEntity", "Aksesskontroll", "access control on endpoint", "Swagger/@Operation", "return 404/403/401/400", "@Protected", "frontend-api", "search endpoint", "/sok".

Expert knowledge of Folketrygdloven (National Insurance Act) processing in melosys-api. Use when: (1) Understanding FTRL bestemmelser (§2-5 to §2-13), (2) Debugging yrkesaktiv/ikke-yrkesaktiv/pensjonist processing flows, (3) Understanding trygdedekning options and combinations, (4) Investigating vilkår for each bestemmelse, (5) Understanding medlemskapsperiode generation logic, (6) Debugging frivillig vs pliktig membership determination.

Expert knowledge of income and tax integrations in melosys-api. Use when: (1) Understanding Inntektskomponenten/A-inntekt lookups, (2) Debugging skattehendelser Kafka processing, (3) Understanding årsavregning triggered by skatteoppgjør, (4) Investigating income data for trygdeavgift calculations.

External integrations overview for melosys-api including REST/SOAP services, Kafka topics, databases, and support services. Use when adding new integrations, debugging external calls, understanding data flow, or troubleshooting connectivity. Triggers: "integration", "external service", "consumer", "kafka topic", "REST client".

Expert knowledge of Journalføring (document archiving) in melosys-api. Use when: (1) Creating/updating journalposts (Joark API), (2) Retrieving documents from SAF (GraphQL), (3) Understanding document workflows, (4) Debugging journalpost issues, (5) Mapping document types and categories. Triggers: "journalpost", "journalføring", "Joark", "dokarkiv", "SAF", "dokumentoversikt", "hentDokument", "ferdigstill journalpost", "Variantformat".

Expert knowledge of Kafka event streaming patterns in melosys-api. Use when: (1) Understanding Kafka producers and consumers, (2) Debugging Kafka message processing issues, (3) Understanding topic configuration and message schemas, (4) Investigating SkippableKafkaErrorHandler and error handling, (5) Understanding Aiven Kafka setup and security configuration.

Expert knowledge of Kodeverk (code registry/enums) system in melosys-api. Use when: (1) Understanding enums (Sakstyper, Behandlingstyper, Behandlingstema, etc.), (2) Validating legal combinations of case/treatment types, (3) Debugging "ugyldig kombinasjon" errors, (4) Adding new enum values or combinations, (5) Mapping between internal codes and external systems (MEDL, Oppgave, SED).

Expert knowledge of lovvalg (law determination/applicable legislation) domain in melosys-api. Use when: (1) Understanding which EU/EEA article applies (11, 12, 13, 16), (2) Debugging LA_BUC processing and SED sending/receiving, (3) Understanding A1 attestation generation, (4) Investigating lovvalgsperiode and unntaksperiode management, (5) Understanding automatic vs manual lovvalg determination, (6) Debugging lovvalgsbeslutning status transitions, (7) Understanding the mapping between regulations and kodeverk.

Expert knowledge of MEDL (Medlemskapsregister) integration in melosys-api. Use when: (1) Debugging MEDL period creation/update failures, (2) Understanding data mapping between domain entities and MEDL API, (3) Working with saga steps that write to MEDL (LagreMedlemsperiodeMedl, LagreLovvalgsperiodeMedl), (4) Understanding MEDL enums (PeriodestatusMedl, LovvalgMedl, DekningMedl, GrunnlagMedl), (5) Troubleshooting Article 13 provisional vs final period logic.

Expert knowledge of membership (medlemskap) domain in melosys-api. Use when: (1) Understanding pliktig vs frivillig membership determination, (2) Debugging medlemskapsperiode creation and updates, (3) Understanding trygdedekning combinations and rules, (4) Investigating MEDL synchronization issues, (5) Understanding membership status transitions and innvilgelsesresultat, (6) Working with UtledMedlemskapsperioder for proposal generation, (7) Understanding the relationship between bestemmelse, medlemskapstype, and trygdedekning. Triggers: medlemskapsperiode, pliktig, frivillig, trygdedekning, MEDL, innvilgelsesresultat, medlPeriodeID, bestemmelse.

Received application data (MottatteOpplysninger) patterns for A1 applications, SED-based cases, and exception requests. Use when working with application forms, person/employer data, work locations, or modifying MottatteOpplysningerData subclasses. Triggers: "mottatteopplysninger", "søknad data", "application form", "MottatteOpplysningerData".

Expert knowledge of Oppgave (task management) integration in melosys-api. Use when: (1) Creating, updating, or closing oppgaver (tasks), (2) Understanding task types (BEH_SAK_MK, VUR, JFR) and priorities, (3) Debugging task assignment or reuse logic, (4) Working with saga steps for oppgave handling, (5) Understanding sensitive case routing (NAV Viken vs Melosys unit).

Expert knowledge of Person data integration (PDL) in melosys-api. Use when: (1) Working with person data from PDL (Person Data Lake), (2) Understanding identity types (fnr, aktørID, NPID), (3) Working with addresses, family relations, or citizenship, (4) Debugging person data lookup issues, (5) Understanding the mapping between PDL and domain models.

Expert knowledge of the saksflyt saga pattern implementation in melosys-api. Use when: (1) Debugging or modifying process flows (Prosessinstans, ProsessType, ProsessSteg), (2) Understanding async step execution and locking mechanisms (låsReferanse), (3) Investigating race conditions, OptimisticLockingException, or entity overwrites, (4) Moving event listeners to saga steps to avoid sync/async conflicts, (5) Adding new process types or steps, (6) Deciding whether to use @DynamicUpdate on entities.

Expert knowledge of authentication and authorization patterns in melosys-api. Use when: (1) Understanding Azure AD/OIDC authentication, (2) Debugging Tilgangsmaskinen access control, (3) Understanding SubjectHandler and user context, (4) Configuring OAuth2 clients for service-to-service calls, (5) Understanding audit logging patterns.

Expert knowledge of SED/EESSI integration in melosys-api. Use when: (1) Understanding SED document types (A001, A003, H-series, X008), (2) Debugging SED sending/receiving flows and RINA integration, (3) Working with BUC (Business Use Case) creation and management, (4) Understanding saga steps for SED handling (SEND_VEDTAK_UTLAND, SED_MOTTAK_RUTING), (5) Troubleshooting mottakerinstitusjoner (recipient institutions) issues.

Expert knowledge of A1 statistics publishing to data warehouse in melosys-api. Use when: (1) Understanding utstedt A1 Kafka publishing, (2) Debugging UtstedtA1Service or Kafka producer issues, (3) Understanding DVH/data warehouse integration, (4) Investigating A1 statistics message format and schema.

Expert knowledge of testing patterns and strategies in melosys-api. Use when: (1) Writing unit tests with JUnit 5 or Kotest, (2) Setting up integration tests with Testcontainers, (3) Understanding the test base classes and hierarchy, (4) Using ArchUnit for architecture tests, (5) Configuring embedded Kafka for testing, (6) Understanding mock patterns and test utilities, (7) Creating test data with the forTest DSL.

Expert knowledge of trygdeavgift (social insurance charge) domain in melosys-api. Use when: (1) Understanding avgift calculation for different member types, (2) Debugging årsavregning (annual reconciliation) processing, (3) Understanding fakturering flow to OEBS/faktureringskomponenten, (4) Investigating avgiftssatser and calculation rules per year, (5) Understanding skatteforhold and inntektskilder, (6) Debugging trygdeavgiftsperiode generation and storage, (7) Understanding the 25% rule and minstebeløp calculations.

Expert knowledge of bilateral social security agreements (trygdeavtaler) in melosys-api. Use when: (1) Understanding which countries have agreements with Norway, (2) Debugging Sakstyper.TRYGDEAVTALE processing, (3) Understanding lovvalgsbestemmelser for specific agreement countries, (4) Investigating TrygdeavtaleVedtakService and attestation generation, (5) Understanding differences between EU/EEA and bilateral agreement handling.

Expert knowledge of vedtak (verdict) processing in melosys-api using the saksflyt saga pattern. Use when: (1) Debugging vedtak-related issues or failures in IVERKSETT_VEDTAK_* processes, (2) Investigating race conditions where vedtak fails due to concurrent operations, (3) Understanding how fattVedtak triggers MEDL updates, letters, invoices, and case closure, (4) Tracing why vedtak got stuck or failed at specific steps, (5) Understanding the relationship between VedtakService classes and Prosessinstans, (6) Debugging issues with brev (letters), fakturering (invoicing), or MEDL registration.

Expert knowledge of vilkår / vilkårsvurdering (requirements evaluation) in melosys-api. Use when: (1) Understanding inngangsvilkår structure for FTRL bestemmelser (VilkårForBestemmelse), (2) Debugging Vilkaarsresultat / oppfylt status or begrunnelser, (3) Understanding avklarte fakta (AvklarteFaktaForBestemmelse) collection, (4) Investigating why a vilkår fails or which vilkår a bestemmelse requires. Triggers: vilkår, vilkaar, vilkaarsresultat, vilkårsvurdering, oppfylt, begrunnelse, inngangsvilkår, avklarte fakta, FTRL_2_5, FTRL_2_8, VilkårForBestemmelse.