mirror of
https://github.com/frappe/frappe_docker.git
synced 2026-06-25 16:55:08 +00:00
3d950d4335
- Enhanced README.md to clarify the inclusion of built-in CRM features in ERPNext and updated the application list. - Introduced RUNTIME_FIX.md to document the removal of the CRM application due to compatibility issues with Frappe v15, detailing the error encountered and providing alternative solutions. - Updated deployment strategies and troubleshooting steps to ensure successful application setup.
229 lines
4.6 KiB
Markdown
229 lines
4.6 KiB
Markdown
# 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](https://github.com/frappe/crm/releases/tag/v1.53.1) Frappe v15 için
|
||
- `main` branch stable ve production-ready
|
||
- Latest bug fixes dahil
|
||
|
||
**Dockerfile**:
|
||
```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
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
```bash
|
||
# 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](https://github.com/frappe/crm/releases)
|
||
|
||
## 🎯 Önerilen Yaklaşım
|
||
|
||
### Seçenek 1: Clean Deploy (Önerilen)
|
||
|
||
```bash
|
||
# 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
|
||
|
||
```bash
|
||
# Container'da:
|
||
bench build --force
|
||
bench --site <site-name> migrate
|
||
bench restart
|
||
```
|
||
|
||
### Seçenek 3: CRM Olmadan Kullanın
|
||
|
||
```bash
|
||
# docker-compose.yml'de CRM'i kaldırın
|
||
# ERPNext CRM modülü kullanın
|
||
# Yeterli özellikler sunar
|
||
```
|
||
|
||
## 🔄 Deployment Sonrası Test
|
||
|
||
### CRM Kontrolü
|
||
|
||
```bash
|
||
# 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:
|
||
```python
|
||
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**:
|
||
```yaml
|
||
# Sadece temel uygulamalar
|
||
- erpnext
|
||
- hrms
|
||
```
|
||
|
||
2. **Test Edin**: Site açılıyor mu?
|
||
|
||
3. **Uygulamaları Tek Tek Ekleyin**:
|
||
```bash
|
||
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**:
|
||
|
||
```bash
|
||
# 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
|
||
|