Factorizer/Cluster ERP WikiCluster ERP English
Ana sayfa / Platform

Referans

Ayarlar başvurusu

config/settings.py içindeki Settings sınıfının her alanı; türü, varsayılanı, CLUSTER_ERP_ ortam değişkeni, onu okuyan kod ve anlamıyla.

Bu sayfa src/cluster_erp/config/settings.py içindeki Settings sınıfının her alanını, ayarlar yüklenirken çalışan doğrulama kurallarını ve türetilmiş özellikleri listeler. Geliştiriciler ve işletmeciler için bir başvuru tablosudur. Bir Linux düğümünün hangi değişkenleri nasıl ayarladığı yapılandırma başvurusu sayfasındadır.

Kapsam ve kaynak

  • Tanımlandığı yer: src/cluster_erp/config/settings.py (Settings)
  • Sayı: class Settings satırı ile doğrulayıcı arasındaki tür açıklamalı sınıf öznitelikleri olarak sayılan 183 alan (src/cluster_erp/config/settings.py:64-738). Üstteki RegionAddress dataclass'ının dört açıklamalı satırı ayar değildir.

Settings bir Pydantic BaseSettings sınıfıdır. Ortam değişkenlerini CLUSTER_ERP_ önekiyle, büyük/küçük harf duyarsız okur ve çalışma dizinindeki bir .env dosyasını da okur (src/cluster_erp/config/settings.py:64-70). Bir alanın ortam değişkeni, CLUSTER_ERP_ ardından büyük harfle alan adıdır.

Sütunlar şunlardır:

  • Varsayılan: koddaki varsayılan. Gizli olan veya olabilecek değerler, ana makine adları, adresler ve bir düğümdeki yollar, belgeleme standardının güvenlik açıklama politikasına göre <value> olarak gösterilir. Uzun listeler için "kaynağa bakın" yazılır.
  • Okuyan: alanı settings.<name> olarak ya da getattr(settings, "<name>") ile okuyan klasörler veya modüller; src/cluster_erp üzerinde grep ile bulundu. config, alanın yalnızca settings.py içinde türetilmiş bir özellik tarafından okunduğu anlamına gelir. -, bu yöntemle okuyan bulunamadığı anlamına gelir.
  • Anlamı: alanın üstündeki yorumdan alınan bir cümle. "Kodda açıklama yok." yorum olmadığı anlamına gelir.

Veritabanı bağlantısı

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
db_host str "localhost" CLUSTER_ERP_DB_HOST config Varsayılan PostgreSQL sunucusunun ana makinesi. src/cluster_erp/config/settings.py:72
db_port int 5432 CLUSTER_ERP_DB_PORT config Varsayılan PostgreSQL sunucusunun bağlantı noktası. src/cluster_erp/config/settings.py:73
db_name str "cluster_erp" CLUSTER_ERP_DB_NAME server Varsayılan veritabanının adı. src/cluster_erp/config/settings.py:74
db_user str "cluster_erp" CLUSTER_ERP_DB_USER config Uygulamanın veritabanı rolü. src/cluster_erp/config/settings.py:75
db_password str <value> CLUSTER_ERP_DB_PASSWORD config Veritabanı rolünün parolası. src/cluster_erp/config/settings.py:76
sql_echo bool False CLUSTER_ERP_SQL_ECHO core Açıkken her SQL ifadesini günlüğe yazar. src/cluster_erp/config/settings.py:181
db_pool_size int 20 CLUSTER_ERP_DB_POOL_SIZE core, server Varsayılan motorun havuz boyutu. src/cluster_erp/config/settings.py:243
db_pool_max_overflow int 10 CLUSTER_ERP_DB_POOL_MAX_OVERFLOW core, server Varsayılan havuzun açabileceği ek bağlantılar. src/cluster_erp/config/settings.py:244
db_pool_timeout_seconds int 10 CLUSTER_ERP_DB_POOL_TIMEOUT_SECONDS core Bir isteğin havuzdan bağlantı için beklediği saniye. src/cluster_erp/config/settings.py:248

Çok kiracılılık, bölgeler ve yerleşim

Bu alanlar çok kiracılı kipi ve veri yerleşimini yapılandırır; mekanizma düzeyinde çok kiracılılık ve veri yerleşimi denetimi sayfalarında belgelenir.

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
multi_tenant bool False CLUSTER_ERP_MULTI_TENANT core, server Kiracı başına bir veritabanını ve bir kontrol düzlemi veritabanını açar. src/cluster_erp/config/settings.py:82
control_db_name str "cluster_control" CLUSTER_ERP_CONTROL_DB_NAME core, server Kontrol düzlemi veritabanının adı. src/cluster_erp/config/settings.py:83
tenant_db_prefix str "cluster_t_" CLUSTER_ERP_TENANT_DB_PREFIX core Kiracı veritabanı adlarının öneki. src/cluster_erp/config/settings.py:84
regions str "tr" CLUSTER_ERP_REGIONS server Bölge kodlarının virgüllü listesi; ilki varsayılandır. src/cluster_erp/config/settings.py:93
region_db_urls str <value> CLUSTER_ERP_REGION_DB_URLS server Varsayılan olmayan her bölgenin veritabanı sunucusunu adlandıran JSON nesnesi. src/cluster_erp/config/settings.py:94
node_country str "" CLUSTER_ERP_NODE_COUNTRY server Bu düğümün hizmet verdiği ISO 3166-1 alpha-2 ülke; boşsa yerleşim politikası yoktur. src/cluster_erp/config/settings.py:111
country_nodes str "" CLUSTER_ERP_COUNTRY_NODES server Ülkeleri düğüm temel URL'lerine eşleyen JSON nesnesi. src/cluster_erp/config/settings.py:114
console_origins str "" CLUSTER_ERP_CONSOLE_ORIGINS server Filo ucunu bir tarayıcıdan okuyabilen https kökenlerinin virgüllü listesi. src/cluster_erp/config/settings.py:122
vendor_admin_username str <value> CLUSTER_ERP_VENDOR_ADMIN_USERNAME server Hiç yoksa açılışta oluşturulan ilk operatör hesabı. src/cluster_erp/config/settings.py:126
vendor_admin_password str <value> CLUSTER_ERP_VENDOR_ADMIN_PASSWORD server Bu ilk operatör hesabının parolası. src/cluster_erp/config/settings.py:127
vendor_require_totp bool True CLUSTER_ERP_VENDOR_REQUIRE_TOTP server Her operatör girişi için ikinci faktör ister. src/cluster_erp/config/settings.py:131
vendor_allowed_ips str <value> CLUSTER_ERP_VENDOR_ALLOWED_IPS server Operatör konsolu API'sine ulaşabilen adresler. src/cluster_erp/config/settings.py:134
tenant_pool_size int 5 CLUSTER_ERP_TENANT_POOL_SIZE core Her kiracı motorunun havuz boyutu. src/cluster_erp/config/settings.py:249
tenant_pool_max_overflow int 5 CLUSTER_ERP_TENANT_POOL_MAX_OVERFLOW core Her kiracı havuzunun ek bağlantıları. src/cluster_erp/config/settings.py:250
tenant_max_engines int 32 CLUSTER_ERP_TENANT_MAX_ENGINES core Önbellekteki en fazla kiracı motoru sayısı. src/cluster_erp/config/settings.py:251

Sunucu süreci

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
server_host str <value> CLUSTER_ERP_SERVER_HOST server Geliştirme sunucusunun bağlanma adresi; varsayılan joker adrestir. src/cluster_erp/config/settings.py:136
server_port int 8000 CLUSTER_ERP_SERVER_PORT server Geliştirme sunucusunun bağlantı noktası. src/cluster_erp/config/settings.py:137
server_workers int 1 CLUSTER_ERP_SERVER_WORKERS core, server İşçi süreci sayısı; Windows'ta 1'e indirilir. src/cluster_erp/config/settings.py:149
trust_proxy_headers bool False CLUSTER_ERP_TRUST_PROXY_HEADERS server Uvicorn'un güvenilir vekillerden gelen yönlendirme başlıklarını yorumlamasını sağlar. src/cluster_erp/config/settings.py:158
trusted_proxy_ips str <value> CLUSTER_ERP_TRUSTED_PROXY_IPS server Yönlendirme başlıklarını ayarlayabilen vekiller; varsayılan geri döngü adresidir. src/cluster_erp/config/settings.py:162
server_access_log bool False CLUSTER_ERP_SERVER_ACCESS_LOG server Uvicorn'un kendi erişim günlüğünü açar. src/cluster_erp/config/settings.py:167
server_keep_alive_seconds int 5 CLUSTER_ERP_SERVER_KEEP_ALIVE_SECONDS server Boştaki bir keep-alive bağlantısının açık kaldığı saniye. src/cluster_erp/config/settings.py:175
debug bool False CLUSTER_ERP_DEBUG server Hata ayıklama kipi: yeniden yükleme, API belge sayfaları, ayrıntılı günlük. src/cluster_erp/config/settings.py:176
max_request_body_bytes int 26_214_400 CLUSTER_ERP_MAX_REQUEST_BODY_BYTES server Kabul edilen en büyük istek gövdesi; daha büyüğü HTTP 413 alır. src/cluster_erp/config/settings.py:345
enabled_modules list[str] kaynağa bakın CLUSTER_ERP_ENABLED_MODULES server Yüklenecek modüller, sırasıyla; varsayılan 28'inin hepsini listeler. src/cluster_erp/config/settings.py:535
readiness_timeout_seconds float 2.0 CLUSTER_ERP_READINESS_TIMEOUT_SECONDS server GET /ready denetimlerinin her birinin süre sınırı. src/cluster_erp/config/settings.py:647

Kimlik doğrulama, oturumlar ve lisanslama

