citrus-cms/resources/views/guide/joint-release-log.md

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