frappe_docker/dokploy/RUNTIME_FIX.md

✅ Runtime Hatası Çözüldü!

🐛 Tespit Edilen Sorun

ModuleNotFoundError: CRM App Uyumsuzluğu

Hata:

ModuleNotFoundError: No module named 'frappe.utils.modules'
Possible source of error: crm (app)

Sebep:

• CRM uygulaması Frappe v16 için geliştirilmiş
• frappe.utils.modules modülü Frappe v16'da tanıtılmış
• Frappe v15'te bu modül yok
• CRM'in develop branch'i v16 gereksinimi var

✅ Uygulanan Çözüm

CRM Uygulaması Kaldırıldı

Dockerfile'dan kaldırıldı:

# CRM - KALDIRILDI (Frappe v16 gereksinimi)
# bench get-app --branch=develop crm https://github.com/frappe/crm

apps.json'dan kaldırıldı:

// CRM kaldırıldı

docker-compose.yml'den kaldırıldı:

# --install-app crm kaldırıldı
bench new-site ... --install-app erpnext --install-app hrms --install-app helpdesk ...

📦 Güncel Uygulama Listesi

8 Uyguşlama (Tümü Frappe v15 Uyumlu)

1. ✅ ERPNext (version-15) - ERP Core
2. ✅ HRMS (version-15) - İnsan Kaynakları
3. ✅ Helpdesk (main) - Müşteri Destek Sistemi
4. ✅ LMS (main) - E-Learning Platformu
5. ✅ Builder (main) - Web Sitesi Oluşturucu
6. ✅ Print Designer (main) - Yazdırma Şablonları
7. ✅ Payments (main) - Ödeme Entegrasyonları
8. ✅ Wiki (main) - Bilgi Tabanı

❌ Kaldırılan Uygulamalar

Uygulama	Sebep	Alternatif
CRM	Frappe v16 gereksinimi (frappe.utils.modules)	ERPNext'in built-in CRM özellikleri
Twilio Integration	version-15 branch yok	ERPNext SMS özellikleri
ERPNext Shipping	Dependency çakışmaları	ERPNext shipping özellikleri

🔧 CRM Alternatifi: ERPNext CRM Modülü

ERPNext zaten güçlü CRM özellikleri içerir:

ERPNext'te Bulunan CRM Özellikleri

• ✅ Lead Management - Potansiyel müşteri takibi
• ✅ Opportunity - Fırsat yönetimi
• ✅ Customer - Müşteri veritabanı
• ✅ Contact - İletişim yönetimi
• ✅ Address - Adres yönetimi
• ✅ Communication - Email/SMS entegrasyonu
• ✅ Activity Log - Aktivite takibi
• ✅ Sales Pipeline - Satış hunisi

ERPNext CRM Kullanımı

ERPNext → Selling Module → CRM Features

1. Lead → Opportunity → Quotation → Sales Order
2. Customer management
3. Contact database
4. Communication tracking
5. Sales analytics

🚀 Manuel CRM Kurulumu (İsteğe Bağlı - RİSKLİ)

Eğer Frappe CRM'i mutlaka kullanmak isterseniz (önerilmez):

Seçenek 1: Frappe v16'ya Yükseltme (Büyük İş)

# Tüm sistemi v16'ya yükseltmek gerekir
# ÖNERİLMEZ - Major breaking changes

Seçenek 2: Eski CRM Versiyonu (Deneysel)

# Container'a girin
docker exec -it <backend-container> bash

# Eski bir commit'i kullanmayı deneyin
bench get-app --branch=main crm https://github.com/frappe/crm
# Veya specific commit:
cd apps
git clone https://github.com/frappe/crm
cd crm
git checkout <v15-uyumlu-commit-hash>
cd ../..

# Site'a kurun
bench --site <site-name> install-app crm

# ⚠️ UYARI: Çalışma garantisi yok!

📊 Test Deployment Sonuçları

✅ Başarılı Deployment

Container configurator → Exited (success)
Container create-site → Exited (success)
Container backend → Started
Container frontend → Started
Container websocket → Started
Container workers → Started
Container scheduler → Started

❌ Runtime Hatası

CRM app → ModuleNotFoundError
Frappe v15 ile uyumsuz

✅ Çözüm

CRM kaldırıldı → Sistem çalışıyor
ERPNext CRM modülü kullanılabilir

🎯 Önerilen Deployment Stratejisi

Senaryo 1: ERPNext CRM Kullan (Önerilen)

✅ Stable Frappe v15
✅ 8 production-ready app
✅ ERPNext'in güçlü CRM özellikleri
✅ Tam entegrasyon

Senaryo 2: Frappe CRM İstiyor (Gelecek)

1. Frappe v16'ya geç (büyük upgrade)
2. Tüm uygulamaları v16'ya yükselt
3. CRM'i tekrar ekle
⚠️ Breaking changes olabilir

🔄 Güncel Dockerfile

# 8 Frappe v15 uyumlu uygulama
ERPNext ✅
HRMS ✅
Helpdesk ✅
LMS ✅
Builder ✅
Print Designer ✅
Payments ✅
Wiki ✅

# Kaldırıldı (uyumsuz)
CRM ❌ (v16 gereksinimi)

📝 Deployment Sonrası Adımlar

1. Container Loglarını Kontrol

# Backend loglarında hata olmamalı
docker logs <backend-container>

# Create-site başarılı mı?
docker logs <create-site-container>

2. Site'a Erişim

# Browser'da aç
https://erp.ubden.com

# Giriş
Username: Administrator
Password: [ADMIN_PASSWORD]

3. Kurulu Uygulamaları Doğrula

# Container'a gir
docker exec -it <backend-container> bash

# Uygulamaları listele
bench --site <site-name> list-apps

# Beklenen çıktı:
frappe
erpnext
hrms
helpdesk
lms
builder
print_designer
payments
wiki

🎉 Sonuç

Deployment Başarılı! 🚀

• ✅ 8 Production-ready uygulama
• ✅ Frappe v15 tam uyumlu
• ✅ Runtime hatası yok
• ✅ Tüm servisler çalışıyor
• ✅ ERPNext CRM özellikleri mevcut

CRM İhtiyacı: ERPNext'in built-in CRM modülü yeterli ve güçlü!

---

Son Güncelleme: 2025-10-13
Versiyon: 1.0.0
Durum: ✅ Deployed & Working
Toplam App: 8 (CRM hariç, ERPNext CRM modülü ile)