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, lifecycle-manager og første version af det centrale component Registry er implementeret. Resolver-, Context-, classloader-, discovery-, runtime-loading-, 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. De konkrete operationer følger serviceområdet: JournalServiceManager har start, stop, data location, refresh og adgang til JournalService, mens første Registry service manager bevidst kun eksponerer start. Det er ikke det daglige domain/query-API for almindelige consumers.
Nenjim component	En færdigkonstrueret Nenjim-byggeklods, som er klar til brug. Dens konkrete rolle som service, applikation, algoritme eller adapter bestemmes af consumeren; NenjimComponent er en ren marker uden ID eller lifecycle state.
NenjimApplication	Et component interface med én fælles start()-operation. Første version lover ikke et fælles stop(). En konkret serviceimplementation kan implementere dette interface uden at lifecycle føjes til dens domain service interface.
NenjimComponentId	Canonical lower-case Registry lookup identity med dot-separated segments og valgfrie interne bindestreger. ID'et er registration metadata i ét Registry, ikke object state, authorization eller artifact-version identity.
NenjimRegistryService	Read-only component-katalog for almindelige consumers. Det giver immutable registration-order ID snapshots og typed lookup, men ingen registration, removal, loading, lifecycle, permission eller persistence administration.
NenjimRegistryServiceAdmin	Package-private registrationshandle i referenceimplementationen. Det er ikke en component, er ikke indexeret og udleveres ikke til almindelige consumers.
NenjimRegistryServiceManager	Public lifecycle/composition API med kun start() i første version. Referenceimplementationen konstruerer Registry og den hardcodede component graph, registrerer ID'er og aktiverer kun den eksplicit valgte application subset.
Component registration	Bindingen mellem ét NenjimComponentId og ét object. Én registration indexeres under alle objektets component interfaces; flere forskellige ID'er må pege på præcis samme object instance.
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 og isoleret runtime; ikke implementeret af Journal-laget eller første Registry-version.
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).