CrossTag cho Perfex Bởi Head Random • 2026-09-25 3:20 PM

Hướng Dẫn Toàn Diện Cài Đặt Và Sử Dụng CrossTag Cho Perfex CRM

376.08 ms

CrossTag nâng tầm giao tiếp nội bộ trong Perfex CRM bằng cách cho phép gắn thẻ người dùng tức thì qua ký tự @ và liên kết dữ liệu CRM qua ký tự $ hoặc # trực tiếp trên trình soạn thảo TinyMCE, danh sách đầu việc và các khung thảo luận. Bài viết này sẽ hướng dẫn chi tiết quy trình cài đặt, cấu hình hệ thống, cách thức thao tác thực tế và quản lý trung tâm hoạt động cá nhân nhằm giúp doanh nghiệp của bạn xóa bỏ đứt gãy thông tin và tăng tốc độ xử lý công việc.

Điều Kiện Tiên Quyết & Khả Năng Tương Thích

Trước khi kích hoạt mô-đun CrossTag, hãy đảm bảo môi trường máy chủ của bạn đáp ứng các yêu cầu kỹ thuật sau:

  • Phiên Bản Perfex CRM: Từ phiên bản 3.0.0 trở lên (tương thích toàn diện với nhánh 3.0.x và 3.1.x).
  • Môi Trường PHP: Hỗ trợ đầy đủ từ PHP 7.4 đến PHP 8.3+.
  • Hệ Quản Trị Cơ Sở Dữ Liệu: MySQL 5.7+ hoặc MariaDB 10.3+ với cấu trúc bảng InnoDB.
  • Trình Soạn Thảo Hỗ Trợ: TinyMCE 4, TinyMCE 5 và TinyMCE 6, cùng với tất cả ô nhập textarea HTML5 tiêu chuẩn và cửa sổ popover AJAX động.

Quy Trình Cài Đặt Từng Bước

CrossTag tuân thủ cấu trúc đóng gói chuẩn của Perfex CRM và có thể cài đặt hoàn tất chỉ trong vòng 2 phút qua giao diện quản trị hoặc tải trực tiếp vào thư mục.

Phương Pháp 1: Tải Lên Qua Trang Quản Trị (Khuyên Dùng)

  1. Đăng nhập vào trang Quản trị viên (Admin Panel) của Perfex CRM.
  2. Điều hướng đến mục Cài đặt > Mô-đun (Setup > Modules) ở thanh menu bên trái.
  3. Nhấp vào nút Tải lên mô-đun (Upload Module) ở góc trên bên phải màn hình.
  4. Chọn tệp nén crosstag.zip từ máy tính của bạn.
  5. Nhấp nút Cài đặt (Install). Sau khi quá trình tải lên hoàn tất, tìm kiếm CrossTag trong danh sách mô-đun và nhấp Kích hoạt (Activate).
  6. Hệ thống cài đặt sẽ tự động chạy migration cơ sở dữ liệu, tạo các bảng chỉ mục phức hợp (tblcrosstag_mentions, tblcrosstag_entity_tags) và thiết lập cấu hình ma trận thông báo mặc định.

Phương Pháp 2: Tải Lên Thủ Công Qua Thư Mục Máy Chủ

  1. Giải nén tệp crosstag.zip đã tải về trên máy tính cá nhân.
  2. Tải toàn bộ thư mục crosstag lên máy chủ theo đúng đường dẫn:
    perfex_crm/modules/crosstag/
  3. Đảm bảo phân quyền thư mục đạt chuẩn 755 và tệp tin là 644.
  4. Truy cập Cài đặt > Mô-đun trong trang quản trị Perfex CRM và nhấp Kích hoạt.

Cấu Hình Hệ Thống & Tùy Chọn Toàn Cục

Sau khi kích hoạt, bạn có thể truy cập khu vực cấu hình tại Cài đặt > Cài đặt chung > CrossTag hoặc truy cập menu thanh bên tại @ CrossTag > Cài đặt:

  • Ký Tự Kích Hoạt Người Dùng: Mặc định là @. Bạn có thể thay đổi ký tự này tùy theo thói quen bàn phím của doanh nghiệp.
  • Ký Tự Kích Hoạt Bản Ghi CRM: Mặc định là $. Bạn cũng có thể dùng # để tra cứu bản ghi CRM trong mọi khung soạn thảo.
  • Lượt Nhắc Trên Cổng Khách Hàng: Cho phép hoặc chặn khách hàng đã đăng nhập gắn thẻ nhân viên và liên kết dữ liệu trong các phiếu hỗ trợ hoặc thảo luận dự án.
  • Hiển Thị Nút Trợ Giúp ('?'): Bật hoặc tắt biểu tượng dấu hỏi tròn xanh 18px đính kèm khung soạn thảo để người dùng mở bảng hướng dẫn nhanh.
  • Ma Trận Thông Báo: Bật hoặc tắt linh hoạt kênh thông báo chuông nội bộ và email tự động cho từng loại bản ghi CRM cụ thể.

Kiến Trúc Hệ Thống & Luồng Xử Lý Dữ Liệu

CrossTag xử lý việc bắt sự kiện giao diện và lưu trữ dữ liệu thông qua cấu trúc mô-đun phân tầng mạch lạc:

flowchart TD
    subgraph UI["User Interaction Layer"]
        A["TinyMCE Rich Text Editor"] 
        B["Standard Form Textareas"]
        C["Task Todo Items & Notes"]
        D["Smart '?' Guide Button"]
    end

    subgraph SEC["Security & Guard Layer"]
        S1["Staff Authentication Guard"]
        S2["Client Portal Permission Scope"]
        S3["Public Guest Decorator Mode"]
    end

    subgraph FE["CrossTag Frontend Engine"]
        K1["Keyup Interceptor (@, $, #)"]
        K2["Autocomplete Finder Panel"]
        K3["Token Inserter & HTML Badge Decorator"]
    end

    subgraph BE["Backend Controller & Model"]
        M1["Api::get_users() with Avatar Resolution"]
        M2["Api::get_entities() Across 8 Modules"]
        M3["Crosstag_model Parser & Cleaner"]
    end

    subgraph DISPATCH["Notification Dispatch"]
        N1["In-App Bell Alerts"]
        N2["Automated HTML Email Delivery"]
        N3["Notification Matrix Settings"]
    end

    subgraph DB["Composite Indexed Storage"]
        D1[("tblcrosstag_mentions")]
        D2[("tblcrosstag_entity_tags")]
        D3[("tblcrosstag_settings")]
    end

    UI --> K1
    SEC -.-> FE
    K1 --> K2
    K2 --> M1
    K2 --> M2
    K2 --> K3
    K3 --> M3
    M3 --> N1
    M3 --> N2
    M3 --> D1
    M3 --> D2
    DISPATCH -.-> D3

Quy Trình Thao Tác Trong Thực Tế

1. Gắn Thẻ Thành Viên Với Ký Tự @

Bất cứ khi nào bạn cần lấy ý kiến của đồng nghiệp hay khách hàng, chỉ cần gõ @ trong ô mô tả công việc, câu trả lời phiếu hỗ trợ hay bình luận thảo luận:

  • Bảng Gợi Ý Tự Động: Một menu thả xuống thông minh xuất hiện ngay vị trí con trỏ chuột. Tiếp tục gõ tên, họ, email hoặc phòng ban để lọc nhanh kết quả.
  • Ảnh Đại Diện Chân Thực: Hiển thị ảnh đại diện thực của thành viên ngay trong bảng gợi ý và trên huy hiệu sau khi chèn, giúp nhận diện người dùng nhanh chóng.
  • Phân Biệt Quyền Rõ Ràng: Huy hiệu phân loại trực quan giữa Quản trị viên, Nhân viên và Khách hàng để tránh gắn thẻ nhầm đối tượng.
  • Mở Hồ Sơ Trực Tiếp: Nhấp chuột vào huy hiệu người dùng đã gắn để chuyển thẳng đến trang hồ sơ cá nhân của nhân sự đó.

2. Liên Kết Chéo Bản Ghi CRM Với Ký Tự $ Và

Thay vì phải mở nhiều tab trình duyệt để sao chép đường dẫn, hãy gõ $ hoặc # kèm từ khóa tìm kiếm để liên kết 8 thực thể CRM chính:

  • Công Việc (Tasks): Hiển thị tên công việc, trạng thái xử lý và độ khẩn cấp.
  • Dự Án (Projects): Hiển thị mã dự án, tên dự án, khách hàng và hạn chót bàn giao.
  • Phiếu Hỗ Trợ (Tickets): Dẫn chứng mã phiếu, chủ đề, phòng ban phụ trách và trạng thái.
  • Hóa Đơn (Invoices): Gắn thẻ số hóa đơn, tên công ty và tình trạng thanh toán (Đã thanh toán, Chưa thanh toán, Quá hạn).
  • Khách Hàng Tiềm Năng (Leads): Dẫn chứng tên đầu mối, công ty và giai đoạn bán hàng hiện tại.
  • Đề Xuất (Proposals): Hiển thị tiêu đề đề xuất, khách hàng và tổng giá trị hợp đồng.
  • Báo Giá (Estimates): Tham chiếu số hiệu báo giá, khách hàng và ngày hết hạn hiệu lực.
  • Hợp Đồng (Contracts): Liên kết chủ đề hợp đồng, đối tác và khoảng thời gian có hiệu lực.

Sơ đồ dưới đây minh họa toàn bộ vòng đời từ thao tác gõ phím đến khi thông báo được gửi đi thành công:

sequenceDiagram
    actor User as Staff Member
    participant Editor as TinyMCE / Textarea
    participant Engine as CrossTag JS Engine
    participant API as Backend API Endpoint
    participant DB as MySQL InnoDB Tables
    participant Notif as Notification Dispatcher
    actor Target as Tagged Colleague

    User->>Editor: Type '@' or '$'
    Editor->>Engine: Trigger Autocomplete Event
    Engine->>API: GET /crosstag/api/users or entities
    API->>DB: Query with Composite Index Lookup
    DB-->>API: Return Ranked Matches (Avatars, Badges)
    API-->>Engine: JSON Response
    Engine->>User: Display Autocomplete Finder Panel
    User->>Engine: Select Target Colleague / Record
    Engine->>Editor: Insert Badge Pill / Markdown Token
    User->>Editor: Submit Comment / Task Note
    Editor->>API: Post Content Payload
    API->>DB: Store Record & Differential Mentions
    API->>Notif: Trigger Notification Matrix
    Notif->>Target: In-App Bell Alert + Contextual Email

3. Cơ Chế Xử Lý Giữa TinyMCE Và Textarea Thuần

CrossTag tự động thay đổi phương thức chèn phù hợp với từng môi trường nhập văn bản:

  • Trên Trình Soạn Thảo TinyMCE: Các lượt tag được chèn dưới dạng huy hiệu HTML hoàn chỉnh có kèm hình ảnh đại diện và liên kết nhấp chuột.
  • Trên Ô Nhập Textarea & Đầu Việc Todo: Các lượt tag được lưu dưới dạng token Markdown chuẩn Option A (như [Nguyễn Văn A](staff:12) hay [INV-2026-004](invoice:4)). Khi người dùng tải lại trang, bộ giải mã CrossTag Decorator sẽ tự động chuyển các token này thành huy hiệu trực quan đẹp mắt mà không làm hỏng cấu trúc dữ liệu thô trong cơ sở dữ liệu MySQL.

4. Quản Lý Thảo Luận Tại Trung Tâm My Mentions

Không bao giờ bỏ sót phản hồi hoặc đầu mục hành động quan trọng. Mở mục @ CrossTag > My Mentions từ thanh điều hướng:

  • Bộ Đếm Chưa Đọc Thời Gian Thực: Cập nhật số lượng tag mới trực tiếp trên menu chính.
  • Bộ Lọc Theo Loại Thực Thể: Xem riêng các thông báo phát sinh từ Công việc, Phiếu hỗ trợ, Dự án hoặc Hóa đơn.
  • Tìm Kiếm Từ Khóa: Tìm nhanh trích đoạn ghi chú ngay tức thì phía client.
  • Hỗ Trợ Ký Tự Tiếng Việt: Tự động giải mã ký tự UTF-8 có dấu hoàn hảo, không để lộ mã markdown thô.
  • Thao Tác Đánh Dấu Nhanh: Đánh dấu đã đọc từng tin hoặc đánh dấu tất cả đã đọc kèm hộp thoại SweetAlert2 xác nhận.

Thiết Kế Cơ Sở Dữ Liệu Tối Ưu Tải Cao

CrossTag được thiết kế để duy trì tốc độ truy vấn dưới một mili-giây ngay cả trên các hệ thống Perfex CRM có hàng trăm ngàn bản ghi hoạt động:

  • Truy Vấn Dòng Thời Gian Không Cần Filesort: Chỉ mục phức hợp (target_type, target_id, id DESC) giúp MySQL đọc dữ liệu tuần tự trực tiếp trên đĩa mà không cần sắp xếp tạm.
  • Quét Bảng Phức Hợp 100% Trong Bộ Nhớ RAM: Chỉ mục (rel_type, rel_id, comment_id, target_type, target_id) cho phép bộ quét kiểm tra các lượt tag đã tồn tại trực tiếp trong vùng đệm RAM mà không phải truy xuất đĩa cứng.
  • Ngăn Chặn Gắn Thẻ Trùng Lặp: Ràng buộc duy nhất (source_rel_type, source_rel_id, tagged_entity_type, tagged_entity_id) đảm bảo tính toàn vẹn dữ liệu ngay tại tầng CSDL.

Bảo Mật & Cách Ly Khách Truy Cập

Khi khách hàng bên ngoài mở xem các đề xuất, hợp đồng hoặc báo giá công khai, CrossTag tự động kích hoạt Chế độ Decorator thuần túy:

  • Các API gợi ý tự động và tìm kiếm bị vô hiệu hóa hoàn toàn đối với khách chưa đăng nhập.
  • Ẩn biểu tượng dấu hỏi trợ giúp và cửa sổ gợi ý.
  • Các liên kết nội bộ được làm sạch để đảm bảo dữ liệu doanh nghiệp luôn được bảo vệ an toàn.

Tối Ưu Hóa Hiệu Quả Làm Việc Nhóm

CrossTag kết nối liền mạch mọi thành viên trong doanh nghiệp của bạn. Hãy trải nghiệm sự tiện lợi của việc gắn thẻ tức thì, liên kết dữ liệu chéo không độ trễ và nhận thông báo theo thời gian thực bằng cách cài đặt CrossTag cho hệ thống Perfex CRM ngay hôm nay.