1) Amaç
Koza Kalite Zekâsı; ERP / QMS sistemlerinde tutulan kalite kontrol, uygunsuzluk, hata türü, iade ve müşteri şikâyeti
verilerini analiz ederek kalite problemlerinin kök nedenlerini tespit eder, tekrar eden hataları ortaya çıkarır ve
iyileştirme alanlarını önerir.
Bu doküman, Koza Kalite Zekâsı’nın çalışması için gerekli veri alanlarını ve entegrasyon ön koşullarını tanımlar.
2) Veri Kaynakları
Koza Kalite Zekâsı aşağıdaki ERP / QMS modüllerinden veri bekler:
- Kalite Yönetimi (QMS)
- Üretim Yönetimi (bağlantılı analizler için)
- Satış / İade Yönetimi
- Müşteri Şikâyetleri (CRM modülü varsa)
- Bakım Yönetimi (opsiyonel, kök neden analizi için)
3) Zorunlu Veri Setleri
Aşağıdaki veri setleri sağlanmadan Koza Kalite Zekâsı’nın hata analizi, kök neden tespiti ve tekrar eden problem
analizi sağlıklı çalışmaz.
3.1) QualityInspections (Kalite Kontrol Kayıtları)
Amaç: Ürün bazlı kalite performansı, kontrol sonuçları ve hata oranlarının analizi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| InspectionNo | Kalite kontrol kayıt numarası | Evet |
| InspectionDate | Kontrol tarihi/saat | Evet |
| ProductCode | Ürün kodu | Evet |
| OrderNo | Üretim emri no | Hayır |
| InspectorId | Kontrol eden kişi | Hayır |
| Result | Geçti / Kaldı | Evet |
| DefectCount | Hatalı adet | Hayır |
3.2) NonConformities (Uygunsuzluk Kayıtları)
Amaç: Uygunsuzluk türleri, tekrar eden problemler ve kök neden analizleri.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| NCNo | Uygunsuzluk kayıt no | Evet |
| NCDate | Uygunsuzluk tarihi | Evet |
| ProductCode | Ürün kodu | Evet |
| DefectCode | Hata türü kodu | Evet |
| DefectDescription | Hata açıklaması | Hayır |
| Severity | Önem derecesi | Hayır |
| DetectedAt | Üretim / Sevkiyat / Müşteri | Evet |
3.3) DefectCodes (Hata Türleri Tanımları)
Amaç: Hata sınıflandırması, Pareto analizi ve trend takibi.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| DefectCode | Hata kodu | Evet |
| DefectName | Hata adı | Evet |
| Category | Mekanik / Görsel / Ölçü vb. | Hayır |
| Description | Açıklama | Hayır |
3.4) CustomerReturns (Müşteri İadeleri)
Amaç: Sahadan gelen kalite problemlerinin analizi, müşteri bazlı hata dağılımı.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| ReturnNo | İade kayıt no | Evet |
| ReturnDate | İade tarihi | Evet |
| CustomerCode | Müşteri kodu | Hayır |
| ProductCode | Ürün kodu | Evet |
| DefectCode | Hata türü | Evet |
| Quantity | İade adedi | Evet |
| Description | Açıklama | Hayır |
4) Opsiyonel Veri Setleri
Aşağıdaki veri setleri zorunlu değildir; ancak kök neden analizini ve öneri doğruluğunu ciddi şekilde güçlendirir.
4.1) CorrectiveActions (Düzeltici / Önleyici Faaliyetler)
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| ActionNo | Faaliyet kayıt no | Evet |
| RelatedNCNo | İlgili uygunsuzluk no | Evet |
| ActionType | Düzeltici / Önleyici | Evet |
| StartDate | Başlangıç | Evet |
| EndDate | Bitiş | Hayır |
| Status | Planlandı / Tamamlandı | Hayır |
4.2) MaintenanceRecords (Bakım Kayıtları – Bağlantılı)
Amaç: Hata – arıza ilişkisi, makine kaynaklı kalite problemleri.
| Alan Adı | Açıklama | Zorunlu |
|---|---|---|
| MachineCode | Makine kodu | Evet |
| MaintenanceType | Planlı / Arıza | Evet |
| StartTime | Başlangıç | Evet |
| EndTime | Bitiş | Evet |
| Reason | Bakım nedeni | Hayır |
5) Entegrasyon Yöntemi
Koza Kalite Zekâsı ERP/QMS 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: Maksimum 5 dakika gecikmeli (önerilir)
- Zaman damgası: Tüm kayıtlar için zorunlu
- Tarih-saat formatı: ISO 8601 (timezone dahil)
- Karakter seti: UTF-8
- Referans bütünlüğü: ProductCode, DefectCode gibi alanlar tutarlı olmalıdır
7) Hazırlık Kontrol Listesi
Aşağıdaki maddelerin tamamı “Evet” ise, Koza Kalite 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 / QMS mimarisine göre isimler değişebilir.
/api/quality-inspections
/api/nonconformities
/api/defect-codes
/api/customer-returns
/api/corrective-actions
/api/maintenance-recordsYetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS