---
type: varlik
baslik: Veritabanı Şeması (genel görünüm)
kategori: sistem
olusturuldu: 2026-05-06
guncellendi: 2026-05-06
etiketler: [proje/gisk, db, sema]
---

# Veritabanı Şeması

GİSK Yönetim Paneli için tüm tabloların hub'ı. Her tablo `db-{ad}.md` sayfasında detaylandırılır.

## Bağlam

- **Üretim:** MariaDB (cPanel) — `gskorg_pangisk.sql`
- **Geliştirme:** SQLite (config'e göre seçilir) — `001_initial_schema.sql`, `002_antrenor_qr_pasif.sql`
- **Charset:** `utf8mb4_uca1400_ai_ci`
- Tüm tablolar `id INT AUTO_INCREMENT PK` (junction tablolar hariç)
- FK on delete: çoğunlukla `CASCADE`

## Tablolar (kategoriye göre)

### Çekirdek / Yönetim
- [[db-kullanicilar]] — panel kullanıcıları (yönetici / kullanıcı)
- [[db-kulup_ayarlar]] — tek satır kulüp config (id=1, koordinat, aidat tutarları)
- [[db-belge_turleri]] — yüklenebilir belge türü kataloğu

### Oyuncular
- [[db-oyuncular]] — oyuncu ana tablosu
- [[db-oyuncu_gruplar]] — antrenman grupları (oyuncu+antrenör paylaşır)
- [[db-oyuncu_grup_atama]] — junction
- [[db-oyuncu_veliler]] — veli/yakın bilgileri
- [[db-oyuncu_beyanlar]] — sağlık/sorumluluk beyanları (IP/UA loglu)
- [[db-oyuncu_belgeler]] — yüklenmiş oyuncu evrakları

### Antrenörler ⭐ (yeni — 002 migration)
- [[db-antrenorler]] — antrenör ana tablosu
- [[db-antrenor_grup_atama]] — junction (oyuncu_gruplar paylaşılır)
- [[db-antrenor_belgeler]] — yüklenmiş antrenör evrakları

### Devam (yoklama)
- [[db-devam_kayitlari]] — günlük yoklama (var/yok/gec/mazeret)
- [[db-devam_paylasimlar]] — public yoklama linkleri
- [[db-devam_paylasim_gruplar]] — paylaşım ↔ grup junction

### Aidat & Kasa
- [[db-aidat_borclar]] — aylık borç kayıtları (oyuncu_id, yil, ay UNIQUE)
- [[db-aidat_tahsilatlar]] — yapılan ödemeler (kasa_hareketler.id ile bağlı)
- [[db-kasa_hareketler]] — gelir/gider hareketleri
- [[db-kasa_kategoriler]] — gelir/gider kategorileri

### Veli Portali
- [[db-veli_sifre_tokens]] — şifre sıfırlama tokenları

### QR Yoklama ⭐ (yeni — 002 migration)
- [[db-qr_kodlar]] — oluşturulmuş QR kod token'ları
- [[db-qr_giris_cikis]] — QR ile giriş/çıkış kayıtları

## İlgili Kavramlar

- [[../kavramlar/aidat-uretim-kurali]] _(henüz yok — ihtiyaca göre yazılacak)_
- [[../kavramlar/qr-yoklama-akisi]] _(henüz yok — ihtiyaca göre yazılacak)_
- [[../kavramlar/pasif-oyuncu-kurali]] _(henüz yok — ihtiyaca göre yazılacak)_

## Migrations

| Dosya | İçerik |
|---|---|
| `database/migrations/001_initial_schema.sql` | Ana şema (SQLite) |
| `database/migrations/002_antrenor_qr_pasif.sql` | Antrenör + QR + pasif_tarihi (SQLite) |
| `database/migrations/002_antrenor_qr_pasif.mysql.sql` | Aynısı (MariaDB) |
| `gskorg_pangisk.sql` | Üretim dump'ı (MariaDB) — antrenör/QR yok |
