MADEN TANIMLAMA EKRANI

Sınıf: FrmMadenEkle · Modül: MOD-STOK · Türetildiği: ERPPRO.FormEditBase · Yaşam döngüsü: ACTIVE_CRITICAL · Kapsam: ERPGOLD_CORE

Nedir?

Maden stok kartı tanımlama ekranıdır: bilezik, gram altın, çeyrek, külçe olmayan işlenmiş her maden ürünü ve hurda kartları Stok.Maden'e burada açılır [DOCUMENT:kitap#4.2] [DB_OBJECT:Stok.Maden]. Kartın Metal / Hurda seçimi (IsHurda) hangi işlem ekranının bu kartı göstereceğini belirler: MADEN ekranı yalnız metal kartları, HURDA ekranı yalnız hurda kartları listeler [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-maden-ishurda]. Kartta saklanan milyem, adet takibi, sabit parça gramı, giriş/çıkış işçiliği ve fiyat tipi; işlem ekranında FİYAT/MİKTAR/HAS'ın nasıl hesaplanacağını ve maliyeti belirler [BUSINESS_RULE:BR-HESAP-011] [BUSINESS_RULE:BR-HESAP-003] [BUSINESS_RULE:BR-MALIYET-001]. Hurda seçilince ayrıntı paneli (milyem, işçilik, adet) gizlenir [SOURCE_CODE:ERPPRO/Form/Tanımlamalar/Stok/FrmMadenEkle.vb:3-8].

Ne zaman kullanılır?

• Yeni bir ürün (ayar/çeşit) alım-satıma başlarken [PROCESS:PROC-183].
• Kartın milyeminin işlemde değiştirilebilir olması istendiğinde (Milyem Degisir/Degismez) [PROCESS:PROC-97] [DOCUMENT:12_Support/KnownIssues/H-027.md].
• Ürün adı değiştirilecekse — hareketi olan kartın adı değişmez; önce stoktan çıkılır [PROCESS:PROC-108] [DOCUMENT:12_Support/KnownIssues/H-026.md].
• Peşin satışta fiyatın has yerine gram üzerinden gelmesi istendiğinde (Fiyat T.) [DOCUMENT:12_Support/KnownIssues/H-028.md] [PROCESS:PROC-109].

Adım adım kullanım

1. ADMIN ile ANA MENÜ ▸ Tanımlamalar ▸ Stok Tanimlari ▸ Maden Stok Tanimlama ▸ YENİ KAYIT [PROCESS:PROC-183].
2. Kodu (ürün adı, işlem ekranında STOK KODU listesinde görünür) ve Acıklama yazılır.
3. Ana Birim: yalnız metal ve hesaplanmamış birimler listelenir (HAS, GUM, PLT, PLD); varsayılan şubenin bilanço birimidir [SOURCE_CODE:FrmMadenEkle.vb:10,16].
4. Metal / Fiyat T.: sol kutu Metal ya da Hurda; sağ kutu fiyat tipi Adet / Miktar / Oz / Has [SOURCE_CODE:FrmMadenEkle.Designer.vb:323,903].
5. Metal ise ayrıntı paneli: Milyem (binde saflık, ör. 0,916) + Degismez/Degisir; Adet Takip (Yok/Var) ve Sabit Miktar (bir adedin gramı; ör. çeyrek); Iscilik Turu (Adet/Miktar) + Degismez/Degisir; Giris Isciligi ve Cıkıs Isciligi + birimleri; Isc Durum(G/C) (Degismez/Degisir); Isc Extra (Yok/Var); Maliyet Birim; Barkod.
6. Grup Kodu, Kategori (rapor kırılımı) ve Durum (Aktif/Pasif).
7. Kayıt; Ctrl+F5 ile sistem yenilenir [DOCUMENT:12_Support/Playbooks/PB-039.md].

Ekranın kayıt/okuma metotları FrmMadenEkle.vb ile FrmMadenEkle.Designer.vb arasında bölünmüştür; makaledeki alan tablosu Designer'dan otomatik türetildiği için bazı etiketler kaymıştır (ör. "Grup Kodu | CmbAdetTakip"); gerçek etiketler yukarıdaki adımlarda ve aşağıdaki tabloda Designer satırlarına göre verilmiştir [SOURCE_CODE:FrmMadenEkle.Designer.vb:150-981].

Alanların anlamı

Kolon anlamları kitapçık §8.3.5'ten [DOCUMENT:kitap#8.3.5 MADEN TANIMLAMA EKRANI].

Hesaplama / doğrulama mantığı

• Ekranda doğrulama mesajı yoktur. Kod içinde Cari.Islemler SELECT'i vardır (1 dinamik ifade); PROC-108'e göre hareketi olan kartın adı değiştirilemez — bu kontrolün kaynağı olası [PROCESS:PROC-108] (GAP: kontrol satırı okunmadı).
• Kart değerleri işlem anında kopyalanır: HAS = MİKTAR × MİLYEM/1000; sabit gramlı üründe MİKTAR = ADET × Sabit Miktar; işlem tipine göre maliyet [BUSINESS_RULE:BR-HESAP-001] [BUSINESS_RULE:BR-HESAP-003] [BUSINESS_RULE:BR-MALIYET-001].
• Kart milyemi 0 ise tetikleyici has = miktar kabul eder [BUSINESS_RULE:BR-HESAP-002].