Bu alanları auth ve app_store modülleri okur; kimlik doğrulama ve oturumlar ve uygulama mağazası, lisanslama ve haklar sayfalarında belgelenir.

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
secret_key str <value> CLUSTER_ERP_SECRET_KEY auth, core, mail, server İmzalama gizli anahtarı; ayarlanmalı, en az 32 karakter olmalı ve hata ayıklama kipi dışında zayıf olmamalı. src/cluster_erp/config/settings.py:186
bootstrap_admin_username str <value> CLUSTER_ERP_BOOTSTRAP_ADMIN_USERNAME server Yeni bir kurulumun ilk yöneticisinin kullanıcı adı. src/cluster_erp/config/settings.py:195
bootstrap_admin_email str <value> CLUSTER_ERP_BOOTSTRAP_ADMIN_EMAIL server İlk yöneticinin e-postası. src/cluster_erp/config/settings.py:196
bootstrap_admin_password str <value> CLUSTER_ERP_BOOTSTRAP_ADMIN_PASSWORD server İlk yöneticinin parolası; boşsa üretilir. src/cluster_erp/config/settings.py:197
bootstrap_admin_password_hash str <value> CLUSTER_ERP_BOOTSTRAP_ADMIN_PASSWORD_HASH server Kiracı hazırlamanın kullandığı önceden özetlenmiş parola. src/cluster_erp/config/settings.py:201
bootstrap_password_file str <value> CLUSTER_ERP_BOOTSTRAP_PASSWORD_FILE server Üretilen ilk parolanın yazıldığı dosya. src/cluster_erp/config/settings.py:205
bootstrap_admin_exclusive bool False CLUSTER_ERP_BOOTSTRAP_ADMIN_EXCLUSIVE server Self servis hazırlama sırasında tohumlanmış varsayılan hesapları kullanımdan kaldırır. src/cluster_erp/config/settings.py:258
jwt_access_expire_minutes int 30 CLUSTER_ERP_JWT_ACCESS_EXPIRE_MINUTES auth Erişim jetonunun ömrü. src/cluster_erp/config/settings.py:307
jwt_refresh_expire_days int 7 CLUSTER_ERP_JWT_REFRESH_EXPIRE_DAYS auth "Beni hatırla" ile yenileme jetonunun ömrü. src/cluster_erp/config/settings.py:308
jwt_session_hours int 12 CLUSTER_ERP_JWT_SESSION_HOURS auth "Beni hatırla" olmadan yenileme zincirinin ömrü. src/cluster_erp/config/settings.py:312
login_rate_limit_per_minute int 10 CLUSTER_ERP_LOGIN_RATE_LIMIT_PER_MINUTE auth HTTP 429'dan önce istemci başına dakikadaki giriş denemesi. src/cluster_erp/config/settings.py:316
auth_cache_seconds float 5.0 CLUSTER_ERP_AUTH_CACHE_SECONDS auth, server Bir isteğin önbellekteki izinleri ve politikaları yeniden kullanabileceği saniye. src/cluster_erp/config/settings.py:320
password_min_length int 8 CLUSTER_ERP_PASSWORD_MIN_LENGTH Güvenlik açıklama politikası gereği çıkarıldı. En kısa parola uzunluğu ayarı. src/cluster_erp/config/settings.py:327
jwt_refresh_reuse_grace_seconds int 15 CLUSTER_ERP_JWT_REFRESH_REUSE_GRACE_SECONDS auth Döndürülmüş bir yenileme jetonunun kabul edilmeye devam ettiği saniye. src/cluster_erp/config/settings.py:332
abac_strict_permission_codes str "" CLUSTER_ERP_ABAC_STRICT_PERMISSION_CODES auth Karşılanmış bir öznitelik politikası gerektiren izin kodları. src/cluster_erp/config/settings.py:339
license_public_key str <value> CLUSTER_ERP_LICENSE_PUBLIC_KEY app_store, server Lisans dosyalarının imzalanması gereken açık anahtar; boşsa lisanslama kapalıdır. src/cluster_erp/config/settings.py:569

Kayıt ve herkese açık uçlar

Kayıt alanları yalnızca kayıt rotalarının bağlandığı çok kiracılı kipte geçerlidir (src/cluster_erp/server/app.py:1440-1450). Bkz. kayıt.

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
signup_payment_provider str "offline" CLUSTER_ERP_SIGNUP_PAYMENT_PROVIDER server Self servis kaydın ödeme bağlantı noktası. src/cluster_erp/config/settings.py:263
signup_trial_days int 30 CLUSTER_ERP_SIGNUP_TRIAL_DAYS server Yeni bir kaydın deneme süresi. src/cluster_erp/config/settings.py:264
signup_enabled bool True CLUSTER_ERP_SIGNUP_ENABLED server Çok kiracılı bir düğümde self servis kaydı açar veya kapatır. src/cluster_erp/config/settings.py:271
signup_rate_limit_per_hour int 5 CLUSTER_ERP_SIGNUP_RATE_LIMIT_PER_HOUR server İstemci adresi başına saatteki kayıt isteği. src/cluster_erp/config/settings.py:272
signup_verify_email bool True CLUSTER_ERP_SIGNUP_VERIFY_EMAIL server Hazırlamadan önce e-postayla alan adı doğrulaması ister. src/cluster_erp/config/settings.py:277
signup_verify_ttl_hours int 48 CLUSTER_ERP_SIGNUP_VERIFY_TTL_HOURS server Doğrulama bağlantısının ömrü. src/cluster_erp/config/settings.py:279
signup_mail_transport str "spool" CLUSTER_ERP_SIGNUP_MAIL_TRANSPORT server Doğrulama postasının taşıması: smtp veya spool. src/cluster_erp/config/settings.py:283
signup_mail_spool_dir str <value> CLUSTER_ERP_SIGNUP_MAIL_SPOOL_DIR server Biriktirilen doğrulama postalarının klasörü. src/cluster_erp/config/settings.py:284
signup_smtp_host str <value> CLUSTER_ERP_SIGNUP_SMTP_HOST server Doğrulama postası için SMTP sunucusu. src/cluster_erp/config/settings.py:285
signup_smtp_port int 587 CLUSTER_ERP_SIGNUP_SMTP_PORT server Doğrulama postası için SMTP bağlantı noktası. src/cluster_erp/config/settings.py:286
signup_smtp_user str <value> CLUSTER_ERP_SIGNUP_SMTP_USER server Doğrulama postası için SMTP kullanıcısı. src/cluster_erp/config/settings.py:287
signup_smtp_password str <value> CLUSTER_ERP_SIGNUP_SMTP_PASSWORD server Doğrulama postası için SMTP parolası. src/cluster_erp/config/settings.py:288
signup_mail_from str <value> CLUSTER_ERP_SIGNUP_MAIL_FROM server Doğrulama postasının göndereni. src/cluster_erp/config/settings.py:289
public_base_url str <value> CLUSTER_ERP_PUBLIC_BASE_URL server Doğrulama bağlantılarında kullanılan mutlak temel URL; boşsa göreli bağlantılar. src/cluster_erp/config/settings.py:292
security_contact str <value> CLUSTER_ERP_SECURITY_CONTACT server /.well-known/security.txt iletişim adresi; boşsa 404 yanıtı verilir. src/cluster_erp/config/settings.py:296
security_policy_url str <value> CLUSTER_ERP_SECURITY_POLICY_URL server security.txt içindeki politika URL'si. src/cluster_erp/config/settings.py:297
security_expires_days int 180 CLUSTER_ERP_SECURITY_EXPIRES_DAYS server security.txt Expires alanına kadar gün. src/cluster_erp/config/settings.py:298
signup_notice_dir str <value> CLUSTER_ERP_SIGNUP_NOTICE_DIR server Kayıttan önce gösterilen aydınlatma metninin klasörü. src/cluster_erp/config/settings.py:305
signup_notice_version str "" CLUSTER_ERP_SIGNUP_NOTICE_VERSION server Her metin onayıyla kaydedilen sürüm. src/cluster_erp/config/settings.py:306

Dosya deposu ve yedekler

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
backup_db_user str <value> CLUSTER_ERP_BACKUP_DB_USER server Yedekleme çalıştırıcısının veritabanı rolü. src/cluster_erp/config/settings.py:216
backup_db_password str <value> CLUSTER_ERP_BACKUP_DB_PASSWORD server Yedekleme rolünün parolası. src/cluster_erp/config/settings.py:217
backup_db_password_file str <value> CLUSTER_ERP_BACKUP_DB_PASSWORD_FILE server Yedekleme rolünün parolasını tutan dosya. src/cluster_erp/config/settings.py:222
console_backup_enabled bool True CLUSTER_ERP_CONSOLE_BACKUP_ENABLED server Operatör konsolundan istek üzerine yedeklemeye izin verir. src/cluster_erp/config/settings.py:225
backup_dir str <value> CLUSTER_ERP_BACKUP_DIR core, server Veritabanı dökümlerinin klasörü. src/cluster_erp/config/settings.py:226
backup_keep int 14 CLUSTER_ERP_BACKUP_KEEP server Veritabanı başına tutulan en yeni dökümler. src/cluster_erp/config/settings.py:227
backup_keep_days int 0 CLUSTER_ERP_BACKUP_KEEP_DAYS server Dökümleri budamak için yaş koruması; 0 kapalıdır. src/cluster_erp/config/settings.py:233
pg_bin_dir str <value> CLUSTER_ERP_PG_BIN_DIR server pg_dump ve pg_restore klasörü. src/cluster_erp/config/settings.py:234
storage_backend str "local" CLUSTER_ERP_STORAGE_BACKEND server Dosya deposu: local veya s3. src/cluster_erp/config/settings.py:347
storage_path str <value> CLUSTER_ERP_STORAGE_PATH server Yerel depolama arka ucunun klasörü. src/cluster_erp/config/settings.py:348
s3_bucket str <value> CLUSTER_ERP_S3_BUCKET server S3 kovası; storage_backend s3 ise zorunludur. src/cluster_erp/config/settings.py:349
s3_region str <value> CLUSTER_ERP_S3_REGION server S3 bölgesi. src/cluster_erp/config/settings.py:350
s3_access_key str <value> CLUSTER_ERP_S3_ACCESS_KEY server S3 erişim anahtarı. src/cluster_erp/config/settings.py:351
s3_secret_key str <value> CLUSTER_ERP_S3_SECRET_KEY server S3 gizli anahtarı. src/cluster_erp/config/settings.py:352
s3_endpoint_url str <value> CLUSTER_ERP_S3_ENDPOINT_URL server S3 uyumlu depolar için S3 ucu. src/cluster_erp/config/settings.py:353
s3_prefix str <value> CLUSTER_ERP_S3_PREFIX server Kova içindeki anahtar öneki. src/cluster_erp/config/settings.py:354
storage_encryption_key str <value> CLUSTER_ERP_STORAGE_ENCRYPTION_KEY server Saklanan dosyaların durağan şifrelemesi için anahtar; 64 onaltılık karakter; çok kiracılı kipte zorunlu. src/cluster_erp/config/settings.py:359
control_encryption_key str <value> CLUSTER_ERP_CONTROL_ENCRYPTION_KEY core Geri okunması gereken kontrol düzlemi gizlerini mühürler. src/cluster_erp/config/settings.py:362
attachment_allowed_extensions list[str] kaynağa bakın CLUSTER_ERP_ATTACHMENT_ALLOWED_EXTENSIONS core, server Genel yükleyicinin kabul ettiği dosya uzantıları. src/cluster_erp/config/settings.py:368
backup_encryption_key str <value> CLUSTER_ERP_BACKUP_ENCRYPTION_KEY core, server Şifreli dökümler için anahtar; çok kiracılı kipte zorunlu. src/cluster_erp/config/settings.py:377
wal_archive_dir str <value> CLUSTER_ERP_WAL_ARCHIVE_DIR server İsteğe bağlı WAL arşivinin klasörü. src/cluster_erp/config/settings.py:392
cold_storage_dir str <value> CLUSTER_ERP_COLD_STORAGE_DIR server İsteğe bağlı soğuk CSV dışa aktarımının klasörü. src/cluster_erp/config/settings.py:393

