Bu sayfa src/cluster_erp/modules/fleet/assets/ içindeki assets alt modülünü anlatır. Bir filo aracı (FleetAsset) tek bir araç, dorse veya makinedir. Bir araç sınıfı (FleetAssetClass) araçları gruplar ve motorlu olup olmadıklarına, doğduklarında hangi sayaçları alacaklarına karar verir. Modülün genel bakışı fleet modülü sayfasındadır.
Kapsam ve kaynak¶
- Tanımlandığı yer:
src/cluster_erp/modules/fleet/models.py(FleetAssetClass,FleetAsset),assets/services.py(FleetClassService,FleetAssetService),assets/routes.py,assets/schemas.pyveassets/metadata.py. - Sayım: 2 tablo, 10 uç (
assets/routes.pyiçindeki@...router.dekoratörleri),assets/metadata.pyiçinde 6ActionMetagirdisi.
Araç alanları¶
| Ad | Anlam | Kaynak |
|---|---|---|
code |
fleet_asset dizisinden gelen iş anahtarı |
src/cluster_erp/modules/fleet/models.py:189, src/cluster_erp/modules/fleet/assets/services.py:229 |
name, class_id |
Görünen ad ve araç sınıfı | src/cluster_erp/modules/fleet/models.py:191-192 |
plate, vin, chassis_no, engine_no |
Birinci sınıf kimlikler; plate ve vin canlı satırlar arasında benzersiz |
src/cluster_erp/modules/fleet/models.py:168-198 |
product_id, product_model_id, product_version_id |
İsteğe bağlı katalog bağlantısı | src/cluster_erp/modules/fleet/models.py:201-205 |
make_name, model_name, model_year, color |
Serbest metin tanım | src/cluster_erp/modules/fleet/models.py:206-209 |
status |
Yaşam döngüsü durumu, varsayılan draft |
src/cluster_erp/modules/fleet/models.py:212 |
acquisition_date, acquisition_value, acquisition_currency |
Edinim; değer Numeric(18, 2) |
src/cluster_erp/modules/fleet/models.py:213-215 |
first_registration_date, disposal_date |
Tescil tarihi (muayene yaşının temeli) ve elden çıkarma tarihi | src/cluster_erp/modules/fleet/models.py:216-218 |
responsible_party_id |
Araçtan günlük olarak sorumlu taraf | src/cluster_erp/modules/fleet/models.py:220-227 |
telematics_device_id |
Telematik beslemesinin kullandığı cihaz kimliği | src/cluster_erp/modules/fleet/models.py:227-229 |
last_odometer_km, last_odometer_at |
Okuma defterinin yazdığı son kilometre | src/cluster_erp/modules/fleet/models.py:231-235 |
extra |
JSON nesnesi olarak kiracı alanı değerleri | src/cluster_erp/modules/fleet/models.py:163-166 |
Araç sınıfı alanları¶
| Ad | Anlam | Kaynak |
|---|---|---|
code |
Canlı satırlar arasında benzersiz sınıf anahtarı | src/cluster_erp/modules/fleet/models.py:140-149 |
label |
JSON nesnesi olarak dil başına etiketler | src/cluster_erp/modules/fleet/models.py:150 |
powered |
Sınıfın motoru olup olmadığı; dorse motorsuzdur | src/cluster_erp/modules/fleet/models.py:151 |
icon, sort_order, is_active |
Görünüm ve etkinlik | src/cluster_erp/modules/fleet/models.py:152-156 |
default_meters |
Bu sınıftaki bir aracın oluşturulurken aldığı sayaç türü anahtarları | src/cluster_erp/modules/fleet/models.py:154-155 |
Form default_meters alanını satır başına bir anahtar olarak düzenler (src/cluster_erp/modules/fleet/assets/services.py:112-116). Sayaç şablonu olmayan bir anahtar hatasız atlanır (src/cluster_erp/modules/fleet/meters/services.py:145-172).
Durumlar ve aksiyonlar¶
Bir araç draft, active, in_maintenance, inactive veya disposed durumundadır (src/cluster_erp/modules/fleet/models.py:46-52). Servis izin verilen geçişleri _TRANSITIONS içinde tutar ve diğerlerini FLEET_INVALID_STATUS ile reddeder (src/cluster_erp/modules/fleet/assets/services.py:41-48, src/cluster_erp/modules/fleet/assets/services.py:277-305).
| Aksiyon | Etiket | Metadata koşulu | Servis kuralı | Kaynak |
|---|---|---|---|---|
activate |
Aktifleştir | status = draft |
draft veya inactive durumundan active |
src/cluster_erp/modules/fleet/assets/metadata.py:90-96 |
reactivate_service |
Filoya Döndür | status = inactive |
activate çağırır |
src/cluster_erp/modules/fleet/assets/metadata.py:97-103 |
send_to_maintenance |
Bakıma Al | status = active |
active durumundan in_maintenance; serbest bırakılmış bir iş emri açar |
src/cluster_erp/modules/fleet/assets/metadata.py:104-136, src/cluster_erp/modules/fleet/assets/services.py:300-338 |
return_to_service |
Servise Döndür | status = in_maintenance |
in_maintenance durumundan active |
src/cluster_erp/modules/fleet/assets/metadata.py:137-143 |
deactivate_asset |
Hizmet Dışına Al | status = active |
active veya in_maintenance durumundan inactive |
src/cluster_erp/modules/fleet/assets/metadata.py:144-150 |
dispose |
Elden Çıkar | status = inactive |
active, inactive veya in_maintenance durumundan disposed; disposal_date doldurur |
src/cluster_erp/modules/fleet/assets/metadata.py:151-157, src/cluster_erp/modules/fleet/assets/services.py:296-297 |
Bakıma Al yapılacak işi, usta veya servis tarafını, planlanan tarihi ve notları sorar (src/cluster_erp/modules/fleet/assets/metadata.py:110-135). Servis iş emrini oluşturur ve hemen serbest bırakır (src/cluster_erp/modules/fleet/assets/services.py:307-338).
stateDiagram-v2 [*] --> draft draft --> active: activate active --> in_maintenance: send_to_maintenance in_maintenance --> active: return_to_service veya son iş emri tamamlandı active --> inactive: deactivate_asset in_maintenance --> inactive: deactivate_asset inactive --> active: activate active --> disposed: dispose inactive --> disposed: dispose in_maintenance --> disposed: dispose
Düz anlatımla: araç taslak olarak başlar ve Aktifleştir ile aktif olur. Aktif durumdan bakıma, hizmet dışına veya elden çıkarmaya gidebilir. Bir iş emrinin tamamlanması, açık başka emir yoksa bakımdaki aracı aktife döndürür (src/cluster_erp/modules/fleet/workorders/services.py:246-265). Elden çıkarma kesindir; disposed durumundan çıkan geçiş yoktur (src/cluster_erp/modules/fleet/assets/services.py:41-48).
Uçlar¶
| Yöntem ve yol | Amaç | İzin | Kaynak |
|---|---|---|---|
GET /assets/ |
search, class_id, status, kiracı alanı süzgeçleri ve sayfalama ile listeleme |
fleet_asset.read |
src/cluster_erp/modules/fleet/assets/routes.py:54-86 |
POST /assets/ |
Taslak araç oluşturma | fleet_asset.create |
src/cluster_erp/modules/fleet/assets/routes.py:89-95 |
GET /assets/{asset_id} |
Tek aracı okuma | fleet_asset.read |
src/cluster_erp/modules/fleet/assets/routes.py:98-107 |
PUT /assets/{asset_id} |
Alanları güncelleme | fleet_asset.update |
src/cluster_erp/modules/fleet/assets/routes.py:110-117 |
POST /assets/{asset_id}/actions/{action} |
Yaşam döngüsü aksiyonu çalıştırma | fleet_asset.update |
src/cluster_erp/modules/fleet/assets/routes.py:120-131 |
DELETE /assets/{asset_id} |
Kaydı devre dışı bırakma | fleet_asset.delete |
src/cluster_erp/modules/fleet/assets/routes.py:134-141 |
GET, POST, PUT /classes/... |
Sınıfları listeleme, okuma, oluşturma ve güncelleme | fleet_asset_class.read, fleet_asset_class.update |
src/cluster_erp/modules/fleet/assets/routes.py:146-192 |
Liste yanıtı, çağıranın göremediği kiracı alanı değerlerini redact_extra_items ile gizler (src/cluster_erp/modules/fleet/assets/routes.py:74-81). Bkz. alan ve satır erişimi.
Kısıtlar ve doğrulama¶
- Araç oluşturma, sınıfın var olduğunu ve
plateilevindeğerlerinin canlı satırlarda boş olduğunu denetler (src/cluster_erp/modules/fleet/assets/services.py:199-233). extraiçindeki kiracı alanı değerleri tanımlarına göre doğrulanır; sınıfa bağlı alanlar için araç satırı bağlam olarak verilir (src/cluster_erp/modules/fleet/assets/services.py:233-235). Bkz. kiracı alanları.- Yeni araç, sınıfının belirttiği sayaçları ve sınıfa bağlı bakım planlarının hatırlatmalarını hemen alır (
src/cluster_erp/modules/fleet/assets/services.py:238-249). - Sınıf kodu canlı sınıflar arasında benzersizdir; yinelenen kod çakışma ile reddedilir (
src/cluster_erp/modules/fleet/assets/services.py:68-76). DELETE, araçta ve canlı hatırlatmalarındadeleted_atalanını doldurur. Kod yorumu bu kayıt düzeyi yumuşak silmeyi operasyonelinactivedurumundan ayırır (src/cluster_erp/modules/fleet/assets/services.py:340-363).
Tanıtılan terimler¶
| Terim | Kod tanımlayıcısı | Tanım | Türkçe terim | Kaynak |
|---|---|---|---|---|
| asset lifecycle | FLEET_ASSET_STATUSES |
Bir aracın taslaktan elden çıkarmaya kadarki beş durumu. | Araç yaşam döngüsü | src/cluster_erp/modules/fleet/models.py:46 |
| default meters | default_meters |
Bir sınıftaki aracın oluşturulurken aldığı sayaç türleri. | Varsayılan sayaçlar | src/cluster_erp/modules/fleet/models.py:155 |
İlgili sayfalar¶
92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.