User Group Details

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

Nedir?

Kullanıcı grubu (yetki grubu) tanımlama penceresidir. Bir grubun adı ve o gruba bağlı kullanıcıların hangi işlem ekranlarını (Takoz, Maden, Hurda, Nakit, Çevir, Vadeli, Hizmet, Taş, Pırlanta, Model, Genel, Borç, Virman, Fatura, Emtia, Çeşni, Parite), hangi işlem haklarını (İşlem Düzelt, İşlem İptal, Kod Tanımlama, Peşin Kontrolü, Bakiye Görünümü, Ticket Kapama) ve ana menüdeki hangi düğmeleri görebileceği burada işaretlenir [SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.vb:1-200] [SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.Designer.vb:137-367]. Seçimler tek bir kodlanmış dize hâlinde Sistem.UserGroup.Permission kolonuna yazılır; program açılışında bu dize çözülür ve iScreen.InitPermission her düğmeyi grup bayrağına bağlar [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-usergroup-permission] [DOCUMENT:06_Workflows/WF-KULLANICI-GRUBU-YETKI.md]. Kullanıcının hangi gruba bağlı olduğu ise KULLANICI TANIMLAMA ekranındaki şube-kasa satırında seçilir.

Ne zaman kullanılır?

• Yeni bir personel rolü (banko, muhasebe, yönetici) için yetki seti oluşturulacağında [PROCESS:PROC-136].
• Bir ekran menüde görünmüyor, DÜZELT/İPTAL düğmesi yok ya da "İşlem Düzeltme Yetkiniz Yok." / "İşlem İptal Etme Yetkiniz Yok." mesajı alınıyorsa [DOCUMENT:06_Workflows/WF-KULLANICI-GRUBU-YETKI.md] [DOCUMENT:12_Support/Playbooks/PB-041.md].
• Aifa Developer Studio sekmesi bir kullanıcıda görünmüyorsa (menü düğmesi yetkisi) [DOCUMENT:12_Support/KnownIssues/H-019.md].

Adım adım kullanım

1. ADMIN (tanımlama yetkili) kullanıcı ile girilir; ANA MENÜ ▸ Tanımlamalar ▸ Sistem Tanimlari ▸ Kullanıcı Grupları listesi açılır [PROCESS:PROC-136].
2. Listede YENİ KAYIT ya da mevcut grup seçilip KAYIT DÜZELT ile bu pencere açılır.
3. Grup Adı yazılır (zorunlu tek metin alanı).
4. Sol bloktaki kutucuklar işaretlenir: işlem ekranı yetkileri (Takoz, Maden, Hurda, Nakit, Cevir, Vadeli, Hizmet, Taş, Pırlanta, Model, Genel, Borc [G/C], Virman, Fatura, Emtia, Cesni, Parite) ve işlem hakları (İşlem Düzelt, İşlem İptal, Kod Tanimlama, Pesin Kontrolu, Bakiye Gorunumu, Ticket Kapama) [SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.Designer.vb:137-367].
5. Sağdaki ızgarada ana menünün her sekmesi ▸ grubu ▸ düğmesi satır olarak listelenir; görünmesi istenen düğmelerin Visible kutusu işaretlenir. Tumunu Sec tüm düğmeleri açar [SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.vb:63-79,156-160].
6. Kayıt ile kapanır. Yetki değişikliği, o gruptaki kullanıcı programdan çıkıp yeniden girince geçerli olur [DOCUMENT:06_Workflows/WF-KULLANICI-GRUBU-YETKI.md].

Alanların anlamı

Dize kodlaması: metin önce True;False;…|Sayfa;Grup;Düğme|… biçiminde birleştirilir, sonra her karakter 3 haneli ASCII koduna çevrilir (GetToCode); okuma tersidir (CodeToString) [SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.vb:80-140]. Bu yüzden Permission kolonu doğrudan okunabilir değildir; DB'den elle düzenlenmemelidir.

Hesaplama / doğrulama mantığı

• Ekranda doğrulama mesajı yoktur; boş grup adıyla kayıt kodda engellenmez (GAP: DAO AIO.Sistem.Usergroup.Save içinde boş ad kontrolü olup olmadığı okunmadı).
• Menü ızgarası, FrmMainForm.RibbonControl üzerindeki tüm sayfa/grup/düğmeleri çalışma anında dolaşarak üretilir; GrpInfo grubu hariç tutulur [SOURCE_CODE:FrmAddUserGroup.vb:63-79]. Yeni bir menü düğmesi eklendiğinde eski gruplarda o düğme kapalı kalır (Visible=False varsayılan).
• Kayıtlı grup açıldığında ızgaradaki Visible işaretleri, çözülen dizedeki Sayfa;Grup;Düğme anahtarlarıyla eşleştirilerek doldurulur; ribbon etiketi Türkçe karakterden arındırılarak (Ceng) karşılaştırılır [SOURCE_CODE:FrmAddUserGroup.vb:35-46].
• Şirket bağı Program.SirketId ile otomatik yazılır (SirketId).

Stok / bakiye / rapor etkisi

Defter etkisi yok — tanım ekranı. Yalnız Sistem.UserGroup güncellenir; işlem, bakiye veya stok defterine dokunmaz.

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

• Yetki verildi ama ekran hâlâ görünmüyor: kullanıcı yeniden giriş yapmamıştır (yetkiler girişte yüklenir) [DOCUMENT:06_Workflows/WF-KULLANICI-GRUBU-YETKI.md] [DOCUMENT:12_Support/Playbooks/PB-041.md].
• Bazı işlem ekranları (TAKOZ, EMTİA, ÇEŞNİ vb.) menüde yok veya düzeltmeye açılmıyor: grup kutusu işaretsiz [DOCUMENT:12_Support/KnownIssues/H-012.md].
• "İşlem Düzeltme Yetkiniz Yok." / "İşlem İptal Etme Yetkiniz Yok.": İşlem Düzelt / İşlem İptal kutuları kapalı [DOCUMENT:12_Support/KnownIssues/H-011.md].
• Aifa Developer Studio sekmesi görünmüyor: ızgarada o sayfanın düğmeleri Visible değil [DOCUMENT:12_Support/KnownIssues/H-019.md].
• Pesin Kontrolu açık bir kullanıcı fiş yazdıramıyor ("İşlemin Karşılığı Bulunamadı…"): fiş toplamı sıfıra kapanmamış [DOCUMENT:12_Support/Playbooks/PB-064.md].

İlgili ticket temaları

• PRB-TANIMLAMA-000 — tanımlama / yetki teması; belirti zinciri SYM-TANIMLAMA.
• Playbook: PB-041 (yetki sorunları).

Müşteri varyasyonları

Bilinen fark yok. Grup adları ve yetki setleri müşteri kurulumuna göre değişir (Sistem.UserGroup V2 örnek DB'de 15 satır) [DOCUMENT:kitap#6.3 Sistem.UserGroup]; yeni şirket kurulumunda Sistem.SirketOlustur varsayılan bir admin grubu ekler [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#6].

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

• ANA MENÜ ▸ Tanımlamalar ▸ Sistem Tanimlari ▸ Kullanıcı Grupları
• Liste ekranındaki Ekle/Düzenle: AIO.Sistem.Usergroup.FormEditBase → bu form

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

ACTIVE_CRITICAL — ANA MENÜ: Tanımlamalar ▸ Sistem Tanimlari ▸ Kullanıcı Grupları; DAO FormEditBase hedefi: AIO.Sistem.Usergroup

Alanlar → veritabanı

Kullanıcı olayları

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

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

AIO.Sistem.Usergroup

Bilinen kusurlar / dikkat

• Kayıtlı kusur yok.

Kaynaklar

• SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.Designer.vb
• SOURCE_CODE:ERPPRO/Form/Users/FrmAddUserGroup.vb
• DERIVED:docs/knowledge-base/screens/FrmAddUserGroup.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).