Filo operasyonları

Bu sayfa src/cluster_erp/modules/fleet/operations/ içindeki operations alt modülünü anlatır. Aracı kimin ne zaman tuttuğunu, hangi çekicinin hangi dorseyi çektiğini, sürücü denetimlerini ve buldukları kusurları, havuz araçlarının rezervasyonlarını ve kaza gibi olayları kaydeder. Modülün genel bakışı fleet modülü sayfasındadır.

Kapsam ve kaynak¶

• Tanımlandığı yer: src/cluster_erp/modules/fleet/models.py (FleetAssignment, FleetCoupling, FleetInspection, FleetDefect, FleetReservation, FleetIncident), operations/services.py, operations/routes.py, operations/schemas.py ve operations/metadata.py.
• Sayım: 6 tablo, operations/routes.py içinde 27 uç, operations/metadata.py içinde 14 ActionMeta girdisi.
• Her servis, elden çıkarılmış bir araçta yeni belgeyi reddeder (src/cluster_erp/modules/fleet/operations/services.py:80-98).

Varlıklar¶

Atamalar ve bağlantılar¶

• Atama bir taraf adlandırır; bu taraf EventBus üzerinden GetPartyById ile denetlenir (src/cluster_erp/modules/fleet/operations/services.py:64-79, src/cluster_erp/modules/fleet/operations/services.py:138).
• Atama şimdi veya geçmişte başlar; en fazla beş dakika ileride olabilir (src/cluster_erp/modules/fleet/operations/services.py:139-145).
• Yeni atama, aynı araç ve türün açık atamasını kendi başlangıcında kapatır. Açık olandan sonra başlamalı ve kapalı geçmişle çakışmamalıdır (src/cluster_erp/modules/fleet/operations/services.py:146-187).
• Kısmi bir benzersiz indeks, araç ve tür başına tek açık atamaya izin verir (src/cluster_erp/modules/fleet/models.py:463-472).
• GET /assignments/as-of, belirli bir anda aracı türe göre kimin tuttuğunu yanıtlar. Farksız bir zaman UTC olarak okunur (src/cluster_erp/modules/fleet/operations/routes.py:83-100, src/cluster_erp/modules/fleet/operations/services.py:225-249).
• Bağlantı, araç sınıfından okunan motorlu bir çekiciyi motorsuz bir dorseye bağlar. Sınıfı silinmiş araç reddedilir (src/cluster_erp/modules/fleet/operations/services.py:284-294, src/cluster_erp/modules/fleet/operations/services.py:352-375).
• Yeni bağlantı iki tarafın açık bağlantılarını kapatır; kısmi benzersiz indeksler çekici başına ve dorse başına tek açık bağlantıya izin verir (src/cluster_erp/modules/fleet/operations/services.py:295-320, src/cluster_erp/modules/fleet/models.py:486-501).

Denetimler ve kusurlar¶

Kod üç imzalı bir zincir tanımlar: yazar denetimi imzalar, kusurun giderilmesi ikinci imzadır, sonraki imzalı temiz denetim giderilmiş kusurları doğrular (src/cluster_erp/modules/fleet/operations/services.py:12-16).

stateDiagram-v2
 [*] --> open: kusur kaydedildi
 open --> resolved: resolve
 resolved --> open: reopen veya observe
 resolved --> verified: sonraki imzalı temiz denetim
 open --> open: observe

Düz anlatımla: kusur open olarak başlar. Gider onu resolved yapar; Yeniden Aç veya yeni bir gözlem onu open durumuna geri getirir. Aynı aracın sonraki bir denetimi temiz olarak imzalandığında, o denetimden önce giderilmiş her kusur verified olur (src/cluster_erp/modules/fleet/operations/services.py:423-459, src/cluster_erp/modules/fleet/operations/services.py:569-656).

• İmzasız denetim düzenlenebilir; imzalı denetim mühürlüdür (src/cluster_erp/modules/fleet/operations/services.py:410-422, src/cluster_erp/modules/fleet/operations/services.py:461-467).
• İmzalama, denetimin kendi kusuru yoksa is_clean alanını kaldırır ve kilometreyi kaynağı form olan bir okuma olarak kaydeder. Reddedilen okuma imzayı engellemez (src/cluster_erp/modules/fleet/operations/services.py:434-440, src/cluster_erp/modules/fleet/operations/services.py:478-503).
• Bir denetime bağlı kusur aynı araca ait olmalıdır ve imzalı denetim yeni kusur almaz (src/cluster_erp/modules/fleet/operations/services.py:538-567).
• Kusurdaki İş Emri Oluştur, kaynağı inspection_defect veya fault olan bir kalemle tek bir emir açar; bir kusura en fazla bir emir açılır (src/cluster_erp/modules/fleet/operations/services.py:612-645).

Rezervasyonlar ve olaylar¶

• Rezervasyon bir taraf adlandırır, başladıktan sonra bitmelidir ve aynı aracın reserved veya retrieved durumundaki bir rezervasyonuyla çakışmamalıdır (src/cluster_erp/modules/fleet/operations/services.py:693-725).
• Teslim Al ve İade Et, kaynağı form olan kilometre okumaları kaydedebilir. İade değeri teslim alma değerinin altında olamaz. İadedeki hasar notu açık bir kusur oluşturur (src/cluster_erp/modules/fleet/operations/services.py:727-786).
• Olay kapanana kadar düzenlenebilir. Sigorta Dosyası Aç reported durumu ister; Onarım Emri Oluştur bir iş emri açar; Kapat olayı mühürler (src/cluster_erp/modules/fleet/operations/services.py:855-934).

Aksiyonlar¶

Uçlar¶

Altı yönlendiricinin her birinde listeleme, oluşturma, okuma ve aksiyon uçları vardır; denetimler ve olaylarda ayrıca güncelleme ucu bulunur (src/cluster_erp/modules/fleet/operations/routes.py:45-458). Yönlendirici önekleri /assignments, /couplings, /inspections, /defects, /reservations ve /incidents şeklindedir (src/cluster_erp/modules/fleet/operations/routes.py:45-50). operations/routes.py içinde silme ucu yoktur.

Tanıtılan terimler¶

İlgili sayfalar¶

• Fleet modülü
• Bakım ve iş emirleri
• Sayaçlar ve yakıt
• Parties modülü

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