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

# Spool Area Release - Quick Guide / Hızlı Kılavuz

## 🔄 How System Calculates Spool Status / Sistem Spool Durumunu Nasıl Hesaplar

### English - The Algorithm

**Step 1: Priority Numbers**
```
Waiting      = Priority 1 (lowest/earliest)
Manufacturing = Priority 2
QC           = Priority 3
Paint        = Priority 4
Completed    = Priority 5 (highest/latest)
```

**Step 2: Find Lowest Status**
- System looks at ALL shop welds (S type) in your spool
- Takes the **LOWEST priority number**
- Shows that status

**Example:**
```
Spool SPL-001 has 10 welds:
- 9 welds = "Completed" (priority 5)
- 1 weld  = "QC" (priority 3)

Result: System shows "QC" ← because 3 is lower than 5
```

**Step 3: Check Date Consistency**
System compares dates for these checkpoints:
- ✅ NDT Release Date
- ✅ Clearance Date
- ✅ Register Date
- ✅ Paint Release Date
- ✅ Spool NDT Check Date

If dates don't match across all welds → adds ⚠️ warning

**Example:**
```
Spool SPL-002 dates:
- Weld 1: NDT Release = March 1
- Weld 2: NDT Release = March 1
- Weld 3: NDT Release = March 15  ← Different!

Result: Shows ⚠️ warning icon
```

**Step 4: Show Signatures**
System shows who approved what:
- **Spool NDT Check** → NDT inspector who checked the spool
- **Spool Paint Check** → Paint inspector who checked the spool
- **NDT Release Check** → Person who released from NDT
- **Paint Release Check** → Person who released from Paint

When someone signs → Shows ✒️ + their name

### Türkçe - Algoritma

**Adım 1: Öncelik Numaraları**
```
Waiting (Bekliyor)      = Öncelik 1 (en düşük/erken)
Manufacturing (Üretim)  = Öncelik 2
QC (Kalite Kontrol)     = Öncelik 3
Paint (Boya)            = Öncelik 4
Completed (Tamamlandı)  = Öncelik 5 (en yüksek/son)
```

**Adım 2: En Düşük Durumu Bul**
- Sistem spool'daki TÜM atölye kaynaklarına (S tipi) bakar
- **EN DÜŞÜK öncelik numarasını** alır
- O durumu gösterir

**Örnek:**
```
SPL-001 spool'unda 10 kaynak var:
- 9 kaynak = "Tamamlandı" (öncelik 5)
- 1 kaynak = "Kalite Kontrol" (öncelik 3)

Sonuç: Sistem "Kalite Kontrol" gösterir ← çünkü 3, 5'ten düşük
```

**Adım 3: Tarih Tutarlılığını Kontrol Et**
Sistem bu kontrol noktalarının tarihlerini karşılaştırır:
- ✅ NDT Serbest Bırakma Tarihi
- ✅ Temizlik Tarihi
- ✅ Kayıt Tarihi
- ✅ Boya Serbest Bırakma Tarihi
- ✅ Spool NDT Kontrol Tarihi

Tüm kaynaklar arasında tarihler uyuşmuyorsa → ⚠️ uyarısı ekler

**Örnek:**
```
SPL-002 tarihleri:
- Kaynak 1: NDT Serbest Bırakma = 1 Mart
- Kaynak 2: NDT Serbest Bırakma = 1 Mart
- Kaynak 3: NDT Serbest Bırakma = 15 Mart  ← Farklı!

Sonuç: ⚠️ uyarı ikonu gösterir
```

**Adım 4: İmzaları Göster**
Sistem neyi kimin onayladığını gösterir:
- **Spool NDT Kontrolü** → Spool'u kontrol eden NDT müfettişi
- **Spool Boya Kontrolü** → Spool'u kontrol eden boya müfettişi
- **NDT Serbest Bırakma Kontrolü** → NDT'den serbest bırakan kişi
- **Boya Serbest Bırakma Kontrolü** → Boyadan serbest bırakan kişi

Biri imzaladığında → ✒️ + ismini gösterir

---

## 📈 Visual Flow / Görsel Akış

### English

```
┌─────────────────────────────────────┐
│ Start: View Spool List              │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ STEP 1: Collect all welds (S type) │
│ Example: SPL-001 has 10 welds       │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ STEP 2: Find LOWEST status          │
│ Waiting(1) < Manufacturing(2) <     │
│ QC(3) < Paint(4) < Completed(5)     │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ STEP 3: Compare dates                │
│ • NDT Release Date                   │
│ • Clearance Date                     │
│ • Register Date                      │
│ • Paint Release Date                 │
│ • Spool NDT Check Date               │
│                                      │
│ Different? → Add ⚠️                  │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ STEP 4: Show signatures              │
│ • NDT Inspector → ✒️ John            │
│ • Paint Inspector → ✒️ Sarah         │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ Display: Status + Warnings + Signs  │
│ SPL-001: QC ⚠️ ✒️John ✒️Sarah       │
└─────────────────────────────────────┘
```

