Quản lý danh bạ

TLDR

Trang /contacts là một bảng phân trang server-side với 2 lớp lọc (kind: person/organization, và type: quan hệ) + tìm kiếm full-text. Chọn nhiều dòng để thao tác hàng loạt (đổi status, gắn tag/type, xoá). Tạo mới đi qua 2 bước: chọn kind rồi điền form theo tab (Basic/Details/More, cộng tab Profile khi sửa).

Danh sách & lọc

Tab theo Kind

All / Person / Organization — đếm số lượng ngay trên tab (từ endpoint counts, không phụ thuộc trang đang xem).

Lọc theo Type

Lọc theo quan hệ (customer/lead/vendor…) qua query ?rel= — có thể deep-link từ nơi khác (vd sidebar) vào một type cụ thể.

Tìm kiếm

Debounce 300ms, khớp display_name, primary_email, primary_phone. Nhấn / để focus nhanh vào ô tìm kiếm.

Cột tuỳ biến

Ẩn/hiện, kéo resize, double-click để auto-fit độ rộng cột — cấu hình ở Thiết lập › Listing.

Phân trang server-side (25/50/100 dòng/trang), tổng số lấy từ meta.filter_count của backend — không đếm ở client.

Thao tác hàng loạt

Chọn checkbox một hoặc nhiều dòng để hiện thanh hành động nổi ở đáy màn hình:

Đổi Status

Áp status mới cho tất cả contact đã chọn.

Gắn Tag / Type

Thêm (không thay thế) tag hoặc type cho các contact đã chọn — mở modal chọn nhiều giá trị.

Xoá

Xoá vĩnh viễn — có hộp thoại xác nhận. Xoá contact sẽ xoá luôn mọi bản ghi con (email/phone/address/profile/notes/social links/employment) — xem Data model.

Nút đổi status/gắn tag/gắn type chỉ hiện nếu bạn có quyền contacts:update; nút xoá chỉ hiện nếu có contacts:delete.

Tạo contact mới

1. Nhấn Add (hoặc phím tắt N) — mở drawer bước 1: chọn kind (Person / Organization), hiển thị dạng thẻ lớn kèm icon.

2. Sau khi chọn kind, drawer chuyển sang form theo tab:

   • Basic — tên (first/last name cho person, hoặc display_name cho organization), email/phone làm việc, status.
   • Details — thông tin riêng theo kind (person: ngày sinh, giới tính, tổ chức đang làm + chức vụ; organization: website, số nhân viên, năm thành lập, mã số thuế), địa chỉ.
   • More — types (quan hệ), tags, biopage URL, ghi chú tự do.

3. Khi tạo mới, field Organization ở tab Details là một dropdown chọn được (không giống lúc sửa) — chọn một organization ở đây sẽ tự tạo một bản ghi Employment hiện tại (is_current: true) ngay khi lưu.

4. Gõ email trùng với contact đã có → cảnh báo trùng lặp hiện ngay trong drawer (debounce 400ms), kèm link nhảy thẳng tới contact trùng để bạn quyết định có tiếp tục tạo mới hay không.

5. Lưu — contact mới xuất hiện đầu danh sách (mặc định sort theo date_created giảm dần).

Vì sao Organization ở form Edit lại readonly

Sau khi tạo, tab Details ẩn hẳn field Organization — quan hệ làm việc giờ được quản lý qua khối Work History ở trang chi tiết (thêm/sửa/xoá nhiều employment, đặt cái nào là hiện tại). Đây là chủ ý: field đơn organization_id trên form chỉ dùng để seed employment đầu tiên lúc tạo, không phải nơi sửa quan hệ về sau.

Sửa contact

Sửa từ trang chi tiết (nút bút chì trên từng section) hoặc mở lại drawer edit — form giống lúc tạo nhưng có thêm tab Profile (hồ sơ CRM: phong cách giao tiếp, mức ưu tiên quan hệ, sở thích, điều cần tránh…).

Phím tắt

Phím	Hành động
N	Mở drawer tạo contact mới
/	Focus vào ô tìm kiếm
?	Mở bảng phím tắt
Esc	Đóng bảng phím tắt đang mở

Phím tắt tự vô hiệu khi con trỏ đang ở trong input/textarea/select để không can thiệp lúc gõ chữ.

Đọc tiếp

• Hồ sơ chi tiết — các section trên trang /contacts/:id
• Khái niệm cốt lõi — kind/status/type/tag là gì
• Thiết lập hệ thống — cấu hình cột danh sách, taxonomy