Thiết lập hệ thống (Admin)

TLDR

Contacts dùng chung hạ tầng Setup Wizard với các module ODP khác — chạy một lần để tạo toàn bộ collection c_contact_* + seed dữ liệu mặc định (kind, status, type, activity type). Sau khi cài xong, trang Cài đặt (/contacts/settings, cần quyền manage-settings) cho phép chỉnh mặc định, cột danh sách hiển thị, và quản lý taxonomy dùng chung.

Chạy Setup Wizard

1. Truy cập /contacts/setup (chuyển hướng tự động nếu module chưa cài và bạn có quyền admin).

2. Wizard chạy 2 bước tuần tự khai báo trong schema: schema (tạo collection + field + relation) rồi seed (chèn dữ liệu mặc định).

3. Xong, wizard điều hướng về /contacts.

Điều kiện tiên quyết

Label collection contacts (thư mục gom nhóm trong Data Studio) đã tồn tại sẵn trên backend — wizard không tạo nó, chỉ tạo các bảng c_contact_* bên trong. Đây là điểm khác với các module khác thường tự tạo cả label.

Dữ liệu được seed sẵn

Kinds (bắt buộc)

person, organization — vào shared_kinds, dùng chung toàn hệ thống.

Statuses (bắt buộc)

contacts:active, contacts:inactive, contacts:lead.

Types (bắt buộc)

contacts:customer, contacts:lead, contacts:vendor, contacts:partner, contacts:investor.

Activity types (bắt buộc)

note, call, email, meeting — dùng cho bảng c_contact_activities (nhật ký hoạt động).

Ngoài dữ liệu bắt buộc, wizard còn seed dữ liệu mẫu (tuỳ chọn khi chạy wizard): 5 contact mẫu (3 person, 2 organization) và 3 intake mẫu (từ helpdesk, web_form, sales) để xem giao diện có dữ liệu ngay sau khi cài.

Trang Cài đặt (/contacts/settings)

Yêu cầu quyền contacts:manage-settings — không có quyền sẽ bị điều hướng ngược về /contacts. Có 4 tab:

General

default_status (status gán mặc định khi tạo contact mới, nếu form không chọn) và name_composition — cách ghép tên hiển thị: first-last (“Văn A Nguyễn”), last-first (“Nguyễn, Văn A”), hoặc last-first-spaced (“Nguyễn Văn A” — thứ tự Việt Nam, không dấu phẩy).

Listing

Bật/tắt, sắp xếp lại, và đặt độ rộng cột cho bảng danh sách contact (display_name, organization, primary_email, primary_phone, location, type, status). Lưu client-side (localStorage), không phải setting server — mỗi trình duyệt/máy tự nhớ layout riêng.

Statuses / Types / Tags

Ba tab dùng chung một component (ContactsSettingsSharedList) — thêm/sửa/xoá từng taxonomy scope theo contacts:. Xoá một status/type/tag đang được contact nào đó dùng sẽ bị chặn (409 in_use).

Kinds không có tab riêng

shared_kinds (person/organization) không scope theo module vì dùng chung toàn hệ thống — Contacts không có UI riêng để thêm/xoá kind mới trong bộ này (khác với statuses/types/tags).

Cột danh sách mặc định

admin/packages/contacts/app/composables/use-contacts-settings.ts

export const DEFAULT_LIST_COLUMNS: ListColumn[] = [
    { key: "display_name", label: "Name", visible: true },
    { key: "organization", label: "Organization / Industry", visible: true },
    { key: "primary_email", label: "Email", visible: true },
    { key: "primary_phone", label: "Phone", visible: true },
    { key: "location", label: "Location", visible: true },
    { key: "type", label: "Type", visible: true },
    { key: "status", label: "Status", visible: true },
]

Độ rộng cột resize bằng tay (kéo cạnh phải) hoặc double-click để auto-fit theo nội dung dài nhất — cả hai đều lưu vào settings.columnWidths và giữ qua các phiên làm việc trên cùng trình duyệt.

Đọc tiếp

• Khái niệm cốt lõi — hiểu kind/status/type/tag trước khi cấu hình
• Quản lý danh bạ — nơi cột danh sách và filter hiển thị
• Data model — toàn bộ collection wizard tạo ra