Posta

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
mail_relay_none bool False CLUSTER_ERP_MAIL_RELAY_NONE server Düğümün sistem postası göndermediğini bildirir. src/cluster_erp/config/settings.py:384
mail_relay_country str "" CLUSTER_ERP_MAIL_RELAY_COUNTRY server Sistem posta aktarıcısının ülkesi. src/cluster_erp/config/settings.py:388
smtp_host str <value> CLUSTER_ERP_SMTP_HOST core, server Sistem posta kutusunun SMTP sunucusu; boşsa yapılandırılmamıştır. src/cluster_erp/config/settings.py:394
smtp_port int 587 CLUSTER_ERP_SMTP_PORT core Sistem posta kutusunun SMTP bağlantı noktası. src/cluster_erp/config/settings.py:395
smtp_user str <value> CLUSTER_ERP_SMTP_USER core Sistem posta kutusunun SMTP kullanıcısı. src/cluster_erp/config/settings.py:396
smtp_password str <value> CLUSTER_ERP_SMTP_PASSWORD core Sistem posta kutusunun SMTP parolası. src/cluster_erp/config/settings.py:397
smtp_use_tls bool True CLUSTER_ERP_SMTP_USE_TLS core Sistem posta kutusu için STARTTLS kullanır. src/cluster_erp/config/settings.py:398
smtp_from_email str <value> CLUSTER_ERP_SMTP_FROM_EMAIL core Gönderen adresi; smtp_host ayarlıysa zorunludur. src/cluster_erp/config/settings.py:399
smtp_from_name str "Cluster ERP" CLUSTER_ERP_SMTP_FROM_NAME core Gönderenin görünen adı. src/cluster_erp/config/settings.py:400
mail_encryption_key str <value> CLUSTER_ERP_MAIL_ENCRYPTION_KEY mail Saklanan posta hesabı gizlerini mühürleyen anahtar; çok kiracılı kipte zorunlu. src/cluster_erp/config/settings.py:408
mail_attachment_max_bytes int 10 * 1024 * 1024 CLUSTER_ERP_MAIL_ATTACHMENT_MAX_BYTES mail Posta düzenleyicisinin kabul ettiği en büyük ek. src/cluster_erp/config/settings.py:412
mail_sync_limit int 30 CLUSTER_ERP_MAIL_SYNC_LIMIT mail Eşitleme başına çekilen son gelen kutusu iletileri. src/cluster_erp/config/settings.py:414

İş varsayılanları

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
allow_project_to_project_stock_transfer bool False CLUSTER_ERP_ALLOW_PROJECT_TO_PROJECT_STOCK_TRANSFER inventory Projeler arası doğrudan stok sahipliği aktarımına izin verir. src/cluster_erp/config/settings.py:184
list_count_cap int 10_000 CLUSTER_ERP_LIST_COUNT_CAP core, server Listeler eşleşen satırları bu tavana kadar sayar; 0 tam sayım demektir. src/cluster_erp/config/settings.py:324
rfq_portal_token_days int 30 CLUSTER_ERP_RFQ_PORTAL_TOKEN_DAYS procurement Tedarikçi portalı davet bağlantılarının ömrü. src/cluster_erp/config/settings.py:364
tcmb_url str <value> CLUSTER_ERP_TCMB_URL currencies Günlük döviz kurlarının kaynağı; varsayılan Türkiye Cumhuriyet Merkez Bankası'nın herkese açık günlük XML'idir. src/cluster_erp/config/settings.py:416
tcmb_sync_on_startup bool False CLUSTER_ERP_TCMB_SYNC_ON_STARTUP - Açılışta döviz kuru eşitlemesi. src/cluster_erp/config/settings.py:417
tcmb_timeout_seconds int 15 CLUSTER_ERP_TCMB_TIMEOUT_SECONDS currencies Döviz kuru çekmenin zaman aşımı. src/cluster_erp/config/settings.py:418
nesting_low_utilization_threshold int 60 CLUSTER_ERP_NESTING_LOW_UTILIZATION_THRESHOLD nesting Altında yerleşimin düşük kullanım uyarısı verdiği kullanım yüzdesi. src/cluster_erp/config/settings.py:420
default_currency str "USD" CLUSTER_ERP_DEFAULT_CURRENCY procurement Varsayılan para birimi kodu. src/cluster_erp/config/settings.py:622
pr_approval_threshold_amount int 50000 CLUSTER_ERP_PR_APPROVAL_THRESHOLD_AMOUNT - Satın alma talebi onay eşiği tutarı. src/cluster_erp/config/settings.py:623
pr_approval_threshold_currency str "TRY" CLUSTER_ERP_PR_APPROVAL_THRESHOLD_CURRENCY - Bu eşiğin para birimi. src/cluster_erp/config/settings.py:624

