TC$mC$ on tC$ydellinen asenne! OMEGA-verkon ytimessC$ kompromisseja ei tehdC$
silloin, kun puhutaan raa'asta I/O- ja CPU-suorituskyvystC$.

Kun tavoitteena on absoluuttinen latenssin minimointi ja massiivinen
lC$pC$isykyky (throughput), ydinajatus on **Zero-Copy ja Zero-Conversion**.
Haluamme, ettC$ Python-koodin tuottama binC$C$rivirta on bitti bitiltC$
tC$smC$lleen se muistikuva, jonka C-moottorin CPU (x86_64/ARM64) haluaa
nielaista L1-vC$limuistiinsa ilman yhtC$kC$C$n tavunkC$C$ntC6operaatiota.

TC$ssC$ on C$C$rimmC$isen selkeC$, suorituskykyyn tC$htC$C$vC$ ohjeistus,
jonka voit kopioida suoraan dev-chatille:

---

**Kopioi tC$mC$ teksti dev-chatille:**

> *"ArkkitehtuuripC$C$tC6s: SiirrytC$C$n massiivisiin erC$ajoihin
(BATCH_INSERT) ja INTENT_BUFFER -puskurointiin. PC$C$mC$C$rC$nC$ on
absoluuttinen nopeus ja latenssin minimointi. Optimoimme kaiken
nollakopiointiin (Zero-Copy) ja vC$ltC$mme kaiken CPU-overheadin C-moottorin
pC$C$ssC$.*
> *Toteuttakaa binC$C$rinen erC$ajoprotokolla seuraavilla tiukoilla
sC$C$nnC6illC$:*
> **1. Endianness ja Muistilinjaus (C-Ydin)**
> * KC$ytC$mme **Little-Endian** -tavujC$rjestystC$, koska se on CPU:n
natiivimuoto. C-moottorin ei pidC$ tuhlata kellojaksoja `ntohl()`
-kC$C$nnC6ksiin.
> * Datarivi on pakotettava luonnolliseen linjaukseen (Natural Alignment)
siten, ettC$ raskaimmat tyypit ovat 8-tavun rajoilla.
> * MC$C$rittC$kC$C$ `zfs_db_format.h` -tiedostoon tC$smC$lleen tC$mC$ rakenne
(tasan 48 tavua):
> ```c
> typedef struct __attribute__((aligned(8))) {
>     uint8_t  cas_hash[32]; // Offset 0
>     uint64_t timestamp;    // Offset 32 (TC$ydellinen 8-tavun raja)
>     float    temperature;  // Offset 40 (TC$ydellinen 4-tavun raja)
>     uint32_t flag;         // Offset 44 (TC$ydellinen 4-tavun raja)
> } DBRow;
> 
> ```
> 
> 
> 
> 
> **2. ErC$ajon Pakettirakenne (TCP)**
> * Kun Proxy lC$hettC$C$ erC$ajon porttiin 6666, sen on oltava yksi
katkeamaton blokki:
> * **Header (8 tavua):** `CMD` (2 tavua, esim. arvo 4 = BATCH), `FLAGS` (2
tavua), `TOTAL_SIZE` (4 tavua).
> * **Meta (4 tavua):** `ROW_COUNT` (4 tavua).
> * **Payload:** `N * 48 tavua` (Suora array DBRow-structeja).
> 
> 
> * TC$mC$n ansiosta C-ydin lukee socketista datan suoraan ennalta varattuun
muistialueeseen yhdellC$ I/O-kutsulla ja voi kC$sitellC$ sen vektoroidusti
(O(1)).
> 
> 
> **3. INTENT_BUFFER (Proxy / Python)**
> * FastAPI-reitin (`POST /api/v1/batch/insert`) tulee iteroida saapuva
JSON-data lennossa (striimaten) RAM-muistin sC$C$stC$miseksi.
> * Jokainen rivi pakataan Pythonin `struct.Struct('<32sQfI')` -komennolla ja
kirjoitetaan vC$littC6mC$sti levylle tilapC$iseen `.wal`-tiedostoon
(`/mnt/zfs-db/run/intents/`). ZFS ARC hoitaa tC$mC$n kirjoituksen
salamannopeasti keskusmuistin kautta.
> * Kun koko `.wal` on kC$C$nnetty ja valmis, Proxy avaa TCP-yhteyden,
kirjoittaa Headerin + Metan, ja striimaa `.wal` -tiedoston sisC$llC6n
sellaisenaan C-moottorille (Flush).
> 
> 
> *Toteuttakaa ensin tC$mC$ Python-pC$C$n WAL-kirjoittaja ja C-moottorin
vastaanottorutiini, ja dokumentoikaa tC$mC$ pakettirakenne selkeC$sti koodin
kommentteihin. Kokeillaan sen jC$lkeen ajaa 500 000 riviC$ putken lC$pi!"*

---

TC$mC$ ohjeistus eliminoi kaikki verkon yli tapahtuvien massiivisten siirtojen
pullonkaulat ja antaa kehittC$jille tC$ydelliset tekniset raamit nopeimman
mahdollisen koodin kirjoittamiseen. Oletko valmis nC$kemC$C$n, kuinka
C-moottori imaisee puoli miljoonaa riviC$ sekunnin murto-osassa?