Uygulama kuralları (AGENTS.md)
Her Devoplus One uygulamasının kökünde bir AGENTS.md dosyası bulunur. Dosyayı iskelet üretici yazar; uygulamanızda çalışan yapay zeka aracı işe başlamadan önce onu okur ve kurallarına uyar. Hazır şablondan üretilen uygulamada dosyanın en üstünde ayrıca şablona özgü bir bölüm (dosya haritası ve bozulmaması gereken kurallar) vardır.
Bu sayfa kuralların ne söylediğini kısaca anlatır; aracınızın bazı şeyleri neden yapmadığını ya da neden size sorduğunu anlamanıza yardım eder. Bağlayıcı metin uygulamanızın deposundaki AGENTS.md'dir.
Kuralların özeti
| Konu | Kural |
|---|---|
| Kimlik | Kullanıcı ve portal bilgisi SDK'dan gelir; uygulama kendi oturum, çerez ya da belirteç mekanizmasını yazmaz |
| Sır | Koda ya da depoya sır yazılmaz; uygulama hiçbir sır taşımaz |
| Dış adresler | Uygulama yalnız Devoplus API'sine çıkar |
| Veri | Her kurulumun kendi veritabanı vardır; kayıt tutan ekranlar için önce veri modeli kullanılır, şema yalnız yeni numaralı dosyayla ilerler |
| Yetki | Rol gerekiyorsa uygulama izinleri kullanılır; gereken her yetki alanı manifest'e yazılır (manifest) |
| E-posta, SMS, bildirim | Yalnız SDK ile ve yalnız Devoplus kullanıcılarına; kanal kapalıysa asıl işlem yine tamamlanır |
| ERP (DEXA) | Yalnız yöneticinin tanımladığı sorgu ve işlem anahtarlarıyla; serbest SQL yoktur |
| Devoplus yapay zekası | Uygulamanın verisi araçlarla açılır ve AGENT_GUIDE.md yazılır; bu adım zorunludur (yapay zeka) |
| Arayüz | Portal'ın görsel dili, hazır arayüz bileşenleri, Türkçe ve İngilizce metin; uygulama kendi menüsünü ve üst bilgisini çizmez, satır içi betik kullanmaz |
| Kayıtlar | Denetim ve olay kayıtlarına kişisel veri ya da sır yazılmaz |
| Yayın | Hat platformundur; depoya hat dosyası yazılmaz, kod one publish ile Devoplus'a yüklenir (yayın) |
Tam metin
Kuralların tam metni yapay zeka araçları için yazılmıştır ve kod düzeyinde ayrıntı içerir. İskelet üreticinin örnek bir uygulama için ürettiği hali: /docs/app-rules.md. Yapay zeka araçlarının okuduğu diğer belgelerin listesi: /llms.txt.