Referans

#Ayarlar

Bütün ayarlar deploy/.env dosyasındadır. Değişiklik, ilgili servis yeniden başlatılınca geçerli olur: docker compose up -d gateway (ya da worker). Geçersiz bir değerle servis açılmaz ve nedenini günlüğe yazar.

Bu sayfa, kurulum paketindeki her değişkeni kapsar; dokümantasyon derlenirken .env.example ile karşılaştırılır.

#Kurulum

Değişken	Varsayılan	Açıklama
`DEPLOYMENT_MODE`	`onprem`	`onprem`: tek sabit kurum. `saas`: kurum her istekte anahtardan çözülür (bulut kurulumu)
`FIXED_TENANT_ID`	`default`	On-prem kurulumda kurumun kimliği; konsol ve arka plan işleri bu kuruma bağlıdır
`LOG_LEVEL`	`info`	Günlük ayrıntısı. Hiçbir seviyede istek içeriği günlüğe yazılmaz
`GATEWAY_PUBLISHED_PORT`	`8080`	Ağ geçidinin sunucuda açıldığı port
`ADMIN_PUBLISHED_PORT`	`5173`	Konsolun sunucuda açıldığı port

#Veritabanı

Değişken	Varsayılan	Açıklama
`MONGO_ROOT_USER`, `MONGO_ROOT_PASSWORD`	—	Yönetici hesabı; yalnız kurulum betiği kullanır
`MONGO_APP_USER`, `MONGO_APP_PASSWORD`	`gateway`	Uygulamanın hesabı. Denetim koleksiyonunda yalnız ekleme ve okuma yetkisi vardır
`MONGO_DB`	`nev_gateway`	Yapılandırma veritabanı
`MONGO_AUDIT_DB`	`nev_audit`	Denetim kaydı veritabanı; aylık bölümler burada
`AUDIT_FLUSH_INTERVAL_MS`	`5000`	Veritabanı erişilemezken diske yazılan kayıtların ne sıklıkla aktarılacağı

#Sağlayıcılar (ön tanımlı hedef)

Bu değişkenler, kurumun kendi hedefi tanımlı değilken kullanılan ön tanımlı hedefi belirler. Hedef tanımlandığında yerini o alır; bulut kurulumunda hiç kullanılmaz.

Değişken	Açıklama
`UPSTREAM_BASE_URL`, `UPSTREAM_REGION`, `UPSTREAM_API_KEY`	OpenAI biçimindeki ön tanımlı hedef. Bölge boşsa kayda `unknown` yazılır; tahmin edilmez
`ANTHROPIC_BASE_URL`, `ANTHROPIC_REGION`, `ANTHROPIC_API_KEY`	Anthropic biçimindeki ön tanımlı hedef
`GEMINI_API_KEY`	Gemini hedefi için anahtar (hedef `create-target` ile tanımlanır)
`UPSTREAM_TIMEOUT_MS`	Sağlayıcıdan ilk bayta kadar beklenen süre; akışın uzunluğunu sınırlamaz. Varsayılan `120000`
`EU_REGIONS`	Kişisel veri taşıyan isteğin gidebileceği bölge etiketleri, virgülle. Tam metin eşleşir. Bkz. İzin listeleri

Hedefler kasadaki anahtarla da tanımlanabilir; o zaman anahtar .env'de değil şifreli kasadadır (SECRET_STORE_KEYRING_PATH).

#Konsol

Değişken	Varsayılan	Açıklama
`ADMIN_SESSION_SECRET`	boş	Oturum çerezini imzalar; 32+ karakter. Boşsa konsol açılmaz ve yönetim API'si kapalıdır. Değiştirmek bütün oturumları kapatır
`ADMIN_SESSION_TTL_HOURS`	`12`	Oturum süresi
`ADMIN_COOKIE_SECURE`	`false`	Konsol HTTPS arkasındaysa `true` yapın; aksi hâlde tarayıcı çerezi reddeder ve giriş çalışmaz

#Tespit

Değişken	Varsayılan	Açıklama
`DEFAULT_DETECTION_MODE`	`fast`	Politikası hiç ayarlanmamış kurumun modu
`NER_MODEL_DIR`	`/opt/nev/models/tr-ner`	Türkçe isim modelinin imaj içindeki yeri. Boş dizin desteklenen bir kurulumdur: serbest metin taraması çalışmaz ve kayıt bunu söyler
`NER_THREADS`	boş (makineye göre, en fazla 4)	Bir isim taramasının kullanabileceği iş parçacığı. Yükseltmek tek isteği hızlandırır, eşzamanlı istekleri yarıştırır
`STREAM_BUFFER_LIMIT_BYTES`	`8388608`	Tamponlu modun bellekte tutacağı en büyük yanıt (8 MB). Aşan yanıt iletilmez
`TENANT_MAX_BUFFERED_STREAMS`	boş (on-prem sınırsız, bulut 8)	Aynı anda tutulabilecek tamponlu akış sayısı
`RATE_LIMIT_WINDOW_MS`	`60000`	İstek limitinin penceresi. Politika "dakikada" diye ifade edildiği için üretimde değiştirmeyin

#Anahtarlar ve imza

Değişken	Varsayılan	Açıklama
`CHECKPOINT_SIGNING_KEY_PATH`	`/var/lib/nev/keys/checkpoint.pem`	Günlük checkpoint'leri imzalayan Ed25519 anahtarının yolu. Dosya yoksa checkpoint üretilmez ve rapor bunu söyler. Bkz. Kurulum
`CHECKPOINT_INTERVAL_MS`	`86400000`	İmza sıklığı (günlük)
`CONTENT_FINGERPRINT_KEYRING_PATH`	boş	İçerik parmak izi anahtar dosyası. Boşsa parmak izi yazılmaz ve onaya bekletme seçilemez
`SECRET_STORE_KEYRING_PATH`	boş	Sağlayıcı anahtarlarını şifreleyen kasa anahtarı. Bulut kurulumunda zorunlu, on-prem'de isteğe bağlı

Anahtarlar her zaman dosya olarak verilir, ortam değişkeni olarak değil: bir ortam değişkeni süreç listesinde ve konteyner incelemesinde görünür.

#Arka plan işleri

Değişken	Varsayılan	Açıklama
`ALERT_INTERVAL_MS`	`60000`	Uyarı taramasının sıklığı. Hangi adımların uyarı üreteceği konsoldan ayarlanır
`AUDIT_RETENTION_MONTHS`	boş (hepsi tutulur)	Denetim kaydının kaç ay tutulacağı. Kurulum geneli; bkz. Saklama süresi
`RETENTION_USER`, `RETENTION_PASSWORD`, `RETENTION_MONGO_URL`	`retention` / boş / boş	Ay bölümlerini düşürmeye yetkili ayrı veritabanı hesabı. Uygulama hesabının bu yetkisi yoktur ve olmamalıdır
`METRICS_TOKEN`	boş	`GET /metrics` için jeton (16+ karakter). Boşsa uç yoktur. Bkz. İzleme