Analitik

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
analytics_quantile_type int 1 CLUSTER_ERP_ANALYTICS_QUANTILE_TYPE analytics Her yerde kullanılan kantil tanımı: 1 (aradeğerlemesiz) veya 7 (doğrusal). src/cluster_erp/config/settings.py:439
analytics_trimmed_mean_pct Decimal Decimal("10") CLUSTER_ERP_ANALYTICS_TRIMMED_MEAN_PCT analytics Budanmış ortalama için her kuyruktan kesilen yüzde. src/cluster_erp/config/settings.py:442
analytics_mad_sigma_constant Decimal Decimal("1.4826") CLUSTER_ERP_ANALYTICS_MAD_SIGMA_CONSTANT analytics MAD'den sigmaya tutarlılık sabiti. src/cluster_erp/config/settings.py:446
analytics_min_n_for_zscore int 11 CLUSTER_ERP_ANALYTICS_MIN_N_FOR_ZSCORE analytics Z-puanı taraması için en az gözlem. src/cluster_erp/config/settings.py:451
analytics_min_iqr_for_fence Decimal Decimal("0") CLUSTER_ERP_ANALYTICS_MIN_IQR_FOR_FENCE analytics IQR çiti için en küçük çeyrekler arası aralık. src/cluster_erp/config/settings.py:454
analytics_abc_cutoff_a_pct Decimal Decimal("80") CLUSTER_ERP_ANALYTICS_ABC_CUTOFF_A_PCT analytics A sınıfını bitiren birikimli değer payı. src/cluster_erp/config/settings.py:460
analytics_abc_cutoff_b_pct Decimal Decimal("95") CLUSTER_ERP_ANALYTICS_ABC_CUTOFF_B_PCT analytics B sınıfını bitiren birikimli değer payı. src/cluster_erp/config/settings.py:461
analytics_abc_hysteresis_pct Decimal Decimal("2") CLUSTER_ERP_ANALYTICS_ABC_HYSTERESIS_PCT analytics Bir kalemin ABC sınıfı değiştirmeden önce aşması gereken pay. src/cluster_erp/config/settings.py:468
analytics_abc_min_periods int 3 CLUSTER_ERP_ANALYTICS_ABC_MIN_PERIODS analytics ABC sınıflamasından önce talepli en az dönem. src/cluster_erp/config/settings.py:473
analytics_sbc_adi_threshold Decimal Decimal("1.32") CLUSTER_ERP_ANALYTICS_SBC_ADI_THRESHOLD analytics SBC talep sınıflamasının ADI eşiği. src/cluster_erp/config/settings.py:478
analytics_sbc_cv2_threshold Decimal Decimal("0.49") CLUSTER_ERP_ANALYTICS_SBC_CV2_THRESHOLD analytics SBC talep sınıflamasının CV kare eşiği. src/cluster_erp/config/settings.py:479
analytics_sbc_min_occurrences int 3 CLUSTER_ERP_ANALYTICS_SBC_MIN_OCCURRENCES analytics SBC için sıfır olmayan en az talep oluşumu. src/cluster_erp/config/settings.py:481
analytics_profile_exact_max_rows int 200_000 CLUSTER_ERP_ANALYTICS_PROFILE_EXACT_MAX_ROWS analytics Üstünde bir profilin örneklem kullandığı satır sayısı. src/cluster_erp/config/settings.py:487
analytics_profile_sample_rows int 50_000 CLUSTER_ERP_ANALYTICS_PROFILE_SAMPLE_ROWS analytics Örneklemli bir profilin örneklem boyutu. src/cluster_erp/config/settings.py:488
analytics_profile_top_values int 10 CLUSTER_ERP_ANALYTICS_PROFILE_TOP_VALUES analytics Sütun profili başına döndürülen en sık değerler. src/cluster_erp/config/settings.py:490
analytics_profile_sentinels list[str] kaynağa bakın CLUSTER_ERP_ANALYTICS_PROFILE_SENTINELS analytics Gizli eksik değer sayılan değerler. src/cluster_erp/config/settings.py:495
analytics_inference_max_rows int 100_000 CLUSTER_ERP_ANALYTICS_INFERENCE_MAX_ROWS analytics Bir hipotez testinin çekebileceği en büyük örneklem. src/cluster_erp/config/settings.py:524
analytics_summary_refresh_seconds int 60 CLUSTER_ERP_ANALYTICS_SUMMARY_REFRESH_SECONDS server Özet hücre yenilemesinin aralığı; 0 kapatır. src/cluster_erp/config/settings.py:530
analytics_summary_rebuild_minutes int 60 CLUSTER_ERP_ANALYTICS_SUMMARY_REBUILD_MINUTES analytics Tam özet hücre yeniden kurulumunun aralığı. src/cluster_erp/config/settings.py:533

