Fleet modülü (fleet)

src/cluster_erp/modules/fleet/ içindeki fleet modülü, şirketin işlettiği araçları ve makineleri yönetir. Tek bir araç ana kaydı binek araçları, panelvanları, kamyonları, çekicileri, dorseleri, otobüsleri, forkliftleri ve iş makinelerini kapsar. Modül bu kaydın çevresinde sayaçları ve okumaları, bakım planlarını ve hatırlatmalarını, yedek parçalı iş emirlerini, sürücü atamalarını, denetimleri ve kusurları, rezervasyonları, olayları, yakıtı, uyum yükümlülüklerini, cezaları, lastikleri ve kampanyaları tutar. Bu sayfa genel bakıştır; alt konuların kendi sayfaları vardır.

Bir bakışta¶

Modül ne yapar¶

• Birinci sınıf kimlikleri (plaka, VIN, şasi numarası, motor numarası) olan ve taslak olarak başlayan bir yaşam döngüsüne sahip tek bir araç ana kaydı tutar (src/cluster_erp/modules/fleet/models.py:159-237).
• Kuruluşun çalışma anında kiracı alanlarıyla kendi araç alanlarını eklemesine izin verir; modül ağır vasıta için bir başlangıç seti tohumlar (src/cluster_erp/modules/fleet/module.py:197-265). Bkz. kiracı alanları.
• Sayaçları, ömür boyu değerleri olan değiştirilemez bir okuma defteri olarak kaydeder (src/cluster_erp/modules/fleet/meters/services.py:1-18).
• Bakım vade tarihlerini takvim, sayaç ve eşik kurallarından hesaplar (src/cluster_erp/modules/fleet/maintenance/services.py:1-20).
• Her bakım ihtiyacını tek bir iş emrinde toplar ve yedek parçaları EventBus üzerinden envanterden düşer (src/cluster_erp/modules/fleet/workorders/services.py:1-18).
• Aracı kimin tuttuğunu, çekici ve dorse bağlantılarını, denetimleri, kusurları, rezervasyonları ve olayları izler (src/cluster_erp/modules/fleet/operations/services.py:1-20).
• Tüketim uyarılı bir yakıt defteri, yenilenen uyum yükümlülükleri ve cezalar tutar (src/cluster_erp/modules/fleet/fuel/services.py:1-20).
• Toplam sahip olma maliyetini, bir yenileme sıralamasını, lastikleri, kampanyaları ve emisyon katsayılarını raporlar (src/cluster_erp/modules/fleet/tco/services.py:1-12).
• Telematik bağdaştırıcılarından sayaç toplu girdilerini kabul eder (src/cluster_erp/modules/fleet/telematics.py:1-16).

Alt modüller¶

Tüm yönlendiriciler /api/v1/fleet önekli tek bir modül yönlendiricisine eklenir (src/cluster_erp/modules/fleet/module.py:267-336). Her routes.py kendi yollarını tanımlar, örneğin src/cluster_erp/modules/fleet/fuel/routes.py:35-41.

Veri modeli¶

23 tablonun tümü src/cluster_erp/modules/fleet/models.py içinde tanımlıdır. Her alt modül sayfası kendi alanlarını listeler. Ortak özellikler:

• Her model BaseModel sınıfının denetim ve yumuşak silme sütunlarını devralır (src/cluster_erp/modules/fleet/models.py:42). Bkz. temel model ve kimlikler.
• Benzersizlik yalnızca canlı satırlarda geçerlidir; bunu uq_fleet_assets_plate_live gibi kısmi benzersiz indeksler sağlar (src/cluster_erp/modules/fleet/models.py:168-186).
• Para sütunları Numeric(18, 2) tipindedir ve yanlarında üç harfli ayrı bir currency sütunu bulunur, örneğin FleetWorkOrder.labor_cost ve FleetFuelEntry.total_cost (src/cluster_erp/modules/fleet/models.py:409-413, src/cluster_erp/modules/fleet/models.py:621-622).
• Sayaç değerleri bir ondalık basamaklı Numeric tipindedir (src/cluster_erp/modules/fleet/models.py:298-301).
• Durum sözlükleri dosyanın başında demetler olarak durur, örneğin FLEET_ASSET_STATUSES ve FLEET_WO_STATUSES (src/cluster_erp/modules/fleet/models.py:46-127).

