5vrstvá architektura

Architektura UAML odděluje zodpovědnosti do pěti vrstev. Každá vrstva může být samostatně pochopena, testována a nahrazena. Tato modularita činí systém robustním, rozšiřitelným a auditovatelným.

💾 Vrstva úložiště

Základ. SQLite databáze ukládají všechny paměťové záznamy s plnými ACID zárukami. WAL režim umožňuje souběžné čtení během zápisů. Každý typ paměti má vlastní tabulku s optimalizovaným schématem. Záloha je tak jednoduchá jako kopírování souboru.

📇 Vrstva indexů

Činí vzpomínky nalezitelnými. Fulltextové vyhledávání (FTS5) pro klíčové dotazy. BM25 ranking pro hodnocení relevance. Tematické indexy pro kategoriální vyhledávání. Časové indexy pro dotazy s rozsahem. Vrstva indexů mění surová data na prohledávatelné znalosti.

📜 Vrstva politik

Řídí, co se s daty děje. Retenční politiky kontrolují, jak dlouho vzpomínky žijí. Přístupové politiky určují, kdo může co číst. Recall politiky formují, jak jsou vzpomínky vybavovány. Klasifikační politiky označují citlivost dat. Vrstva politik zajišťuje správu dat bez manuálních zásahů.

🔌 Vrstva rozhraní

Způsob, jakým aplikace komunikují s UAML. Čisté Python API (uaml.facade.UAML) poskytuje vysokoúrovňové operace: learn, recall, search, forget. V pozadí vrstva rozhraní koordinuje všechny ostatní vrstvy. Jedno volání learn() spustí úložiště, indexování, vyhodnocení politik a šifrování.

🔐 Vrstva kryptografie

Zabezpečuje vše. Post-kvantové šifrování (ML-KEM-768) chrání data at rest. Podepsané exporty ověřují integritu dat. Shamirovo sdílení tajemství umožňuje bezpečnou zálohu klíčů. Vrstva kryptografie obaluje všechny ostatní — data jsou šifrována před uložením a dešifrována po vybavení.

Jak spolupracují

# Co se stane, když zavoláte uaml.learn():

uaml.learn("Tržby za Q1 překročily cíle o 12 %",
           topic="finance", source_type="report")

# 1. Vrstva rozhraní přijme volání
# 2. Vrstva politik kontroluje: retence? klasifikace? souhlas?
# 3. Vrstva kryptografie zašifruje data
# 4. Vrstva úložiště zapíše do SQLite
# 5. Vrstva indexů aktualizuje FTS a tematické indexy
# 6. Audit log zaznamená operaci

# Co se stane, když zavoláte uaml.recall():

results = uaml.recall("výkonnost tržeb")

# 1. Vrstva rozhraní přijme dotaz
# 2. Vrstva politik aplikuje pravidla recallu a rozpočet
# 3. Vrstva indexů najde odpovídající vzpomínky (BM25 + filtry)
# 4. Vrstva úložiště načte záznamy
# 5. Vrstva kryptografie dešifruje data
# 6. Vrstva rozhraní vrátí seřazené, rozpočtované výsledky
            

Principy návrhu

Oddělení zodpovědností — každá vrstva má jednu úlohu a dělá ji dobře
Testovatelnost — vrstvy mohou být unit-testovány nezávisle
Rozšiřitelnost — vyměnit SQLite za PostgreSQL? Změňte vrstvu úložiště. Přidat vektorové vyhledávání? Rozšiřte vrstvu indexů
Bezpečnost ve výchozím stavu — vrstva kryptografie obaluje vše; šifrování není volitelné
Auditovatelnost — každá operace napříč vrstvami je zalogována

← Zpět na UAML