# ZFS_COLUMNAR_DB {db-root-0001}
> description: Salamannopea, indeksitC6n ja hajautettava ZFS-pohjainen
tietokanta. Append-only arkkitehtuuri.
## STORAGE_ARCHITECTURE {db-stor-0001}
> description: Datan ja metadatan fyysinen tallennusrakenne ja
tiedostojC$rjestelmC$tason indeksointi.
### CHUNK_DATA {db-stor-0002}
> description: Varsinainen data-chunk (.chunk). Tiivis sarakepohjainen
(columnar) kiinteC$mittainen rakenne. Raskaat datat (teksti/binC$C$ri)
tallennetaan vain 32-tavuisina Blake3/SHA256 -hasheina.
### CHUNK_SHADOW {db-stor-0003}
> description: Rinnakkainen varjotaulu (.shadow). SisC$ltC$C$ tagit, bitflagit
ja rutiini-ID:t suoralla pointteri-mC$ppC$yksellC$ dataan.
### FS_INDEXING {db-stor-0004}
> description: Hakemistopohjainen indeksointi. Base62-enkoodatut tiedostonimet
(Aikaleima + Flagit + Tag-Hash).
### CAS_BLOB_STORE {db-stor-0005}
> description: Content-Addressable Storage erillisille raskaantietueen
tiedostoille (.blob). Nimetty suoraan sisC$llC6n tiivisteen (hash) mukaan
deduplikoinnin takaamiseksi.
### BLOB_METADATA {db-stor-0006}
> description: Rinnakkainen aputiedosto (.blob.meta). Append-only
tekstitiedosto, johon lokitetaan kaikki BLOBiin viittaavat taulukot ja rivit
roskienkeruuta varten (Back-references).
## CORE_ENGINE_C {db-core-0001}
> description: Natiivi, staattisesti konfiguroitu C-kielinen tietokantamoottori
 absoluuttiseen suorituskykyyn. Suoritetaan eristettynC$, itsenC$isenC$