### Türkçe

```
┌─────────────────────────────────────┐
│ Başlangıç: Spool Listesini Görüntüle│
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ ADIM 1: Tüm kaynakları topla (S tip)│
│ Örnek: SPL-001'de 10 kaynak var      │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ ADIM 2: EN DÜŞÜK durumu bul          │
│ Bekliyor(1) < Üretim(2) <            │
│ Kalite(3) < Boya(4) < Tamamlandı(5)  │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ ADIM 3: Tarihleri karşılaştır       │
│ • NDT Serbest Bırakma Tarihi         │
│ • Temizlik Tarihi                    │
│ • Kayıt Tarihi                       │
│ • Boya Serbest Bırakma Tarihi        │
│ • Spool NDT Kontrol Tarihi           │
│                                      │
│ Farklı mı? → ⚠️ ekle                │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ ADIM 4: İmzaları göster              │
│ • NDT Müfettişi → ✒️ Ahmet           │
│ • Boya Müfettişi → ✒️ Ayşe           │
└──────────────┬──────────────────────┘
               │
               ▼
┌─────────────────────────────────────┐
│ Göster: Durum + Uyarılar + İmzalar  │
│ SPL-001: Kalite ⚠️ ✒️Ahmet ✒️Ayşe   │
└─────────────────────────────────────┘
```

---

## 📊 Spool Status - What Does It Mean? / Spool Durumu - Ne Anlama Gelir?

### English

| Status | What It Means | Can I Release? |
|--------|---------------|----------------|
| **Waiting** | Spool hasn't started yet | ❌ No - Not ready |
| **Manufacturing** | Currently being made in the shop | ❌ No - Still in production |
| **QC** | Quality control is checking it | ❌ No - Under inspection |
| **Paint** | Being painted | ❌ No - Not finished |
| **Completed** | Finished and ready to go | ✅ Yes - Ready for release |

**Important:** If your spool has 10 welds and 9 are "Completed" but 1 is "QC", the system shows "QC" to keep you safe from releasing too early.

### Türkçe

| Durum | Ne Anlama Gelir | Serbest Bırakabilir miyim? |
|-------|-----------------|----------------------------|
| **Waiting** | Spool henüz başlamadı | ❌ Hayır - Hazır değil |
| **Manufacturing** | Atölyede yapılıyor | ❌ Hayır - Hala üretimde |
| **QC** | Kalite kontrol inceliyor | ❌ Hayır - Denetim altında |
| **Paint** | Boyanıyor | ❌ Hayır - Bitmedi |
| **Completed** | Bitmiş ve gönderilmeye hazır | ✅ Evet - Serbest bırakmaya hazır |

**Önemli:** Spool'unuzda 10 kaynak varsa ve 9'u "Tamamlandı" ancak 1'i "Kalite Kontrol"deyse, sistem sizi erken serbest bırakmaktan korumak için "Kalite Kontrol" gösterir.

---

## 🔍 Icons You'll See / Göreceğiniz İkonlar

### English

| Icon | What It Means | What Should I Do? |
|------|---------------|-------------------|
| ✒️ | Someone signed/approved this | Good! This person checked it |
| ⚠️ | Warning - dates don't match! | Check why dates are different |
| (no icon) | Normal, no problems | Nothing special to do |

### Türkçe

| İkon | Ne Anlama Gelir | Ne Yapmalıyım? |
|------|-----------------|----------------|
| ✒️ | Biri imzaladı/onayladı | Güzel! Bu kişi kontrol etti |
| ⚠️ | Uyarı - tarihler uyuşmuyor! | Tarihlerin neden farklı olduğunu kontrol et |
| (ikon yok) | Normal, sorun yok | Özel bir şey yapma |

---

## What is the Spool Area Release Module?

**English:** This module helps you release spools (pipe pieces) from the workshop to the construction site. It tracks who checked what, when it's ready, and warns you if something is wrong.

**Türkçe:** Bu modül, spool'ları (boru parçalarını) atölyeden şantiyeye serbest bırakmanıza yardımcı olur. Neyi kimin kontrol ettiğini, ne zaman hazır olduğunu takip eder ve bir sorun varsa sizi uyarır.

---

## 🚀 How to Access / Nasıl Erişilir

**English:** Login → **Shop** menu → **Spool Area Release**

**Türkçe:** Giriş Yap → **Shop** (Atölye) menüsü → **Spool Area Release**

---

## 🎯 Key Features / Ana Özellikler

### 1️⃣ Revision Number (Revizyon Numarası)

**English:** Shows the latest drawing revision automatically. You always work with current info.

**Türkçe:** En son çizim revizyonunu otomatik gösterir. Her zaman güncel bilgiyle çalışırsınız.

