help-desk/README.md

66 lines
4.0 KiB
Markdown

# Feature Branch: Unified Inbox Chat
**Branch Name:** `feature/unified-inbox-chat`
**Base Branch:** `develop`
---
## 📝 āļŠāļĢāļļāļ›āļœāļĨāļāļēāļĢāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ
āļˆāļēāļāđ‚āļ„āđ‰āļ”āđāļĨāļ° Test Coverage āļ›āļąāļˆāļˆāļļāļšāļąāļ™ āļŠāļĢāļļāļ›āļ āļēāļžāļĢāļ§āļĄāļāļēāļĢāļĢāļ­āļ‡āļĢāļąāļšāļĢāļ°āļšāļš Ticketing / Shared Inbox āđāļĨāļ°āļŸāļĩāđ€āļˆāļ­āļĢāđŒāđ€āļ—āļĩāļĒāļšāļāļąāļš Chatwoot/Freshdesk āđ„āļ”āđ‰āļ”āļąāļ‡āļ™āļĩāđ‰:
### 1. āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļĢāļ°āļšāļšāļ›āļąāļˆāļˆāļļāļšāļąāļ™
**Ticketing System** āļĢāļ­āļ‡āļĢāļąāļšāđ€āļ•āđ‡āļĄāļĢāļđāļ›āđāļšāļš āļ”āļąāļ‡āļ™āļĩāđ‰:
- āļŠāļĢāđ‰āļēāļ‡ Ticket (`Ticket` model)
- Assign Ticket (`TicketService.assign_ticket_to_user`)
- Update Status (`TicketService.update_ticket_status`)
- āļ•āļīāļ”āļ•āļēāļĄ Last Message (`Ticket.last_message_content`, `last_message_at`)
- Test āļ„āļĢāļ­āļšāļ„āļĨāļļāļĄāļ—āļąāđ‰āļ‡ Unit + Integration + Functional Tests āļ‹āļķāđˆāļ‡āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ„āļĢāļšāļ–āđ‰āļ§āļ™
**Shared Inbox / Multi-channel** āļĒāļąāļ‡āļˆāļģāļāļąāļ” āļ”āļąāļ‡āļ™āļĩāđ‰:
- āļ›āļąāļˆāļˆāļļāļšāļąāļ™ Inbox āđ€āļ›āđ‡āļ™ Unified Inbox āđāļ•āđˆāļĒāļąāļ‡āļĢāļ­āļ‡āļĢāļąāļšāđ€āļ‰āļžāļēāļ° internal messages (Ticket + Chat messages)
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ integration āļāļąāļš external channels (Email, Live Chat, Line, WhatsApp, āļ­āļ·āđˆāļ™ āđ†)
**āļŠāļĢāļļāļ›:** āļĢāļ°āļšāļšāļŠāļēāļĄāļēāļĢāļ–āļ—āļģ Ticketing + Inbox āļ‚āļ­āļ‡āļ•āļąāļ§āđ€āļ­āļ‡āđ„āļ”āđ‰ āđāļ•āđˆāļĒāļąāļ‡āđ„āļĄāđˆāđƒāļŠāđˆ “Shared Inbox” āđāļšāļš multi-channel āđ€āļŦāļĄāļ·āļ­āļ™ Chatwoot
### 2. āļŠāđˆāļ­āļ‡āļ—āļēāļ‡āļŠāļ·āđˆāļ­āļŠāļēāļĢ
- āļ›āļąāļˆāļˆāļļāļšāļąāļ™āļĢāļ­āļ‡āļĢāļąāļš Internal Ticket + Chat message
- āļ‚āļēāļ” Multi-channel (Email/Line/WhatsApp/Facebook/Twitter/SMS)
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩāļŦāļ™āđ‰āļē Customer Portal āđƒāļŦāđ‰āļĨāļđāļāļ„āđ‰āļēāļŠāđˆāļ‡ Ticket āļŦāļĢāļ·āļ­āļ”āļđāļŠāļ–āļēāļ™āļ°
**āļŠāļĢāļļāļ›:** āļĢāļ°āļšāļšāļˆāļ°āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ”āļĩāđ€āļ‰āļžāļēāļ°āļ āļēāļĒāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢ āđāļ•āđˆāļĒāļąāļ‡āđ„āļĄāđˆāļ„āļĢāļšāļ—āļļāļāļŠāđˆāļ­āļ‡āļ—āļēāļ‡
### 3. AI / Automation
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ Auto-Routing / SLA / AI Agent
- āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ `TicketService` āđāļĨāļ° `MessageService` āļŠāļēāļĄāļēāļĢāļ–āļ•āđˆāļ­āđ€āļ•āļīāļĄāđ„āļ”āđ‰
### 4. Security
- RBAC āļ‚āļąāđ‰āļ™āļžāļ·āđ‰āļ™āļāļēāļ™ (Django `is_staff`)
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ Audit Logs, SSO, Shift/Business Hours management
**āļŠāļĢāļļāļ›:** āđ€āļŦāļĄāļēāļ°āļāļąāļš internal team āļ‚āļ™āļēāļ”āđ€āļĨāđ‡āļ/āļāļĨāļēāļ‡ āđāļ•āđˆāļĒāļąāļ‡āđ„āļĄāđˆāđ€āļ—āļĩāļĒāļš Freshdesk āđƒāļ™āļ”āđ‰āļēāļ™ Security
### 5. Collaboration
- āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļžāļąāļ’āļ™āļē Internal Notes / Private Messages āļ”āđ‰āļ§āļĒ `MessageService` + `Ticket.last_message_content` / `is_read` āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļĢāđˆāļ§āļĄāļāļąāļ™āļ‚āļ­āļ‡ Agent
- āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļžāļąāļ’āļ™āļē Assignment Notification āļ”āđ‰āļ§āļĒ `TicketService` + `NotificationService`
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ Canned Responses, Internal Threads, Rich Collaboration Tools
### 6. Reporting / Analytics
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ KPI / CSAT / Agent Performance Reports
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩ Knowledge Base / Self-Service Portal
- āļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩāļĢāļ°āļšāļšāļŠāļĢāļļāļ› Inbox / Ticket summary āđāļšāļš Dashboard
### 7. Test Coverage āļ›āļąāļˆāļˆāļļāļšāļąāļ™
- āļ„āļĢāļ­āļšāļ„āļĨāļļāļĄ Logic āļŦāļĨāļąāļ, Query āđāļĨāļ° Data Integrity
- āļ„āļĢāļ­āļšāļ„āļĨāļļāļĄ workflow
- āļ„āļĢāļ­āļšāļ„āļĨāļļāļĄāļŠāļģāļŦāļĢāļąāļš API Endpoints āļ›āļąāļˆāļˆāļļāļšāļąāļ™
**āļŠāļĢāļļāļ› Coverage:** āļ”āļĩāļĄāļēāļāļŠāļģāļŦāļĢāļąāļšāļŸāļĩāđ€āļˆāļ­āļĢāđŒāļ—āļĩāđˆāļĄāļĩāļ­āļĒāļđāđˆ āđāļ•āđˆāļĒāļąāļ‡āđ„āļĄāđˆāļĄāļĩāļŠāļģāļŦāļĢāļąāļšāļŸāļĩāđ€āļˆāļ­āļĢāđŒāļ‚āļąāđ‰āļ™āļŠāļđāļ‡ āđ€āļŠāđˆāļ™ multi-channel, AI routing, SLA, analytics āđ€āļ›āđ‡āļ™āļ•āđ‰āļ™
---
## 📝 āļŦāļĄāļēāļĒāđ€āļŦāļ•āļļ
- Feature branch āļ™āļĩāđ‰āļĒāļąāļ‡āđ„āļĄāđˆ merge āļāļĨāļąāļšāđ„āļ› `develop`
- āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļšāļžāļąāļ’āļ™āļēāđāļĨāļ°āļ—āļ”āļŠāļ­āļšāļŸāļĩāđ€āļˆāļ­āļĢāđŒ **Unified Inbox Chat**