Kalite & Bitki Sağlığı Operasyonları - Tarım

Bu grup ne yapar

Bu, Tarım & Tarım Teknolojisi Operasyonları eklentisindeki en birbirine bağlı gruptur. Toprak & Su Testi ve Zararlı & Hastalık Uyarıları'nın her ikisi de Tarım-Kimyasal Analitiği'nde kaydedilen pestisit/gübre uygulamalarını besler; bu ekran bir PHI (Hasat-Öncesi Aralık) hasat kilidini uygular. Mahsul Sağlığı Kontrol Listesi hasat-öncesi izni kapılar. Çiftlikten Sofraya İzlenebilirlik, tüm bunları — artı Mahsul Verim Panosu'nun kantar verisini — parti başına bir dijital ürün pasaportunda derler.

Toprak & Su Testi

→

Mahsul Sağlığı Kontrol Listesi

→

Zararlı & Hastalık Uyarıları

→

Tarım-Kimyasal Analitiği

→

Çiftlikten Sofraya İzlenebilirlik

Beş ekranın tamamı tek bir servis dosyasını paylaşır: src/services/qualityCropHealthService.ts. Tarla emirleri, hasat planları, verim kayıtları ve silo kaydı için agroTechExecutionService.ts ve harvestSupplyInventoryService.ts'e uzanır.

1. Toprak & Su Testi

Amaç: Toprak ve su numuneleri için laboratuvar sonuçlarını — pH, EC tuzluluğu, makro/mikro besinler, ağır metaller — SOP tanımlı sınırlara karşı kaydetmek ve bir numune aralık dışına çıktığında iyileştirme tetiklemek.

Öne çıkan özellikler

Numune tipleri — topsoil_profile, subsoil_profile, irrigation_water, hydroponic_runoff; her test SWT-2026-XXXX ile kodlanır.
Durum yaşam döngüsü — sample_collected → in_lab_analysis → report_published → action_required.
Laboratuvar okumaları — pH seviyesi, EC tuzluluğu (mS/cm), azot/fosfor/potasyum (ppm), organik madde (%), mikro besin okumaları listesi (ppm, eksiklik bayrağı) ve ağır metal bayrakları (ppm, güvenli sınırı aşma bayrağı).
Toprak Sağlığı Skoru — computeSoilHealthScore() pH ve EC'yi mahsul reçetesinin hedef büyüme aşaması eşikleriyle karşılaştırır.
SOP sınır kontrolü — isOutOfSopBounds(), pH'ı reçetenin min/maks değerinin dışına çıkan veya EC'si hedeften %25'ten fazla sapan bir numuneyi işaretler — bir iyileştirme emrinin tetikleyici koşulu.

Entegrasyon tetikleyicileri

Eylem	Ne yapar
`syncTestToFieldProfile`	Tarlalar & Seralar'daki `ProductionAreaItem` kaydında ana parselin toprak özelliklerini (son toprak testi tarihi) doğrudan günceller.
`createFieldWorkOrder`	pH veya besin seviyeleri SOP sınırlarının dışına çıktığında, Tarla/Sera Emirleri'nde doğrudan bir toprak iyileştirme/kireçleme uygulaması tarla emri (görev tipi `fertigation`, durum `scheduled`) oluşturur — bkz. Tarım Teknolojisi Operasyonları.
`syncChemicalRequirements`	N/P/K eksikliklerinden türetilen gübre ayarlama gereksinimlerini bu aynı servisin kendi Tarım-Kimyasal Analitiği defterine yeni bir gübre uygulama kaydı olarak besler.

2. Mahsul Sağlığı Kontrol Listesi

Amaç: Tarla agronomik denetimlerini — rutin, hasat-öncesi veya işlem-sonrası — bir dizi 1-5 tarla değerlendirmesi ve yüzde metriği üzerinde puanlayarak yürütmek ve hasat yetkilendirmesini kapılamak.

Öne çıkan özellikler

Denetim tipleri — routine_agronomic, pre_harvest_audit, post_treatment_check; her kontrol listesi CHC-2026-XXXX ile kodlanır.
Durum yaşam döngüsü — passed, requires_attention, quarantine_flagged.
1-5 tarla değerlendirme ölçeği — klorofil sağlığı, yabani ot yoğunluğu, sulama düzgünlüğü, böcek baskısı, artı kanopi yoğunluğu, yaprak canlılığı ve kök yapısı sağlığı için yüzde metrikleri.
Sağlık Endeksi Skoru — computeHealthIndexScore(), normalize edilmiş değerlendirmeleri ve yüzde metriklerini tek bir 0-100 skorunda ortalar.
Eksiklik bayrakları — semptom/şiddet girdileri listesi (örn. "Azot eksikliği — alt yaprakların sararması").
Hasat-öncesi bağlantı — bir pre_harvest_audit kontrol listesi linkedScheduleId aracılığıyla bir Sezon & Hasat Planlama planına bağlanabilir.

