RG2
Maskinlesbar registerfil
Denne sida fastset den maskinlesbare registerfila for Røyndsgransking. JSON-registeret gjer publiserte døme, protokollar, registerpostar og rettingslogg sporbare utan å gjera registeret til ei ny kjelde for funn.
Funksjon og grense
Den maskinlesbare registerfila gjev eit stabilt offentleg JSON-lag for nettstaden. Ho kan brukast av interne verktøy, arkiv, søk, framtidige visualiseringar og eksterne lesarar som treng strukturert metadata.
Fila inneheld berre offentleg metadata: kode, tittel, lenkje, type, livsløpsstatus, publiseringsnivå, bruksområde, granskingstypar, versjon og rettingsstatus. Ho publiserer ikkje skjult materiale, råkjelder, personopplysningar eller ikkje-offentlege saksmatriser.
JSON-registeret er eit hjelpemiddel for sporbarheit. Det avgjer ikkje funn, aukar ikkje funnstyrke og erstattar ikkje den menneskelesbare saksframstillinga.
JSON-endepunkt
Nynorsk JSON
Kanonisk maskinlesbar registerfil for nynorsk publisering.
/royndsgransking/dome/register.jsonEnglish JSON
Canonical machine-readable register file for English publication.
/en/reality-audit/examples/register.jsonMenneskelesbar forklaring
Denne sida med forklaring av felt, grenser og vern.
/royndsgransking/dome/maskinlesbart-register/Skjema og felt
Skjemaet er medvite lite og stabilt. Det skal vera lett å lesa, eksportera og kontrollera utan å låsa framtidige saker til eit for tidleg teknisk format.
Alle lenkjer i JSON-nyttelasta er absolutte. Kodeverdiane er språknøytrale der det er metodisk viktig, medan etikettane følgjer vald språkversjon.
| Felt | Type | Forklaring |
|---|---|---|
| schema | string | Stabil identifikator for registerfamilien. |
| schemaVersion | string | Versjon av JSON-strukturen, ikkje nødvendigvis versjon av kvar sak. |
| language | nn | en | Språkversjonen for etikettar og samandrag. |
| counts | object | Tal på registerpostar, revisjonspostar og publiserte faktiske saker. |
| register[] | array | Publiserte døme, protokollar, register og framtidige faktiske saker. |
| revisions[] | array | Synlege rettingar, publiseringar, gjenopningar og revisjonar frå RG3. |
| correctionStatus | object | Kode og etikett for om retting er open, korrigert eller lukka. |
| domains / auditTypes | array | D1–D8 og A1–A7 som metadata, ikkje som funn. |
Innhald i registeret
Registerfila samlar metadata frå RG1 og RG3. Ho inneheld dei same offentlege objekta som er publiserte på nettstaden, men i eit format som kan lesast maskinelt.
Det finst framleis ingen publiserte faktiske saker. Dette vert òg uttrykt i JSON-teljaren publishedActualCases.
Døme
Syntetiske døme vert merkte som synthetic og skal ikkje lesast som faktiske hendingar.
Protokollar
CP1 og CA1 vert merkte som protocol; dei er metodetekstar, ikkje saker.
Register
RG1, RG2 og RG3 vert merkte som register og viser infrastruktur for sporing og retting.
Faktiske saker
Framtidige faktiske saker kan førast inn først når relevant protokoll, status og publiseringsnivå er på plass.
Versjon og revisjon
JSON-fila tek med rettings- og revisjonsloggen slik at endringar kan sporast av både menneske og maskiner.
Ei ny versjon av JSON-fila er ikkje i seg sjølv ei materiell retting. Materiell retting krev eigen loggpost, grunn, omfang og status.
Objektkopling
Kvar revisjon peikar tilbake til objektkode og menneskelesbar side.
Versjon før og etter
Loggen skil første publisering, presisering, materiell retting og metoderevisjon.
Nedstraums spor
Maskinlesbar status gjer det mogleg å finna postar som må oppdaterast vidare.
Språkparallelitet
NN og EN nyttelast har same kodar, men eigne etikettar og kanoniske lenkjer.
Vern og misbrukssperrer
Eit maskinlesbart register kan auka sporbarheit, men kan òg misbrukast dersom det vert lese som personregister eller domsregister. Difor er feltutvalet avgrensa.
Ingen råmateriale
Fila skal ikkje innehalda kjelder, interne notat, private dokument eller ikkje-offentlege matriser.
Ingen personregistereffekt
Framtidige faktiske saker skal ikkje eksponera personnamn eller sensitive indirekte identifikatorar gjennom metadatafelt.
Status er ikkje funn
LS-status, PL-nivå og rettingsstatus er metodisk metadata, ikkje konklusjonar om saka.
Rett kanal for retting
Maskinlesbare feil skal kunna rettast gjennom same revisjons- og rettingslogg som menneskelesbare dokument.
Absolutte lenkjer
Nyttelasta brukar absolutte URL-ar for å hindra tvitydig kopling ved kopiering og arkivering.
Ingen skjult autoritet
Registerfila er ikkje autoritativ overfor det menneskelesbare dokumentet; ved konflikt må dokument og revisjonslogg kontrollerast.
Implementering og vidare program
Første versjon vert publisert som statisk JSON frå Astro. Seinare kan same struktur brukast for nedlasting, arkivering, visualisering, intern validering og offentleg API-liknande tilgang.
Statisk eksport
Fila vert bygd saman med nettstaden og krev ingen database eller brukarsporing.
Skjemaversjon
Endring av feltstruktur skal krevja schemaVersion-endring og RG3-loggpost.
Validering
Framtidig validering kan kontrollera at alle publiserte sider finst, har revisjonslogg og har korrekte språkpar.
Vidare program
Neste steg kan vera nedlastbare CSV/JSON-utdrag, intern valideringsrapport eller visualisert registerkart.