---

### 2️⃣ Signature System (✒️ İmza Sistemi)

**English:** When someone checks or approves, their name shows with ✒️ icon. You see instantly who approved what.

**Türkçe:** Biri kontrol edip onayladığında, ismi ✒️ ikonu ile gösterilir. Neyi kimin onayladığını anında görürsünüz.

---

### 3️⃣ Smart Status (Akıllı Durum)

**English:** System shows the **lowest** status to protect you. If 1 weld is "QC" and 9 are "Completed", it shows "QC" = not ready yet!

**Türkçe:** Sistem sizi korumak için **en düşük** durumu gösterir. 1 kaynak "Kalite Kontrol"de ve 9'u "Tamamlandı" ise, "Kalite Kontrol" gösterir = henüz hazır değil!

---

### 4️⃣ Warning System (⚠️ Uyarı Sistemi)

**English:** 
- ⚠️ means dates don't match
- Example: Some welds released March 1, others March 15
- Fix the wrong date!

**Türkçe:**
- ⚠️ tarihler uyuşmuyor demek
- Örnek: Bazı kaynaklar 1 Mart, diğerleri 15 Mart tarihli
- Yanlış tarihi düzelt!

---

### 5️⃣ Two Counters (İki Sayaç)

**English:**
- **Counter 1:** Shop welds (S, F/S types)
- **Counter 2:** Field welds (F type)

**Türkçe:**
- **Sayaç 1:** Atölye kaynakları (S, F/S tipleri)
- **Sayaç 2:** Saha kaynakları (F tipi)

---

## 📋 How to Use / Nasıl Kullanılır

### Two Views / İki Görünüm

**English:**
1. **Summary View** (default) = See all spools grouped
2. **Detail View** = Filter by ISO or Spool number to see each weld

**Türkçe:**
1. **Özet Görünümü** (varsayılan) = Tüm spool'ları gruplu gör
2. **Detay Görünümü** = ISO veya Spool numarasına göre filtrele, her kaynağı gör

---

### Quick Check Before Release / Serbest Bırakmadan Önce Hızlı Kontrol

**English:**
- ✅ Status = "Completed"?
- ✅ No ⚠️ warning icons?
- ✅ All ✒️ signatures present?
- ✅ Revision number shown?

If YES to all → Ready to release!

**Türkçe:**
- ✅ Durum = "Tamamlandı" mı?
- ✅ ⚠️ uyarı ikonu yok mu?
- ✅ Tüm ✒️ imzalar var mı?
- ✅ Revizyon numarası gösteriliyor mu?

Hepsine EVET ise → Serbest bırakmaya hazır!

---

## ⚠️ Common Problems / Yaygın Sorunlar

### English

| Problem | What to Do |
|---------|------------|
| ⚠️ icon appears | Check dates - some joints have different dates. Fix the wrong ones. |
| No ✒️ signature | Find who needs to sign and remind them. |
| Status not "Completed" | One or more welds aren't finished yet. Go to Detail View to find which ones. |
| Can't release | Check: Is it "Completed"? Any ⚠️? All ✒️ present? |
| No revision number | Drawing not in system. Add it to Document Management first. |

### Türkçe

| Sorun | Ne Yapmalı |
|-------|------------|
| ⚠️ ikonu çıktı | Tarihleri kontrol et - bazı kaynakların farklı tarihi var. Yanlış olanı düzelt. |
| ✒️ imza yok | Kimin imzalaması gerektiğini bul ve hatırlat. |
| Durum "Tamamlandı" değil | Bir veya daha fazla kaynak bitmedi. Hangisi bitmediğini bulmak için Detay Görünümüne git. |
| Serbest bırakamıyorum | Kontrol et: "Tamamlandı" mı? ⚠️ var mı? Tüm ✒️ var mı? |
| Revizyon numarası yok | Çizim sistemde yok. Önce Doküman Yönetimi'ne ekle. |

---

## 💡 Quick Tips / Hızlı İpuçları

**English:**
1. Always look at icons first: ✒️ = good, ⚠️ = fix it!
2. "Completed" status = safe to release
3. Before releasing: Check 4 things (status, warnings, signatures, revision)
4. Use Summary View for quick check, Detail View for investigation

**Türkçe:**
1. Her zaman önce ikonlara bak: ✒️ = iyi, ⚠️ = düzelt!
2. "Tamamlandı" durumu = serbest bırakabilirsin
3. Serbest bırakmadan önce: 4 şeyi kontrol et (durum, uyarılar, imzalar, revizyon)
4. Hızlı kontrol için Özet Görünümü, araştırma için Detay Görünümü kullan

---

## 📞 Need Help? / Yardım mı Lazım?

**English:** Contact Shop Department

**Türkçe:** Atölye Departmanı ile iletişime geç