1) Amaç
Koza Bakım Zekâsı; ERP/CMMS içerisinde tutulan arıza, bakım iş emri, ekipman envanteri ve duruş verilerini analiz ederek
arıza tekrarlarını, kritik ekipman risklerini ve bakım planı iyileştirme alanlarını tespit eder. Planlı bakım uyumu,
MTBF/MTTR gibi göstergeler ve arıza kök nedenleri üzerinden öneriler üretir.
Bu doküman, Koza Bakım Zekâsı’nın çalışması için gerekli veri alanlarını ve entegrasyon ön koşullarını tanımlar.
2) Veri Kaynakları
Koza Bakım Zekâsı aşağıdaki ERP / CMMS modüllerinden veri bekler:
- Bakım Yönetimi (CMMS)
- Ekipman / Varlık Yönetimi (Asset Management)
- Üretim Yönetimi (duruş/arıza etkisi için)
- Stok / Yedek Parça Yönetimi (opsiyonel fakat önerilir)
- Satınalma (yedek parça tedarik performansı – opsiyonel)
- IoT / Sensör Verileri (opsiyonel, kestirimci bakım için)
3) Zorunlu Veri Setleri
Aşağıdaki veri setleri sağlanmadan Koza Bakım Zekâsı’nın arıza analizi, bakım planı optimizasyonu ve performans
göstergeleri sağlıklı çalışmaz.
3.1) Assets (Ekipman / Varlık Envanteri)
Amaç: Kritik ekipmanların sınıflandırılması, ekipman bazlı risk ve performans analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| AssetCode | Ekipman/varlık kodu | Evet |
| AssetName | Ekipman/varlık adı | Evet |
| AssetType | Tür (Makine, Hat, Pompa vb.) | Hayır |
| LineCode | Hat / bölüm | Hayır |
| Location | Konum | Hayır |
| Criticality | Kritiklik (A/B/C vb.) | Hayır |
| CommissionDate | Devreye alma tarihi | Hayır |
| Status | Aktif / Pasif | Evet |
3.2) MaintenanceWorkOrders (Bakım İş Emirleri)
Amaç: Planlı bakım uyumu, iş emri süreleri, gecikme ve tekrar eden arızaların analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| WorkOrderNo | İş emri numarası | Evet |
| WorkOrderType | Planlı / Arıza / Revizyon | Evet |
| AssetCode | İlgili ekipman kodu | Evet |
| Priority | Öncelik | Hayır |
| PlannedStartTime | Planlanan başlangıç | Hayır |
| PlannedEndTime | Planlanan bitiş | Hayır |
| ActualStartTime | Gerçek başlangıç | Evet |
| ActualEndTime | Gerçek bitiş | Evet |
| Status | Açık / Devam / Kapalı | Evet |
| FailureCode | Arıza kodu | Hayır |
| FailureDescription | Arıza açıklaması | Hayır |
| RootCauseCode | Kök neden kodu | Hayır |
3.3) BreakdownEvents (Arıza / Olay Kayıtları)
Amaç: Arıza frekansı, tekrar eden arızalar, MTBF hesapları için olay bazlı veri.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| EventNo | Arıza/olay kayıt no | Evet |
| AssetCode | Ekipman kodu | Evet |
| StartTime | Arıza başlangıç | Evet |
| EndTime | Arıza bitiş | Evet |
| FailureCode | Arıza kodu | Evet |
| FailureDescription | Arıza açıklaması | Hayır |
| Severity | Önem derecesi | Hayır |
| DetectedBy | Operatör / Sensör / Bakım | Hayır |
| DowntimeMinutes | Duruş süresi (dk) | Hayır |
3.4) DowntimeRecords (Duruş Kayıtları – Bağlantılı)
Amaç: Üretim kaybı ile bakım olaylarının ilişkilendirilmesi (opsiyonel fakat önerilir).
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| MachineCode | Makine/istasyon kodu (AssetCode ile eşlenebilir) | Evet |
| StartTime | Duruş başlangıç | Evet |
| EndTime | Duruş bitiş | Evet |
| ReasonCode | Duruş nedeni | Evet |
| ReasonDescription | Açıklama | Hayır |
| PlannedUnplanned | Planlı / Plansız | Hayır |
4) Opsiyonel Veri Setleri
Aşağıdaki veri setleri zorunlu değildir; ancak bakım optimizasyonu, maliyet analizi ve kestirimci bakım senaryoları için
yüksek değer sağlar.
4.1) SparePartsConsumption (Yedek Parça Tüketimi)
Amaç: Arıza türü – parça tüketimi ilişkisi, kritik parça analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| WorkOrderNo | İlgili iş emri | Evet |
| ItemCode | Parça kodu | Evet |
| Quantity | Tüketilen miktar | Evet |
| Uom | Birim | Hayır |
| ConsumptionDate | Tüketim tarihi | Hayır |
| UnitCost | Birim maliyet | Hayır |
4.2) PreventiveMaintenancePlans (Planlı Bakım Planları)
Amaç: Planlı bakım kapsamı, periyotlar, uyum (compliance) analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| PlanNo | Plan no | Evet |
| AssetCode | Ekipman kodu | Evet |
| FrequencyType | Zaman / Sayaç (km, saat, çevrim) | Evet |
| FrequencyValue | Periyot değeri | Evet |
| NextDueDate | Bir sonraki planlı bakım tarihi | Hayır |
| Checklist | Kontrol listesi (text/JSON) | Hayır |
4.3) IoTMeasurements (Sensör / Sayaç Ölçümleri)
Amaç: Kestirimci bakım (predictive) senaryoları için zaman serisi ölçümler.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| AssetCode | Ekipman kodu | Evet |
| MetricName | Titreşim / Sıcaklık / Akım vb. | Evet |
| MetricValue | Ölçüm değeri | Evet |
| Timestamp | Zaman damgası | Evet |
| Unit | Birim | Hayır |
| Source | PLC / SCADA / IoT Gateway | Hayır |
5) Entegrasyon Yöntemi
Koza Bakım Zekâsı ERP/CMMS sistemine yazmaz; sadece okur. Entegrasyon read-only çalışır ve sistem üzerinde veri değişikliği yapılmaz.
- REST API: JSON tabanlı uç noktalar üzerinden veri okuma
- SOAP Web Service: Mevcut servisler üzerinden okuma
- Database View: Sadece okuma yetkili view’ler
- Scheduled Export: JSON/CSV olarak dışa aktarım
6) Performans & Format Beklentileri
- Veri güncelliği: Maks. 5 dakika gecikmeli (önerilir); IoT için 10-60 sn aralığı tercih edilebilir
- Zaman damgası: Olay/iş emri başlangıç-bitiş zamanları zorunludur
- Tarih-saat formatı: ISO 8601 (timezone dahil)
- Karakter seti: UTF-8
- Referans bütünlüğü: AssetCode/WorkOrderNo eşleşmeleri tutarlı olmalıdır
7) Hazırlık Kontrol Listesi
Aşağıdaki maddelerin tamamı “Evet” ise, Koza Bakım Zekâsı kısa sürede devreye alınabilir.
8) Örnek API Endpoint’leri
Aşağıdaki uç noktalar örnek amaçlıdır. ERP/CMMS mimarisine göre isimler değişebilir.
/api/assets
/api/maintenance-workorders
/api/breakdown-events
/api/downtimes
/api/spareparts-consumption
/api/preventive-maintenance-plans
/api/iot-measurementsYetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS