KozMES Kullanim Kilavuzu v0.0.1

Proje Ozeti

60K+

Satir Kod

205

DB Tablosu

API Controller

Frontend Sayfa

HTML Yuzey

ERP Event

Mimari

Katman	Teknoloji	Detay
Backend	Node.js + Express	32 controller, JWT, Socket.IO
Veritabani	PostgreSQL	205 tablo, FIFO/FEFO, lot takibi, audit trail
Cache	Redis	Session + queue (opsiyonel)
Frontend	Vanilla JS SPA	Hash router, 22 sayfa, 4 tema
Mobil	Tablet + Portal	6 mod terminal + B2B (EN/AR/TR+RTL)
Fabrika TV	Andon Board	5 gorunum, Socket.IO push, giris yok
ERP	Mikro v15.21a / SAP B1	Parametrik sorgu editori, async queue, retry
AI	Claude API (Sonnet)	Rol bazli DB sorgu, hata yardimcisi
Altyapi	Termux (Android)	Cloudflare Tunnel, PostgreSQL+Redis+Node

Giris ve Erisim

Erisim Noktalari

Yuzey	URL	Aciklama
Ana Panel	`/`	26 menu, 5 grup, Turkce, 4 tema
Tablet Terminal	`/tablet`	6 modlu fabrika terminali
Fabrika TV	`/andon`	5 gorunum, gercek zamanli, giris yok
Distributor Portali	`/portal`	EN/AR/TR+RTL, siparis ve takip
Cockpit	`/#/cockpit`	KPI + onaylar + uyarilar, 15sn yenileme
Kilavuz	`/guide`	Bu sayfa

Giris Bilgileri

Panel	Kullanici	Sifre
Ana Panel / Tablet	`admin`	Kurulumda belirlenir
Distributor Portali	`buyer_1`	Yonetici tarafindan atanir
Andon Board	Giris gerektirmez

26 Menu - 5 Grup

Grup	Menuler
Uretim	Is Emirleri, Uretim Takibi, Planlama, OR-Tools, MRP, Receteler, Urunler
Kalite & Stok	Kalite Kontrol, Stok & Depo, Izlenebilirlik
Makine & Personel	Makineler, Bakim, Fason, Personel
Ticari	B2B, WMS/Sevkiyat, Cekme Listesi, Satinalma, AR-GE
Yonetim	Raporlar, Grafikler, Cockpit, Ayarlar, AI, Mesajlar, Denetim Izi

Urun Yonetimi

Tip	Prefix	Aciklama
Bitimis Urun	KRM-, RJ-, SMP-	Satisa hazir kozmetik
Yarimimamul	YM-	Paketlenmemis uretim ara urunu
Hammadde	HM-	Recetede kullanilan malzeme
Ambalaj	AM-	Sise, kavanoz, kutu, etiket

Ambalaj hiyerarsisi: Birim → Paket → Koli → Palet. Varyantlar: renk (hex swatch), boyut, koku. Toplu CSV import.

ERP Yeni urun kaydinda product_create eventi otomatik gonderilir.

Recete Yonetimi

Malzeme satirlari (miktar, %, faz A/B/C/D, kritik), proses adimlari (sure, sicaklik, RPM). Versiyon karsilastirma. Maliyet trend grafigi. CSV toplu import.

Is Emri

Planlandı

→

Serbest

→

Hazirlik

→

Uretimde

→

Tamamlandi

→

Kapatildi

Maliyet: Hammadde + Makine + Personel + Enerji + Fire + Genel Gider.

ERP Tamamlandiginda: production_close + material_consume + scrap_report otomatik.

QDMS Is emri detayinda DOF butonu - bilgiler pre-fill ile form acilir.

Uretim Takibi

Uretim kaydi: miktar, fire, neden kodu, lot otomatik olusturulur. OEE = Kullanilabilirlik x Performans x Kalite. Andon anlık Socket.IO. Proses adimlari tablet/masaustunden sirali onaylanir.

Stok ve Depo

Mod	Davranis	Kullanim
batch	Lot takipli, FIFO onerir	Hammadde, genel depolar
fifo	FIFO zorunlu	Merkez hammadde, uretim
none	Lot yok	Bitimis urun, sevk, stand

Giris

→

Karantina

→

Numune

→

Kalite Onay

→

Stok

ERP Mal kabulunde goods_receipt | Sayim farkinda inventory_adjust ERP'ye gonderilir.

Kalite Kontrol

Tab	Aciklama
Muayeneler	Parametre bazli, min/max otomatik kontrol
NCR	Uygunsuzluk raporu - her NCR'dan DOF acilabilir
Sapmalar / CAPA	Proses sapmasi + duzeltici faaliyet
SPC	X-bar/R grafikleri, Cpk, Nelson kurallari
Numune	Al → lab → test → imha
Karantina Kurallari	Urun+tip bazli otomatik karantina
Kontrol Noktalari	Hat/makine/urun bazli siklik
Tedarikci Kalite	Degerlendirme + kalite puani

Muayene basarisiz → otomatik DOF onerisi. NCR listesinde her satirda DOF butonu.

QDMS artik Kalite altinda degil, sol menude ayri QDMS modulu olarak yonetilir.

QDMS - Kalite Dokuman Yonetim Sistemi

Modul	Aciklama
Dokumanlar	SOP, SPEC, WI, Form, Politika, Validasyon - onay akisi + versiyon
DOF	Duzeltici Onleyici Faaliyet - 5 Neden, Balik Kilcigi, 8D
Sikayet	Musteri sikayet - kok neden + DOF baglantisi
Denetimler	Ic/dis/tedarikci - major/minor NC, gozlem, bulgu takibi
Riskler	P x S x T = RPN otomatik, risk matrisi, kalinti risk
Degisiklik	Change Control - onay akisi, validasyon gereksinimi
Egitimler	Plan, katilim, on/son test, sertifika, etkinlik skoru

Taslak

→

Inceleme

→

Onaylandı

→

Yururlukte

→

Gozden Gecirme

Sistem Genelinde QDMS Baglantilari

Sayfa	QDMS Baglantisi
Is Emirleri	DOF butonu - is emri bilgisi pre-fill
Kalite Muayene	Basarisiz sonuc → DOF onerisi
NCR Listesi	Her satirda DOF butonu
Satinalma	DOF / Tedarikci Sikayet secimi
B2B Siparisler	Musteri sikayeti - distributor pre-fill
Makineler	Ariza → DOF onerisi, makine+neden pre-fill
Andon Board	Kalite gorununumde: DOF/Sikayet/Risk/Denetim kartlari

RPN: 100+ Kritik | 50-99 Yuksek | 20-49 Orta | altinda Dusuk. 12 dokuman tipi: SOP, SPEC, FORM, WI, POL, VAL, PROC, RISK, AUDIT, CC, GMP, CERT.

Parametrik QDMS: UI sekmeleri, dokuman kategorileri, yasam dongusu, kullanim alanlari ve rol/yetki matrisi /api/qdms/settings uzerinden JSON olarak yonetilir.

Makine Yonetimi

Makine CRUD, hat atamasi, urun uyumluluk matrisi. Her makine bir uretim deposuna baglidir. Maliyet: Amortisman + Bakim + Ariza + Enerji + Sigorta = dakika maliyeti. Ariza → DOF onerisi, makine adi + neden pre-fill.

Bakim Yonetimi

Planlanmis bakim takvimi. Gecikmis bakimlar 5dk kontrol ile otomatik uyari. Bakim gecmisi ve maliyet takibi.

Personel ve Vardiya

3 vardiya: A (06-14), B (14-22), C (22-06). Yaka karti barkod ile makine bazli giris/cikis → personel maliyeti otomatik. Yetkinlik matrisi: kisi x makine x seviye. 5 tab: Liste, Vardiya Plani, Haftalik Plan, Performans, Yetkinlik.

Satinalma

Talep

→

Teklif

→

Siparis

→

Mal Giris

→

ERP

6 tab: Siparisler, Talepler, Mal Kabul, Tedarikçiler (5 kriterli slider), Teklifler (karsilastirma), Ithalat (landed cost).

QDMS Siparis satirinda DOF / Tedarikci Sikayet ikonu.ERP Mal kabulunde goods_receipt.

Uretim Planlama & APS

7 Sekmeli Planlama Ekrani

Sekme	Aciklama
Gantt Cizelge	APS Gantt: makine bazli zaman cizelgesi, surukle-birak, malzeme durumu
OEE Dashboard	Makine verimlilik metrikleri
Kapasite Analizi	Makine doluluk oranlari ve darbogaz tespiti
Plansiz Is Emirleri	Henuz planlanmamis isler + toplu planlama
Malzeme Hazirlik	YM/SA bagimlilik durumu
Urun Yasam Dongusu	Is emri durum takibi
APS 12'li Paket	Tek is emri icin ileri planlama simulasyonu

Gantt Ozellikleri

Ozellik	Aciklama
Vardiya Filtresi	V1/V2/V3 checkbox ile gorunur saatleri sec
Zoom In/Out	Zaman eksenini yaklas/uzaklas
Surukle-Birak	Bloklari yatay (zaman) ve dikey (makine) tasi
Malzeme Durumu	Ust yari: uretim hazirlik, Alt yari: hammadde/SA durumu
Renk Kodlari	Yesil=hazir, Turuncu=kismi, Kirmizi=eksik
Setup/Temizlik	Ok seklinde setup ve temizlik bloklari
Karantina	Mor badge ile karantina suresi gosterimi
Bakim Bloklari	Cizgili kirmizi alan olarak gorunur
Bagimlilik Oklari	YM uretim bagimlilik oklari (mor/kirmizi)
Mini Harita	Ust barda plan yogunluk haritasi

Planlama Yontemleri

Yontem	Buton	Aciklama
Manuel	Is Emri Planla	Tek tek makine ve zaman sec
MRP Otomatik	MRP→APS	MRP onerilerini sirali slotlara yerlestir
Toplu Tren	Toplu Planla	Ayni urun grubunu setup'siz tren olarak planla
OR-Tools Onizleme	OR-Tools Onizleme	CP-SAT solver ile optimal plan hesapla (kaydetmez)
OR-Tools Uygula	OR-Tools Uygula	Hesaplanan optimal plani DB'ye kaydet

OR-Tools Menusu (Ayri Sayfa)

Sol menude OR-Tools olarak ayri bir sayfa. Google OR-Tools CP-SAT solver ile matematiksel optimizasyon:

Sekme	Aciklama
Planlama	Onizleme + Uygula butonlari, istatistikler, zaman limiti ayari
Kilitli Planlar	Tum planlari listele, kilitle/ac islemleri
Calistirma Gecmisi	Audit trail baglantisi

Kavram	Ne Yapar
IntervalVar	Gantt'taki her blok bir zaman araligi olarak modellenir
NoOverlap	Ayni makinede iki is cakismaz
Precedence	Operasyon sirasi korunur (once karistirma, sonra dolum)
Makespan	Tum islerin toplam bitis suresi minimize edilir
Tardiness	Termin gecikme cezasi (oncelik agirlikli)
Load Balancing	Makineler arasi is dagilim dengesi
Splittable	Uzun operasyonlar birden fazla vardiyaya bolunebilir

Plan Kilitleme

Kullanici onayli planlar kilitlenebilir. Kilitli planlar OR-Tools veya surukle-birak ile degistirilemez. Kilit acilirsa tekrar planlamaya dahil olur.

Ipucu Onizleme ile once plani gorun, begenirseniz Uygula ile kaydedin.

MRP

Recursive BOM patlatma (cok seviyeli). Lot sizing: Lot-for-Lot, EOQ, Fixed, Period Order. Tedarikci otomatik secim (fiyat+kalite+teslimat puani). MRP → Oneri → Onayla → Otomatik siparis/is emri.

Setup Seed node server/migrations/run.js sonrasinda kozmetik test senaryosu otomatik gelir (37 urun, 10 recete, 6 makine, stok ve tedarikci fiyat kirilimlari).

B2B / Distributor

Siparis Tipi	Fatura	Teslimat
Standard	Distributore	Distributor adresine
Dropship	Distributore	Musteri adresine
Internet	Distributore	Son kullaniciya

Temsilci bazli cari gorunurlugu, musteri ozel fiyat, yillik kota, Chestny Znak (Rusya) DataMatrix QR.

QDMS Siparis detayinda Musteri Sikayeti butonu.ERP Sevkiyat tamamlandiginda shipment_complete.

Etiketleme Kontrol (VRF)

Kritik Distributor karisma engeli.

Ata
lot+dist

→

Bas
etiket

→

Okut
VRF tabletten

→

Dogrula
ok / dur

→

Sevk

Parametrik Davranis: block / warn / off - Ayarlar Is Kurallari.

Sevkiyat

Ceki listesi, palet listesi, proforma fatura. ZPL etiket: 4 tip. VRF ataması olanlar verified olmadan sevkiyata gecemez.

Fason + AR-GE

Fason: Partner CRUD, malzeme gonder/teslim al. Fason kod sistemi.

AR-GE: 5 proje tipi, 6 faz (Formulasyon → Lab → Stabilite → Pilot → Mikrobiyoloji → Onay). Onayda Urun + Recete direkt olusturulabilir.

AI Asistan + Mesajlasma

AI: Claude API ile veritabanina dogal dil sorgusu. Rol bazli erisim. Ekran sag altinda mor robot ikonu: hata tespiti, Admin'e Bildir, Ekran Yakala.

Mesajlasma: Thread/forum sistemi. Hiyerarsik gorunurluk. Mesajdan gorev olusturma akisi.

Raporlar ve Grafikler

19+ rapor: Gunluk Uretim, OEE, Kalite Ozet, Stok, Fire, Vardiya, Maliyet, NCR/CAPA, MRP, SPC, Fason, Enerji, Durus Pareto.

Cockpit: 5 KPI + uretim + OEE barları + onay bekleyenler + MRP onerileri. 15sn yenileme. Grafikler: 8 interaktif panel.

Ayarlar (17 Tab)

Tab	Icerik
Kullanicilar	CRUD, rol atama, sifre sifirlama
Roller & Yetkiler	16 yetki tipi, modul bazli
Genel Ayarlar	Firma, lot/is emri prefix, sifre kurallari
Toplu Yukleme	CSV: urun, makine, distributor, varyant, ambalaj, recete
Genel Gider	Aylik elektrik/su/gaz/kira/maas → urunlere dagitim
Enerji Sayaclari	Sayac CRUD, okuma, maliyet/kWh
Etiket Sablonlari	ZPL: boyut, DPI, barkod tipi
Uyarilar	Stok/SKT/bakim/kalite/uretim/satinalma
Is Kurallari	23 parametrik kural - JSON editorunden duzenle
Depo Yetkileri	Kisi x islem bazli erisim kontrolu
Degisiklik Gecmisi	Otomatik changelog + manuel not
ERP Entegrasyon	Mikro/SAP parametrik sorgu editori + queue yonetimi
Sarf Malzeme	Talep - onay - israf analizi
Export Politikasi / PLC	Veri aktarma + OPC-UA

Tablet Terminal

/tablet - 2 sutun grid menu. Ana panel token ile otomatik giris veya inline giris formu.

Mod	Islev
Barkod Kontrol	Kod/ad/barkod cinsi gosterimi
Miktar Kontrol	Parti bazli depo miktari (yetkili depo filtreli)
Stok Kontrol	Parti bagimsiz toplam stok (gonderen/alici depo bazli)
Depolar Arasi Sevk	Itme ekrani: urunler ortak nakliye havuzuna itilir
Sevk Fisi Girisi	Cekme ekrani: sevk edilen = teslim alinan kontrolu
Depo Onay Formu	Ekstra yetki ile dogrudan hedef depoya transfer
Raf Yerlestirme / Raf Kontrol	Raf bazli yerlesim ve dogrulama
Alinan Siparis	Stok hareketi yapmadan not/okutma ciktisi
Raf Transfer	Ayni depo icinde raflar arasi aktarim
Malzeme/Urun Talep	Depolar arasi talep acma (ornegin uretim merkez depodan)
Siparis Hazirla	Acik siparise okutulan urunu ayirir, siparis kapanisini hizlandirir
Yaka Karti	Personel giris/cikis
Etiket Dogrula	VRF QR okut - distributor dogrula

Tablet akisinda barkod okuma ana ekranda degil, ilgili mod secilince kullanilir. Kamera acilisinda kullanicidan izin onayi alinir.

Depo secimleri kullanici depo yetkisine gore filtrelenir (receive/issue/transfer/count/view).

Distributor Portali

/portal - 3 dil (EN/AR/TR + RTL). Buyer siparis olusturur, manager onaylar, fabrikaya gider.

Urun katalogu + sepet, Excel grid siparis (renk/varyant x koli/paket/adet), standard/dropship/internet tipleri, dashboard, yillik kota, sevkiyat takibi.

Mobil: Portal responsive tasarim ile mobil cihazlarda da duzgun calisir. Header dikey yigilir, nav butonlari sadece ikon gosterir, kullanici bilgisi kisaltilir.

ERP Entegrasyonu - Parametrik Sistem

