Ümit Tunç
116 lines
5.3 KiB
Markdown
116 lines
5.3 KiB
Markdown
# 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
|