🏢 Enterprise B2B SaaS ERP System 🚀

Modern, ölçeklenebilir ve yüksek performanslı Kurumsal ERP (Kurumsal Kaynak Planlama) projesi. Bu sistem; üretim yapan fabrikalar, depolar ve şirketler için SAP/Oracle standartlarında, Multi-Tenant (Çok Kiracılı) mimariyle sıfırdan inşa edilmiştir.

✨ Temel Özellikler

Sistem, işletmelerin tüm operasyonel süreçlerini tek bir çatı altında toplamayı hedefler:

• 🛡️ Multi-Tenant & RBAC: Verilerin şirket/departman bazında izole edildiği çok kiracılı mimari. Admin, Muhasebe, Üretim Lideri ve Depo Sorumlusu gibi Rol Bazlı Yetkilendirme (RBAC) ile katı güvenlik duvarları.
• 👥 Personel (HR) Yönetimi: Sisteme yeni personellerin eklenmesi, yetki profillerinin ayarlanması ve güvenli JWT tabanlı oturum yönetimi.
• 📊 Gelişmiş Dashboard: Recharts destekli gerçek zamanlı KPI'lar. 7 aylık gelir/gider analizleri, üretim performans grafikleri ve sistem sağlık durumu (PostgreSQL, MinIO, FastAPI durumları).
• 📦 Envanter ve Depo: Hammadde ve Mamul sınıflandırması. Anlık stok takibi, birim maliyet analizleri ve kritik stok uyarı mekanizması.
• ⚙️ Üretim ve İş Emirleri: Üretim Reçetesi (BOM - Bill of Materials) tabanlı dinamik stok düşümü. İş emri başlatıldığında hammaddelerin tüketilip, tamamlandığında mamul stoğunun otomatik artırılması.
• 💳 Finans ve Faturalandırma: Satınalma ve satış faturalarının genel mizan ve kasa ile asenkron entegrasyonu.

🛠️ Teknoloji Yığını (Tech Stack)

Frontend (İstemci):

• Framework: Next.js 16 (App Router, Turbopack)
• UI/UX: Tailwind CSS & Shadcn UI (Ultra-dense kurumsal tasarım dili)
• Veri Yönetimi: Axios (Global Interceptor & Error Handling)
• Görselleştirme: Recharts

Backend (Sunucu):

• Framework: FastAPI (Python, Asenkron)
• Veritabanı: PostgreSQL
• ORM & Migrations: SQLAlchemy (Async) & Alembic
• Veri Doğrulama: Pydantic v2
• Güvenlik: JWT Authentication, Bcrypt Hashing

🚀 Kurulum ve Çalıştırma

Proje %100 Dockerize edilmiştir. Bilgisayarınızda sadece Docker ve Docker Compose yüklü olması yeterlidir.

1. Projeyi Klonlayın

git clone [https://github.com/halilbsp/ERP-SYSTEM.git](https://github.com/halilbsp/ERP-SYSTEM.git)
cd ERP-SYSTEM

2. Çevresel Değişkenleri (ENV) Ayarlayın

Ana dizinde .env dosyası oluşturun ve gizli anahtarlarınızı tanımlayın (Örnek şablon .env.example içinde mevcuttur).

3. Sistemi Ayağa Kaldırın

docker-compose up -d --build

Bu komut veritabanını, backend'i ve frontend'i izole network içinde otomatik olarak birbirine bağlayarak başlatır.

4. İlk Giriş (Seeder)

Sistem ilk kez ayağa kalktığında veritabanı boşsa, otonom seeder devreye girer ve default bir Admin hesabı oluşturur:

• Email: admin@erp.local
• Şifre: admin123

Sisteme http://localhost:3000 üzerinden erişebilirsiniz.

---

Bu proje, endüstri standartlarında yüksek veri tutarlılığı ve kesintisiz operasyon hedefiyle modern yazılım mühendisliği prensipleri kullanılarak geliştirilmiştir. 🏭💻