TotalApp Dokümantasyon

Tarım Teknolojisi Operasyonları

Tarla/sera iş emri sevkiyatından sezon & hasat planlamaya, IoT iklim izlemeye, verim toplamaya ve kaynak sayaç ölçümüne kadar — tam tarla-hasat yürütme hattı.

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.

Tarla & Sera İş Emirleri
→
Sezon & Hasat Planlama
→
IoT İklim & Toprak İzleme
→
Mahsul Verim Panosu
→
Kaynak Sayaçları

Beş ekranın tümü sunucu tarafında kalıcı olarak saklanan kendi kayıt setini yönetir ve gerçek çapraz-ekran entegrasyon bağlantıları içerir — simüle edilmiş devirler değil.

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 — Sürme, Damla Sulama Gübreleme, Pestisit Püskürtme, Budama.
  • Emir yaşam döngüsü — Taslak → Planlandı → Devam Ediyor → Tamamlandı → Kalite Beklemede.
  • 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 kullanılan malzeme listesi, çalışılan saat ve mürettebatın sahadan bildirebileceği bir mahsul sağlığı anomali 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

Aksiyon / KancaNe yapar
Malzeme tüketimini senkronize etBir emir Tamamlandı durumuna geçtiğinde çağrılır. Kullanılan her malzemeyi Tarım Girdisi Hazırlama stoğundan düşer ve kullanılan her malzeme için Tarım Malzeme Tüketimine bir kayıt yazar — gerçek bir oku-değiştir-yaz işlemi.
Varlık çalışma saatini güncelleEmrin kaydedilen saatlerini atanan Varlığın kümülatif çalışma saati sayacına yansıtmayı ve Önleyici Bakım planlamasını tetiklemeyi amaçlar. Henüz bağlanmadı — bu bağlantının hedefleyeceği Bakım ekranları bu add-on'da henüz yok (aşağıdaki Tarım Ekipman Bakımı'na bakın), bu yüzden şu an her zaman etkisiz kalan bir yer tutucudur.
Mahsul sağlığı anomalisini işaretleBir mürettebat yürütme sırasında bir mahsul sağlığı anomali bayrağı bildirdiğinde Zararlı & Hastalık Uyarıları'nda doğrudan bir uyarı açmayı amaçlar. Henüz bağlanmadı — Zararlı & Hastalık Uyarıları şimdi Kalite & Bitki Sağlığı Operasyonları'nda mevcut olsa da, bu bağlantı onu çağırmak için henüz yükseltilmedi, şu an etkisiz kalan bir yer tutucudur.

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ı — ID format HSC-2026-XXXX.
  • Durum yaşam döngüsü — Planlandı → Olgunlaşıyor → Hasada Hazır → Aktif Hasat → Tamamlandı.
  • Kilometre taşları — etiketli hedef tarihler ve tamamlanma bayrağı içeren bir liste.
  • Hasat Hazırlık Skoru — bir olgunluk hedefine karşı biriken Büyüme Derece Günlerini (%70 ağırlık) toprak nem sağlığıyla (%30 ağırlık) harmanlayarak hesaplanır.
  • Silo rezervasyonu — gerçek kapasiteyi rezerve eden bir hedef silo bağlantısı ve beklenen hacim (ton).
  • Hasat kapıları — hasat öncesi yetkilendirme onayı (bir Mahsul Sağlığı Kontrol Listesi hasat öncesi denetimi geçtiğinde ayarlanır) ve hasat kilidi (Tarım-Kimyasal Analitiği'nden aktif bir PHI penceresi tarlada hasadı engellerken doğru olur).

Entegrasyon tetikleyicileri

Aksiyon / KancaNe yapar
WIP'e senkronize etBir plan kesinleştiğinde, Büyüyen Mahsul Takibi (WIP)'de yeni bir biyolojik varlık partisi başlatır (durum Aktif WIP, büyüme aşaması Çimlenme) — gerçek bir yazma işlemi.
Hasat öncesi kalite denetimi planlaMahsul Sağlığı Kontrol Listesi'nde zorunlu bir hasat öncesi denetim talebi sevk eder (durum İlgi Gerektiriyor), bu plana geri bağlı — gerçek bir yazma işlemi.
Depolama kapasitesini rezerve etPlanın beklenen hasat hacmini seçilen bir silonun rezerve edilmiş tonajına ekler — bkz. Hasat & Tedarik Envanteri'ndeki "perde arkası" notu.

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ı — ID format IOT-2026-XXXX.
  • Sensör durumu — Optimal, Toprak Kuruluğu Uyarısı, Kritik Yüksek Sıcaklık, Sensör Çevrimdışı.
  • 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 eşik ayarları.
  • Mikroiklim Sağlık Skoru — 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ı alınarak hesaplanır.

Entegrasyon tetikleyicileri

Aksiyon / KancaNe yapar
Otomatik tarla emri tetikleToprak nemi düğümün eşiğinin altına düştüğünde, doğrudan Tarla & Sera İş Emirlerinin kendi kayıt defterine yeni bir Damla Sulama Gübreleme tipi tarla emri oluşturur (durum Planlandı). Gerçek yazma — her iki ekran da aynı veri katmanını paylaşır.
Bakım iş emri oluşturBir düğüm çevrimdışı ping attığında veya bozuk değerler bildirdiğinde, add-on'lar arasında paylaşılan ortak bir bakım servisi aracılığıyla bir donanım bakım iş emri sevk eder — Tarım Ekipman Bakımı kendi ekranlarını sunsa da sunmasa da bağımsız çalışan gerçek bir entegrasyon.

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ı — ID format YLD-2026-XXXX, ayrı bir hasat parti kodu (BAT-2026-XXXX) ile birlikte.
  • Kalite dereceleri — A Sınıfı Premium, B Sınıfı Endüstriyel, C Sınıfı Atık.
  • Verim farkı — 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 kusur girişleri listesi (sebep + kayıp yüzdesi), artı tartı köprüsü okuması ve toplam kayıp/atık yüzdesi.
  • Yayınlama bayrakları — doğrulandı, izlenebilirliğe yayınlandı, taban çizgisi senkronize edildi, depo partisi loglandı bayrakları bu parti için hangi alt akış senkronizasyonlarının tetiklendiğini izler.

Entegrasyon tetikleyicileri

Aksiyon / KancaNe yapar
Verimi izlenebilirliğe yayınlaBir verim kaydı doğrulandığında, Çiftlikten Sofraya İzlenebilirlik'te doğrudan serileştirilmiş bir parti (ID format LOT-2026-XXXX) oluşturur (durum Sertifikasız / Laboratuvar Onayı Eksik), verim kaydına geri bağlı.
Verim farkını Hedef Hasatlara senkronize etGerçek verimi, Hedef Hasatlar'ın bu mahsul ürünü için çalışan ML taban çizgisi ortalamasına katar.
Gelen depo partisini loglaBir hasat partisi mutabık kılındığında, doğrudan silo kayıt defterinde onaylanmamış bir alım partisi oluşturur — silo mağazasına karşı gerçek bir yazma (bkz. Hasat & Tedarik Envanteri'ndeki mimari not).

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ı — ID format CTR-2026-XXXX.
  • Kaynak tipleri — Sulama Suyu (m³), Elektrik (kWh), Dizel (Litre), Doğal Gaz (m³).
  • Durum — Normal, Eşik Aşıldı, Olası Sızıntı/Aşırı Kullanım, Kalibre Edilmemiş.
  • Net kullanım & günlük kota — sayaç sıfırlama/dönüşünün asla negatif tüketim bildirmemesi için (gerçek − önceki okuma) sıfırda kelepçelenir; bu kullanım sayacın günlük limit izninin yüzdesi olarak ifade edilir.
  • Sızıntı & dalgalanma bayrakları — sızıntı bayrağı, güç dalgalanması bayrağı, artı bir fotoğraf kanıtı ve son kalibrasyon tarihi.
  • SOP maliyet atfı — her sayaç bir Agronomik SOP'a bağlanabilir böylece gözlemlenen maliyeti o SOP'un çalışan maliyet tabanını besler.

Entegrasyon tetikleyicileri

Aksiyon / KancaNe yapar
Kaynağı malzeme tüketimine gönderSayacın net kullanımını ve maliyetini yeni bir tüketim kaydı olarak (kaynak kategorisine eşlenmiş — su/elektrik/gaz veya dizel) Tarım Malzeme Tüketimi kayıt defterine yayınlar — gerçek bir yazma işlemi.
Ekipman boru sızıntısını işaretleIoT İklim & Toprak İzleme'nin kullandığı aynı genel bakım yardımcısı aracılığıyla acil bir bakım iş emri ("Anormal Utility Dalgalanması / Sızıntı") sevk eder.
SOP maliyet tabanını yeniden hesaplaSayacın gözlemlenen utility maliyetini, atfedilen Agronomik SOP'un çalışan maliyet tabanı ortalamasına katar.

Perde arkası — her kanca henüz bağlanmadı

Tarla & Sera İş Emirleri'ndeki iki bağlantı (varlık çalışma saati güncelleme ve mahsul sağlığı anomali işaretleme) kasıtlı olarak henüz etkisiz bırakılmıştır. Çağıranların zaten kullandığı imza ile mevcuttur, böylece bunları daha sonra gerçek entegrasyonlara yükseltmek çağrı noktasında herhangi bir değişiklik gerektirmez. Bu, yazma anında hedef bir ekran henüz mevcut olmadığında kod tabanında kullanılan kasıtlı bir kalıptır.

Uçtan uca veri akışı

Kaynak ekran / kancaYazarHedef ekran / kayıt
Tarla & Sera İş Emirleri · Malzeme tüketimini senkronize etHazırlama stoğunu düşer; tüketim kaydı oluştururTarım Girdisi Hazırlama + Tarım Malzeme Tüketimi
Sezon & Hasat Planlama · WIP'e senkronize etBüyüyen mahsul WIP kaydı oluşturur (durum Aktif WIP)Büyüyen Mahsul Takibi (WIP)
Sezon & Hasat Planlama · Hasat öncesi kalite denetimi planlaHasat öncesi denetim kontrol listesi oluştururMahsul Sağlığı Kontrol Listesi
Sezon & Hasat Planlama · Depolama kapasitesini rezerve etSilonun rezerve edilmiş tonajını artırırSilo & Depolama Yönetimi kayıt defteri
IoT İklim & Toprak İzleme · Otomatik tarla emri tetikleDamla sulama gübreleme tarla emri oluşturur (durum Planlandı)Tarla & Sera İş Emirleri
IoT İklim & Toprak İzleme · Bakım iş emri oluşturSensör arızası iş emri sevk ederOrtak bakım servisi (alan-bağımsız)
Mahsul Verim Panosu · Verimi izlenebilirliğe yayınlaParti kaydı oluşturur (ID format LOT-2026-XXXX)Çiftlikten Sofraya İzlenebilirlik
Mahsul Verim Panosu · Verim farkını senkronize etML taban çizgisi verimini güncellerHedef Hasatlar
Mahsul Verim Panosu · Gelen depo partisini loglaSilo partisi oluştururSilo & Depolama Yönetimi kayıt defteri
Kaynak Sayaçları · Kaynağı malzeme tüketimine gönderTüketim kaydı oluştururTarım Malzeme Tüketimi
Kaynak Sayaçları · Ekipman boru sızıntısını işaretleSızıntı/dalgalanma iş emri sevk ederOrtak bakım servisi (alan-bağımsız)
Kaynak Sayaçları · SOP maliyet tabanını yeniden hesaplaSOP maliyet tabanı ortalamasını güncellerAgronomik SOP'lar

Sıkça Sorulan Sorular

Neden bazen kimse manuel oluşturmadan bir tarla emri görünür?
IoT İklim & Toprak İzleme'nin otomatik tarla emri tetikleme bağlantısı, bir düğüm toprak nemini yapılandırılmış eşiğinin altında bildirdiğinde otomatik olarak bir Damla Sulama Gübreleme emri (durum Planlandı) üretir. Emrin SOP/lokasyon bağlantısını tetikleyen sensöre geri kontrol edin.
Bir tarla emrini tamamlamak otomatik olarak envanteri düşürür mü?
Evet — bir emrin durumu Tamamlandı'ya geçtiğinde, malzeme tüketimini senkronize etme bağlantısı yürütme kaydındaki kullanılan her malzemeyi Tarım Girdisi Hazırlama stoğundan düşer ve bir tüketim kaydı loglar. Bir malzeme adı herhangi bir hazırlama SKU'suyla eşleşmezse, o öğe için düşürme atlanır ama tüketim kaydı yine de yazılır.
Ekipman çalışma saatleri tarla emri yürütmesinden izleniyor mu?
Henüz değil. Varlık çalışma saati güncelleme bağlantısı doğru imzayla mevcuttur, ancak Tarım Ekipman Bakımı yazacağı gerçek Varlık/Bakım ekranlarını sunana kadar etkisizdir. Bu grubun yol haritası durumu için bkz. Tarım Ekipman Bakımı.
Bir hasat planının aktif hasada geçmesini ne engeller?
Hasat planı üzerinde iki kapı: hasat öncesi yetkilendirme onayı doğru olmalı (Mahsul Sağlığı Kontrol Listesi'nin hasat öncesi onayı tarafından ayarlanır) ve hasat kilidi yanlış olmalı (bir Tarım-Kimyasal Analitiği PHI penceresi sona erdiğinde temizlenir). Tam zincir için bkz. Kalite & Bitki Sağlığı Operasyonları.
Hasat Hazırlık Skoru nasıl hesaplanır?
Hesaplama, mahsulün olgunluk hedefine doğru Büyüme Derece Günü ilerlemesini %70 ağırlıkta, toprak nem sağlığını (mevcut nemin ideal %50'ye ne kadar yakın olduğu) %30 ağırlıkta ölçer. Her iki girdi de atlanabilir, bu durumda skor boş kalır.
Mahsul verim tartı köprüsü okuması nereye gider?
Verim kaydının kendisinde saklanır ve daha sonra Çiftlikten Sofraya İzlenebilirlik tarafından bir partinin Dijital Ürün Pasaportuna çekilir; bu işlem bağlı verim kayıtlarını okur.
Bir kaynak sayacının sızıntı bayrağı otomatik olarak bir bakım biletine yönlendirilebilir mi?
Evet — ekipman boru sızıntısını işaretleme bağlantısı, IoT İklim & Toprak İzleme'nin çevrimdışı/arızalı sensörler için kullandığı aynı paylaşılan bakım yardımcısı aracılığıyla acil bir iş emri sevk eder. İkisi de aynı ortak, alan-bağımsız bakım servisi üzerinden yönlendirilir ve diğer add-on'lar arasında paylaşılır.