frappe_docker/dokploy/CRM_ERROR_ANALYSIS.md

CRM Hatası Analizi ve Çözüm

🐛 Tespit Edilen Hata

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

🔍 Hata Analizi

Muhtemel Sebepler

1. Build Cache Sorunu

   • Eski build cache'i kullanılmış olabilir
   • CRM yüklenirken dependency hatası

2. Bench Build Eksikliği

   • Frontend assets build edilmemiş olabilir
   • bench build çalıştırılmamış

3. Module Import Path

   • CRM'in import path'i güncellenmemiş olabilir
   • Frappe v15/v16 compatibility katmanı eksik

✅ Uygulanan Çözüm

CRM Geri Eklendi (main branch)

Neden main branch?

• v1.53.1 Release Frappe v15 için
• main branch stable ve production-ready
• Latest bug fixes dahil

Dockerfile:

# CRM - main branch (v15 compatible, latest stable v1.53.1)
bench get-app --branch=main crm https://github.com/frappe/crm

🔧 Sorun Giderme Adımları

Adım 1: Clean Build

# Dokploy'da yeniden deploy
1. Service → Settings → Delete
2. Yeniden oluştur
3. Build cache temizlenerek yeniden build edilecek

Adım 2: Manuel Build (Container içinde)

Eğer hata devam ederse:

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

# Bench build çalıştırın
cd /home/frappe/frappe-bench
bench build --app frappe
bench build --app crm

# Site'ı restart edin
bench restart

# Cache temizleyin
bench --site <site-name> clear-cache
bench --site <site-name> clear-website-cache

Adım 3: CRM'i Yeniden Kurun

Eğer sorun devam ederse:

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

# CRM'i kaldırın
bench --site <site-name> uninstall-app crm

# Apps klasöründen silin
rm -rf apps/crm

# Yeniden yükleyin
bench get-app --branch=main crm https://github.com/frappe/crm

# Build edin
bench build --app crm

# Yeniden kurun
bench --site <site-name> install-app crm

# Migrate edin
bench --site <site-name> migrate

Adım 4: Alternatif - CRM Olmadan Kullanın

ERPNext'in built-in CRM özellikleri ile devam edin:

ERPNext → Selling Module:
- Lead Management
- Opportunity
- Customer
- Contact
- Communication
- Sales Pipeline

📊 CRM Compatibility Matrix

CRM Version	Frappe Version	Branch	Durum
v1.x (v1.53.1)	v15	main	✅ Compatible
v2.x (future)	v16	develop	❌ Not compatible with v15

Kaynak: CRM Releases

🎯 Önerilen Yaklaşım

Seçenek 1: Clean Deploy (Önerilen)

# Dokploy'da:
1. Current deployment'ı silin
2. Yeni deployment oluşturun
3. Build cache temiz olacak
4. CRM main branch ile build edilecek
5. Sorun çözülmeli ✅

Seçenek 2: Manuel Fix

# Container'da:
bench build --force
bench --site <site-name> migrate
bench restart

Seçenek 3: CRM Olmadan Kullanın

# docker-compose.yml'de CRM'i kaldırın
# ERPNext CRM modülü kullanın
# Yeterli özellikler sunar

🔄 Deployment Sonrası Test

CRM Kontrolü

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

# 2. CRM kurulu mu?
bench --site <site-name> list-apps | grep crm

# 3. CRM sayfasını açın
# Browser: https://erp.ubden.com/crm

# 4. Eğer açılmazsa:
bench --site <site-name> console

Python console'da:

import frappe
frappe.init(site='<site-name>')
frappe.connect()

# CRM'i test et
from crm.api import *
# Eğer import hatası yoksa CRM çalışıyor ✅

📝 Deployment Önerileri

İlk Deployment

1. Minimal Setup ile Başlayın:

   # Sadece temel uygulamalar
   - erpnext
   - hrms
   

2. Test Edin: Site açılıyor mu?

3. Uygulamaları Tek Tek Ekleyin:

   bench --site <site> install-app crm
   bench --site <site> install-app helpdesk
   # vb...
   

4. Her Adımda Test Edin: Hangi app sorun çıkarıyor?

Production Deployment

1. Clean Build: Her zaman temiz build
2. Test Environment: Önce staging'de test
3. Backup: Her işlemden önce backup
4. Monitor: Logs'ları sürekli izleyin

💡 Çözüm Önerisi

Sizin durumunuz için en iyi çözüm:

# Dokploy'da yeniden deploy edin
# Build cache temizlenecek
# CRM main branch ile doğru kurulacak
# Hata düzelecek ✅

Sebep: İlk deployment'ta build cache veya timing sorunu olmuş olabilir.

---

Son Güncelleme: 2025-10-13
CRM Version: v1.53.1 (Frappe v15 uyumlu)
Durum: CRM tekrar eklendi, yeniden deployment önerilir