Sınıf: FrmLoginForm · Modül: MOD-SISTEM · Türetildiği: DevExpress.XtraEditors.XtraForm · Yaşam döngüsü: ACTIVE_CRITICAL · Kapsam: ERPGOLD_CORE
Nedir?
ERPGOLD V2 KULLANICI GIRIS EKRANI — programın açılış penceresi. Kullanıcı sırayla Şirket Kodu, Kullanıcı Adı, Şifre ve Şube seçip GİRİŞ yapar; başarılı girişte Program.Init çalışır ve ANA MENÜ açılır [SOURCE_CODE:ERPPRO/Form/Genel/FrmLoginForm.vb:62-123] [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#2]. Üstteki veritabanı kutusu, canlı veritabanı ile devir sonrası oluşan arşiv veritabanlarını (ERPGLOBAL.dbo.Company listesi) seçtirir; böylece geçmiş yıla salt okunur bakılabilir [SOURCE_CODE:FrmLoginForm.vb:137-159] [DOCUMENT:kitap#4.7]. Pencerede ayrıca Şifre Değiştir, bağlantı ayarları (Settings → ConfigurationForm) ve şema kontrolü (DBUpdate) düğmeleri ile Ap. Version / Db. Version bilgisi vardır [SOURCE_CODE:FrmLoginForm.Designer.vb:66-508]. Kimlik doğrulamanın teknik ayrıntısı (parola saklama, deneme sayacı, denetim kaydı) SEC-AUTHN makalesindedir; burada yinelenmez.
Ne zaman kullanılır?
- Her program açılışında; ana menü kapatılınca yeniden görünür [SOURCE_CODE:ERPPRO/Form/Genel/FrmMainForm.vb:531-537].
- Devir sonrası geçmiş yılı görmek için arşiv veritabanına geçerken (arşivde işlem yapılamaz: "BU VERI TABANI ISLEME KAPATILMISTIR.") [DOCUMENT:12_Support/KnownIssues/H-007.md].
- Sunucuya bağlanılamadığında bağlantı ayarları penceresi buradan açılır [DOCUMENT:12_Support/KnownIssues/H-001.md].
Adım adım kullanım
- Program açılır; veritabanı kutusu
DEFAULT(config'teki DB) + arşiv DB'leri listeler;ERPGLOBALyoksa kutu gizlenir [SOURCE_CODE:FrmLoginForm.vb:137-155]. - Şirket Kodu seçilir → Kullanıcı Adı listesi o şirketin silinmemiş kullanıcılarıyla dolar [SOURCE_CODE:FrmLoginForm.vb:62-70].
- Şifre yazılıp kutudan çıkılır → parola ön-doğrulanır; doğruysa Şube listesi kullanıcının
UserDetailssatırlarıyla dolar ve GİRİŞ etkinleşir; yanlışsa "Şifreniz Hatalı Lütfen Tekrar Giriniz.(n)" [SOURCE_CODE:FrmLoginForm.vb:72-103]. - Şube seçilir (birden çok şube-kasa varsa) → GİRİŞ.
LoginInformation.Loginşube+kullanıcı eşleşmesini yükler,Sistem.Login'e denetim kaydı atar, ana menü açılır [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#2] [BUSINESS_RULE:BR-LOGIN-001]. - KAPAT programı kapatır. Şifre Değiştir oturum açmadan Sifre Değiştir penceresini açar (mevcut şifre gerekir).
Alanların anlamı
| Ekran etiketi | İş anlamı |
|---|---|
| (Veritabanı kutusu) | DEFAULT = canlı DB; diğerleri devir arşivleri (ERPGLOBAL.dbo.Company.DBName) — seçim Program.ConnectDatabase ile bağlantıyı değiştirir |
| Şirket Kodu | Sistem.Sirketler — çok şirketli kurulumda ilk seçim |
| Kullanıcı Adı | Sistem.Users.UserName (şirkete göre süzülü) |
| Şifre | Sistem.Users.Password ile karşılaştırılır (ayrıntı SEC-AUTHN §3; değer/algoritma burada yazılmaz) |
| Şube | Sistem.GetUsers(Şirket) → kullanıcının atanmış şubeleri; kasa ve yetki grubu şube satırından gelir |
| Ap. Version / Db. Version | Program sürümü ve şema sürümü (Sistem.ERPSCHEMA) — sürüm uyumsuzluğunda DBUpdate |
| GİRİŞ / KAPAT / Şifre Değiştir / Settings | Eylem düğmeleri |
Hesaplama / doğrulama mantığı
- 3 Kez Hatalı Şifre Girdiniz. Program Kapatılacaktır. — sayaç 3'e ulaşınca program kapanır; sayaç uygulama yeniden açılınca sıfırlanır, hesap kilitlenmez [SOURCE_CODE:FrmLoginForm.vb:80-84] [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#2].
- Lütfen bilgileri Eksiksiz Giriniz. — şube veya kullanıcı boş (kullanıcının şube satırı yoksa şube listesi boş gelir) [SOURCE_CODE:FrmLoginForm.vb:105-107].
- Program Dosyası Değiştirilmiş. Lütfen ERPPRO.EXE Dosyasının İsmini Değiştirmeyiniz. — pencere görünür olurken (
FormInit) exe dosya adı kontrol edilir [SOURCE_CODE:FrmLoginForm.vb:32-37]. - Pasif kullanıcı (
IsActive=False) giriş yapabilir; erişimi kesmek için şube satırı silinmelidir [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#1]. - Lisans süresi dolmuşsa giriş sonrası ana menü şeridi kapalı açılır ve lisans penceresi gösterilir [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#7.5] [SCREEN:SCR-FRMSHOWLISANS].
- Belirli bir şirket kodunda "acil durum" SMS gönderimi kodlanmıştır (
IsAlert); telefon numaraları gizli [SOURCE_CODE:FrmLoginForm.vb:111-118] [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#6].
Stok / bakiye / rapor etkisi
Defter etkisi yok. Yalnız Sistem.Login denetim tablosuna giriş kaydı (bilgisayar adı, IP, sürüm, durum) yazılır; çıkış kaydı yoktur [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#2] [DB_OBJECT:Sistem.Login].
Sık yapılan kullanıcı hataları
- Program açılışında bağlantı ayarları ekranı geliyor / sunucuya bağlanamıyor [DOCUMENT:12_Support/KnownIssues/H-001.md] [DOCUMENT:12_Support/Playbooks/PB-001.md].
- Ek kullanıcı bilgisayarından girilemiyor; bazen bağlanıyor bazen kopuyor [DOCUMENT:12_Support/KnownIssues/H-002.md] [DOCUMENT:12_Support/KnownIssues/H-003.md] [DOCUMENT:12_Support/Playbooks/PB-003.md].
- Kullanıcı adı / şifre kabul edilmiyor [DOCUMENT:12_Support/KnownIssues/H-009.md] [DOCUMENT:12_Support/Playbooks/PB-009.md].
- Yeni kullanıcı şube seçemiyor —
UserDetailssatırı yok [DOCUMENT:12_Support/KnownIssues/H-010.md]. - "BU VERI TABANI ISLEME KAPATILMISTIR." — arşiv DB seçili [DOCUMENT:12_Support/KnownIssues/H-007.md] [DOCUMENT:12_Support/Playbooks/PB-006.md].
- Program her açılışta lisans istiyor / lisans girişi [DOCUMENT:12_Support/KnownIssues/H-013.md] [DOCUMENT:12_Support/KnownIssues/H-014.md] [DOCUMENT:12_Support/Playbooks/PB-007.md] [DOCUMENT:12_Support/Playbooks/PB-008.md].
- "Kullanıcı Lisansı Aşıldı" — eşzamanlı kullanıcı sayısı [PROCESS:PROC-87] [DOCUMENT:06_Workflows/WF-LISANS-GIRIS.md].
İlgili ticket temaları
- PRB-BAGLANTI-000, PRB-LISANS-000, PRB-KURULUM-000; zincirler SYM-BAGLANTI, SYM-LISANS.
- Playbook'lar: PB-001, PB-009, PB-007, PB-010.
Müşteri varyasyonları
- Çok şirketli kurulumda Şirket Kodu listesi birden çok satır içerir; tek şirketli kurulumda tek satırdır.
- Arşiv veritabanı listesi yalnız ekran devri yapılmış kurulumlarda dolar (
ERPGLOBALdevirde oluşturulur) [SCREEN:SCR-FRMDEVIR]. - Şirket koduna bağlı acil durum SMS'i tek bir müşteri kurulumuna özgüdür (kod içi sabit) [SOURCE_CODE:FrmLoginForm.vb:111].
Kim kullanır? Nereden açılır?
- Hiçbir açılış yolu bulunamadı — bkz. yaşam döngüsü kanıtı.
Yaşam döngüsü kanıtı
ACTIVE_CRITICAL — kod içinden erişim (New/varsayılan örnek): ERPPRO/Form/Genel/FrmMainForm.vb; çağıran sınıf: FrmMainForm
Kullanıcı olayları
| Olay | Metot | Dosya:satır |
|---|---|---|
Me.KeyDown |
FrmLoginForm_KeyDown |
FrmLoginForm.vb:22 |
Me.VisibleChanged |
FormInit |
FrmLoginForm.vb:32 |
CmbSirket.EditValueChanged |
SirketDegisti |
FrmLoginForm.vb:62 |
txtPassword.Validated |
SubeListele |
FrmLoginForm.vb:72 |
BtnLogin.Click |
Login |
FrmLoginForm.vb:104 |
Button2.Click |
Close |
FrmLoginForm.vb:124 |
BtnSifreDegistir.Click |
BtnSifreDegistir_Click |
FrmLoginForm.vb:127 |
BtnSettings.Click |
BtnSettings_Click |
FrmLoginForm.vb:132 |
Me.Load |
GetDatabase |
FrmLoginForm.vb:137 |
CmbDatabase.EditValueChanged |
DatabaseChanged |
FrmLoginForm.vb:156 |
BtnCheckShema.Click |
BtnCheckShema_Click |
FrmLoginForm.vb:160 |
Okuduğu / yazdığı tablolar (kod içi SQL, statik)
| Tablo | Fiiller |
|---|---|
ERPGLOBAL.dbo ⚠︎ DB'de yok |
SELECT |
Sistem.Sirketler |
SELECT |
Sistem.Users |
SELECT |
Sistem.getusers ⚠︎ DB'de yok |
SELECT |
Kullandığı DAO / iş sınıfları
Kullanıcıya gösterilen mesajlar (doğrulama)
- 3 Kez Hatalı Şifre Girdiniz. Program Kapatılacaktır.
- Lütfen bilgileri Eksiksiz Giriniz.
- Program Dosyası Değiştirilmiş. Lütfen ERPPRO.EXE Dosyasının İsmini Değiştirmeyiniz.
- Şifreniz Hatalı Lütfen Tekrar Giriniz.(
Bilinen kusurlar / dikkat
- Dinamik SQL: 4 ifade — parametresiz birleştirme riski (TD-DYNAMIC-SQL).
Kaynaklar
SOURCE_CODE:ERPPRO/Form/Genel/FrmLoginForm.Designer.vbSOURCE_CODE:ERPPRO/Form/Genel/FrmLoginForm.vbDERIVED:docs/knowledge-base/screens/FrmLoginForm.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).
- Menüden değil kod içinden açılıyor; kullanıcı yolu doğrulanmalı.