Ekranlar ve metadata¶

get_metadata, 16 bölümlü Filo (İngilizce Fleet) kenar çubuğu grubunu tanımlar (src/cluster_erp/modules/fleet/module.py:403-547). Altı bölüm çubukta görünür: Araçlar, Bakım, İş Emirleri, Rezervasyonlar, Yakıt ve Uyum. Dokuz liste bölümü hidden_from_bar=True taşır: Cezalar, Lastikler, Kampanyalar, Yenileme Analizi, Atamalar, Çekici-Dorse, Denetimler, Kusurlar ve Olaylar. Kod yorumu bu listelerin aranabilir kaldığını ve araç kartının bunlara bağlamsal kapı olduğunu belirtir (src/cluster_erp/modules/fleet/module.py:490-492). Ayarlar dört sekmeli bir ayar görünümüdür: araç sınıfları, bakım planları, muayene dönemleri ve emisyon katsayıları (src/cluster_erp/modules/fleet/module.py:536-547).

Araç kartında Genel sekmesinden Lastikler sekmesine kadar 14 ayrıntı sekmesi vardır (src/cluster_erp/modules/fleet/assets/metadata.py:358-450). Web uygulaması ve masaüstü bunların hepsini genel olarak çizer; bkz. genel liste ve genel ayrıntı.

Durum ve aksiyonlar¶

Her alt modül sayfası kendi aksiyonlarını listeler. Her durum değişikliği POST .../{id}/actions/{action} aksiyon ucundan geçer; araç güncelleme yolu durumu değiştirmez (src/cluster_erp/modules/fleet/assets/services.py:1-11). Diyagram alt modüller arasındaki bakım akışını gösterir.

flowchart TD
 RD["FleetMeterReading oluşturuldu"] --> RC["FleetReminderService.recompute_for_asset_id"]
 PL["FleetMaintenancePlan"] --> RC
 RC --> RM["FleetMaintenanceReminder: ok, due_soon, overdue"]
 RM -->|create_work_order| WO["FleetWorkOrder taslak"]
 AS["FleetAsset send_to_maintenance"] --> WO2["FleetWorkOrder serbest bırakılmış"]
 DF["FleetDefect create_work_order"] --> WO
 WO -->|release, start| WOP["open, in_progress"]
 WOP -->|parça çıkışı| GI["envantere PostGoodsIssue"]
 WOP -->|complete| DONE["completed"]
 DONE --> RCOMP["bağlı hatırlatmalar tamamlanır"]
 DONE --> ODO["kilometre okuması, kaynak work_order"]
 DONE --> BACK["araç yeniden active"]

Düz anlatımla:

1. Yeni bir okuma, aracının hatırlatmalarını yeniden hesaplar (src/cluster_erp/modules/fleet/meters/services.py:308-311, src/cluster_erp/modules/fleet/meters/services.py:363-371).
2. Hatırlatma motoru her hatırlatmayı ok, due_soon, overdue veya snoozed yapar (src/cluster_erp/modules/fleet/maintenance/services.py:588-597).
3. Bir hatırlatma, kusur, olay veya kampanya kalemi iş emri açabilir. Aracı bakıma almak serbest bırakılmış bir iş emri açar (src/cluster_erp/modules/fleet/maintenance/services.py:351-366, src/cluster_erp/modules/fleet/assets/services.py:307-338).
4. Bir parça satırının çıkışı envantere PostGoodsIssue gönderir (src/cluster_erp/modules/fleet/workorders/services.py:464-514).
5. Emrin tamamlanması bağlı hatırlatmaları tamamlar, bir kapanış kilometresi kaydedebilir ve açık başka emir yoksa aracı active durumuna döndürür (src/cluster_erp/modules/fleet/workorders/services.py:191-265).

İş kuralları¶

Her alt modülün kuralları kendi sayfasındadır. Modülün tamamında geçerli kurallar:

• API'nin kabul ettiği her tarih-saat bir UTC farkı taşımalıdır; saf (naive) bir değer doğrulama hatasıyla reddedilir (src/cluster_erp/modules/fleet/validation.py:1-21).
• Form yükündeki boş bir dize değer yok sayılır (src/cluster_erp/modules/fleet/validation.py:24-37).
• Elden çıkarılmış bir araç yeni operasyon belgesi almaz (src/cluster_erp/modules/fleet/operations/services.py:80-98).
• Araç kodları fleet_asset, iş emri kodları fleet_work_order dizisinden gelir (src/cluster_erp/modules/fleet/assets/services.py:229, src/cluster_erp/modules/fleet/workorders/services.py:108).
• Alt modüller paket içinde birbirlerinin servislerini çağırır. Kod yorumları bunları modüller arası çağrı değil, kardeş içe aktarma olarak işaretler (src/cluster_erp/modules/fleet/assets/services.py:240-241).

Olaylar ve sorgular¶

Modül 1 sözleşme tüketir ve 6 sözleşme üretir. Tüketilen, pakette subscribe( veya register_query_handler( çağrısına ilk argüman olarak verilen sözleşmedir; üretilen, pakette adının ardından ( gelen sözleşme sınıfıdır. Tam liste sözleşmeler başvurusunda yer alır.

Bir parça satırının ürün kırılımı, satır kaydedilmeden önce ensure_product_breakdown ile denetlenir (src/cluster_erp/modules/fleet/workorders/services.py:412-424).

İzinler¶

Her uç require_permission ile bir izin denetler. Anahtarlar <entity>.read, .create, .update ve .delete kalıbını izler.

Mekanizma roller ve izinler sayfasında anlatılır.

Gizlilik, saklama ve geçmiş¶

Modülde privacy_handlers.py ve retention_handlers.py yoktur (klasör listesi). Bir kaydı silmek deleted_at alanını doldurur. Araç için bu, canlı hatırlatmalarını da emekliye ayırır; okumalar, emirler ve dönemler kalır (src/cluster_erp/modules/fleet/assets/services.py:340-363). Okumalar hiçbir zaman düzenlenmez veya silinmez; hatalı bir okuma incorrect olarak işaretlenir (src/cluster_erp/modules/fleet/meters/services.py:9-12). Değişiklikleri değişiklik geçmişi yakalar; devre dışı bırakma yumuşak silme ve devre dışı bırakma sayfasında anlatılır.

Analitik olgular¶

analytics_facts.py dört olgu kümesi sağlar: fleet_fuel, fleet_work_order, fleet_penalty ve fleet_compliance; hepsi fleet_asset.read izniyle okunur (src/cluster_erp/modules/fleet/analytics_facts.py:35-310). Ayrıntılar TCO, telematik ve analitik sayfasında, toplama yolu analitik olgular sayfasındadır.

Ayarlar ve referans verileri¶

• Araç sınıfları referans verisidir. Modül başlarken eksik olan dokuz sınıfı tohumlar: car, van, truck, tractor_unit, trailer, bus, forklift, construction ve other; her biri varsayılan sayaçlarıyla gelir (src/cluster_erp/modules/fleet/module.py:27-47, src/cluster_erp/modules/fleet/module.py:159-195).
• Modül, fleet_asset kovasında kiracı alanı olarak dokuz araç alanı tanımı tohumlar, örneğin fuel_tank_l ve gvwr_kg. Zaten var olan bir anahtara dokunulmaz (src/cluster_erp/modules/fleet/module.py:49-133, src/cluster_erp/modules/fleet/module.py:197-265).
• Muayene dönemleri ve emisyon katsayıları boş başlar; kuruluş bunları doldurur (src/cluster_erp/modules/fleet/models.py:673-789).

Testler¶

web-client/_e2e_*.mjs içinde /fleet/ ve tests/*.py içinde fleet için grep ile bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Araçlar
• Sayaçlar ve yakıt
• Bakım ve iş emirleri
• Operasyonlar
• TCO, telematik ve analitik
• Inventory modülü
• Bu modülün API başvurusu

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