MRP ve DDMRP

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
mrp_default_planning_horizon_days int 90 CLUSTER_ERP_MRP_DEFAULT_PLANNING_HORIZON_DAYS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:571
mrp_safety_stock_method str "fixed" CLUSTER_ERP_MRP_SAFETY_STOCK_METHOD procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:572
mrp_lot_sizing_default str "lot_for_lot" CLUSTER_ERP_MRP_LOT_SIZING_DEFAULT procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:573
mrp_reschedule_threshold_days int 3 CLUSTER_ERP_MRP_RESCHEDULE_THRESHOLD_DAYS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:574
mrp_max_bom_depth int 20 CLUSTER_ERP_MRP_MAX_BOM_DEPTH procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:575
mrp_excess_receipt_tolerance_pct Decimal Decimal("10") CLUSTER_ERP_MRP_EXCESS_RECEIPT_TOLERANCE_PCT procurement Bir girişin azaltma istisnası ürettiği, planlanan ihtiyacın üzerindeki yüzde. src/cluster_erp/config/settings.py:582
mrp_opening_period_days int 21 CLUSTER_ERP_MRP_OPENING_PERIOD_DAYS procurement Planlı bir siparişin üretim emrine çevrilebildiği pencere. src/cluster_erp/config/settings.py:591
mrp_damping_delay_days int 3 CLUSTER_ERP_MRP_DAMPING_DELAY_DAYS procurement Aksiyon mesajından önce tolere edilen gecikme. src/cluster_erp/config/settings.py:592
mrp_damping_advance_days int 3 CLUSTER_ERP_MRP_DAMPING_ADVANCE_DAYS procurement Aksiyon mesajından önce tolere edilen erkenlik. src/cluster_erp/config/settings.py:593
mrp_consumption_backward_days int 30 CLUSTER_ERP_MRP_CONSUMPTION_BACKWARD_DAYS procurement İş günü cinsinden geriye tüketim penceresi. src/cluster_erp/config/settings.py:594
mrp_consumption_forward_days int 15 CLUSTER_ERP_MRP_CONSUMPTION_FORWARD_DAYS procurement İş günü cinsinden ileriye tüketim penceresi. src/cluster_erp/config/settings.py:595
mrp_default_cut_kerf_mm Decimal Decimal("3") CLUSTER_ERP_MRP_DEFAULT_CUT_KERF_MM bom, procurement, production Stok dönüşümü için milimetre cinsinden varsayılan kesim payı. src/cluster_erp/config/settings.py:596
mrp_sheet_part_gap_mm Decimal Decimal("5") CLUSTER_ERP_MRP_SHEET_PART_GAP_MM bom, procurement, production Levhada parçalar arası boşluk, milimetre. src/cluster_erp/config/settings.py:597
mrp_sheet_edge_margin_mm Decimal Decimal("10") CLUSTER_ERP_MRP_SHEET_EDGE_MARGIN_MM bom, procurement, production Levha kenar payı, milimetre. src/cluster_erp/config/settings.py:598
mrp_abc_a_lot_sizing str "lot_for_lot" CLUSTER_ERP_MRP_ABC_A_LOT_SIZING procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:599
mrp_abc_b_lot_sizing str "period_order" CLUSTER_ERP_MRP_ABC_B_LOT_SIZING procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:600
mrp_abc_c_lot_sizing str "fixed_order" CLUSTER_ERP_MRP_ABC_C_LOT_SIZING procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:601
mrp_period_order_days int 7 CLUSTER_ERP_MRP_PERIOD_ORDER_DAYS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:602
mrp_eoq_ordering_cost str "250.00" CLUSTER_ERP_MRP_EOQ_ORDERING_COST procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:603
mrp_eoq_holding_cost_rate str "0.25" CLUSTER_ERP_MRP_EOQ_HOLDING_COST_RATE procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:604
mrp_bucket_days int 7 CLUSTER_ERP_MRP_BUCKET_DAYS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:605
mrp_flush_chunk int 500 CLUSTER_ERP_MRP_FLUSH_CHUNK procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:606
mrp_background_timeout_seconds int 600 CLUSTER_ERP_MRP_BACKGROUND_TIMEOUT_SECONDS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:607
mrp_xyz_x_cov Decimal Decimal("0.5") CLUSTER_ERP_MRP_XYZ_X_COV procurement Altında bir kalemin X sınıfı olduğu değişim katsayısı. src/cluster_erp/config/settings.py:609
mrp_xyz_y_cov Decimal Decimal("1.0") CLUSTER_ERP_MRP_XYZ_Y_COV procurement Altında bir kalemin Y sınıfı olduğu değişim katsayısı. src/cluster_erp/config/settings.py:610
mrp_xyz_default_horizon_days int 180 CLUSTER_ERP_MRP_XYZ_DEFAULT_HORIZON_DAYS procurement Kodda açıklama yok. src/cluster_erp/config/settings.py:611
mrp_leadtime_tolerance_days int 2 CLUSTER_ERP_MRP_LEADTIME_TOLERANCE_DAYS procurement Gerçek teslim süresi önerisinin toleransı. src/cluster_erp/config/settings.py:613
mrp_leadtime_max_samples int 12 CLUSTER_ERP_MRP_LEADTIME_MAX_SAMPLES procurement Gerçek teslim süresi önerisinin örneklem boyutu. src/cluster_erp/config/settings.py:614
ddmrp_adu_horizon_days int 90 CLUSTER_ERP_DDMRP_ADU_HORIZON_DAYS procurement DDMRP ortalama günlük kullanım ufku. src/cluster_erp/config/settings.py:617
ddmrp_spike_threshold_pct Decimal Decimal("50") CLUSTER_ERP_DDMRP_SPIKE_THRESHOLD_PCT procurement Kırmızının yüzdesi olarak DDMRP sivrilme eşiği. src/cluster_erp/config/settings.py:618
ddmrp_default_lt_factor Decimal Decimal("0.5") CLUSTER_ERP_DDMRP_DEFAULT_LT_FACTOR procurement Varsayılan tampon teslim süresi katsayısı. src/cluster_erp/config/settings.py:619
ddmrp_default_variability_factor Decimal Decimal("0.5") CLUSTER_ERP_DDMRP_DEFAULT_VARIABILITY_FACTOR procurement Varsayılan tampon değişkenlik katsayısı. src/cluster_erp/config/settings.py:620
ddmrp_default_order_cycle_days int 7 CLUSTER_ERP_DDMRP_DEFAULT_ORDER_CYCLE_DAYS procurement Varsayılan tampon sipariş döngüsü. src/cluster_erp/config/settings.py:621

Günlükler, saklama ve gizlilik

