Aetherium Ecosystem Architecture Hub

เอกสารชุดนี้เป็นศูนย์กลางสำหรับอธิบาย สถาปัตยกรรมเชิงระบบและเชิงข้อมูล ของ Aetherium ecosystem ในมุมมองที่อิงกับ domain ownership, event flow, governance gate และ data persistence ที่ตรวจสอบได้

ขอบเขตที่ตรวจสอบได้จริงใน workspace นี้คือ repository .github เท่านั้น ดังนั้นการปรับปรุงรอบนี้มุ่งแก้ความคลาดเคลื่อนของเอกสาร, ลดเนื้อหาซ้ำซ้อน, ปรับโครงสร้างหน้าแรกใหม่, และจัดข้อมูลให้พร้อมต่อการอ้างอิงข้าม repository

What this repository now provides

• Architecture hub สำหรับภาพรวมระบบและ dependency ระหว่าง repository
• Database-centric view ที่แยก source of truth ออกจาก runtime state อย่างชัดเจน
• System context diagrams ทั้ง Mermaid และ PlantUML
• Thai architecture summary สำหรับใช้อ้างอิงในการวางแผนและสื่อสารภายในทีม
• Ownership matrix และ event contract catalog สำหรับงาน integration และ governance review

Documentation map

Document	Purpose
README.md	หน้าหลักและภาพรวมสถาปัตยกรรมล่าสุด
profile/README.md	หน้าแรกแบบ organization landing page สำหรับ GitHub profile
SYSTEM_ARCHITECTURE_TH.md	สรุปเชิงสถาปัตยกรรมภาษาไทย
DATABASE_OWNERSHIP_MATRIX.md	ตาราง owner ของข้อมูลและกติกาการเขียน/อ่าน
EVENT_CONTRACT_CATALOG.md	ชุด event contracts กลางสำหรับ envelope-first integration
system-architecture-database-centric.mmd	Mermaid source ของภาพรวมระบบ
docs/system-context.puml	PlantUML system context diagram
GENESIS_PLATFORM_WORK.md	แผน platform workstreams และ rollout roadmap
LINEAGE_INDEX_SPEC.md	สเปก lineage index สำหรับ correlation-policy-memory query path
AETHERIUM_UNIFIED_AI_OS_REPORT_TH.md	รายงานทางการภาษาไทย: การนิยาม AG-OS และบทบาท 6 โครงการ
README_SPECIAL_Aetherium.md	เอกสาร reference ดั้งเดิมของแพลตฟอร์ม

---

Executive summary

Repository	Responsibility	Persistence pattern	Operational note
.github	Documentation, architecture hub, org profile	Static docs	ไม่มี runtime database
Aetherium-Syndicate-Inspectra	Governance, identity, billing, tenancy	SQLite relational core	system of record สำหรับ entitlements และ user context
AETHERIUM-GENESIS	Continuity memory, entropy/trust logic	Append-only ledger	ผูกกับ replay และ audit lineage
AetherBus-Tachyon	Canonical event routing and recovery	In-memory broker + WAL	durability เพื่อ delivery/replay ไม่ใช่ business truth
Aetherium-Manifest	Visualization and telemetry rendering	In-memory time-series cache	read-optimized transient state
SpectraCall	Mission control surface	Read models / control UI	ไม่ควรถือ source of truth
OmniVoice-AI	Telephony commerce operations	Operational database	publish เฉพาะ canonical events สำคัญ
AmpereEye	Device-local battery analytics	Local SQLite / Room target	sync เฉพาะ summary ที่จำเป็น

---

System architecture diagram

flowchart LR
    subgraph Channels[Interaction Channels]
        OP[Operators / Admins]
        WEB[Web and Dashboard Users]
        PHONE[Phone Customers]
        DEVICE[Android Device Users]
    end

    subgraph Experience[Experience and Control]
        SC[SpectraCall\nMission Control]
        MF[Aetherium Manifest\nVisualization Surface]
        OV[OmniVoice AI\nVoice Operations]
        AE[AmpereEye\nBattery Insight App]
    end

    subgraph Core[Core Runtime]
        GOV[Aetherium-Syndicate-Inspectra\nGovernance / Identity / Billing]
        BUS[AetherBus-Tachyon\nCanonical Event Fabric]
        GEN[AETHERIUM-GENESIS\nContinuity / Trust Ledger]
    end

    subgraph Data[Persistence and State]
        GOVDB[(Governance SQLite\nusers\nsubscriptions\ntransactions\nidentity_links\nuser_contexts\nagent_runtime_registry)]
        BUSWAL[(Broker runtime state + WAL\nroutes\nconsumer sessions\ninflight\ndelivery retry logs)]
        GENLEDGER[(Continuity ledger\nappend-only memory\nhash chain\nevidence trail)]
        MFCACHE[(Manifest telemetry cache\nin-memory TS store\nrender snapshots)]
        OVIDB[(OmniVoice operational DB\ncalls\norders\nappointments\nleads)]
        AEDB[(AmpereEye local store\nbattery snapshots\ncharge cycles\nusage summaries)]
    end

    OP --> SC
    WEB --> MF
    PHONE --> OV
    DEVICE --> AE

    SC --> GOV
    SC --> BUS
    MF --> BUS
    MF --> MFCACHE
    OV --> BUS
    OV --> OVIDB
    AE --> AEDB

    GOV --> GOVDB
    BUS --> BUSWAL
    BUS <--> GEN
    BUS <--> GOV
    GEN --> GENLEDGER