Stok / bakiye / rapor etkisi

Defter etkisi yok — tanım ekranı. Kart değişikliği geçmiş satırları etkilemez (işlem satırı kendi milyem/fiyat/kur fotoğrafını taşır). Ancak Ana Birim, Milyem ve Maliyet Birim yeni işlemlerin stok defteri (Stok.StokHaraketleri StokTipi=1: Adet/Miktar/Has/Maliyet) satırlarını belirler [BUSINESS_RULE:BR-STOK-001] [BUSINESS_RULE:BR-DEFTER-URETIMI].

Sık yapılan kullanıcı hataları

• Maden stok adı değiştirilemiyor — hareketi olan kart; stoktan çıkılıp değiştirilir [DOCUMENT:12_Support/KnownIssues/H-026.md] [PROCESS:PROC-108].
• Milyem değiştirilemiyor / ekranda milyem kutusu kilitli — Milyem "Degismez" [DOCUMENT:12_Support/KnownIssues/H-027.md] [PROCESS:PROC-97].
• Peşin satışta fiyat has'a göre geliyor, gram isteniyor — Fiyat T. ve Pesin Kur Tipi ayarı [DOCUMENT:12_Support/KnownIssues/H-028.md].
• "Lütfen Adet Giriniz." — Sabit Miktar dolu üründe adet boş [DOCUMENT:12_Support/KnownIssues/H-048.md].
• Milyem yazıyorum siliniyor; işçilik fiyatı kendiliğinden değişiyor — kart işçiliği/milyem durumu [DOCUMENT:12_Support/KnownIssues/H-049.md] [DOCUMENT:12_Support/Playbooks/PB-059.md].
• Maden stok listesinde ürünlerin sırası bozuk / alt toplam görünmüyor [DOCUMENT:12_Support/KnownIssues/H-118.md] [DOCUMENT:12_Support/KnownIssues/H-138.md] [PROCESS:PROC-14] [PROCESS:PROC-147].
• Maliyet "tuhaf" / sıçradı — maliyet birimi ve işçilik tabanı [DOCUMENT:12_Support/KnownIssues/H-120.md] [DOCUMENT:12_Support/KnownIssues/H-122.md] [DOCUMENT:12_Support/Playbooks/PB-058.md] [PROCESS:PROC-111].
• HURDA ekranında ürün yok — kart Metal olarak açılmış (IsHurda=0) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-maden-ishurda].

İlgili ticket temaları

• PRB-MADEN-000, PRB-TANIMLAMA-000; zincirler SYM-MADEN, SYM-TANIMLAMA.
• Playbook'lar: PB-057, PB-058, PB-059.

Müşteri varyasyonları

• V2 (döviz) örnek DB'de 104 normal + 17 hurda kartı; kuyumcu kurulumunda kart sayısı ve işçilik alanlarının kullanımı farklıdır [DOCUMENT:kitap#4.2] [DOCUMENT:kitap#9.3].
• Model/pırlanta gibi diğer ürün grupları ayrı tanım ekranlarındadır; bu ekran yalnız Stok.Maden içindir.

Kim kullanır? Nereden açılır?

• ANA MENÜ ▸ Tanımlamalar ▸ Stok Tanimlari ▸ Maden Stok Tanimlama
• Liste ekranındaki Ekle/Düzenle: AIO.Stok.Maden.FormEditBase → bu form

Yaşam döngüsü kanıtı

ACTIVE_CRITICAL — ANA MENÜ: Tanımlamalar ▸ Stok Tanimlari ▸ Maden Stok Tanimlama; DAO FormEditBase hedefi: AIO.Stok.Maden

Alanlar → veritabanı

Kullanıcı olayları

Okuduğu / yazdığı tablolar (kod içi SQL, statik)

Kullandığı DAO / iş sınıfları

AIO.Stok.Maden

Bilinen kusurlar / dikkat

• Dinamik SQL: 1 ifade — parametresiz birleştirme riski (TD-DYNAMIC-SQL).

Kaynaklar

• SOURCE_CODE:ERPPRO/Form/Tanımlamalar/Stok/FrmMadenEkle.Designer.vb
• SOURCE_CODE:ERPPRO/Form/Tanımlamalar/Stok/FrmMadenEkle.vb
• DERIVED:docs/knowledge-base/screens/FrmMadenEkle.md (KB-docs statik analiz)
• DERIVED:kb_src/erppro/scan.json (olay/SQL/çağrı)

Bilinmeyenler

• Hangi sürümde eklendiği: VERSION_UNKNOWN (GAP-CODE-VERSION-DATE).