Ayar Tür Varsayılan Ortam değişkeni Okuyan Anlamı Kaynak
activity_log_enabled bool True CLUSTER_ERP_ACTIVITY_LOG_ENABLED server İstek etkinlik günlüğünü açar veya kapatır. src/cluster_erp/config/settings.py:628
activity_log_skip_paths list[str] kaynağa bakın CLUSTER_ERP_ACTIVITY_LOG_SKIP_PATHS server Günlüğe yazılmayan yollar. src/cluster_erp/config/settings.py:630
activity_log_retention_days int 90 CLUSTER_ERP_ACTIVITY_LOG_RETENTION_DAYS server Etkinlik günlüğü satırlarının tutulduğu gün. src/cluster_erp/config/settings.py:640
error_log_retention_days int 365 CLUSTER_ERP_ERROR_LOG_RETENTION_DAYS server Hata günlüğü satırlarının tutulduğu gün. src/cluster_erp/config/settings.py:641
log_purge_batch_rows int 10_000 CLUSTER_ERP_LOG_PURGE_BATCH_ROWS server Günlük temizliğinin ifade başına sildiği satır. src/cluster_erp/config/settings.py:644
log_sanitize_keys list[str] kaynağa bakın CLUSTER_ERP_LOG_SANITIZE_KEYS server Değerleri günlük özetlerinde maskelenen gövde anahtarları. src/cluster_erp/config/settings.py:653
log_sanitize_path_keys dict[str, list[str]] kaynağa bakın CLUSTER_ERP_LOG_SANITIZE_PATH_KEYS server Yalnızca eşleşen yollarda maskelenen gövde anahtarları. src/cluster_erp/config/settings.py:695
log_body_max_bytes int 2048 CLUSTER_ERP_LOG_BODY_MAX_BYTES server Saklanan bir gövde özetinin en büyük boyutu. src/cluster_erp/config/settings.py:700
log_redact_path_tokens bool True CLUSTER_ERP_LOG_REDACT_PATH_TOKENS server Günlükte jeton benzeri yol parçalarını *** ile değiştirir. src/cluster_erp/config/settings.py:704
log_username_cache_seconds int 300 CLUSTER_ERP_LOG_USERNAME_CACHE_SECONDS server Günlüğün çözülmüş bir kullanıcı adını yeniden kullandığı saniye. src/cluster_erp/config/settings.py:707
change_history_redact_columns list[str] [] CLUSTER_ERP_CHANGE_HISTORY_REDACT_COLUMNS core, server Değişiklik geçmişinin değerlerini gizlediği ek sütunlar. src/cluster_erp/config/settings.py:711
control_signup_retention_days int 30 CLUSTER_ERP_CONTROL_SIGNUP_RETENTION_DAYS server Tamamlanmamış bir kaydın kontrol düzleminde tutulduğu gün. src/cluster_erp/config/settings.py:718
control_rate_limit_retention_hours int 24 CLUSTER_ERP_CONTROL_RATE_LIMIT_RETENTION_HOURS server Hız sınırı satırlarının tutulduğu saat. src/cluster_erp/config/settings.py:721
control_actions_retention_years int 10 CLUSTER_ERP_CONTROL_ACTIONS_RETENTION_YEARS server Operatör eylem kayıtlarının tutulduğu yıl. src/cluster_erp/config/settings.py:724
signup_mail_spool_retention_days int 7 CLUSTER_ERP_SIGNUP_MAIL_SPOOL_RETENTION_DAYS server Biriktirilen doğrulama postalarının tutulduğu gün. src/cluster_erp/config/settings.py:727
privacy_response_days int 30 CLUSTER_ERP_PRIVACY_RESPONSE_DAYS privacy Bir veri sahibi talebinin yanıtlanması gereken gün. src/cluster_erp/config/settings.py:733
privacy_anonymised_marker str "[anonymised]" CLUSTER_ERP_PRIVACY_ANONYMISED_MARKER privacy Anonimleştirmede kimlik belirleyici alanların üzerine yazılan değer. src/cluster_erp/config/settings.py:737

Türetilmiş özellikler ve yardımcılar

Üye Döndürdüğü Kaynak
database_url Varsayılan veritabanının async URL'si postgresql+asyncpg://... src/cluster_erp/config/settings.py:838-843
database_url_sync Düz postgresql:// şemasıyla aynı URL src/cluster_erp/config/settings.py:845-850
control_database_url Kontrol düzlemi veritabanının async URL'si src/cluster_erp/config/settings.py:852-857
node_country_code Boşlukları alınmış ve büyük harfli node_country src/cluster_erp/config/settings.py:860-863
console_origin_list() Ayrıştırılmış console_origins; her köken https:// ile başlamalıdır src/cluster_erp/config/settings.py:865-875
country_node_map() Ayrıştırılmış country_nodes; iki harfli anahtarlar ve https:// adresleri src/cluster_erp/config/settings.py:877-896
region_codes() ve default_region Ayrıştırılmış regions; ilki varsayılandır src/cluster_erp/config/settings.py:899-905
region_address(region) ve region_url(region, db_name, sync=False) Bir bölgenin veritabanının sunucusu ve URL'si src/cluster_erp/config/settings.py:915-944

Kısıtlar ve doğrulama

_validate_settings doğrulayıcısı alanlar yüklendikten sonra çalışır (src/cluster_erp/config/settings.py:739-836). Yükleme şu durumlarda ValueError ile başarısız olur:

  • Bir bölge kodu küçük harf, rakam veya tireden oluşan 2 ile 8 karakter değilse; region_db_urls bilinmeyen bir bölgeyi adlandırıyorsa; ya da varsayılan olmayan bir bölgenin sunucusu yoksa (src/cluster_erp/config/settings.py:746-753).
  • node_country ayarlı ve iki harfli bir kod değilse ya da country_nodes bu düğümün kendi ülkesini listelemiyorsa (src/cluster_erp/config/settings.py:754-765).
  • multi_tenant ve debug ikisi de açıksa (src/cluster_erp/config/settings.py:766-770).
  • secret_key hata ayıklama kipi dışında gelen varsayılanı koruyorsa, 32 karakterden kısaysa ya da hata ayıklama kipi dışında zayıfsa. Hata ayıklama kipinde varsayılan anahtar üretilmiş bir anahtarla değiştirilir, zayıf bir anahtar yalnızca uyarı yazar (src/cluster_erp/config/settings.py:771-804).
  • Çok kiracılı kipte storage_encryption_key, backup_encryption_key veya mail_encryption_key boşsa (src/cluster_erp/config/settings.py:805-821).
  • storage_encryption_key veya backup_encryption_key ayarlı ama 32 baytlık onaltılık değer değilse (src/cluster_erp/config/settings.py:822-827).
  • storage_backend s3 ve s3_bucket boşsa (src/cluster_erp/config/settings.py:828-831).
  • smtp_host ayarlı ve smtp_from_email boşsa (src/cluster_erp/config/settings.py:832-835).

Tanıtılan terimler

Terim Kod tanımlayıcısı Tanım Türkçe terim Kaynak
settings Settings Yapılandırmayı CLUSTER_ERP_ ortam değişkenlerinden ve .env dosyasından yükleyen Pydantic sınıfı. ayarlar src/cluster_erp/config/settings.py:64

İlgili sayfalar


92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.

Doğrulanan commit 92f8051 · 2026-11-13