frappe_docker/dokploy/SUMMARY.md

Frappe ERPNext - Dokploy Kurulum Özeti

📦 Paket İçeriği

Bu Dokploy paketi, Frappe ERPNext'i ve 8 ek uygulamayı tek seferde deploy etmenizi sağlar.

İçerilen Uygulamalar (Minimal Setup)

Uygulama	Açıklama	Branch/Tag
ERPNext	Tam özellikli ERP (Accounting, Inventory, Sales, Manufacturing)	version-15
HRMS	İnsan Kaynakları Yönetimi (Payroll, Leave, Attendance)	version-15
CRM	Müşteri İlişkileri Yönetimi (Lead, Deal, Contact)	main (v1.53.1)
Helpdesk	Müşteri Destek Sistemi (Ticket, SLA, Knowledge Base)	v1.14.0
Payments	Ödeme Gateway Entegrasyonları (Stripe, PayPal, Razorpay)	main

Toplam: 5 Production-Ready Uygulama

Avantajlar:

• 🚀 Hızlı build (~15-20 dakika)
• 💾 Az disk kullanımı (~4-5 GB)
• ✅ Tüm core özellikler dahil
• ✅ Frappe v15 tam uyumlu

🏗️ Mimari

┌─────────────────────────────────────────┐
│           Dokploy Platform              │
└─────────────────┬───────────────────────┘
                  │
    ┌─────────────┴─────────────┐
    │    Docker Compose         │
    └─────────────┬─────────────┘
                  │
    ┌─────────────┴─────────────────────────┐
    │                                       │
    ▼                                       ▼
┌───────────┐                      ┌────────────┐
│  Frontend │                      │   Backend  │
│  (Nginx)  │◄─────────────────────┤ (Gunicorn) │
└─────┬─────┘                      └──────┬─────┘
      │                                   │
      │         ┌─────────────────────────┤
      │         │                         │
      ▼         ▼                         ▼
┌──────────┐ ┌──────────┐         ┌─────────────┐
│WebSocket │ │  Workers │         │  Scheduler  │
│  (Node)  │ │ (Short)  │         │   (Cron)    │
└────┬─────┘ └────┬─────┘         └──────┬──────┘
     │            │                      │
     │            └──────────┬───────────┘
     │                       │
     ▼                       ▼
┌─────────────┐      ┌──────────────┐
│   Redis     │      │   MariaDB    │
│   Cache     │      │  Database    │
└─────────────┘      └──────────────┘

📋 Dosya Yapısı

dokploy/
├── apps.json                 # Kurulacak uygulamaların listesi
├── Dockerfile               # Özel Frappe ERPNext image tanımı
├── docker-compose.yml       # Development/local kullanım için
├── docker-compose.prod.yml  # Production için optimize edilmiş
├── .env                     # Environment variables (kopyalanacak)
├── .dockerignore           # Docker build için ignore dosyası
├── dokploy.json            # Dokploy metadata
├── install.sh              # Otomatik kurulum scripti
├── README.md               # Ana dokümantasyon
├── QUICKSTART.md           # Hızlı başlangıç kılavuzu
├── DEPLOYMENT.md           # Detaylı deployment kılavuzu
└── SUMMARY.md              # Bu dosya

🚀 Hızlı Başlangıç

1 Dakikada Deploy

# Dokploy Dashboard → New Project → Docker Compose
Repository: https://github.com/ubden/frappe_docker
Branch: main
Compose Path: dokploy/docker-compose.yml

# Environment Variables ekle:
SITE_NAME=erp.yourdomain.com
ADMIN_PASSWORD=your_secure_password
DB_PASSWORD=your_db_password

# Deploy butonuna tıkla!

Detaylı bilgi: QUICKSTART.md

⚙️ Konfigürasyon

Temel Ayarlar

Variable	Varsayılan	Açıklama
SITE_NAME	site1.localhost	Site domain adı
ADMIN_PASSWORD	admin	Administrator şifresi
DB_PASSWORD	changeit	MariaDB root şifresi
HTTP_PORT	80	HTTP port

Gelişmiş Ayarlar

Variable	Varsayılan	Açıklama
CLIENT_MAX_BODY_SIZE	50m	Maksimum upload boyutu
PROXY_READ_TIMEOUT	120	Proxy timeout (saniye)
FRAPPE_SITE_NAME_HEADER	$$host	Site resolution header

🔧 Servisler

Core Services

• frontend: Nginx reverse proxy (Port 8080)
• backend: Gunicorn application server
• websocket: Socket.IO server (real-time)

Data Services

• mariadb: MariaDB 10.6 (utf8mb4)
• redis-cache: Redis cache layer
• redis-queue: Redis job queue

Worker Services

• queue-short: Kısa süreli işler
• queue-long: Uzun süreli işler
• scheduler: Zamanlanmış görevler

Setup Services (One-time)

• configurator: İlk konfigürasyon
• create-site: Site oluşturma

💾 Volumes (Veri Depolama)

