MODÜL HARİTASI
Bölüm 2 — Her modül, her alt modül, her bağlantı
Sistem 8 ana modülden oluşuyor; her birinin kendi frontend sayfaları, backend API rotaları ve veritabanı modelleri var. Bu doküman her modül ve alt modülü haritalandırıyor — ne yaptıklarını, ne içerdiklerini ve birbirlerine nasıl bağımlı olduklarını. Tüm ERP’nin içindekiler tablosu olarak düşünülebilir. Her modülün detaylı incelemesi sonraki bölümlerde.
8
ANA MODÜL
200+
API ENDPOINT
50+
VERİTABANI TABLOSU
40+
FRONTEND SAYFA
İÇİNDEKİLER
1. VERİ AKIŞI
Tek tek modüllere geçmeden önce, verinin sistem içinde nasıl aktığını görelim. Her modül, yukarı akıştaki bir modülün ürettiği veriyi aşağı akıştaki bir modülün tüketmesi için var.
TEKNİK
Kablo & makine tanımla
→
Kablo & makine tanımla
SİPARİŞ
Sipariş al
→
Sipariş al
ÜRETİM
Kablo üret
→
Kablo üret
STOK
Stok takip et
Stok takip et
HAMMADDE
Malzeme tedarik et
→
Malzeme tedarik et
ÜRETİM
Malzeme tüket
→
Malzeme tüket
LAB
Kalite test et
→
Kalite test et
STOK
Stoğa al
Stoğa al
Üretim’de birleşen iki paralel hat. Üst hat ne üretileceğini ve ne zaman üretileceğini tanımlar. Alt hat neyle üretileceğini sağlar ve kaliteyi doğrular.
2. TEKNİK — MÜHENDİSLİK
Temel Modül
Her şey buradan başlar. Teknik, hangi kabloların var olduğunu, nasıl üretildiklerini, fabrikanın hangi makinelere sahip olduğunu, hangi standartlardan geçmeleri gerektiğini ve üzerlerine ne yazılacağını tanımlar. Teknik’ten veri olmadan sipariş verilemez, üretim başlayamaz, test yapılamaz.
Kablo Tasarım
Görsel sürükle-bırak kablo tasarım aracı. Adım adım kablo oluştur — makine seç, parametre yapılandır, malzeme katmanlarını tanımla. Çıktı: malzeme gereksinimleri, yarı ürün kodları ve test eşlemeleri ile birlikte tam üretim akışı.
Frontend: react-dnd canvas, geri al/yinele, otomatik kaydetme • Backend: 20+ tasarım endpoint, oturum tabanlı
Kablo Veritabanı
Tasarım Alanı’ndan onaylı kablo tasarımları. Her kayıt, tam üretim akışını, yarı ürün ağacını, malzeme formüllerini ve test gereksinimlerini yapılandırılmış JSON olarak saklar. Aşağı akıştaki her şey için tek doğru kaynak.
Backend: cable_code arama, üretim akışı ayrıştırma, yarı ürün ağacı, analitik
Makine Yönetimi
7 makine tipi için CRUD (Kabatel Çekme, Kalaylama, İncetel Çekme, Buncher, Extruder, E-beam, Aktarma). Her makine tipinin kendi yapılandırma şeması var — hız aralıkları, çap limitleri, giriş/çıkış kısıtlamaları.
Backend: 7 makineye özel rota grubu, toplamda ~42 endpoint
Standart Yönetimi
Parametreler, test türleri, frekans kuralları ve geç/kal kriterleri ile test standartlarını (IEC-EN, UL, SLN) tanımla. Standartlar kablo tasarımlarına bağlı — her tasarım hangi testlerin ne zaman gerektiğini bilir.
Backend: standart CRUD, parametre yönetimi, test sonuç kaydı
Kablo Markalama
Markalama şablonları ekstrüzyon sırasında kablonun üzerine ne yazılacağını tanımlar (firma adı, standart, gerilim, kesit vb.). Sıralı kelime dizileri olarak saklanır. Her sipariş-kablo bir markalama şablonuna referans verir.
Backend: markalama CRUD, aktif/pasif geçiş
Operatör Yönetimi
Üretim operatör kaydı. Operatörler üretim oturumlarına atanir. Sistem kullanıcılarından ayrı — operatörün giriş yapmasına gerek yok, oturumu başlatan kişi tarafından atanır.
Backend: basit CRUD, üretim oturumları tarafından referans edilir
Tüketenler: Sipariş (kablo seçimi, markalama seçimi) • Üretim (makine yapılandırmaları, iş kartı üretimi, test tetiklemeleri) • Lab (test standartları, geç/kal kriterleri) • Stok (yarı ürün tanımları, ürün kodları)
3. HAMMADDE — MALZEME YÖNETİMİ
Tedarik Zinciri Modülü
Fabrikaya giren her şeyi takip eder — satın alma siparişi verildiği andan malzeme üretimde tüketildiği ana kadar. Bakır, kalay, plastik bileşikleri, katalizörler, boyalar, antikemirgen katkılar, makaralar ve paletler. Her fiziksel öğe girişte QR kod, fotoğraf ve lot numarası alır.
Hammadde Girişi
QR taramalı malzeme kabulü. Lab kullanıcısı her öğeyi fotoğraflar, bekleyen siparişe atar, QR kod üretir ve etiket basar. İki giriş modu: tekil öğeler (bakır/kalay sepetleri) ve lot bazlı (plastik çuvallar, boya varilleri — bir lottan birden fazla öğe).
Backend: /api/materials/entry + /lot-entry + /palette-entry + /reel-entry
Hammaddeler Listesi
Sistemdeki tüm hammaddelerin envanter görünümü. Fotoğraflar, QR kodlar, lot numaraları, tedarikçi, ağırlık, kalan ağırlık ve yaşam döngüsü durumu (Teslim Alındı → Onaylandı → Kullanımda → Tüketildi / Reddedildi).
Backend: /api/materials/list filtreleme, fotoğraf lazy-loading
Hammadde Sipariş
Tedarikçilerle satın alma siparişi takibi. Çoklu siparişler, beklenen teslimat tarihleri, neden kodlu tarih değişiklik geçmişi (tedarikçi gecikmesi, iç değişiklik, diğer), teslimat puanlaması (1–5 yıldız) ve durum yaşam döngüsü (Beklemede → Kargoda → Teslim Edildi / İptal).
Backend: /api/material-orders/* CRUD + tarih değişiklikleri + puanlama
Tedarikçi Yönetimi
Tedarikçi kaydı ve iç içe malzeme katalogları. Her tedarikçi hangi malzeme türlerini sağladığını beyan eder (bakır, kalay, plastik, katalizör, boya, antikemirgen, makara, palet) marka adları ve spesifikasyonlarla. WebSocket üzerinden gerçek zamanlı güncellemeler.
Backend: /api/suppliers/* CRUD, değişiklikte WebSocket yayını
Besler: Üretim (üretim oturumlarında tüketilen malzemeler) • Lab (girişte malzeme muayenesi) • Stok (hammadde stok görünümü) • Sipariş (malzeme hesaplayıcı mevcut stoğu referans alır)
4. SİPARİŞ — SİPARİŞ YÖNETİMİ
Talep Modülü
Müşteri taleplerini yapılandırılmış üretim işlerine dönüştürür. Sipariş, Kablo Veritabanı’ndan kablo seçer, miktar ve makara yapılandırmalarını belirler, teslimatları planlar ve — onay üzerine — tam hammadde ihtiyacını hesaplayan ve üretim sahası için iş kartları üreten Malzeme Hesaplayıcı’yı tetikler.
Sipariş Oluştur
Çok adımlı sipariş formu: müşteri seç, Kablo Veritabanı’ndan kablo seç, markalama şablonu belirle, makara uzunlukları ve miktarları tanımla, haftalık takvimde teslimat planla, palet düzenlemeli sevkiyat detaylarını yapılandır. Kablo başına malzeme seçimi (plastik, katalizör, boya, antikemirgen).
Backend: /api/siparis/orders POST, iç içe kablolar, teslimatlar, sevkiyat, ödemeler
Siparişlerim
Genişletilebilir satırlarla tüm siparişler. Durum yönetimi (Taslak → Beklemede → Onaylandı → Üretimde → Tamamlandı / Reddedildi), onayla/reddet işlemleri, hesaplama tetikleme ve arama. Her sipariş kablolarını, teslimatlarını ve iş kartı durumunu gösterir.
Backend: /api/siparis/orders GET, sayfalama + doğrulama durumu
Malzeme Hesaplayıcı
Sipariş hattının beyni. Kablo tasarımının üretim akışında yürür, büküm faktörlerini, taşma sabitlerini, kaplama oranlarını ve plastik yoğunluk formüllerini uygulayarak gereken tam kg bakır, kalay ve plastiği hesaplar. Her üretim adımı için otomatik iş kartı üretir.
Backend: /api/siparis/calculate-materials + iş kartı üretim servisi
Müşteri Yönetimi
Yurt içi/ihracat sınıflandırması, iletişim bilgileri, vergi numaraları ve adresle müşteri kaydı. Her sipariş tarafından referans edilir. Değişikliklerde WebSocket üzerinden gerçek zamanlı güncellemeler.
Backend: /api/siparis/customers CRUD, WebSocket yayınları
Teslimat Planlama
Sipariş başına teslimat takvimi — ne zaman, ne kadar, hangi kablo. Kısmi teslimatları destekler. Palet yapılandırması ve kamyon yükleme için Sevkiyat’a bağlı.
Backend: /api/siparis/deliveries CRUD, sipariş bazlı filtreleme
Bağımlı: Teknik (Kablo Veritabanı, markalama şablonları) • Hammadde (hesaplayıcı için mevcut malzeme stoğu)
Besler: Üretim (iş kartları, üretim akışı) • Stok (projeksiyon için talep verisi)
Besler: Üretim (iş kartları, üretim akışı) • Stok (projeksiyon için talep verisi)
5. ÜRETİM
En Büyük Modül
Sistemin kalbi. 12 alt modül, 7 makineye özel operatör arayüzü, üretim planlama takvimi, oturum yönetimi ve çıktı takibi. Siparişlerin fiziksel kabloya dönüştüğü yer. Her sepet tartılır, her makara ölçülür, her QR kod taranır.
Üretim Planlama
Takvim tabanlı planlama. İş kartlarını makine zaman dilimlerine sürükle (günlük/haftalık/aylık görünüm). Aynı anda birden fazla giriş işleyen makineler için paralel slot desteği. Makine müsaitlik takibi ve üretim ayarlamaları (stok tahsisi, fire faktörleri).
Backend: iş kartı planlama/plandan çıkarma, makine durumu, sıradaki kart sorgusu
Kabatel Çekme Operatörü
Tel çekme makinesi. Operatör giriş bakır sepeti QR kodunu tarar, oturumu başlatır, ağırlıklarla çıkış sepetlerini kaydeder. Giriş: 1 filmaşin sepeti → Çıkış: 1 sepet çıplak bakır. Tahsis modu: SİPARİŞ (belirli bir sipariş için) veya STOK (genel üretim).
Frontend: QR tarayıcı, oturum kontrolleri, sepet çıktı formu
Kalaylama Operatörü
Kalaylama makinesi. Giriş: 1 sepet çıplak bakır → Çıkış: 1 sepet kalaylı bakır. Kabatel ile benzer oturum akışı — giriş tara, başlat, çıkış kaydet, bitir.
Frontend: QR tarayıcı, oturum kontrolleri
İncetel Çekme Operatörü
İnce tel çekme makinesi. Giriş: 1–16 sepet → Çıkış: 1 makara çok damarlı tel. Üretimin tasarıma bağımlı hale geldiği yer — giriş sayısı, çıkış damar sayısı ve tel çapı tamamıyla kablo tasarımından gelir.
Frontend: çoklu giriş QR tarama, damar yapılandırma gösterimi
Buncher Operatörü
Büküm makinesi. Giriş: İncetel’den 1–7 makara → Çıkış: 1 makara bükülü bakır (bükülmüş iletken). Ekstrüzyondan önceki son bakır işleme adımı. İş kartı gereksinimlerine karşı doğrulamalı çoklu makara giriş tarama.
Frontend: çoklu giriş tarama, büküm faktörü gösterimi
Extruder Operatörü
Ekstrüzyon makinesi. Bakırın kablo olduğu yer — izolasyon, kılıf veya her ikisi aynı anda uygulanır. Giriş: 1 makara bükülü bakır + plastik bileşik + katalizör + boya + antikemirgen (hepsi QR taranmış). Çıkış: 1 makara bitmiş veya yarı mamul kablo.
Frontend: çoklu malzeme tarama, plastik/katalizör/boya giriş formları
E-beam Operatörü
Elektron ışın radyasyonu. E-beam kablo tipleri için opsiyonel adım. Giriş: Extruder’dan 1 makara → Çıkış: 1 makara ışınlanmış kablo. Radyasyon dozajı (5–25 Mrad) kablo tasarımının malzemesi ve plastik kalınlığına göre belirlenir.
Frontend: radyasyon dozaj gösterimi, oturum kontrolleri
Aktarma Operatörü
Aktarma/sarma makinesi. Üretim makaralarından müşteri makaralarına veya kangala (serbest halka) aktarım. Çıkış başına 100m’den 5000m’ye kadar. Üretim ile sevkiyat arasındaki köprü.
Frontend: uzunluk girişi, makara/kangal modu seçici
Üretim Listesi
Sistemdeki tüm yarı ürünlerin üretim adımına göre düzenlenmiş envanteri. Her sepet ve makara QR kodu, ağırlığı, tahsis durumu ve bağlı test sonuçları ile. Fabrika zemininde ne olduğunun gerçek zamanlı görünümü.
Backend: /api/stock/half-products adım filtreleme + özet
Üretim Geçmişi
Tamamlanmış üretim oturumları arşivi. Tam denetim izi: hangi operatör, hangi makine, hangi iş kartı, başlangıç/bitiş zamanları, ağırlıklarla tüm çıktılar, tüketilen tüm girişler ve oturum sırasında yapılan tüm testler.
Backend: /api/production/sessions/history + tam detay endpoint
Paletleme
Palet düzenleme. Aktarma sonrası bitmiş makaralar sevkiyat için paletlere yerleştirilir. Siparişteki sevkiyat planına uygun manuel palet yapılandırması.
Frontend: palet düzenleme aracı
Sevkiyat
Sevkiyat yönetimi. Son adım — paletler teslimata yüklenir. Üretimden müşteriye zinciri tamamlar.
Frontend: sevkiyat organizasyonu, teslimat tamamlama
Bağımlı: Teknik (makine yapılandırmaları, kablo tasarımları) • Sipariş (iş kartları, sipariş tahsisi) • Hammadde (hammadde QR kodları)
Besler: Stok (yarı ürün oluşturma, stok girişleri) • Lab (üretim aralıklarında test talepleri)
Besler: Stok (yarı ürün oluşturma, stok girişleri) • Lab (üretim aralıklarında test talepleri)
6. STOK — STOK & ENVANTER
Görünürlük Modülü
Aynı sorunun üç görünümü: “elimizde ne var?” Hammadde’den hammadde stoğu, Üretim’den yarı mamul stoğu, Aktarma/Sevkiyat’tan bitmiş ürün stoğu. Artı “neye ihtiyacımız olacak?” sorusunu yanıtlayan ileriye dönük projeksiyon.
Projeksiyon (Tahmin)
İleriye dönük malzeme projeksiyonu. Bekleyen tüm siparişler için gereken hammaddeleri hesaplar, mevcut stokla karşılaştırır ve eksiklikleri işaretler. Satın alma için karar destek aracı.
Backend: /api/projeksiyon, özet + malzeme bazlı döküm
Ürün Stok
Bitmiş ürün envanteri. Tüm üretim adımlarını tamamlamış, tüm testlerden geçmiş ve sevkiyata hazır veya siparişlere tahsis edilmiş kablolar.
Frontend: ürün seviyesinde stok görünümü, sipariş tahsis durumu
Hammadde Stok
3 seviyeli hiyerarşi görünümü: malzeme tipi bölümleri (bakır, kalay, plastik...) → gruplandırılmış tablolar → tekil öğeler. Miktarları, ayrılmış/kullanılabilir tutarları ve QR kodları gösterir. Satın alma ekibinin ana ekranı.
Frontend: açılır kapanır 3 katmanlı hiyerarşi, miktar özetleri
Bağımlı: Üretim (yarı ürün oluşturma) • Hammadde (hammadde girişleri) • Sipariş (projeksiyon için talep verisi) • Teknik (ürün kodu tanımları)
7. LAB — LABORATUVAR
Kalite Kapısı
Üretimle iç içe geçmiş kalite kontrol. Testler rastgele değil — kablo tasarım gereksinimlerine dayanarak belirli üretim aralıklarında (üretim başı, üretim sonu, her sepet) otomatik tetiklenir. Lab kullanıcıları bekleyen testleri görür, sonuçları kaydeder ve kritik testler başarısız olursa sistem üretim ilerlemesini engeller.
Lab Paneli
Bekleyen uyarıları, devam eden aktif testleri, son tamamlanan testleri ve günün istatistiklerini gösteren genel bakış paneli. Lab kullanıcısının ana ekranı — şu anda neye dikkat edilmesi gerektiğini gösterir.
Frontend: gerçek zamanlı uyarılar, test sayaçları, hızlı işlem bağlantıları
Test Yönetimi
Üretim çıktılarına karşı test sonuçlarını kaydet. Her test talebi belirli bir üretim çıktısına (sepet/makara) bağlı ve Teknik’ten bir test standardına bağlantılı. Standart parametrelerine göre geç/kal belirleme. Kendi kendine referanslı test talepleri, başarısız öğelerin yeniden test edilmesini destekler.
Backend: /api/test-requests + /api/production/test-requests, bağlı çıktı takibi
Bağımlı: Teknik (test standartları, parametreler, geç/kal kriterleri) • Üretim (aralıklarda tetiklenen üretim test talepleri, çıktılara bağlı)
Besler: Stok (stoğa alınması için test geçişi gerekli) • Hammadde (girişte malzeme muayenesi)
Besler: Stok (stoğa alınması için test geçişi gerekli) • Hammadde (girişte malzeme muayenesi)
8. ADMIN — SİSTEM YÖNETİMİ
Kontrol Modülü
Sistem geneli yapılandırma. Kullanıcılar, yetkiler, yazıcılar ve AI. Yalnızca Super Admin kullanıcıları tarafından erişilebilir. Diğer her şeyi çalışır tutan modül.
Kullanıcı Yönetimi
Buton seviyesinde ayrıntılı yetkilerle kullanıcı CRUD. Üç kullanıcı tipi (Super Admin, Lab Kullanıcısı, Operatör) yetki şablonlarıyla. Şifre sıfırlama, hesap askıya alma, aktivite loglama. Sistemdeki her işlem bir kullanıcıya izlenebilir.
Backend: /api/user-management/* rol şablonları + aktivite logları
Yazıcı Yönetimi
Fabrika zeminindeki 4 Epson termal yazıcı için ağ yazıcı yapılandırması. IP/port ayarları, malzeme tipi atamaları (hangi yazıcı hangi etiketi basar) ve bağlantı testi.
Backend: /api/printers/* CRUD, test endpoint
Yazdırma İzleme
4 yazıcı genelinde gerçek zamanlı yazdırma kuyruğu. İş durumları: Kuyrukta → Basılıyor → Tamamlandı / Başarısız. Başarısız işleri tekrarla, kuyruktakileri iptal et. Baskı hacimlerini ve hata oranlarını gösteren istatistik panosu.
Backend: /api/print-queue/* istatistik endpoint
AI Ayarları
Çoklu sağlayıcı AI yapılandırması. Düzinelerce sağlayıcı için API anahtar yönetimi, model seçimi, servis hesabı ayarları. Her AI sorgusunu, araç çağrısını ve yanıtı zaman damgası ve kullanıcı atfalıyla gösteren tam denetim log görüntüleyici.
Backend: /api/ai/* config, stats, audit-logs, api-keys yönetimi
Çapraz kesim: Kimlik doğrulama tüm modüllere hizmet eder • Yazdırma kuyruğu Hammadde (malzeme etiketleri) ve Üretim (çıktı etiketleri) için çalışır • AI asistan tüm modüllere salt okunur erişir • Kullanıcı yetkileri her sayfa ve butona erişimi kontrol eder
9. ÇAPRAZ SERVİSLER
Bunlar kendi sayfaları olan modüller değil — her modüle dokunmuş servisler.
Kimlik Doğrulama
JWT tabanlı. 12 saat erişim tokenı, 7 gün yenileme tokenı. Her API çağrısı kimlik doğrulamalı. Frontend’te rol bazlı rota korumaları.
WebSocket
Gerçek zamanlı güncellemeler. Müşteri değişiklikleri, tedarikçi değişiklikleri, üretim olayları tüm bağlı istemcilere anında yayınlanır.
Bildirimler
Kullanıcıdan kullanıcıya bildirimler. Bekleyen testler için lab uyarıları, planlamacılar için üretim olayları, malzeme varış bildirimleri.
Yazdırma Kuyruğu
Asenkron etiket baskı. Malzeme QR kodları, yarı ürün etiketleri — kuyruğa alınıp 4 ağ yazıcısına gönderilir.
Genel Arama
Modüller arası arama. Tek bir arama çubuğundan herhangi bir özellikle malzeme, sipariş, kablo, müşteri, operatör bul.
AI Asistan
Salt okunur AI sohbet. Sistemdeki herhangi bir veri hakkında arama, özetleme ve soru yanıtlama için 92 API aracına erişir. Denetim loglu.
10. BAĞIMLILIK HARİTASI
Hangi modül hangisine bağımlı? Satırlar “bu modül şuna bağımlı...” olarak okunur. Sütun başlıkları sağlayıcılardır. Güçlü ağır veri bağımlılığı. Hafif ara sıra referans.
| Teknik | Hammadde | Sipariş | Üretim | Stok | Lab | Admin | |
|---|---|---|---|---|---|---|---|
| Teknik | — | — | — | — | — | — | users |
| Hammadde | — | — | — | — | — | — | users |
| Sipariş | cables, markings | stock check | — | — | — | — | users |
| Üretim | machines, designs | materials (QR) | work cards | — | stock lookup | — | users, printers |
| Stok | product codes | materials | demand data | outputs | — | test status | users |
| Lab | standards | material tests | — | test requests | — | — | users |
| Admin | — | — | — | — | — | — | — |
Kilit gözlem: Teknik’in diğer iş modüllerine sıfır bağımlılığı var — temeldir. Admin’in sıfır bağımlılığı var — altyapıdır. Üretim ve Stok en fazla bağımlılığa sahip — tüm sistemin birleşme noktasında otururlar. Bu, modüler monolitik mimariyle tutarlıdır: tek bir veritabanı ve tek bir işlem bağlamını paylaşmaktan fayda gören yüksek bağlantılı modüller.
11. RAKAMLAR
| Modül | Frontend Sayfa | API Endpoint | DB Tablo | Anahtar Modeller |
|---|---|---|---|---|
| Teknik | 7 | ~75 | 10 | CableDesign, CableDatabase, Machine×7, TestStandard, Marking, ProductCode |
| Hammadde | 4 | ~30 | 6 | RawMaterial, MaterialOrder, Supplier, SupplierMaterial, MaterialPhoto |
| Sipariş | 3 | ~25 | 11 | Order, OrderCable, OrderDelivery, OrderSevkiyat, Customer |
| Üretim | 12 | ~35 | 5 | ProductionSession, WorkCard, ProductionOutput, HalfProductSequence |
| Stok | 3 | ~10 | 2 | HalfProductStock, ProductCode |
| Lab | 2 | ~15 | 3 | ProductionTestRequest, TestRequest, TestResult |
| Admin | 4 | ~25 | 6 | User, UserRole, Printer, PrintJob, AIAuditLog, Notification |
| Dashboard | 1 | ~5 | — | Tüm modüllerden toplama |
| TOPLAM | 36+ | ~220 | 50+ | — |
Sırada ne var: Her modül kendi derinlemesine bölüm dokümanını alır — veritabanı şemaları, API sözleşmeleri, frontend desenleri, kod incelemeleri ve inşa edilirken alınan kararlar. Bu harita içindekiler tablosudur. Detaylar takip eder.