Helpdesk Ticket Stage Change History
by Coflow Teknoloji https://coflow.com.tr , Ali Zeynel AĞÇA https://coflow.com.tr$ 17.35
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Helpdesk (helpdesk)
• Discuss (mail) |
| Lines of code | 179 |
| Technical Name |
helpdesk_stage_change_history_17 |
| License | LGPL-3 |
| Website | https://coflow.com.tr |
| Versions | 15.0 16.0 17.0 18.0 |
🎫 Yardım Masası Aşama Geçiş Geçmişi
Odoo 15.0 için Gelişmiş Aşama Takip ve Analiz Modülü
📋 Genel Bakış
Yardım Masası Aşama Geçiş Geçmişi, Odoo yardım masası biletlerinin her aşama değişikliğini otomatik olarak izleyen ve kaydeden güçlü bir modüldür. Biletlerin her aşamada ne kadar süre kaldığını izleyerek iş akışınızdaki darboğazları tespit etmenize ve süreçlerinizi optimize etmenize yardımcı olur.
🎯 Neden Bu Modül?
Yardım masası ekipleri, biletlerin hangi aşamalarda ne kadar süre kaldığını bilmek ister. Bu bilgi, süreç iyileştirmeleri, ekip performansı analizi ve SLA uyumluluğu için kritik öneme sahiptir. Bu modül, tüm bu verileri otomatik olarak toplar ve analiz için hazır hale getirir.
⭐ Temel Özellikler
💼 Kullanım Senaryoları
Biletlerin en çok hangi aşamalarda zaman harcadığını tespit ederek iş akışınızdaki darboğazları belirleyin. Bu verilerle süreçlerinizi optimize edin ve verimliliği artırın.
Aşama başına ortalama çözüm sürelerini izleyerek ekip performansını değerlendirin. Kıyaslamalar oluşturun ve zaman içindeki iyileştirmeleri ölçün.
Bilet aşama sürelerini analiz ederek SLA uyumluluk raporları oluşturun. Ekibinizin hizmet seviyesi anlaşmalarını karşıladığından emin olun.
Biletlerin hangi aşamalarda biriktiğini analiz ederek daha fazla kaynak gerektiren aşamaları tespit edin. Ekip tahsisi ve eğitim konusunda veriye dayalı kararlar alın.
Geçmiş verilere dayanarak müşterilere doğru tahminler verin. Aşama süre istatistiklerini paylaşarak şeffaflık gösterin ve müşteri güvenini artırın.
🛠️ Teknik Özellikler
📦 Yeni Model: helpdesk.stage.history
Aşama değişikliklerini izlemek için ana model:
| Alan | Tür | Açıklama |
|---|---|---|
ticket_id |
Many2one | Yardım masası biletine referans |
stage_id |
Many2one | Biletin bulunduğu aşama |
start_datetime |
Datetime | Bu aşamaya giriş zamanı |
end_datetime |
Datetime | Bu aşamadan çıkış zamanı (mevcut ise boş) |
duration_hours |
Float | Saat cinsinden hesaplanmış süre |
duration_display |
Char | Okunabilir süre formatı (örn: "5s 23d 15sn") |
changed_by |
Many2one | Aşamayı değiştiren kullanıcı |
is_open |
Boolean | Mevcut aşama mı? (end_datetime yoksa) |
🔧 Genişletilmiş Model: helpdesk.ticket
Mevcut yardım masası bilet modeline eklenen özellikler:
- stage_history_ids: Bu bilet için tüm aşama geçmiş kayıtları (One2many)
- last_stage_change: Son aşama değişikliğinin zaman damgası
- _create_initial_stage_history(): Bilet oluşturulduğunda ilk geçmiş kaydını oluşturur
- action_backfill_stage_history(): Mevcut biletler için geçmiş doldurma
📥 Kurulum
✅ Gereksinimler
- Odoo 15.0 (Community veya Enterprise Sürümü)
- Python 3.7+
- PostgreSQL 10+
- Yardım Masası modülü (odoo/helpdesk)
🚀 Kurulum Adımları
-
Modülü indirin:
git clone https://github.com/zeynelagca/coflowapps_odoo.git
cd coflowapps_odoo
git checkout 17.0 -
Addons dizinine kopyalayın:
cp -r helpdesk_stage_change_history_17 /path/to/odoo/addons/
-
Uygulama listesini güncelleyin:
Odoo'da Uygulamalar menüsüne gidin ve "Uygulama Listesini Güncelle" butonuna tıklayın
-
Modülü kurun:
"Helpdesk Ticket Stage Change History" modülünü arayın ve "Kur" butonuna tıklayın
-
Mevcut biletleri doldurun (opsiyonel):
Yardım Masası > Biletler'e gidin, biletleri seçin ve İşlem > Aşama Geçmişini Doldur'u tıklayın
📖 Kullanım Kılavuzu
👀 Aşama Geçmişini Görüntüleme
Bilet Form Görünümünden:
- Herhangi bir yardım masası biletini açın
- "Aşama Geçmişi" sekmesine gidin
- Aşama değişikliklerinin eksiksiz zaman çizelgesini görün
- Her aşamada geçen süreyi, kimin değiştirdiğini ve ne zaman olduğunu görün
Aşama Geçmişi Menüsünden:
- Yardım Masası > Aşama Geçmişi'ne gidin
- Tüm biletlerdeki tüm aşama değişikliklerini görün
- Bilet, aşama, kullanıcı veya tarih aralığına göre filtreleyin
- Analiz için bilet, aşama veya kullanıcıya göre gruplandırın
⏱️ Süre Gösterimini Anlama
- Süre (saat): Hesaplamalar için hassas ondalık saat (örn: 5.38)
- Süre: Okunabilir format (örn: "5s 23d 15sn")
- Açık Aralık: Mevcut aşama gerçek zamanlı süre gösterir
- Kapalı Aralık: Geçmiş aşamalar nihai süreyi gösterir
📊 Rapor Oluşturma
Aşama geçmiş verilerini kullanarak özel raporlar oluşturun:
- Yardım Masası > Raporlama > Aşama Geçmişi'ne gidin
- Pivot tablolarını kullanarak şunları analiz edin:
- Aşama başına ortalama süre
- Aşama ve tarihe göre biletler
- Kullanıcı aktivitesi ve performansı
- Aşama geçiş desenleri
📊 Örnek Senaryolar
Örnek 1: Bilet Yaşam Döngüsü
Bir bilet şu aşamalardan geçer:
- Yeni (01.01.2024 09:00 → 01.01.2024 09:15) - 15 dakika
- İşleniyor (01.01.2024 09:15 → 01.01.2024 14:30) - 5 saat 15 dakika
- Müşteri Bekliyor (01.01.2024 14:30 → 02.01.2024 10:00) - 19 saat 30 dakika
- İşleniyor (02.01.2024 10:00 → 02.01.2024 11:45) - 1 saat 45 dakika
- Çözüldü (02.01.2024 11:45 → devam ediyor) - Devam ediyor
Modül, hassas zaman damgaları ve sürelerle tüm 5 aşama değişikliğini izler.
Örnek 2: Performans Analizi
Şunları gösteren bir rapor oluşturun:
- "Müşteri Bekliyor" aşamasında ortalama süre: 12 saat
- "İşleniyor" aşamasında ortalama süre: 4 saat
- Toplam çözüm süresi: 25 saat
"Müşteri Bekliyor" aşamasının darboğaz olduğunu tespit edin ve daha hızlı müşteri yanıt süreçleri uygulayın.
🔧 Sorun Giderme
❓ Eski biletler için aşama geçmişi gösterilmiyor
Çözüm: Mevcut biletler için geçmiş oluşturmak üzere geriye dönük doldurma server action'ını kullanın.
❓ Yinelenen aşama geçmiş kayıtları
Çözüm: Bu olmamalı. Yinelenenleri görürseniz, lütfen bir hata olarak bildirin. Modül, doğru aşama değişikliği tespiti ile yinelemeleri önler.
❓ Yanlış süre hesaplamaları
Çözüm: Sunucu zaman diliminin doğru yapılandırıldığından emin olun. Süre, sunucu saatine göre hesaplanır.
❓ Çok sayıda biletle performans sorunları
Çözüm: Modül, uygun indeksleme ile performans için optimize edilmiştir. Milyonlarca kaydınız varsa, eski geçmiş verilerini arşivlemeyi düşünün.
🗓️ Versiyon Geçmişi
Versiyon 15.0.1.0.0 (05.11.2024)
- Odoo 15.0 için ilk sürüm
- Otomatik aşama değişikliği izleme
- Süre metrikleri ve gösterimi
- Kullanıcı takibi
- Mevcut biletler için geriye dönük doldurma desteği
- Eksiksiz geçmiş görünümleri ve raporlama
🚀 Gelecek Planları
- Gelişmiş analitik kontrol paneli
- SLA uyumluluk uyarıları
- Uzun süren aşamalar için e-posta bildirimleri
- Excel/CSV dışa aktarma işlevi
- Proje yönetimi modülleri ile entegrasyon
- Makine öğrenimi kullanarak aşama süresi tahmini
📞 Destek ve İletişim
Teknik destek, hata raporları veya özellik istekleri için:
- Yazar: Coflow Teknoloji, Ali Zeynel AĞÇA
- Web Sitesi: https://coflow.com.tr
- E-posta: Web sitesi üzerinden iletişime geçin
- GitHub: Sorun Bildir
🎫 Helpdesk Ticket Stage Change History
Advanced Stage Tracking and Analysis Module for Odoo 15.0
📋 Overview
Helpdesk Ticket Stage Change History is a powerful Odoo 15.0 module that automatically tracks and logs every stage change for helpdesk tickets. It provides comprehensive duration metrics, historical data, and reporting capabilities to help you analyze your helpdesk workflow efficiency and identify bottlenecks.
🎯 Why This Module?
Helpdesk teams need to know how long tickets stay in each stage. This information is critical for process improvements, team performance analysis, and SLA compliance. This module automatically collects all this data and makes it ready for analysis.
⭐ Key Features
💼 Use Cases
Identify bottlenecks in your helpdesk workflow by determining which stages tickets spend the most time in. Optimize your processes and increase efficiency with this data.
Monitor team performance by tracking average resolution times per stage. Set benchmarks and measure improvements over time.
Generate SLA compliance reports by analyzing ticket stage durations. Ensure your team meets service level agreements.
Identify stages that require more resources by analyzing where tickets accumulate. Make data-driven decisions about team allocation and training needs.
Provide accurate estimates to customers based on historical data. Show transparency by sharing stage duration statistics and increase customer confidence.
🛠️ Technical Features
📦 New Model: helpdesk.stage.history
Main model for tracking stage changes:
| Field | Type | Description |
|---|---|---|
ticket_id |
Many2one | Reference to helpdesk ticket |
stage_id |
Many2one | Stage the ticket was in |
start_datetime |
Datetime | When ticket entered this stage |
end_datetime |
Datetime | When ticket left this stage (empty if current) |
duration_hours |
Float | Calculated duration in hours |
duration_display |
Char | Human-readable duration format (e.g., "5h 23m 15s") |
changed_by |
Many2one | User who changed the stage |
is_open |
Boolean | Is this the current stage? (no end_datetime) |
🔧 Extended Model: helpdesk.ticket
Features added to existing helpdesk ticket model:
- stage_history_ids: All stage history records for this ticket (One2many)
- last_stage_change: Timestamp of last stage change
- _create_initial_stage_history(): Creates initial history record on ticket creation
- action_backfill_stage_history(): Backfills history for existing tickets
📥 Installation
✅ Requirements
- Odoo 15.0 (Community or Enterprise Edition)
- Python 3.7+
- PostgreSQL 10+
- Helpdesk module (odoo/helpdesk)
🚀 Installation Steps
-
Download the module:
git clone https://github.com/zeynelagca/coflowapps_odoo.git
cd coflowapps_odoo
git checkout 17.0 -
Copy to addons directory:
cp -r helpdesk_stage_change_history_17 /path/to/odoo/addons/
-
Update apps list:
Navigate to Apps menu in Odoo and click "Update Apps List"
-
Install the module:
Search for "Helpdesk Ticket Stage Change History" and click "Install"
-
Backfill existing tickets (optional):
Go to Helpdesk > Tickets, select tickets, and Action > Backfill Stage History
📖 Usage Guide
👀 Viewing Stage History
From Ticket Form View:
- Open any helpdesk ticket
- Navigate to "Stage History" tab
- View complete timeline of stage changes
- See duration in each stage, who changed it, and when
From Stage History Menu:
- Navigate to Helpdesk > Stage History
- View all stage changes across all tickets
- Filter by ticket, stage, user, or date range
- Group by ticket, stage, or user for analysis
⏱️ Understanding Duration Display
- Duration (hours): Precise decimal hours for calculations (e.g., 5.38)
- Duration: Human-readable format (e.g., "5h 23m 15s")
- Open Interval: Current stage shows real-time duration
- Closed Interval: Past stages show final duration
📊 Creating Reports
Use stage history data to create custom reports:
- Navigate to Helpdesk > Reporting > Stage History
- Use pivot tables to analyze:
- Average duration per stage
- Tickets by stage and date
- User activity and performance
- Stage transition patterns
📊 Example Scenarios
Example 1: Ticket Lifecycle
A ticket goes through these stages:
- New (2024-01-01 09:00 → 2024-01-01 09:15) - 15 minutes
- In Progress (2024-01-01 09:15 → 2024-01-01 14:30) - 5 hours 15 minutes
- Pending Customer (2024-01-01 14:30 → 2024-01-02 10:00) - 19 hours 30 minutes
- In Progress (2024-01-02 10:00 → 2024-01-02 11:45) - 1 hour 45 minutes
- Resolved (2024-01-02 11:45 → current) - Ongoing
The module tracks all 5 stage changes with precise timestamps and durations.
Example 2: Performance Analysis
Generate a report showing:
- Average time in "Pending Customer" stage: 12 hours
- Average time in "In Progress" stage: 4 hours
- Total resolution time: 25 hours
Identify that "Pending Customer" is the bottleneck and implement faster customer response processes.
🔧 Troubleshooting
❓ Stage history not showing for old tickets
Solution: Use the backfill server action to create history for existing tickets.
❓ Duplicate stage history entries
Solution: This shouldn't happen. If you see duplicates, please report it as a bug. The module prevents duplicates through proper stage change detection.
❓ Wrong duration calculations
Solution: Ensure server timezone is configured correctly. Duration is calculated based on server time.
❓ Performance issues with many tickets
Solution: The module is optimized for performance with proper indexing. If you have millions of records, consider archiving old history data.
🗓️ Changelog
Version 15.0.1.0.0 (2024-11-05)
- Initial release for Odoo 15.0
- Automatic stage change tracking
- Duration metrics and display
- User tracking
- Backfill support for existing tickets
- Complete history views and reporting
🚀 Roadmap
- Advanced analytics dashboard
- SLA compliance alerts
- Email notifications for prolonged stages
- Export to Excel/CSV functionality
- Integration with project management modules
- Stage duration forecasting using ML
📞 Support and Contact
For technical support, bug reports, or feature requests:
- Author: Coflow Teknoloji, Ali Zeynel AĞÇA
- Website: https://coflow.com.tr
- Email: Contact through website
- GitHub: Report an Issue
Please log in to comment on this module