UCall App — Bảng Routes & Đề xuất cải thiện

Khảo sát tại: https://dev.app.ucall.vn
Tài khoản: hieuhoang@ucall.asia
Thực hiện: 2026-05-18


Đề xuất cải thiện Route

Nguyên tắc RESTful + Domain-Driven:
/{workspace}/{domain}/{resource}/{action?}

Quy tắc:
✅ Dùng kebab-case (gạch ngang), không dùng snake_case hay camelCase
✅ Dùng danh từ số nhiều cho collections
✅ Không để version vào route người dùng thấy
✅ Route phản ánh đúng tên UI hiển thị
✅ Nhóm sub-module theo domain rõ ràng

CRM

👥 Contacts (CRM)

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/contacts/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/contacts/{uuid}

Công ty - Enterprises

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/enterprises/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/enterprises/{uuid}

Cơ hội bán hàng - Deals

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/deals/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/deals/{uuid}

Đơn hàng - orders

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/orders/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/orders/{uuid}

Sản phẩm - products

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/products/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/products/{uuid}

Phiếu ghi - tickets

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/tickets/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/tickets/{uuid}

Công việc - tasks

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/tasks/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/tasks/{uuid}

Lịch hẹn - meetings

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/meetings/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/meetings/{uuid}

Lịch - Calendar

  • Màn list: app.ucall.vn/dashboard/{workspace_slug}/calendar

Danh sách - lists

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/lists/{view_slug}
  • Màn detail: app.ucall.vn/dashboard/{workspace_slug}/lists/{uuid}

Quét data - adalead / ulead

  • Màn list/kanban: app.ucall.vn/dashboard/{workspace_slug}/adalead

Campaign

Callbot

  • Màn list: app.ucall.vn/dashboard/{workspace_slug}/campaigns/callbot
  • Màn cài đặt: app.ucall.vn/dashboard/{workspace_slug}/campaigns/callbot/{uuid}/step-1
  • Màn xem nhanh: app.ucall.vn/dashboard/{workspace_slug}/campaigns/callbot/{uuid}/overview
  • Màn báo cáo tổng quan: app.ucall.vn/dashboard/{workspace_slug}/campaigns/callbot/{uuid}/report/overview
  • Báo cáo chi tiết: app.ucall.vn/dashboard/{workspace_slug}/campaigns/callbot/{uuid}/report/detail

Telesale

  • Màn list: app.ucall.vn/dashboard/{workspace_slug}/campaigns/telesale
  • Màn cài đặt: app.ucall.vn/dashboard/{workspace_slug}/campaigns/telesale/{uuid}/step-1
  • Màn xem nhanh: app.ucall.vn/dashboard/{workspace_slug}/campaigns/telesale/{uuid}/overview
  • Màn báo cáo tổng quan: app.ucall.vn/dashboard/{workspace_slug}/campaigns/telesale/{uuid}/report/overview
  • Báo cáo chi tiết: app.ucall.vn/dashboard/{workspace_slug}/campaigns/telesale/{uuid}/report/detail

ZNS

  • Màn list: app.ucall.vn/dashboard/{workspace_slug}/campaigns/zns
  • Màn cài đặt: app.ucall.vn/dashboard/{workspace_slug}/campaigns/zns/{uuid}/step-1
  • Màn xem nhanh: app.ucall.vn/dashboard/{workspace_slug}/campaigns/zns/{uuid}/overview
  • Màn báo cáo tổng quan: app.ucall.vn/dashboard/{workspace_slug}/campaigns/zns/{uuid}/report/overview
  • Báo cáo chi tiết: app.ucall.vn/dashboard/{workspace_slug}/campaigns/zns/{uuid}/report/detail

Library

  • Callbot: app.ucall.vn/dashboard/{workspace_slug}/library/callbot
  • Telesale: app.ucall.vn/dashboard/{workspace_slug}/library/telesale
  • ZNS: app.ucall.vn/dashboard/{workspace_slug}/library/zns
  • Email: app.ucall.vn/dashboard/{workspace_slug}/library/email

History

  • Lịch sử cuộc gọi: app.ucall.vn/dashboard/{workspace_slug}/history/call

Chat đa kênh

  • Chat v2: app.ucall.vn/dashboard/{workspace_slug}/chat-v2

Adaflow

  • Màn list: app.ucall.vn/dashboard/{workspace_slug}/adaflow
  • Màn cài đặt: app.ucall.vn/dashboard/{workspace_slug}/adaflow/{uuid}/step-1
  • Màn xem nhanh: app.ucall.vn/dashboard/{workspace_slug}/adaflow/{uuid}/overview
  • Màn báo cáo tổng quan: app.ucall.vn/dashboard/{workspace_slug}/adaflow/{uuid}/report/overview
  • Báo cáo chi tiết: app.ucall.vn/dashboard/{workspace_slug}/adaflow/{uuid}/report/detail

Thanh toán

  • Thanh toán: app.ucall.vn/dashboard/{workspace_slug}/wallet/billing/callbot
  • Báo cáo chi phí: app.ucall.vn/dashboard/{workspace_slug}/wallet/expense
  • Lịch sử đơn hàng: app.ucall.vn/dashboard/{workspace_slug}/wallet/order-history
  • Lịch sử giao dịch: app.ucall.vn/dashboard/{workspace_slug}/wallet/transaction-history/callbot

🔧 Settings

| Trước | Sau | Lý do | |—|—|—| | /settings/general/user_info | /settings/account/profile | Nhóm theo account thay vì general | | /settings/general/billing_info | /settings/account/billing | Khớp với tên UI | | /settings/general/api_key | /settings/account/api-keys | kebab-case + số nhiều | | /settings/general/change_password | /settings/account/security | Mở rộng hơn cho tương lai | | /settings/general/permissionset | /settings/team/permission-sets | Tách nhóm team; kebab-case | | /settings/general/profilegroup | /settings/team/groups | profilegroup sang groups | | /settings/general/profile | /settings/team/members | profile sang members | | /settings/general/work_shift | /settings/team/work-shifts | kebab-case | | /settings/general/personal | /settings/preferences | Tách ra khỏi general | | /settings/general/routing | /settings/pbx/routing | Nhóm theo pbx | | /settings/general/integration | /settings/integrations | Nâng lên cấp cao hơn | | /settings/general/customer | /settings/property/contacts | Nhóm property; nhất quán suffix | | /settings/general/enterprise_property | /settings/property/companies | | | /settings/general/product_property | /settings/property/products | | | /settings/general/deal_property | /settings/property/deals | | | /settings/general/order_property | /settings/property/orders | | | /settings/general/ticket_property | /settings/property/tickets | | | /settings/general/crmtask_property | /settings/property/tasks | Bỏ prefix crm | | /settings/general/crmmeeting_property | /settings/property/meetings | Bỏ prefix crm |