Loading

---

Database structure alignment (source-of-truth view)

Data store	Owned by	Primary role	Truth classification
Governance SQLite	Aetherium-Syndicate-Inspectra	Identity, tenancy, entitlement, billing-linked policy context	Canonical transactional truth
Continuity ledger	AETHERIUM-GENESIS	Immutable continuity/memory commitments and audit evidence	Canonical immutable truth
Broker runtime state + WAL	AetherBus-Tachyon	Delivery guarantees, retry/replay durability	Runtime operational state (not business truth)
Manifest telemetry cache	Aetherium-Manifest	Fast visualization and interaction rendering	Derived/read-optimized state
OmniVoice operational DB	OmniVoice-AI	Voice commerce execution records	Domain truth (OmniVoice boundary)
AmpereEye local store	AmpereEye	Device-local analytics snapshots	Local domain truth (edge boundary)

---

Architecture principles

1. Canonical owner first — transactional data ต้องถูกบันทึกใน domain owner ก่อน แล้วจึงกระจายผ่าน event contracts
2. Governed execution only — flow ที่มีผลต่อสิทธิ์, policy, billing, หรือ trust ต้องผ่าน governance gate
3. Correlation preservation — ทุกระบบต้องรักษา correlation_id และ tenant_id แบบ end-to-end
4. Runtime is not truth — cache, broker state, และ operator read model เป็นเพียง operational projections
5. Immutable evidence trail — outcome ที่สำคัญต้องเชื่อมสู่ append-only continuity memory เพื่อ replay และ audit ได้

---

Proposed next capabilities (EN)

1. Define a canonical envelope compatibility matrix (v2 -> v3) with explicit downgrade/upgrade rules.
2. Publish domain-by-domain data contracts (table/event ownership + allowed writers) as versioned governance artifacts.
3. Add deterministic replay conformance checks for AetherBus-Tachyon -> AETHERIUM-GENESIS handoff.
4. Introduce cross-repository policy test fixtures to validate approval gates before deployment.
5. Build a lineage index that links correlation_id, policy_trace_id, and memory commit hash in one query path. (Implemented spec: LINEAGE_INDEX_SPEC.md)
6. Create an operator-facing incident playbook for dead-letter recovery and controlled re-drive.

ข้อเสนอฟังก์ชัน/แนวทางต่อยอด (TH)

1. จัดทำ compatibility matrix ของ canonical envelope (v2 -> v3) พร้อมกติกา downgrade/upgrade ที่ชัดเจน
2. จัดทำ data contracts รายโดเมน (owner ของตาราง/อีเวนต์ + สิทธิ์เขียน) ในรูป governance artifacts แบบมีเวอร์ชัน
3. เพิ่ม deterministic replay conformance checks สำหรับจุดส่งต่อ AetherBus-Tachyon -> AETHERIUM-GENESIS
4. เพิ่ม policy test fixtures แบบข้าม repository เพื่อตรวจ approval gates ก่อน deployment
5. สร้าง lineage index ที่ผูก correlation_id, policy_trace_id, และ memory commit hash ในเส้นทางค้นหาเดียว (มีสเปกใน LINEAGE_INDEX_SPEC.md)
6. จัดทำ incident playbook สำหรับ operator ในกรณี dead-letter recovery และ controlled re-drive

---

Constraints of this repository

repository นี้ไม่มี source code runtime ของระบบหลักทั้งหมด ดังนั้นงานรอบนี้ ไม่สามารถยืนยันการทำงาน runtime จริงหรือแก้บั๊กเชิง executable code ข้าม repository ได้ แต่ได้ปรับปรุงชุดเอกสารให้พร้อมเป็นฐานสำหรับ:

• architecture review
• ownership review
• integration planning
• documentation-driven validation
• handoff ไปยัง repository ต้นทางที่ต้องแก้ implementation จริง