# Joint Release Log User Guide

## What is Joint Release Log?

The Joint Release Log is a **client-facing** module that displays only **welded joints** from production, including deleted-but-welded joints. It combines data from two sources:

- **Weld Logs** (active production records) — only joints where `type_of_welds` is a welded type (`is_welded = 1`)
- **Deleted Joints** — joints that were removed (revision, error, scope change) but were actually welded

> **Critical Rule:** Joint Release = (welded joints) + (deleted but welded joints)

## How It Works

### Data Sources

| Source | Filter | Purpose |
|--------|--------|---------|
| `weld_logs` | `type_of_welds IN (welded types)` | Active welded production records |
| `deleted_joints` | `type_of_welds IN (welded types)` + `welding_date IS NOT NULL` + not duplicated in weld_logs | Historical welded joints that were deleted |

### What is Excluded

- **Mechanical joints** (e.g., TH, FJ, BJ) — these are NOT welded, so they do not appear
- **Deleted joints without welding date** — joints that were never actually welded
- **Deleted joints that already exist in weld_logs** — to avoid duplicates

### Visual Indicators

- **DELETED badge** (red): Rows from `deleted_joints` are marked with a red "DELETED" badge and grayed out
- **Deletion comment**: If a deletion reason was provided, it appears next to the badge

## Key Features

- **Read-only view**: All columns are read-only (no editing allowed)
- **RFI Popups**: Click magnifier icons on RFI No fields to view related RFI details
- **Block Groups**: Data is organized into sections (General Info, Spool Info, Joint Info, NDT Releases, etc.)
- **PDF Attachments**: Links to Engineering, ISO, and As-Built drawings
- **Mechanical Controls**: Mechanical joint fields are automatically disabled for welded joints

## Database Architecture

The module uses a MySQL VIEW called `joint_release_view` which combines both data sources with the `is_welded` filter applied at the database level. The DevExtreme datagrid queries this view directly for client-side operations (filtering, sorting, paging).

### Joint Type Classification

Joint types are defined in the `joint_types` table:

| Field | Description |
|-------|-------------|
| `is_welded` | `1` = welded joint (included in Joint Release) |
| `is_mechanical` | `1` = mechanical joint (excluded from Joint Release) |
| `has_ndt` | `1` = requires NDT testing |

---

# Joint Release Log Kullanıcı Kılavuzu (TR)

## Joint Release Log Nedir?

Joint Release Log, müşteriye sunulan **kaynaklı (welded) birleşimleri** gösteren bir modüldür. İki veri kaynağını birleştirir:

- **Weld Logs** (aktif üretim kayıtları) — sadece `type_of_welds` alanı kaynaklı tip olan (`is_welded = 1`) jointler
- **Deleted Joints** (silinen jointler) — silinmiş ama gerçekten kaynak yapılmış olan jointler

> **KRİTİK KURAL:** Joint Release = (is_welded=1 olanlar) + (silinmiş ama welded olanlar)

## Nasıl Çalışır?

### Veri Kaynakları

| Kaynak | Filtre | Amaç |
|--------|--------|------|
| `weld_logs` | `type_of_welds IN (welded tipler)` | Aktif kaynaklı üretim kayıtları |
| `deleted_joints` | `type_of_welds IN (welded tipler)` + `welding_date IS NOT NULL` + weld_logs'ta yok | Silinmiş ama kaynak yapılmış olan jointler |

### Neler Hariç Tutulur?

- **Mekanik jointler** (örn. TH, FJ, BJ) — bunlar kaynaklı değil, listede GÖRÜNMEZ
- **Kaynak tarihi olmayan silinmiş jointler** — hiç kaynak yapılmamış olanlar
- **Weld_logs'ta zaten mevcut olan silinmiş jointler** — mükerrer kayıt önlenmesi

### Görsel Göstergeler

- **DELETED rozeti** (kırmızı): `deleted_joints`'ten gelen satırlar kırmızı "DELETED" rozeti ile işaretlenir ve griyle gösterilir
- **Silme yorumu**: Silme sebebi belirtilmişse rozet yanında görünür

## Temel Özellikler

- **Salt okunur görünüm**: Tüm sütunlar salt okunurdur (düzenleme yapılamaz)
- **RFI Popupları**: RFI No alanlarındaki büyüteç simgelerine tıklayarak RFI detaylarını görüntüleyin
- **Blok Grupları**: Veriler bölümler halinde organize edilir (Genel Bilgi, Spool Bilgisi, Joint Bilgisi, NDT Release'leri vb.)
- **PDF Ekleri**: Engineering, ISO ve As-Built çizim bağlantıları
- **Mekanik Kontroller**: Mekanik joint alanları otomatik olarak devre dışı bırakılır

## Veritabanı Mimarisi

Modül, `joint_release_view` adlı bir MySQL VIEW kullanır. Bu VIEW, her iki veri kaynağını `is_welded` filtresi ile birleştirir. DevExtreme datagrid, istemci tarafı işlemler (filtreleme, sıralama, sayfalama) için doğrudan bu VIEW'ı sorgular.

### Joint Tip Sınıflandırması

Joint tipleri `joint_types` tablosunda tanımlanır:

| Alan | Açıklama |
|------|----------|
| `is_welded` | `1` = kaynaklı joint (Joint Release'e dahil) |
| `is_mechanical` | `1` = mekanik joint (Joint Release'den hariç) |
| `has_ndt` | `1` = NDT testi gerektirir |

## Sorun Giderme

### Sık Karşılaşılan Sorunlar

1. **Kayıt sayısı beklenenden az**: Bu normal — artık sadece kaynaklı (`is_welded=1`) jointler gösteriliyor
2. **Silinmiş joint görünmüyor**: Joint tipinin kaynaklı (`is_welded=1`) olduğundan ve `welding_date` alanının dolu olduğundan emin olun
3. **Mekanik jointler görünmüyor**: Bu tasarım gereğidir — Joint Release sadece kaynaklı jointleri gösterir