# 📚 Dokumentasi Arsitektur Sistem SRE Knowledge Graph

Selamat datang di pusat dokumentasi arsitektur proyek ini! 

Dokumentasi ini dirancang menggunakan pendekatan hierarkis (dari makro ke mikro) untuk memudahkan proses *onboarding* maupun referensi *debugging* teknis. Seluruh diagram dibuat menggunakan **Mermaid.js** sehingga akan langsung ter-*render* saat Anda membukanya di GitHub/GitLab atau *Markdown Viewer* yang mendukung.

Silakan telusuri dokumentasi berdasarkan kedalaman (*zoom level*) yang Anda butuhkan:

## 🗺️ Level A: Gambaran Besar (The Macro View)
Direkomendasikan untuk **Stakeholders, Product Managers, & Developer Baru**.
Diagram ini menunjukkan bagaimana data mengalir dari dokumen mentah hingga menjadi *Knowledge Graph*, memisahkan dengan tegas batasan antara komputasi Lokal dan layanan *Cloud* (LLM, Supabase, Neo4j).
👉 **[High-Level End-to-End Architecture](high_level_architecture.md)**

---

## 📦 Level B: Peta Kontainer (The Container View)
Direkomendasikan untuk **Software Engineers & DevOps**.
Diagram ini memetakan komponen perangkat lunak (modul `.py` utama) yang hidup di dalam repositori ini. Ini adalah panduan Anda untuk memahami siapa memanggil siapa (misalnya `ingestion.py` sebagai *orchestrator* utama).
👉 **[C4-Container Architecture](c4_container_architecture.md)**

---

## 🔬 Level C: Alur Mikro (The Micro Flows)
Direkomendasikan untuk **Backend Engineers & AI/Data Engineers**.
Ini adalah pembedahan mendalam lapis demi lapis dari *Ingestion Pipeline* utama. Jika Anda ingin melakukan *debugging* batas *token* LLM, Regex pemurnian, atau kalkulasi Z-Score, bacalah dokumen-dokumen di bawah ini secara berurutan:

1. **[Flow 2A: Ingestion & Parsing](flow_2a_ingestion_parsing.md)** 
   *(Fokus: Dual-Pass Parser & OCR Timeout Guard)*
2. **[Flow 2B: Smart Chunking & Data Purification](flow_2b_chunking_purification.md)** 
   *(Fokus: Multi-Level Chunking & Regex JIT Purification V2)*
3. **[Flow 2C: LLM Extraction & Vectorization](flow_2c_extraction_vectorization.md)** 
   *(Fokus: Anchor-Density Strategy & Pydantic Armor)*
4. **[Flow 2D: Neo4j Storage & Edge Generation](flow_2d_storage_edge_generation.md)** 
   *(Fokus: Multi-Tenant Isolation & The Validation Gauntlet)*
5. **[Flow 2E: Background Maintenance (Cron Job)](flow_2e_background_maintenance.md)** 
   *(Fokus: Global Z-Score Calibration Math & Safety Checks)*

---
*Dokumentasi ini terakhir diperbarui sesuai dengan integrasi arsitektur Dynamic Threshold & Kueri V3 (Multilingual).*