volumes:
  mariadb-data:      # Database verileri
  redis-cache-data:  # Redis cache
  redis-queue-data:  # Redis queue
  sites:             # Frappe sites ve dosyalar
  logs:              # Application logs

⚠️ ÖNEMLİ: Bu volume'ları silmeden önce mutlaka backup alın!

🔒 Güvenlik

Önerilen Güvenlik Ayarları

1. Güçlü Şifreler

   Min 12 karakter
   Büyük/küçük harf + sayı + özel karakter
   

2. HTTPS/SSL

   • Dokploy otomatik Let's Encrypt
   • Domain ekle + "Enable HTTPS"

3. Firewall

   Açık portlar: 80, 443
   SSH: Sadece güvenli IP'ler
   

4. 2FA (Two-Factor Authentication)

   • User ayarlarından aktif edin
   • TOTP app kullanın (Google Authenticator vb.)

5. Düzenli Backup

   • Günlük otomatik backup
   • Off-site backup storage

📊 Sistem Gereksinimleri

Minimum (Test/Development)

CPU:  2 cores
RAM:  4GB
Disk: 20GB

Önerilen (Production)

CPU:  4+ cores
RAM:  8GB+
Disk: 50GB+ SSD

Optimal (Enterprise)

CPU:  8+ cores
RAM:  16GB+
Disk: 100GB+ NVMe SSD

📈 Performans Ayarları

MariaDB Optimizasyonu

innodb-buffer-pool-size: 4G  # RAM'in %50-75'i
max-connections: 1000
innodb-log-file-size: 1G

Gunicorn Workers

workers = CPU_count × 2
threads = 8
timeout = 300

Redis Memory

redis-cache:  2GB (LRU eviction)
redis-queue:  1GB (No eviction)

🛠️ Maintenance

Güncellemeler

# Dokploy'da: Redeploy butonu

# Manuel:
docker exec <backend> bench update --reset
docker exec <backend> bench migrate
docker exec <backend> bench build

Backup

# Otomatik (Cron)
0 2 * * * docker exec <backend> bench --site <site> backup --with-files

# Manuel
docker exec <backend> bench --site <site> backup --with-files

Monitoring

# Container durumu
docker-compose ps

# Loglar
docker-compose logs -f [service-name]

# Resource kullanımı
docker stats

🐛 Yaygın Sorunlar

Sorun	Çözüm
Site açılmıyor	Browser cache temizle, container loglarını kontrol et
"Site not found"	docker-compose up create-site çalıştır
Yavaş çalışıyor	Worker/buffer pool ayarlarını artır
DB bağlantı hatası	MariaDB container'ın healthy olduğunu kontrol et

Detaylı sorun giderme: DEPLOYMENT.md#troubleshooting

📚 Dokümantasyon

• 🚀 Hızlı Başlangıç - 5 dakikada deploy
• 📖 Deployment Kılavuzu - Detaylı adımlar
• 📝 Ana README - Genel bilgiler
• 🌐 Frappe Docs - Framework dokümantasyonu
• 📘 ERPNext Docs - Uygulama dokümantasyonu

🎯 Kullanım Senaryoları

1. Küçük İşletme

✓ Muhasebe ve Finans (ERPNext)
✓ Müşteri Yönetimi (CRM)
✓ Web Sitesi (Builder)
✓ Bilgi Tabanı (Wiki)

2. E-Ticaret

✓ Ürün/Stok Yönetimi (ERPNext)
✓ Kargo Entegrasyonu (Shipping)
✓ Ödeme İşlemleri (Payments)
✓ Müşteri İletişimi (CRM + Twilio)

3. Eğitim Kurumu

✓ Online Kurslar (LMS)
✓ Öğrenci Yönetimi (ERPNext)
✓ Dökümanlar (Wiki)
✓ Web Sitesi (Builder)

4. Hizmet Şirketi

✓ Proje Yönetimi (ERPNext)
✓ CRM (Müşteri Takibi)
✓ Faturalandırma (ERPNext)
✓ SMS Bildirimleri (Twilio)

🔄 Versiyon Bilgisi

• Frappe Framework: v15
• ERPNext: v15
• Python: 3.11.6
• Node.js: 20.19.2
• MariaDB: 10.6
• Redis: 7
• Nginx: Latest (Debian Bookworm)

🤝 Destek

Community Support

• 💬 Frappe Forum
• 💭 GitHub Discussions

Issues & Bugs

• 🐛 GitHub Issues

Commercial Support

• 📧 Frappe Cloud - Managed hosting
• 🏢 Frappe Technologies - Enterprise support

📄 Lisans

Bu proje ve içerdiği uygulamalar çeşitli açık kaynak lisansları altında sunulmaktadır:

• Frappe Framework: MIT License
• ERPNext: GNU GPLv3
• Diğer Uygulamalar: İlgili repository'lerindeki lisanslar

Detaylar için: LICENSE

🙏 Teşekkürler

Bu proje şu harika açık kaynak projelere dayanmaktadır:

• Frappe
• ERPNext
• Frappe Docker
• Dokploy

---

Son Güncelleme: 2025-10-13
Versiyon: 1.0.0
Maintainer: @ubden