binC$C$rinC$ (ei .so -kirjastona).
### MMAP_IO {db-core-0002}
> description: POSIX mmap() -toteutus ZFS ARC -vC$limuistin ja
C-muistiavaruuden suoraan yhdistC$miseen (Zero-Copy).
### SIMD_SEARCH {db-core-0003}
> description: Vektoroidut (AVX2 / AVX-512) hakualgoritmit sarakkeiden nopeaan
skannaukseen.
### DISPATCH_TABLE {db-core-0004}
> description: O(1) hakunopeuden sanakirja ja funktiopointterit datan
validointiin rutiini-ID:n perusteella.
### TCP_SERVER {db-core-0005}
> description: Nollariippuvuuden lokaali TCP-kuuntelija. Keskustelee
Proxy-kerroksen kanssa minimaalisella binC$C$rikehyksellC$ (esim. 8-tavuinen
header).
## WRITE_PIPELINE {db-write-0001}
> description: Datan asynkroninen ja skaalautuva sisC$C$notto ennen
ZFS-jC$C$dytystC$ (Append-Only).
### ACTIVE_CHUNK {db-write-0002}
> description: Keskusmuistissa (RAM) elC$vC$ Lock-Free Ring Buffer, joka
vastaanottaa uudet insertit ja deltat atomisesti.
### ASYNC_FLUSH {db-write-0003}
> description: TaustasC$ie, joka jC$C$dyttC$C$ tC$yttyneen Active Chunkin ja
kirjoittaa .chunk ja .shadow -tiedostot levylle sekventiaalisesti uutena
versiona.
## PROXY_API_LAYER {db-proxy-0001}
> description: Vikasietoinen vC$lityspalvelin (esim. Node.js/FastAPI), joka
hoitaa verkkoliikenteen C-ytimen ulkopuolella.
### INTENT_BUFFER {db-proxy-0002}
> description: Dynaaminen, sessiopohjainen staging-alue Proxy-kerroksessa
(All-or-Nothing). Puskuroi erC$ajot joko RAM-muistiin tai levylle (WAL) ennen
TCP-siirtoa C-ytimelle. Mahdollistaa keskeytyneiden siirtojen turvallisen
perumisen (Rollback).
### BLOB_ROUTER {db-proxy-0003}
> description: Sieppaa ylisuuret tekstit ja binC$C$rit, laskee
Blake3/SHA-hashin, kirjoittaa tiedoston CAS_BLOB_STORE:en ja lC$hettC$C$
C-ytimelle vain 32-tavuisen tiivisteen.
## READ_PIPELINE {db-read-0001}
> description: Hakukyselyiden reititys ylemmC$ltC$ tasolta ZFS-hakemiston ja
C-moottorin lC$pi.
### QUERY_PARSER {db-read-0002}
> description: KC$C$ntC$C$ API-haut regex/glob -muotoisiksi ZFS Base62
-tiedostonimihauiksi ennen ytimeen vientiC$.
### BLOB_RESOLVER {db-read-0003}
> description: Jos C-ydin palauttaa raskaaseen dataan viittaavan 32-tavuisen
tiivisteen, Proxy-kerros hakee automaattisesti oikean datan CAS_BLOB_STORE:sta
levyltC$ ja liittC$C$ sen asiakkaalle lC$htevC$C$n vastaukseen.
## LIFECYCLE_MGR {db-life-0001}
> description: Datan tiivistC$minen ja roskienkeruu.
### COMPACT_ORCHESTRATOR {db-life-0002}
> description: Python-pohjainen taustaprosessi. Vastaanottaa chunk_frozen
-signaalin, analysoi ZFS-hakemiston liian pienten/pC$C$llekkC$isten chunkkien
varalta ja delegoi tyC6n C-moottorille.
### COMPACT_ENGINE_C {db-life-0003}
> description: ItsenC$inen C-kielinen mmap-binC$C$ri (db_compact). Lukee
sisC$C$n useita .chunk/.shadow -pareja, yhdistC$C$ datan muistissa
(reconciliation) ja kirjoittaa ulos uuden eheC$n 1M-optimoidun chunkin.
### LAZY_GC {db-life-0004}
> description: TaustasC$ie, joka analysoi .blob.meta -lokeja. Jos yksikC$C$n
taulu/chunk ei enC$C$ viittaa BLOBiin (tai viittaavat chunkit on tuhottu),
BLOB poistetaan levyltC$.
## SIGNAL_MESH {db-signal-0001}
> description: Riippumaton, tiedostojC$rjestelmC$C$n pohjautuva trigger- ja
signaalivC$ylC$ tietokannan ja ympC$rC6ivC$n Mesh-verkon vC$lillC$.
### FS_STATUS_DIR {db-signal-0002}
> description: Atomisiin tiedosto-operaatioihin (touch, rm, mv) perustuva
lokaali signaalihakemisto (esim. /run/triggers/). Toimii Lock-Free
viestijonona.
### CONTROL_DAEMON {db-signal-0003}
> description: Kevyt hallintaprosessi, joka tarjoaa REST-rajapinnan.
Mesh-verkon solmut voivat tilata (subscribe) ilmoituksia tietyistC$
trigger-tiedostoista.
### DISPATCH_WORKER {db-signal-0004}
> description: Inotify/poll-pohjainen eristetty taustasC$ie. Monitoroi
FS_STATUS_DIR-hakemistoa, lukee tilaajalistat ja laukaisee asynkroniset
REST-callbackit tukkimatta tietokannan ydintC$.
## SPOOL_MAILBOX_LAYER {db-spool-0001}
> description: Asynkroninen, POSIX-tiedostojC$rjestelmC$C$n ja ZFS-lukkoihin
perustuva solmujen vC$linen siirtokerros (Airgap/High-Latency -yhteensopiva).
### SPOOL_QUARANTINE {db-spool-0010}
> description: Karanteenihakemisto (/mnt/zfs-db/spool/quarantine/)
korruptoituneelle tai hylC$tylle datalle (Dead Letter Office).
### POISON_PILL_HANDLING {db-spool-0011}
> description: HylkC$ys- ja diagnostiikkalogiikka INBOX_WATCHER-prosessissa.
Jos saapuvan BLOBin kryptografinen tiiviste (Hash) ei tC$smC$C$ tai metadatan
luku epC$onnistuu, viestin kaikki osat (mukaan lukien atominen lukko)
siirretC$C$n karanteeniin.
### SPOOL_INBOX {db-spool-0002}
> description: Saapuvan datan puskurihakemisto (/mnt/zfs-db/spool/inbox/).
Vastaanottaa viestejC$ siirtokerrokselta (esim. rsync, USB, satelliitti)
riippumatta verkkoprotokollista.
### THREE_PHASE_HANDSHAKE {db-spool-0003}
> description: Kolmivaiheinen tiedostojen siirtomekanismi. Takaa
keskenerC$isten viestien hylkC$C$misen (.meta.start, .blob, .meta.end).
### INBOX_WATCHER {db-spool-0004}
> description: Inotify/poll -pohjainen taustaprosessi. Monitoroi .meta.end
-tiedostoja, kC$yttC$C$ atomista os.rename() POSIX-lukitusta, validoi
sisC$llC6n (SHA256) ja purkaa intentin jC$rjestelmC$n sisC$iseen kC$sittelyyn.
### SPOOL_OUTBOX {db-spool-0005}
> description: LC$htevien viestien puskurihakemisto. JC$rjestelmC$ kirjoittaa
viestin valmiina pakettina, josta Mesh-verkon vikasietoinen siirtomekanismi
poimii sen ja reitittC$C$ maailmalle.
### HEARTBEAT_WATCHDOG {db-spool-0006}
> description: Siirtojen aikainen vikasietomekanismi. Kuriiri pC$ivittC$C$
.lock -tiedoston muokkausaikaa sC$C$nnC6llisesti siirron aikana. Watchdog
tarkkailee orpoja lukkoja ja siirtC$C$ kaatuneet siirrot takaisin OUTBOXiin
uudelleenkC$sittelyC$ varten (Self-Healing).