Entegrasyon tetikleyicileri

Eylem	Ne yapar
`escalateChecklistToAlert`	`isPestPressureCritical()` doğru olduğunda (böcek baskısı değerlendirmesi ≥ 4), bu servisin kendi Zararlı & Hastalık Uyarısı defterinde doğrudan bir uyarı oluşturur; şiddet değerlendirmeden türetilir (5→`critical_quarantine`, 4→`moderate`).
`approvePreHarvestChecklist`	Sezon & Hasat Planlama'daki bağlı hasat planında `preHarvestClearanceApproved`'ı ayarlar, hasat yetkilendirmesinin kilidini açar — bkz. Tarım Teknolojisi Operasyonları.
`requestSoilTesting`	`hasNutrientDeficiencySymptoms()` bir eksiklik bayrağının semptom metniyle eşleştiğinde, bu servisin kendi Toprak & Su Testi defterine doğrudan bir numune toplama görevi gönderir (durum `sample_collected`).

3. Zararlı & Hastalık Uyarıları

Amaç: Tarla başına aktif zararlı/hastalık salgınlarını izlemek, yayılma riskini değerlendirmek ve acil bir pestisit yanıtı göndermek.

Öne çıkan özellikler

Salgın şiddeti — low, moderate, critical_quarantine; her uyarı PDA-2026-XXXX ile kodlanır.
Yanıt durumu — active_threat → spray_scheduled → contained → resolved.
Yayılma Riski Skoru — computeSpreadRiskScore(), mevcut olduğunda IoT telemetrisinden çekilen ortam nemi (>%70) ve sıcaklıktan (22-32°C) gelen bir iklim artışıyla bir şiddet temel skorunu harmanlar.
Tanısal bulgular & hedef aktif bileşenler — laboratuvarda doğrulanabilir bulgular listesi ve her biri bir dozaj oranı sınırı ve PHI günü olan hedef aktif bileşenler listesi.
Kaynak bağlantısı — bir uyarı, bir Mahsul Sağlığı Kontrol Listesi denetiminden yükseltildiğinde sourceChecklistId, belirli bir verim kaydına verim kaybı yansıtmak için linkedYieldRecordId taşıyabilir.

Entegrasyon tetikleyicileri

