# ZFS_COLUMNAR_DB {db-root-0001}
> description: Salamannopea, indeksitC6n ja hajautettava ZFS-pohjainen
tietokanta. Append-only arkkitehtuuri.
> type: system
> status: mvp_active
## STORAGE_ARCHITECTURE {db-stor-0001}
> description: Datan ja metadatan fyysinen tallennusrakenne ja
tiedostojC$rjestelmC$tason indeksointi.
> type: architecture
### 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.
> type: data_structure
### CHUNK_SHADOW {db-stor-0003}
> description: Rinnakkainen varjotaulu (.shadow). SisC$ltC$C$ tagit, bitflagit
ja rutiini-ID:t suoralla pointteri-mC$ppC$yksellC$ dataan.
> type: data_structure
### FS_INDEXING {db-stor-0004}
> description: Hakemistopohjainen indeksointi. Base62-enkoodatut tiedostonimet
(Aikaleima + Flagit + Tag-Hash).
> type: indexing_logic
### CAS_BLOB_STORE {db-stor-0005}
> description: Content-Addressable Storage erillisille raskaantietueen
tiedostoille (.blob). Nimetty suoraan sisC$llC6n tiivisteen (hash) mukaan
deduplikoinnin takaamiseksi.
> type: storage
### 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).
> type: metadata
## 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).
> type: engine/native
> status: mvp_active
### MMAP_IO {db-core-0002}
> description: POSIX mmap() -toteutus ZFS ARC -vC$limuistin ja
C-muistiavaruuden suoraan yhdistC$miseen (Zero-Copy).
> type: logic
### SIMD_SEARCH {db-core-0003}
> description: Vektoroidut (AVX2 / AVX-512) hakualgoritmit sarakkeiden nopeaan
skannaukseen.
> type: logic
> status: planning
### DISPATCH_TABLE {db-core-0004}
> description: O(1) hakunopeuden sanakirja ja funktiopointterit datan
validointiin rutiini-ID:n perusteella.
> type: logic
### TCP_SERVER {db-core-0005}
> description: Nollariippuvuuden lokaali TCP-kuuntelija. Keskustelee
Proxy-kerroksen kanssa minimaalisella binC$C$rikehyksellC$ (esim. 8-tavuinen
header).
> type: interface
## WRITE_PIPELINE {db-write-0001}
> description: Datan asynkroninen ja skaalautuva sisC$C$notto ennen
ZFS-jC$C$dytystC$ (Append-Only).
> type: pipeline
> status: mvp_active
### ACTIVE_CHUNK {db-write-0002}
> description: Keskusmuistissa (RAM) elC$vC$ Lock-Free Ring Buffer, joka
vastaanottaa uudet insertit ja deltat atomisesti.
> type: buffer
### 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.
> type: logic
## PROXY_API_LAYER {db-proxy-0001}
> description: Vikasietoinen vC$lityspalvelin (esim. Node.js/FastAPI), joka
hoitaa verkkoliikenteen C-ytimen ulkopuolella.
> type: middleware
> status: mvp_active
### 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).
> type: buffer
> status: execution_pending
### 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.
> type: logic
> status: mvp_active
## READ_PIPELINE {db-read-0001}
> description: Hakukyselyiden reititys ylemmC$ltC$ tasolta ZFS-hakemiston ja
C-moottorin lC$pi.
> type: pipeline
> status: mvp_active
### QUERY_PARSER {db-read-0002}
> description: KC$C$ntC$C$ API-haut regex/glob -muotoisiksi ZFS Base62
-tiedostonimihauiksi ennen ytimeen vientiC$.
> type: logic
> status: mvp_active
### 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.
> type: logic
> status: mvp_active
## LIFECYCLE_MGR {db-life-0001}
> description: Datan tiivistC$minen ja roskienkeruu.
> type: manager
> status: mvp_active
### 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.
> type: logic
> status: mvp_active
### 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.
> type: logic
> status: mvp_active
### 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$.
> type: logic
> status: mvp_active
## 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$.
> type: infrastructure
> status: mvp_active
### FS_STATUS_DIR {db-signal-0002}
> description: Atomisiin tiedosto-operaatioihin (touch, rm, mv) perustuva
lokaali signaalihakemisto (esim. /run/triggers/). Toimii Lock-Free
viestijonona.
> type: structure
> status: mvp_active
### CONTROL_DAEMON {db-signal-0003}
> description: Kevyt hallintaprosessi, joka tarjoaa REST-rajapinnan.
Mesh-verkon solmut voivat tilata (subscribe) ilmoituksia tietyistC$
trigger-tiedostoista.
> type: service
> status: mvp_active
### 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$.
> type: logic
> status: mvp_active