citrus-cms/resources/views/guide/spool-release-workflow.md

Spool Release Workflow Guide / Spool Release İş Akışı Rehberi

1. Scope & Purpose / Kapsam ve Amaç

• EN: This guide explains how the Spool Release NDT, Spool Release Paint, and Spool Area Release screens work together, covering release triggers, automatic updates, and rollback logic.
• TR: Bu rehber Spool Release NDT, Spool Release Paint ve Spool Area Release ekranlarının birlikte nasıl çalıştığını, tetikleyicileri, otomatik güncellemeleri ve geri alma (rollback) mantığını açıklar.

2. Key Files / Ana Dosyalar

• resources/views/admin/type/spool-release-ndt.blade.php – Shared template; $paint değişkeni set edildiğinde Paint modu açılır (resources/views/admin/type/spool-release-paint.blade.php sadece bu dosyayı @include eder).
• resources/views/admin/type/spool-release/rollback.blade.php – Statü geri alma zinciri.
• resources/views/admin/type/spool-release/* – Spool listesi, weld/paint info panelleri, release listeleri ve paint follow-up güncelleyicileri gibi parçalar.
• resources/views/admin/type/spool-area-release.blade.php + resources/views/admin-ajax/spool-area-release.blade.php – Tüm spool’ların özet ekranı ve veri kaynağı.

3. Layout & Widgets / Arayüz ve Bileşenler

Left Column – Spool List & Checklists

• EN: Checklist modal (admin.type.spool-release.checklist-system) and document upload widget switch between NDT vs Paint folders based on $paint.
• TR: Checklist modülü ve doküman yükleme bileşeni $paint değerine göre NDT ya da Paint klasörlerine yönlenir.
• EN: spool-list grid (DevExtreme) fetches data via ?ajax=spool-list, supports multi-select and exports. Selecting rows auto-posts iso_number & spool_number back to the main form.
• TR: spool-list grid’i (?ajax=spool-list) çoklu seçim ve dışa aktarma sunar; seçilen satırlar formda iso_number/spool_number alanlarını doldurur.

Middle Column – Weld/Paint Info Form

• EN: The form mirrors iso_number & spool_number filters, shows painting cycles (grouped per ISO), NDT % and PWHT badges, and lowest spool status (via getLowestSpoolStatus).
• TR: Form, seçilen ISO/SPL bilgilerini tekrar gösterir, boyama çevrimlerini listeler, NDT % ve PWHT etiketlerini, ayrıca getLowestSpoolStatus ile hesaplanan minimum statüyü sunar.
• EN: For SHOP vs FIELD toggling, $field flag is stored in session (oturum("type_of_joint", ...)) to render specialized field lists.
• TR: SHOP / FIELD geçişi oturumda saklanan $field bayrağıyla yapılır; bu bayrak belirli alan listelerini (ör. spool-list-field) yükler.

Right Column – Release Lists

• EN: ndt-release-list or ndt-release-paint-list show recent release numbers with rollback icons for each row.
• TR: ndt-release-list veya ndt-release-paint-list panelleri, son release numaralarını ve her satır için rollback ikonunu gösterir.

4. Release Actions / Release İşlemleri

NDT Release (ndt_release=ok)

• EN: Generates ndt_release_no from setting("ndt_release_number_pattern") via get_counter, stamps ndt_release_check, ndt_release_date, and pushes spool_status to Paint.
• TR: setting("ndt_release_number_pattern") kalıbından get_counter ile numara üretir, ndt_release_check, ndt_release_date alanlarını doldurur ve spool_status değerini Paint yapar.
• EN: Query is limited to iso_number & spool_number, ensures spool_ndt_check_no exists but ndt_release_date is null.
• TR: Sorgu seçilen ISO/SPL ile sınırlandırılır, spool_ndt_check_no dolu ama ndt_release_date boş kayıtlar hedeflenir.

NDT + Paint Release (ndt_paint_release=ok)

• EN: Accepts comma-separated ISO/SPL pairs, loops through them, and issues paint release numbers using setting("paint_release_number_pattern").
• TR: Virgülle ayrılmış ISO/SPL çiftlerini döngü ile işler, setting("paint_release_number_pattern") ile yeni numaralar üretir.
• EN: spool_status becomes Paint when painting_cycle exists, otherwise Completed; both ndt_release_* fields are stamped in one shot.
• TR: painting_cycle varsa spool_status Paint olur, yoksa Completed; ndt_release_* alanları aynı anda doldurulur.
• EN: Includes admin.type.spool-release.paint-follow-up-updater, which backfills paint_follow_ups, construction_paint_logs, and maps brand info from incoming_control_paints without overwriting existing values.
• TR: admin.type.spool-release.paint-follow-up-updater dosyası tetiklenir; paint_follow_ups, construction_paint_logs ve incoming_control_paints tablolarını mevcut veriyi bozmadan günceller.

Paint Mode Differences

• EN: When $paint is set (Spool Release Paint screen), the left upload widget points to 004_QA/0016_Spool_Paint_Release_Checklist, and the central table renders paint-info partial instead of weld-info.
• TR: $paint aktif olduğunda (Spool Release Paint), yükleme klasörü 004_QA/0016_Spool_Paint_Release_Checklist olur ve orta bölüm paint-info parçasını kullanır.
• EN: SHOP/FIELD radio toggles limit queries by type_of_joint and influences which list partial (spool-list-field) is loaded.
• TR: SHOP/FIELD butonları sorguları type_of_joint değerine göre filtreler ve hangi liste parçasının (spool-list-field) yükleneceğini belirler.

5. Rollback Logic / Rollback Mantığı

• EN: spool-release/rollback.blade.php inspects the current spool_status per selected ISO/SPL pair and steps one level backward (Completed → Paint → NDT Release → Spool Release → Manufacturing). Relevant date/number fields are nulled to keep consistency.
• TR: spool-release/rollback.blade.php, seçilen her ISO/SPL çifti için mevcut spool_status değerini bir önceki aşamaya çeker (Completed → Paint → NDT Release → Spool Release → Manufacturing) ve ilgili tarih/numara alanlarını sıfırlar.
• EN: Supports batch rollback: iso_number and spool_number strings are split, paired by index, and updated in a loop. Success message shows previous/current states and total affected rows.
• TR: Toplu rollback desteklenir; iso_number ve spool_number değerleri virgül ile ayrılır, indeks bazlı eşleştirilir ve döngüyle güncellenir. Sonuç mesajında eski/yeni statüler ile etkilenen satır sayısı gösterilir.
• EN: Rollback is blocked if no update data is generated (e.g., unsupported status transitions); users receive an error toast.
• TR: Desteklenmeyen statülerde güncelleme yapılmadığında rollback iptal olur ve kullanıcıya hata mesajı gönderilir.

6. Spool Area Release Overview / Spool Area Release Özeti

• EN: spool-area-release.blade.php is a DevExtreme grid backed by ?ajax=spool-area-release. It groups by ISO/SPL, aggregates status-related dates, and color-codes columns for Manufacturing, Spool Release, and Paint Release phases.
• TR: spool-area-release.blade.php, ?ajax=spool-area-release tarafından beslenen DevExtreme grid’idir; ISO/SPL bazında gruplanır, statü tarihlerini toplar ve üretim/NDTR/Paint aşamalarını renk kodlarıyla gösterir.
• EN: AJAX layer computes min_status_order with a CASE expression so statuses can be sorted (Waiting → Manufacturing → QC → Paint → Completed). getLowestSpoolStatus is reapplied client-side to flag inconsistencies (⚠️).
• TR: AJAX katmanı CASE ifadeleriyle min_status_order hesaplar (Waiting → Manufacturing → QC → Paint → Completed). İstemci tarafında getLowestSpoolStatus tekrar çalıştırılarak tutarsızlıklar ⚠️ ikonu ile işaretlenir.
• EN: Detail modal (spoolDetailModal) reuses the same endpoint with filter_iso_number/filter_spool_number to show all joints, while toolbar buttons generate Clearance/Paint Release PDFs from selected rows.
• TR: Detay modalı (spoolDetailModal) aynı endpoint’i filter_iso_number/filter_spool_number parametreleriyle çağırıp tüm joint’leri gösterir; araç çubuğu butonları seçilen satırlardan Clearance/Paint Release PDF’leri üretir.

7. Operational Checklist / Operasyonel Kontrol Listesi

1. EN: Filter or pick ISO/SPL rows in Spool List → TR: Spool List’te ISO/SPL seçin.
2. EN: Use the center form to verify painting cycles, NDT %, PWHT, and spool status → TR: Orta formda boyama çevrimlerini, NDT %, PWHT ve spool statüsünü doğrulayın.
3. EN: Upload checklist PDFs if needed; SHOP/FIELD toggle applies proper templates → TR: Gerekirse checklist PDF’lerini yükleyin; SHOP/FIELD seçimi doğru şablonları açar.
4. EN: Trigger NDT Release when only NDT clearance is required; use NDT & Paint Release when paint cycle is already defined → TR: Sadece NDT onayı gerekiyorsa NDT Release butonunu, boyama çevrimi hazırsa NDT & Paint Release butonunu kullanın.
5. EN: Monitor automatic paint follow-up updates via notifications (Log::debug + bilgi() toast) → TR: Otomatik paint follow-up güncellemelerini log ve bilgi() bildirimlerinden takip edin.
6. EN: If a mistake happens, use rollback icons in the release list to revert statuses in bulk → TR: Hata durumunda release listesinde yer alan rollback ikonlarıyla statüleri toplu olarak geri alın.
7. EN: Review consolidated progress inside Spool Area Release; generate registers or drill into detail modal as needed → TR: Spool Area Release ekranından genel ilerlemeyi kontrol edin; gerekirse register üretin veya detay modala inin.

8. Data & Integration Notes / Veri ve Entegrasyon Notları

• EN: All release flows operate on weld_logs; status counts for charts also rely on this table. Paint follow-up sync touches paint_follow_ups, construction_paint_logs, incoming_control_paints, and MTO aggregates.
• TR: Tüm release akışları weld_logs tablosu üzerinde çalışır; grafikler de bu tabloya dayanır. Paint follow-up senkronu paint_follow_ups, construction_paint_logs, incoming_control_paints ve MTO özetlerini kullanır.
• EN: Number generators (get_counter) respect patterns from settings; ensure counters are configured for ndt_release_number_pattern, paint_release_number_pattern, CLN, L1/L2/L3.
• TR: Numara üreticileri (get_counter) settings tablosundaki kalıpları kullanır; ndt_release_number_pattern, paint_release_number_pattern, CLN, L1/L2/L3 sayaçlarının tanımlı olduğundan emin olun.
• EN: Temperature snapshots for paint sync come from setting("temperatures"), indexed by day-of-year; missing data aborts the updater to avoid wrong entries.
• TR: Paint senkronizasyonundaki sıcaklık değerleri setting("temperatures") dizisinden (yılın günü indeksli) alınır; veri yoksa güncelleme iptal edilir.

9. Troubleshooting / Sorun Giderme

• EN: Release button hidden? Confirm spool_ndt_check is filled and current status equals NDT Release. Also ensure painting_cycle exists when attempting paint release.
• TR: Release butonu görünmüyor mu? spool_ndt_check alanının dolu ve mevcut statünün NDT Release olduğundan emin olun. Paint release için painting_cycle kaydını kontrol edin.
• EN: Rollback unavailable? Requested status may already be at the earliest phase or no matching ISO/SPL pair exists; verify selections on the left grid.
• TR: Rollback çalışmıyor mu? Statü zaten en erken aşamada olabilir veya eşleşen ISO/SPL bulunmamış olabilir; sol grid’deki seçimi doğrulayın.
• EN: Spool Area data mismatch? Use the detail modal to inspect raw rows; ⚠️ icons usually mean inconsistent dates between joints of the same spool.
• TR: Spool Area verisi tutarsız mı? Detay modalla ham satırları inceleyin; ⚠️ ikonları aynı spool’daki joint’ler arasında tarih uyumsuzluğu olduğuna işaret eder.

---

• EN: Keeping these interactions in sync ensures NDT and Paint releases move smoothly from detailed forms to the consolidated area dashboard.
• TR: Bu etkileşimleri senkron tutmak, ayrıntılı formlardan konsolide alan paneline kadar NDT ve Paint release süreçlerinin sorunsuz ilerlemesini sağlar.