Filo sayaçları ve yakıt · Cluster ERP Wiki

Bu sayfa fleet modülünün iki alt modülünü anlatır. src/cluster_erp/modules/fleet/meters/ içindeki meters alt modülü sayaçları ve değiştirilemez bir okuma defterini tutar. src/cluster_erp/modules/fleet/fuel/ içindeki fuel alt modülü yakıt girişlerini, uyum yükümlülüklerini, cezaları ve muayene dönemi tablosunu tutar. Modülün genel bakışı fleet modülü sayfasındadır.

Kapsam ve kaynak¶

Tanımlandığı yer: src/cluster_erp/modules/fleet/models.py (FleetMeter, FleetMeterReading, FleetFuelEntry, FleetComplianceItem, FleetInspectionPeriod, FleetPenalty), meters/services.py, meters/routes.py, meters/metadata.py, fuel/services.py, fuel/routes.py ve fuel/metadata.py.
Sayım: 6 tablo, 32 uç (meters/routes.py içinde 9, fuel/routes.py içinde 23), 8 ActionMeta girdisi (meters/metadata.py içinde 3, fuel/metadata.py içinde 5).

Sayaç ve okuma alanları¶

Ad	Anlam	Kaynak
`FleetMeter.asset_id`, `kind`, `label`, `unit`	Bir araçtaki tek sayaç; araç ve tür başına bir canlı sayaç	`src/cluster_erp/modules/fleet/models.py:240-263`, `src/cluster_erp/modules/fleet/meters/services.py:118-129`
`FleetMeter.rollover_max`, `initial_value`	Göstergenin başa döndüğü değer ve doğuş değeri	`src/cluster_erp/modules/fleet/models.py:264-267`
`FleetMeterReading.reading_at`, `entry_mode`, `value_entered`	Ne zaman, nasıl (`absolute` veya `delta`) ve girilen değer	`src/cluster_erp/modules/fleet/models.py:271-298`, `src/cluster_erp/modules/fleet/models.py:63`
`value_absolute`, `delta`, `ltd_value`	Hesaplanan gösterge değeri, önceki okumadan bu yana kullanım ve ömür boyu kullanım	`src/cluster_erp/modules/fleet/models.py:299-301`
`source`	Okumanın geldiği yer, varsayılan `manual`	`src/cluster_erp/modules/fleet/models.py:302`, `src/cluster_erp/modules/fleet/models.py:62`
`status`	`valid`, `preliminary` veya `incorrect`	`src/cluster_erp/modules/fleet/models.py:303`, `src/cluster_erp/modules/fleet/models.py:60`
`is_initial`, `meter_changed`, `rollover`	Taban bayrağı, sayaç değişti, gösterge başa döndü	`src/cluster_erp/modules/fleet/models.py:306-310`

Kodda iki sayaç şablonu vardır: odometer_km (birim km, 999999.9 değerinde başa döner) ve engine_hours (birim h). Başka türden bir sayaç doğrudan oluşturulabilir (src/cluster_erp/modules/fleet/meters/services.py:46-60).

Okuma defteri kuralları¶

Okuma oluşturulur ve hiçbir zaman düzenlenmez. Hatalı bir okuma incorrect olarak işaretlenir ve ondan sonraki zincir yeniden hesaplanır (src/cluster_erp/modules/fleet/meters/services.py:9-12).
Kayıt süresince sayaç satırı kilitlenir; böylece iki kayıt aynı öncülü okuyamaz (src/cluster_erp/modules/fleet/meters/services.py:244-254).
Devre dışı bırakılmış veya elden çıkarılmış bir araç için, beş dakikadan fazla ileri bir tarih için, negatif değer için ve son sayılan okumadan sonra olmayan bir tarih için okuma reddedilir (src/cluster_erp/modules/fleet/meters/services.py:255-286).
İlk okuma tabandır. initial_value sıfırdan büyükse ilk okuma bu değerden itibaren kullanımı sayar (src/cluster_erp/modules/fleet/meters/services.py:407-433).
Sayaç değişimi göstergeyi yeniden tabanlar, ömür boyu değeri değiştirmez (src/cluster_erp/modules/fleet/meters/services.py:434-442).
Okuma başa dönme olarak işaretlenmedikçe daha düşük bir mutlak değer reddedilir (src/cluster_erp/modules/fleet/meters/services.py:455-474).
Günlük kullanımı son günlük hızın beş katını aşan ve sıçraması 1000 üzerinde olan okuma preliminary yapılır (src/cluster_erp/modules/fleet/meters/services.py:62-68, src/cluster_erp/modules/fleet/meters/services.py:476-497).
Kayıttan sonra aracın last_odometer_km alanı okuma tarihine göre eşitlenir ve bakım hatırlatmaları yeniden hesaplanır (src/cluster_erp/modules/fleet/meters/services.py:308-311).

Aksiyon	Etiket	Koşul	Uç	Kaynak
`confirm`	Onayla	`status` = `preliminary`	`POST /readings/{id}/actions/confirm`	`src/cluster_erp/modules/fleet/meters/metadata.py:161-169`
`mark_incorrect`	Hatalı İşaretle	`status` = `valid`	`POST /readings/{id}/actions/mark_incorrect`	`src/cluster_erp/modules/fleet/meters/metadata.py:170-178`
`mark_incorrect_preliminary`	Hatalı İşaretle	`status` = `preliminary`	`POST /readings/{id}/actions/mark_incorrect`	`src/cluster_erp/modules/fleet/meters/metadata.py:179-187`

Sonraki okumalar varken taban okuma hatalı olarak işaretlenemez (src/cluster_erp/modules/fleet/meters/services.py:332-345).

Yakıt girişi alanları¶

Ad	Anlam	Kaynak
`asset_id`, `plate`	Eşleşen araç ve içe aktarmanın verdiği plaka	`src/cluster_erp/modules/fleet/models.py:596-628`
`filled_at`, `station`, `fuel_type`	Ne zaman, nerede ve yedi yakıt türünden hangisi	`src/cluster_erp/modules/fleet/models.py:98-106`, `src/cluster_erp/modules/fleet/models.py:615-618`
`quantity`, `unit_price`, `total_cost`, `currency`	Litre `Numeric(10, 2)`, fiyat `Numeric(18, 4)`, toplam `Numeric(18, 2)`	`src/cluster_erp/modules/fleet/models.py:619-622`
`odometer_km`, `is_full_tank`	Dolumdaki kilometre ve deponun doldurulup doldurulmadığı	`src/cluster_erp/modules/fleet/models.py:623-624`
`source`, `card_no`, `driver_party_id`	`manual`, `tts_import` veya `card`; yakıt kartı; sürücü	`src/cluster_erp/modules/fleet/models.py:107`, `src/cluster_erp/modules/fleet/models.py:625-628`
`match_status`, `mismatch_reason`	Nedeniyle birlikte `verified` veya `unverified`	`src/cluster_erp/modules/fleet/models.py:629-630`
`consumption_l_100km`, `consumption_alert`, `non_utts_risk`	Hesaplanan tüketim ve iki bayrak	`src/cluster_erp/modules/fleet/models.py:631-633`

Yakıt kuralları¶

Miktar pozitif olmalıdır. Eksik toplam, miktar çarpı birim fiyat olarak hesaplanır ve iki ondalığa yuvarlanır (src/cluster_erp/modules/fleet/fuel/services.py:124-137).
Aracı olmayan giriş unverified olarak düşer. Aracın fuel_tank_l kiracı alanını aşan miktar da nedeniyle birlikte unverified olarak düşer (src/cluster_erp/modules/fleet/fuel/services.py:143-147, src/cluster_erp/modules/fleet/fuel/services.py:291-313).
Kilometresi olan doğrulanmış tam depo girişi, önceki tam depodan bu yana 100 km başına litreyi hesaplar. En az üç önceki değer varsa, değer bunların ortalamasının 1,5 katını aştığında uyarı bayrağı kalkar (src/cluster_erp/modules/fleet/fuel/services.py:46-49, src/cluster_erp/modules/fleet/fuel/services.py:333-355).
Geç bir giriş, bir doğrulama veya bir devre dışı bırakma, aynı araç ve yakıt türünün sonraki tüm tüketim değerlerini yeniden hesaplar (src/cluster_erp/modules/fleet/fuel/services.py:357-383).
Kilometresi olan doğrulanmış giriş source değeri fuel olan bir okumaya dönüşür; reddedilen okuma yakıt girişini engellemez (src/cluster_erp/modules/fleet/fuel/services.py:385-414).
POST /fuel/import satırları plakaya göre eşleştirir. Eşleşmeyen satır unverified düşer; bozuk satır dizini ve nedeniyle rejected içinde döner ve toplu girdinin geri kalanı tutulur (src/cluster_erp/modules/fleet/fuel/services.py:158-224).

Aksiyon	Etiket	Koşul	Uç	Kaynak
`assign_asset`	Araç Ata	`match_status` = `unverified`	`POST /fuel/{id}/actions/assign_asset`	`src/cluster_erp/modules/fleet/fuel/metadata.py:115-132`
`verify`	Doğrula	`match_status` = `unverified`	`POST /fuel/{id}/actions/verify`	`src/cluster_erp/modules/fleet/fuel/metadata.py:133-139`, `src/cluster_erp/modules/fleet/fuel/services.py:232-251`

Uyum kalemleri, cezalar ve muayene dönemleri¶

Varlık	Ana alanlar	Durumlar	Kaynak
`FleetComplianceItem`	`asset_id`, `kind`, `title`, `due_date`, `amount`, `currency`, `renew_months`, `vendor_party_id`, `reference_no`, `completed_at`	`pending`, `overdue`, `completed`	`src/cluster_erp/modules/fleet/models.py:109-120`, `src/cluster_erp/modules/fleet/models.py:636-671`
`FleetPenalty`	`asset_id`, `kind`, `occurred_at`, `amount`, `currency`, `due_date`, `driver_party_id`, `reference_no`	`pending`, `paid`, `objected`	`src/cluster_erp/modules/fleet/models.py:121-122`, `src/cluster_erp/modules/fleet/models.py:687-703`
`FleetInspectionPeriod`	`class_id`, `age_from_years`, `age_to_years`, `period_months`	yok	`src/cluster_erp/modules/fleet/models.py:673-685`

Uyum kalemlerini listelemek önce vadesi geçmiş her pending kalemi overdue yapar (src/cluster_erp/modules/fleet/fuel/services.py:427, src/cluster_erp/modules/fleet/fuel/services.py:595-606).
Tamamlandı İşaretle satırı kilitler, ileri tarihi reddeder ve bir sonraki kalemi doğurur. Muayenede aralık, araç sınıfı ve yaşıyla eşleşen muayene döneminden; diğerlerinde renew_months alanından gelir. Aralık yoksa sonraki kalem de yoktur (src/cluster_erp/modules/fleet/fuel/metadata.py:381-397, src/cluster_erp/modules/fleet/fuel/services.py:479-593).
Araç yaşı first_registration_date alanından, o yoksa model_year alanından okunur (src/cluster_erp/modules/fleet/fuel/services.py:572-582).
Sürücüsü olmayan yeni ceza, cezanın gerçekleştiği anı kapsayan atamanın sürücüsünü alır (src/cluster_erp/modules/fleet/fuel/services.py:647-663).
Ödendi İşaretle pending veya objected durumunu paid yapar; İtiraz Et pending durumunu objected yapar (src/cluster_erp/modules/fleet/fuel/metadata.py:610-625, src/cluster_erp/modules/fleet/fuel/services.py:681-706).

Uçlar¶

Yönlendirici	Yollar	Kaynak
`meter_router`	`GET /meters/`, `POST /meters/`, `GET /meters/kinds`, `GET /meters/{meter_id}`, `DELETE /meters/{meter_id}`	`src/cluster_erp/modules/fleet/meters/routes.py:29-102`
`reading_router`	`GET /readings/`, `POST /readings/`, `GET /readings/{reading_id}`, `POST /readings/{reading_id}/actions/{action}`	`src/cluster_erp/modules/fleet/meters/routes.py:105-169`
`fuel_router`	listeleme, oluşturma, `POST /fuel/import`, okuma, aksiyon, silme	`src/cluster_erp/modules/fleet/fuel/routes.py:46-126`
`compliance_router`	listeleme, oluşturma, okuma, güncelleme, aksiyon, silme	`src/cluster_erp/modules/fleet/fuel/routes.py:129-216`
`penalty_router`	listeleme, oluşturma, okuma, güncelleme, aksiyon, silme	`src/cluster_erp/modules/fleet/fuel/routes.py:219-301`
`period_router`	`/inspection-periods` listeleme, oluşturma, okuma, güncelleme, silme	`src/cluster_erp/modules/fleet/fuel/routes.py:38-40`, `src/cluster_erp/modules/fleet/fuel/routes.py:304-361`

GET /meters/kinds, bakım planı formu için şablon türlerini ve her canlı sayaç türünü döndürür (src/cluster_erp/modules/fleet/meters/routes.py:61-78).

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
meter reading	`FleetMeterReading`	Bir sayaçtaki değiştirilemez sayaç belgesi.	Sayaç okuması	`src/cluster_erp/modules/fleet/models.py:271`
life-to-date value	`ltd_value`	Bir sayacın yalnızca artan birikmiş kullanımı.	Ömür boyu değer	`src/cluster_erp/modules/fleet/models.py:301`
preliminary reading	`preliminary`	Kullanımı inandırıcı olmadığı için onaylanana veya hatalı işaretlenene kadar bekletilen okuma.	Ön okuma	`src/cluster_erp/modules/fleet/models.py:60`
compliance item	`FleetComplianceItem`	Bir aracın tamamlanınca yenilenen tarihli yükümlülüğü.	Uyum kalemi	`src/cluster_erp/modules/fleet/models.py:636`

İlgili sayfalar¶

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