Tarım Teknolojisi Operasyonları

Bu grup ne yapar

Tarım Teknolojisi Operasyonları, Tarım add-on'ının operasyonel çekirdeğidir: bir tarla görevinin sevkinden hasada, verim toplamaya ve utility maliyet ölçümüne kadar bir mahsul döngüsünü taşıyan beş ekran. Her ekran, diğer ekranların okuduğu gerçek veriyi yazar — bir mürettebatın gerçekleştirdiği tarla emri, bir IoT sensör uyarısından otomatik türetilebilir; hasat planı gerçek silo kapasitesi ayırır ve teraziden çıkan verim kaydı doğrudan Çiftlikten Sofraya İzlenebilirlik'e yayınlanır.

Beş ekranın tümü src/services/agroTechExecutionService.ts tarafından desteklenir; her ekran kendi /api/data/* destekli kayıt setini yönetir ve gerçek çapraz-ekran entegrasyon kancaları içerir — simüle edilmiş devirler değil. Bazı kancalar döngüsel modül bağımlılığını önlemek için dinamik import() ile harvestSupplyInventoryService.ts ve qualityCropHealthService.ts'ye ulaşır.

1. Tarla & Sera İş Emirleri

Amaç: Mürettebat ve ekipmanların bir parsele veya sera bölgesine karşı gerçekleştirdiği fiziksel tarla/sera görevlerini — sürme, damla sulama gübreleme, pestisit püskürtme, budama — sevk edip izlemek.

Temel özellikler

• Görev tipleri — plowing, fertigation, pesticide_spraying, pruning (FieldOrderTaskType).
• Emir yaşam döngüsü — draft → scheduled → in_progress → completed → qa_on_hold (FieldOrderStatus).
• Yürütme kaydı — gerçek başlangıç/bitiş zamanı, tüketilen yakıt/enerji, operatör gözlemleri, fotoğraf URL'leri, planlanan-vs-gerçek oranlı bir materialsUsed[] listesi, çalışılan saat ve mürettebatın sahadan bildirebileceği bir cropHealthAnomalyReported bayrağı.
• Bağlı referanslar — hedef lokasyon (Tarla/Sera), hedef Mahsul Reçetesi, Agronomik SOP, atanan iş gücü (Çalışan) ve atanan ekipman (Varlık).

Entegrasyon tetikleyicileri

2. Sezon & Hasat Planlama

Amaç: Ekimden hasada bir mahsul döngüsünü planlamak — kilometre taşları, hedef ton, ekipman filosu ataması ve depolama rezervasyonu — ve hasat yetkilendirmesini kalite onayı ve kimyasal güvenlik pencereleri arkasında kilitli tutmak.

Temel özellikler

• Plan kodları — HSC-2026-XXXX (generateHarvestScheduleCode).
• Durum yaşam döngüsü — planned → maturing → ready_for_harvest → active_harvesting → completed (HarvestScheduleStatus).
• Kilometre taşları — etiketli hedef tarihler ve tamamlanma bayrağı içeren bir liste (HarvestMilestone[]).
• Hasat Hazırlık Skoru — computeHarvestReadinessScore() bir olgunluk hedefine karşı biriken Büyüme Derece Günlerini (%70 ağırlık) toprak nem sağlığıyla (%30 ağırlık) harmanlar.
• Silo rezervasyonu — gerçek kapasiteyi rezerve eden bir targetSiloId/targetSiloCode ve expectedVolumeTons.
• Hasat kapıları — preHarvestClearanceApproved (bir Mahsul Sağlığı Kontrol Listesi hasat öncesi denetimi geçtiğinde ayarlanır) ve harvestLockoutActive (Tarım-Kimyasal Analitiği'nden aktif bir PHI penceresi tarlada hasadı engellerken doğru olur).

Entegrasyon tetikleyicileri

3. IoT İklim & Toprak İzleme

Amaç: Tarla/sera düğümlerinden sensör telemetrisini — ortam sıcaklığı, nem, toprak nemi/EC/pH, VPD — almak ve eşik dışı okumalar üzerine otomatik olarak hareket etmek.

Temel özellikler

• Düğüm kodları — IOT-2026-XXXX (generateIoTNodeCode).
• Sensör durumu — optimal, warning_dry_soil, critical_high_temp, sensor_offline (IoTSensorStatus).
• Telemetri alanları — ortam sıcaklığı (°C), bağıl nem (%), toprak nemi (%), toprak EC, toprak pH, VPD (kPa), pil %, sinyal gücü %, son ping zaman damgası, düğüm başına yapılandırılabilir bir IoTThresholdConfig.
• Mikroiklim Sağlık Skoru — computeMicroclimateHealthScore(), ortam sıcaklığı, nem ve pH'ın bağlı Mahsul Reçetesi'nin hedef büyüme-aşaması parametrelerini ne kadar yakından izlediğinin ortalamasını alır.

Entegrasyon tetikleyicileri

4. Mahsul Verim Panosu

Amaç: Parti başına gerçek hasat sonucunu — hektar başına verim, kalite derecesi, tartı köprüsü okuması, kusurlar — kaydetmek ve bu veriyi izlenebilirliğe, ML verim taban çizgilerine ve depolama girişine yaymak.

Temel özellikler

• Verim kayıt kodları — YLD-2026-XXXX (generateYieldRecordCode), ayrı bir harvestBatchCode (BAT-2026-XXXX) ile birlikte.
• Kalite dereceleri — grade_a_premium, grade_b_industrial, grade_c_waste (YieldQualityGrade).
• Verim farkı — computeYieldVariancePercent(), gerçek verim/ha'yı hedef taban çizgisi/ha ile karşılaştırır, işaretli bir yüzde olarak ifade eder.
• Kusur takibi — bir YieldDefectEntry[] listesi (sebep + kayıp yüzdesi), artı weighbridgeReadingTons ve percentLossWaste.
• Yayınlama bayrakları — validated, traceabilityPublished, baselineSynced, storageBatchLogged bu parti için hangi alt akış senkronizasyonlarının tetiklendiğini izler.

Entegrasyon tetikleyicileri

5. Kaynak Sayaçları

Amaç: Tarla/sera bölgesi başına utility tüketimini — sulama suyu, elektrik, dizel, doğal gaz — günlük bir kotaya karşı ölçmek, sızıntıları/dalgalanmaları işaretlemek ve gözlemlenen maliyeti alt akışa yayınlamak.

Temel özellikler

• Sayaç kodları — CTR-2026-XXXX (generateCounterCode).
• Kaynak tipleri — irrigation_water_m3, electricity_kwh, diesel_liters, natural_gas_m3 (ResourceType).
• Durum — normal, threshold_exceeded, possible_leak_overuse, uncalibrated (ResourceCounterStatus).
• Net kullanım & günlük kota — computeNetUsage(), sayaç sıfırlama/dönüşünün asla negatif tüketim bildirmemesi için (gerçek − önceki okuma)'yı sıfırda kelepçeler; computeDailyQuotaPercent() bu kullanımı sayacın dailyLimitAllowance'ının yüzdesi olarak ifade eder.
• Sızıntı & dalgalanma bayrakları — leakFlagged, powerSurgeFlagged, artı bir photoProofUrl ve lastCalibrationDate.
• SOP maliyet atfı — her sayaç bir Agronomik SOP'a bağlanabilir (sopId/sopCode) böylece gözlemlenen maliyeti o SOP'un çalışan maliyet tabanını besler.

Entegrasyon tetikleyicileri

Uçtan uca veri akışı

Sıkça Sorulan Sorular

Bu bölümdeki sayfalar

• Genel Bakış
• Operasyonel Kurulum & Ana Veri
• Alan Rolleri & Yetenekler
• Ekran İş Akışları
• Kalite & Bitki Sağlığı Operasyonları
• Tarım Ekipman Bakımı
• Hasat & Tedarik Envanteri