Eylem	Ne yapar
`dispatchEmergencyPesticideOrder`	Tarla/Sera Emirleri'nde doğrudan acil bir `pesticide_spraying` tarla emri oluşturur, aktif bileşeni operatör gözlemlerinde belirtir — bkz. Tarım Teknolojisi Operasyonları.
`logChemicalActiveIngredient`	Uyarının hedef aktif bileşenini, dozaj sınırını ve PHI penceresini bu servisin kendi Tarım-Kimyasal Analitiği defterine doğrudan kaydeder, MRL durumu `phi_restricted` olarak ayarlanır.
`projectYieldLossPenalty`	Tahmini mahsul kaybı yüzdesini etkilenen ürünün ML verim temelini indirmek için gönderir (`targetHarvestService`'te `discountMlBaselineYield`) ve bağlı Mahsul Verim kaydının hedef temelini orantılı olarak azaltır.

4. Tarım-Kimyasal Analitiği

Amaç: Her kimyasal uygulamayı Hasat-Öncesi Aralık (PHI) geri sayımına ve Maksimum Kalıntı Limiti (MRL) uyumluluğuna karşı izlemek, kısıtlıyken bir hasat kilidi uygulamak.

Öne çıkan özellikler

Kayıt kodları — ACA-2026-XXXX; her uygulama bir kimyasal ürün adına, aktif bileşene, toplam dozaja (L/ha) ve uygulama tarihine bağlı.
MRL durumu — compliant, phi_restricted, mrl_violation_risk.
PHI geri sayımı & hasat kilidi — computePhiDaysRemaining() uygulama tarihinden ve pencere uzunluğundan aralıkta kalan günleri türetir; isPhiLockoutActive() herhangi bir gün kalırken doğrudur — o tarlada hasadı kilitlemenin tetikleyici koşulu.
Uygulayıcı lisans doğrulaması — uygulama başına doğrulanmış lisans bayrağı ve lisans numarası, artı bir MSDS URL'si.
Kalıntı laboratuvar testleri — uygulama başına eklenen laboratuvar test sonuçları listesi (kalıntı ppm, ihracat pazarı MRL eşiği, test tarihi).
Kaynak bağlantısı — bir kayıt, bir Toprak & Su Testi gübre eksikliğinden otomatik türetildiğinde sourceTestId, bir Zararlı & Hastalık Uyarıları yükseltmesinden otomatik türetildiğinde sourceAlertId taşıyabilir.

Entegrasyon tetikleyicileri

Eylem	Ne yapar
`toggleHarvestLockout`	PHI geri sayımı aktifken o tarlayı hedefleyen her Sezon & Hasat Planlama planında `harvestLockoutActive`'i ayarlar — bkz. Tarım Teknolojisi Operasyonları.
`deductInventoryStock`	Uygulanan kimyasal hacmini Tarım Girdisi Depolama'daki (`deductStagingStock`) depolanmış stokla mutabık kılar — bkz. Hasat & Tedarik Envanteri.
`attachComplianceToPassport`	Eşleşen partinin dijital pasaportu için bu servisin kendi Çiftlikten Sofraya İzlenebilirlik defterine doğrudan bir kalıntı temizlik sertifikası referansı gönderir.

5. Çiftlikten Sofraya İzlenebilirlik

Amaç: Tarla emirlerinden, toprak/su testlerinden, kimyasal uygulamalardan ve verim/kantar verisinden köken verisini derleyen parti başına bir dijital ürün pasaportu oluşturmak, ardından tüketiciye yönelik doğrulama için genel bir QR kodu dışa aktarmak.

Öne çıkan özellikler

Parti kodları — LOT-2026-XXXX; her biri bir hasat parti koduna, mahsul çeşidine, menşe tarlaya ve isteğe bağlı olarak bir depolama silosuna bağlı.
Sertifikasyon durumu — not_certified, globalgap_pending, globalgap_certified, organic_certified.
Uyumluluk durumu — verified_complete, missing_lab_clearance, quarantined.
Dijital Ürün Pasaportu modalı — tarla emirlerinden ve tarım-kimyasal kayıtlarından çekilen bir LineageDataSource girdileri listesi olan agronomicTreatmentHistory'yi derler (kaynak tipi, id, kod, derlenme zaman damgası).
Tedarik Zinciri Kökeni Skoru — computeLineageScore(), 6 faktörlü bir tamlık göstergesidir: ekim tarihi ayarlı, tedavi geçmişi boş değil, kalıntı temizliği ekli, kantar okuması mevcut, soğuk zincir günlük özeti mevcut, depolama silosu bağlı. Geçen her faktör 0-100 skoruna 1/6 katkı sağlar.
Genel QR dışa aktarımı — pasaport derlendikten sonra tüketiciye yönelik bir doğrulama jetonu oluşturur.

Entegrasyon tetikleyicileri

Eylem	Ne yapar
`compileBatchPassport`	Tarla/Sera Emirleri'nden ve Tarım-Kimyasal Analitiği'nden (menşe tarlaya göre filtrelenmiş) köken verisini derler ve bağlı Mahsul Verim kaydından kantar okumasını çeker; birleşik sonucu `agronomicTreatmentHistory`'ye yazar ve `passportCompiled`'ı ayarlar.
`exportPublicQrPassport`	Genel bir QR jetonu oluşturur ve `qrPassportExported`'ı ayarlar, bu servisin kendi izlenebilirlik kaydına doğrudan yazılır.
`verifyStorageOrigin`	Partinin giriş parametrelerini Silo & Depolama Yönetimi kaydına karşı doğrular ve eşleştiğinde `storageSiloId`/`storageSiloCode`'u bağlar — bkz. Hasat & Tedarik Envanteri.

Perde arkası — pasaport gerçek bir derleme, sahte değil

compileBatchPassport, agroTechExecutionService.ts'e (tarla emirleri, verim kayıtları) ve bu aynı dosyanın kendi tarım-kimyasal defterine karşı gerçek çapraz-servis okumaları gerçekleştirir — yer tutucu bir metin değildir. Tek eksik: verifyStorageOrigin, özel bir ekranın kendi doğrulama arayüzü yerine doğrudan silo kaydına karşı kontrol eder; çünkü Silo & Depolama Yönetimi'nin kaydı yakın zamanda agroTechExecutionService.ts'ten taşındı (bkz. uygulama notu Hasat & Tedarik Envanteri).

Uçtan uca veri akışı

Kaynak ekran / fonksiyon	Ne yazar	Hedef ekran / kayıt
Toprak & Su Testi — `syncTestToFieldProfile`	Son toprak testi tarihini günceller	Tarlalar & Seralar (`ProductionAreaItem`)
Toprak & Su Testi — `createFieldWorkOrder`	Yeni `fertigation` tarla emri	Tarla/Sera Emirleri
Toprak & Su Testi — `syncChemicalRequirements`	Yeni gübre uygulama kaydı	Tarım-Kimyasal Analitiği (aynı dosya)
Mahsul Sağlığı Kontrol Listesi — `escalateChecklistToAlert`	Yeni zararlı/hastalık uyarısı	Zararlı & Hastalık Uyarıları (aynı dosya)
Mahsul Sağlığı Kontrol Listesi — `approvePreHarvestChecklist`	`preHarvestClearanceApproved`'ı ayarlar	Sezon & Hasat Planlama
Mahsul Sağlığı Kontrol Listesi — `requestSoilTesting`	Yeni toprak numunesi testi	Toprak & Su Testi (aynı dosya)
Zararlı & Hastalık Uyarıları — `dispatchEmergencyPesticideOrder`	Yeni `pesticide_spraying` tarla emri	Tarla/Sera Emirleri
Zararlı & Hastalık Uyarıları — `logChemicalActiveIngredient`	Yeni kimyasal uygulama kaydı	Tarım-Kimyasal Analitiği (aynı dosya)
Zararlı & Hastalık Uyarıları — `projectYieldLossPenalty`	ML verim temelini indirir	Hedef Hasatlar + Mahsul Verim Panosu
Tarım-Kimyasal Analitiği — `toggleHarvestLockout`	`harvestLockoutActive`'i ayarlar	Sezon & Hasat Planlama
Tarım-Kimyasal Analitiği — `deductInventoryStock`	Depolama stoğunu düşer	Tarım Girdisi Depolama
Tarım-Kimyasal Analitiği — `attachComplianceToPassport`	Kalıntı temizliğini ekler	Çiftlikten Sofraya İzlenebilirlik (aynı dosya)
Çiftlikten Sofraya İzlenebilirlik — `compileBatchPassport`	Köken geçmişini derler	Kendi kaydı (3 yukarı akış ekranını derler)
Çiftlikten Sofraya İzlenebilirlik — `verifyStorageOrigin`	Depolama silosunu bağlar	Silo & Depolama Yönetimi kaydı

Bu bölümdeki sayfalar

Sıkça Sorulan Sorular

Bir tarlada hasat kilidini ne tetikler?

PHI (Hasat-Öncesi Aralık) penceresi henüz geçmemiş herhangi bir Tarım-Kimyasal Analitiği uygulaması. toggleHarvestLockout, o tarlayı hedefleyen her hasat planında harvestLockoutActive'i ayarlar ve computePhiDaysRemaining() sıfıra ulaşana kadar temizlenmez.

Bir tarla denetiminden bir zararlı/hastalık uyarısı otomatik olarak nasıl açılır?

Bir Mahsul Sağlığı Kontrol Listesi denetiminin böcek baskısı değerlendirmesi 4 veya 5 olduğunda, isPestPressureCritical() doğru döner ve escalateChecklistToAlert doğrudan yeni bir uyarı kaydı açar — 5 değerlendirme için critical_quarantine şiddeti, 4 için moderate.

Tedarik Zinciri Kökeni Skoru tam olarak neyi ölçer?

Bir izlenebilirlik partisi üzerinde altı tamlık kontrolü: ekim tarihi ayarlı, tedavi geçmişi boş değil, kalıntı temizliği ekli, kantar okuması mevcut, soğuk zincir günlük özeti mevcut ve depolama silosu bağlı. Geçen her kontrol 0-100 skorunun altıda birine katkı sağlar — ürün kalitesini değil, veri tamlığını ölçer.

Bir toprak testinden gelen gübre uygulaması PHI/MRL iş akışını atlayabilir mi?

Hayır — syncChemicalRequirements gübre ayarlamalarını, pestisit uygulamalarıyla aynı Tarım-Kimyasal Analitiği defterine yazar; sadece varsayılan olarak compliant bir MRL durumu ve sıfır PHI penceresiyle — böylece hâlâ aynı uyumluluk tablosunda görünürler.

Dijital Ürün Pasaportu'nu hangi veri kaynakları besler?

compileBatchPassport, Tarla/Sera Emirleri'nden ve Tarım-Kimyasal Analitiği'nden (her ikisi de partinin menşe tarlasına filtrelenmiş) artı bağlı Mahsul Verim Panosu kaydından kantar okumasını çeker. Depolama silosu bağlantısı ayrıca verifyStorageOrigin tarafından eklenir.

Depolama kökenini doğrulamak neden özel bir ekran yerine doğrudan silo kaydını kontrol ediyor?

verifyStorageOrigin yazıldığında, silo kaydı yalnızca agroTechExecutionService.ts içindeki minimal bir depo olarak yaşıyordu. O zamandan beri tam bir yönetim ekranıyla (Silo & Depolama Yönetimi) birlikte harvestSupplyInventoryService.ts'e taşındı — doğrulama mantığı aynı şekilde çalışmaya devam ediyor, sadece artık kanonik olan kayda karşı.