Qapu Variable Structure AI Memory

Bu dosya, project-qapu/variable-structure altindaki veri sozlesmelerini kalici tutmak icin kullanilir. Amac: AI'nin CPS kurallarini, degisken segmentlerini ve olcum iliskilerini unutmadan devam etmesi.

Hizli Kural Seti

• Variable structure degisikliginden once bu dosya okunur.
• CPS veya degisken isimlendirme degisikliginden sonra bu dosya guncellenir.
• Geriye donuk kararlar silinmez; gerekirse "geri alindi" notu eklenir.
• Genel dokumantasyon stili icin merkez referans: project-qapu/AI_MEMORY.md -> Dokumantasyon Stili (Merkezi Kurallar).

Variable Structure Haritasi

• Giris sayfasi: /projects/qapu/variable-structure
• Ana referanslar:
  • CPS: /projects/qapu/variable-structure/cps
  • Variable list: /projects/qapu/variable-structure/variable-list
  • Variable segments: /projects/qapu/variable-structure/variable-segments
  • Segment sayfalari: energy/environment/water/register/device/location

CPS (Core Packet Standard) Ozeti

• Standart: CPS V1.0
• Tasima formati: JSON, minified (bosluksuz) gonderim
• Paket omurgasi: Info, Device, Payload

CPS Cekirdek Kurallari

• Info.Command zorunlu ve tanimli komut kumesinden olmalidir.
• Info.TimeStamp zorunlu, format: YYYY-MM-DDTHH:mm:ss (timezone offset yok).
• Info.ID zorunlu, DS28C kaynakli 16 hex karakter.
• Info.Seq zorunlu, uretim sirasini tasir (ack sayaci degil).
• IMEI/ICCID/Firmware opsiyonel envanter alanlaridir.
• Device.Power ve Device.IoT operasyonel baglam tasir.
• Payload duz obje yapisinda tasinir; gereksiz ic segmentleme yapilmaz.

Paket Boyutu ve Tasima Disiplini

• Referans guvenli sinir: yaklasik 1024 byte.
• Cihaz paketleri minified gonderilmelidir.
• Boyut asiminda once opsiyonel alanlar budanir, cekirdek alanlar korunur.

Command Degerleri (CPS)

• Online, Offline, Timed, Timed_Tiny, Interrupt, Event, Alarm
• Ayni kok olayda birden fazla command secilmez; en dogru semantik secilir.
• Kritik olaylarda Alarm, normal olaylarda Event tercih edilir.

Segment Sozlugu (Variable Segments)

• 0: Unknown
• 1: Device
• 2: Power
• 3: GSM
• 4: Location
• 5: Environment
• 6: Water
• 7: Energy
• 9: FOTA

Degisken Yonetimi (Variable List)

• Degiskenler segment bazli tanimlanir.
• Her degisken icin birim, CT kalibrasyon durumu ve measurement tablosu hedefi tanimlidir.
• Energy ailesi typed tablolara ayrilir:
  • measurements_voltage
  • measurements_current
  • measurements_power
  • measurements_energy
• Sentez degiskenleri synthesis_* tablo ailesine gider.

Pipeline Iliski Notlari

• Ingest, CPS paketini kabul eder ve canonical state'e cevirir.
• Raw Writer, variable-segment kurallarina gore typed measurement tablolarina dagitim yapar.
• Segment disi scalar degiskenler generic measurements tablosuna duser.
• Calibration sadece gerekli degiskenlerde CT/kalibrasyon uygular; hepsi zorunlu degildir.

Naming ve Uyumluluk Kurallari

• Ayni semantik degisken farkli isimlerle tekrar tanimlanmaz.
• Yeni degisken eklemeden once segment ve hedef tablo etkisi belirlenir.
• Degisken adlandirmasi buyuk harf/alt cizgi desenini korur.

Operasyon Notlari

• CPS degisiklikleri firmware + backend + data-model etkisiyle birlikte ele alinir.
• Geriye donuk uyumluluk icin event/payload versiyonlama notu zorunludur.
• Dokuman degistiginde ingestion validation kurallari da capraz kontrol edilmelidir.

Bugun Alinan Kararlar

2026-04-14

• Variable structure icin ayri AI memory dosyasi acildi.
• CPS temel kurallari ve segment sozlugu bu dosyada sabitlendi.
• Degiskenlerin measurement/synthesis tablo dagitimi referans mantigi eklendi.

Acik Konular

• CPS V2 planinda timezone/UTC semantigi degisecek mi?
• Harmonik degiskenlerde (3/5/7/9/11) cihaz bazli alt kume politikasinin resmi kurali netlestirilecek.
• FOTA degiskenlerinin olcum tablolarina dahil edilmeme kurali kesinlestirilecek.

Sonraki Adim

• Variable list ile data-model tablo kolonlari birebir capraz dogrulama tablosu olustur.
• CPS zorunlu/opsiyonel alanlari icin tek bakista kontrol listesi ekle.