===========================================================
ANIMAL RESCUE MANAGEMENT ECOSYSTEM - cPanel QURAŞDIRMA
===========================================================

1) VERİLƏNLƏR BAZASI YARADIN
   - cPanel > MySQL Databases > yeni DB yaradın (məs: cpaneluser_arms)
   - Eyni yerdə DB istifadəçisi yaradın, şifrə verin
   - Bu istifadəçini DB-yə "All Privileges" ilə əlavə edin

2) FAYLLARI YÜKLƏYİN
   - Bu ZIP-i cPanel > File Manager > public_html (və ya subdomain qovluğu) içinə yükləyin
   - ZIP-i həmin qovluqda "Extract" edin

3) CONFIG DOLDURUN
   - includes/config.php faylını açın
   - DB_NAME, DB_USER, DB_PASS sahələrini addım 1-də yaratdığınız məlumatlarla doldurun

4) QURAŞDIRMANI İŞƏ SALIN
   - Brauzerdə saytınıza gedin: https://saytiniz.com/install.php
   - Super Admin adı, e-poçtu və şifrəsini daxil edin, "Quraşdırmanı işə sal" düyməsini basın
   - Bu addım BÜTÜN CƏDVƏLLƏRİ (34 modul) avtomatik yaradacaq

5) TƏHLÜKƏSİZLİK - VACİB!
   - install.php işlədikdən SONRA bu faylı serverdən silin (File Manager ilə)
   - schema.sql faylını da silə bilərsiniz (artıq lazım deyil)

6) DAXİL OLUN
   - https://saytiniz.com/login.php ünvanına gedin
   - install.php-də verdiyiniz e-poçt/şifrə ilə daxil olun
   - Super Admin bütün 34 modula giriş əldə edir

===========================================================
MODULLAR VƏ ROLLAR
===========================================================
Sistem 9 rol dəstəkləyir: citizen, volunteer, vet, shelter, ngo,
municipality, moderator, admin, super_admin.

Hər modul yalnız müvafiq rollara görünür (məs. "Baytarlar" modulu
yalnız vet/moderator/admin rollarına açıqdır). Yeni istifadəçi
qeydiyyat zamanı (register.php) rolunu seçir; admin panelindən
(users cədvəli, hazırda birbaşa phpMyAdmin ilə) rolları dəyişmək olar.

===========================================================
NƏLƏR REAL İŞLƏYİR
===========================================================
✅ Qeydiyyat/Giriş, rol-əsaslı giriş nəzarəti (RBAC)
✅ Bütün 34 modul üçün real CRUD (əlavə et/redaktə et/sil/siyahı)
   verilənlər bazasına bağlı
✅ Fayl yükləmə (foto/sənəd) hər modulda
✅ Dashboard - canlı statistika (SQL sorğuları ilə)
✅ Audit logging (kim, nə vaxt, nə etdi)
✅ CSRF qorunması, bcrypt şifrə hash-lənməsi

===========================================================
NƏLƏR "SADƏLƏŞDİRİLMİŞ" MODELDƏ TƏQDİM OLUNUB
===========================================================
⚠ "AI injury detection", "AI matching", "AI Copilot", "AI Dispatch"
  modulları hazırda MƏLUMAT STRUKTURU + MANUAL DAXİLETMƏ formasındadır
  (nəticəni admin/vet əl ilə yazır). Əsl computer-vision AI inteqrasiyası
  üçün xarici API (məs. Google Vision, OpenAI Vision) qoşulmalıdır -
  bu, ayrı API açarı və əlavə kodlaşdırma tələb edir.
⚠ Canlı Xəritə modulu lat/lng sahələrini saxlayır, lakin xəritə
  vizuallaşdırması üçün Google Maps API açarınızı əlavə etməlisiniz
  (pulsuz deyil, Google-dan alınır).
⚠ Ödəniş (Stripe) inteqrasiyası hazırda "manual qeyd" formasındadır -
  real kart ödənişi üçün Stripe API açarları ilə əlaqələndirmə lazımdır.

===========================================================
GENİŞLƏNDİRMƏ
===========================================================
Yeni sahə/modul əlavə etmək üçün:
1. schema.sql-ə yeni CREATE TABLE əlavə edin
2. includes/modules_config.php-ə modulun tərifini əlavə edin
Bu qədər - sistem avtomatik CRUD interfeysini yaradacaq.