Mimari: KozMES tum operasyonu yonetir. ERP sadece finansal. Tek ERP aktif olabilir - biri aktif edilince digeri otomatik pasif.

ERP	Baglanti	Versiyon
Mikro ERP	Direkt MSSQL	v15.21a tablo yapisi
SAP Business One	Service Layer REST	En guncel B1

13 Otomatik ERP Eventi

Event	Tetikleyen	Yon
product_create	Yeni urun kaydi	KozMES → ERP
goods_receipt	Mal kabulu tamamlandi	KozMES → ERP
production_close	Is emri tamamlandi (mamul girisi)	KozMES → ERP
material_consume	Is emri tamamlandi (hammadde)	KozMES → ERP
scrap_report	Fire miktari 0'dan buyuk	KozMES → ERP
shipment_complete	Sevkiyat "shipped" oldu	KozMES → ERP
inventory_adjust	Sayim farki onaylandi	KozMES → ERP
product_sync / stock_pull / customer_pull	Zamanlayici veya manuel	ERP → KozMES

Parametrik Sorgu Editori

Ayarlar → ERP Entegrasyon → event satirinda Mikro veya SAP butonu → kod editorü acilir. Degiskenler: {{product_code}} formati. Test: once syntax, sonra canli ERP (yazma islemi ROLLBACK yapilir). Basarisizsa kaydetmez. Rollback ile onceki versiyona donus. Async queue: 2dk/10dk/30dk backoff ile 3 retry.

Andon Board

/andon - Fabrika TV. Giris gerektirmez. Socket.IO anlik guncelleme.

Gorunum	Icerik
Genel	OEE + is emirleri + makine durumu + QDMS ozet + uyari ticker
Uretim	OEE bilesenleri + is emri ilerleme detayi
Kalite	SPC + NCR + Acik DOF/Sikayet/Risk/Yaklasan Denetim kartlari
Enerji	kWh tuketimi + birim maliyet + makine bazli
Makineler	Tum makineler renk kodlu durum kartlari

Sayfalama (Pagination)

Tum liste sayfalari varsayilan 20 kayit/sayfa gosterir. Tablo altinda "Toplam X kayit — Onceki / Sayfa / Sonraki" butonlari bulunur.

Sayfa	Liste Tablosu
Urunler	Urun listesi, tip/arama filtreli
Makineler	Makine grid kartlari
Kalite	Muayene, NCR, Sapma, CAPA tablari
Stok	Stok, Lot, Hareket tablari
WMS	Sevkiyat listesi
B2B	B2B siparis listesi
Fason	Fason emirleri
Satinalma	Siparis ve talep listeleri
Cekme Listesi	Pick list tablosu
AR-GE	Proje listesi
MRP	Oneri listesi
Mesajlasma	Thread listesi

Guvenlik

Ozellik	Detay
JWT Auth	Access token (4s) + refresh token rotasyonu
Brute Force	5 hatali giris → 15dk hesap kilidi
Rate Limit	API 120/dk, login 10/15dk, arama 30/dk
Audit Trail	Her CRUD: kullanici + IP + zaman + eski/yeni deger
CSP	Content-Security-Policy headers
Export Limiti	Maks 500 satir/export, log kaydi

Kisayollar ve Kurulum

Kisayol	Islev
Ctrl+K	Global arama (8 tip: urun, lot, is emri, siparis, makine, recete, personel, NCR)
?	Sayfa baglamsal yardim
Sidebar alt	4 tema: Gece / Acik / Endustriyel / Yuksek Kontrast
v0.0.1 badge	Changelog modali (tum degisiklikler)

Termux Komutlari

Tam Kurulum (yeni tar.gz):
bash ~/kozmes/scripts/stop-termux.sh 2>/dev/null; cd ~ && rm -rf kozmes && cp "/storage/emulated/0/SUNUCU YEDEKLER/pydroid3/kozmes/v001/kozmes-v001.tar.gz" ~/ && mkdir kozmes && tar xzf kozmes-v001.tar.gz -C kozmes && cd kozmes && ln -sf ../client server/public && cd server && npm install --no-audit --no-fund && cd .. && bash scripts/setup-termux.sh

Baslat: bash ~/kozmes/scripts/start-termux.sh
Simulatur (yeni sekme): bash ~/kozmes/scripts/simulator-start.sh
Durdur: bash ~/kozmes/scripts/stop-termux.sh