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
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\nroutes\nconsumer sessions\ninflight\nWAL)]
        GENLEDGER[(Continuity Ledger\nappend-only memory\nhash chain)]
        MFCACHE[(Manifest telemetry cache\nin-memory TS store)]
        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

---

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 ได้

---

Verified findings and fixes in this pass

What was actually checked

• ตรวจไฟล์เอกสารทั้งหมดที่มีอยู่ใน repository .github
• ตรวจความซ้ำซ้อนระหว่าง README.md และ profile/README.md
• ตรวจความสอดคล้องของชื่อระบบหลัก เช่น AetherBus-Tachyon เทียบกับ reference docs เดิมที่ยังใช้ชื่อ AetherBus Extreme
• ตรวจว่ามีเนื้อหาที่ปะปนระหว่าง "งานที่ทำแล้ว" กับ "ข้อเสนอระยะถัดไป" หรือไม่

Documentation bugs fixed

• ลดการซ้ำกันเกือบทั้งไฟล์ระหว่าง README.md และ profile/README.md
• ปรับ README.md ให้ทำหน้าที่เป็น architecture hub จริง แทนการเป็นสำเนาของหน้า profile
• แยกข้อจำกัดของการตรวจสอบ workspace ออกจากข้อเสนอพัฒนาต่อ เพื่อไม่ให้ตีความเป็นสถานะ implementation ผิด
• ปรับ diagram หลักให้ใช้คำอธิบายที่สม่ำเสมอระหว่าง README, Mermaid source, และ PlantUML
• ลบเนื้อหาที่ไม่เกี่ยวข้องกับโครงสร้างของ repository นี้ออกจากหน้าแรก และคงไว้เฉพาะ reference ที่ยังมีประโยชน์

---

Follow-up proposals

ด้านล่างคือ ข้อเสนอใหม่ ที่ยังไม่ถือว่าเสร็จแล้ว และตั้งใจเก็บไว้เป็น next-step โดยไม่ปะปนกับงานที่เอกสารรอบนี้ดำเนินการไปแล้ว

1. เพิ่ม AsyncAPI หรือ schema registry กลางสำหรับ canonical envelope V3 และ event contracts
2. สร้าง governance decision journal ที่ผูก policy_trace_id กับ correlation_id เพื่อ audit ได้ครบทั้ง approval chain
3. เพิ่ม replay validation suite สำหรับตรวจว่า governed outcomes ถูก commit เข้า continuity memory ครบถ้วน
4. สร้าง operator read model แยกต่างหากสำหรับ SpectraCall โดยกำหนดชัดว่าเป็น projection เท่านั้น
5. เพิ่ม cross-repository architecture review checklist สำหรับเวลามีการเปลี่ยน schema, event, หรือ ownership boundary
6. เพิ่ม data retention matrix ที่ระบุ retention, archival policy, และ evidence requirements ของแต่ละ domain

---

Constraints of this repository

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

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