Ikhtisar

NEIR (NAEOS Engineering Intermediate Representation) adalah model kanonikal yang merepresentasikan seluruh sistem yang sedang direkayasa. Model ini adalah sumber kebenaran tunggal yang mengalir melalui pipeline, memungkinkan semua pemrosesan hilir — generasi kode, kompilasi AI, dokumentasi, dan deployment.

Komponen Inti

Metadata Proyek

Informasi tingkat atas tentang sistem yang dibangun: nama, versi, deskripsi, pola arsitektur, model domain, dan informasi tim.

Struktur Modul

Graf modul menangkap semua komponen kode dan hubungannya: definisi modul dengan jalur dan tipe, tepi dependensi dengan kendala versi, grup modul, dan ruang nama.

Definisi Layanan

Layanan mewakili komponen yang dapat dijalankan: tipe layanan (REST, GraphQL, WebSocket, gRPC), pemetaan port dan protokol, definisi endpoint, middleware, dan konfigurasi health check.

Kontrak API

Definisi API termasuk endpoint REST dengan metode dan jalur, tipe skema GraphQL, tipe event WebSocket, skema request/response, dan aturan autentikasi.

Penyimpanan & Database

Konfigurasi lapisan data: engine database (PostgreSQL, Redis, MongoDB), skema tabel/koleksi, konfigurasi migrasi, pengaturan connection pool, kebijakan backup dan replikasi.

Infrastruktur & Cloud

Definisi infrastruktur sebagai kode: sumber daya Kubernetes, konfigurasi Docker, sumber daya cloud (AWS, GCP, Azure), konfigurasi jaringan dan VPC, aturan load balancer dan auto-scaling.

Keamanan & Kebijakan

Model keamanan: penyedia autentikasi dan metode, definisi peran RBAC, aturan dan kendala kebijakan, pengaturan enkripsi, konfigurasi jejak audit.

Integrasi AI

Konfigurasi khusus AI: penyedia LLM, pemilihan model dan parameter, template prompt, definisi alat dan fungsi, pengaturan orkestrasi agen.

Deployment & CI/CD

Konfigurasi deployment: definisi lingkungan (dev, staging, production), template pipeline CI/CD, pengaturan blue/green dan canary, kebijakan rollback.

Mengakses Model NEIR

# Ekspor model NEIR sebagai JSON
naeos export --format json --output neir.json

# Periksa model
naeos kernel --model

# Validasi model
naeos validate --model

NEIR dalam Konteks AI

Model NEIR juga digunakan untuk menghasilkan bundel konteks AI. Ketika dikompilasi, ia menghasilkan set instruksi yang sadar-arsitektur yang membantu asisten coding AI memahami konteks sistem penuh.