com_r35157_nenjim-hubd-impl_ref/docs/Terminologi.md

Tekniske termer

Dokumentstatus: Journal-format version 1 og de tilhørende Java-typer, den interne parser, query-service og lifecycle-manager er implementeret. Resolver-, Context-, classloader-, retrieval- og publishing-termer beskriver kun fremtidig vision, når det er angivet.

Term	Beskrivelse
Service	Det offentlige domæne-API, som applikationer og andre services bruger i daglig drift. Det eksponerer almindelige domæneoperationer, men ikke lifecycle, configuration, data-source administration, refresh, parser eller mutation af intern viden.
ServiceManager	Det offentlige lifecycle- og administrations-API, som en composition/lifecycle owner bruger til start, stop, configuration/data location, refresh og adgang til den tilhørende Service efter vellykket initialisering. Det er ikke det query-API, som almindelige consumers bruger.
Journal	Et immutable, komplet snapshot af al aktuel viden om præcis én artifakt og dens kendte releases. Journalen er aldrig en delta.
ArtifactCoordinate	Journal-kædens stabile identitet, udledt som <GROUP>-<MODULE>-<ARTIFACT>, f.eks. com_r35157_nenjim-hubd-api. Der findes intet separat JournalId.
JournalVersion	Journal-snapshottets publiceringstid som UTC med millisekundpræcision: uuuuMMddHHmmssSSS'Z'. Den er forskellig fra en releases PUBLISHED_AT.
Journal-kæde	Én genesis og en lineær række immutable snapshots for samme coordinate. Hver efterfølger refererer med SHA-256 til forgængerens eksakte UTF-8-tekst.
Historisk worldview	Hele det snapshot, som var nyest på eller før en valgt JournalVersion; det beregnes ikke ved at filtrere et nyere snapshot efter release-tid.
Artifact release	En eksakt stabil major.minor.patch-version af én artifakt med per-release licens, publication time, content digests, content size og dependencies.
DESCRIPTION	Obligatorisk single-quoted artifactbeskrivelse i [METADATA]; decoded tekst kan ændres i en senere Journal-revision.
INFORMATION_URI	Valgfri single-quoted, syntaktisk gyldig absolut URI. Alle schemes er tilladt; indholdet åbnes eller fortolkes ikke automatisk.
LICENSE	Obligatorisk single-quoted fri tekst for hver release. Den normaliseres eller juridisk fortolkes ikke; fremtidig filtrering er ikke implementeret.
ContentDigest	Valideret indholdsidentitet. Format 1 understøtter sha256 og CIDv1 (cid1), men downloader eller verificerer ikke artifact-bytes.
SemanticVersion	Én eksakt stabil artifaktrelease med major, minor og patch. Prerelease/build metadata understøttes ikke i format 1.
VersionExpression	Et normaliseret sæt acceptable releases: exact, minor-serie eller inclusive/exclusive/open range. Mathematical comparison syntax understøttes ikke.
DependencyTarget	Et explicit scheme og et scheme-specifikt target. Format 1 implementerer kun nenjim:<artifact-coordinate>; Maven-resolution er fremtidig.
DEPENDS_ON	Den hårde basisramme af acceptable releases for én dependency-relation.
EXCLUDES	En hård relationel regel, som fjerner versioner fra én bestemt DEPENDS_ON. Individuelle beskrivelser bevares.
PREFERRED	Et hint til en delmængde af DEPENDS_ON - EXCLUDES; det kan aldrig gøre en ellers ugyldig version gyldig.
BLACKLIST	En hård artifact-policy: matchende releases må ikke vælges.
DISCOURAGED	Et negativt artifact-policy-hint: matchende releases bør undgås, men er fortsat selectable.
RECOMMENDED	Et positivt hint til én eksakt release, der findes i samme snapshot. Højeste version er kun en fremtidig fallback, ikke en ubetinget selection-regel.
JournalService	Filesystem-uafhængigt, read-only Service-API for current og historical Journal-queries. Det eksponerer ingen lifecycle-, path-, refresh-, parser- eller mutationsoperationer.
JournalServiceManager	Lifecycle- og administrations-API for JournalService. Det ejer den normaliserede data root, udfører komplet initial loading ved start, stopper servicen, udfører explicit refresh og udleverer JournalService efter vellykket initialisering.
Journal referenceimplementation	JournalServiceImpl, JournalServiceManagerImpl, JournalTextParser, intern ingestion, chain state og filesystem-loading under com.r35157.nenjim.service.journal.impl.ref; implementation details lækker ikke gennem public signatures.
Context	Fremtidig beskrivelse af ønskede/resolverede artifactvalg; ikke implementeret af denne Journal-change.
Resolver	Fremtidig komponent for dependency graph og release-selection; Journal-laget repræsenterer reglerne, men vælger ikke en graf.

Domænespecifikke termer

Term	Beskrivelse
Position Value	Den samlede nutidsværdi af en position (nuværende pris × antal).
Base Value	Den pris det har kostet at købe positionen (gennemsnitlig købspris × antal).
Margin Value	Den pris man faktisk har betalt for en gearet position (base value / gearing).