> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/cai-dat-chung/cai-dat-thong-tin-khach-hang.md).
# Cài đặt thông tin khách hàng
## Màn hình danh sách trường thông tin
✅ **Mục đích:**\
Hiển thị tất cả các trường thông tin đã khai báo.
✅ **Nội dung chính:**
* **Bộ lọc tìm kiếm:** tìm nhanh theo tên trường.
* **Bảng danh sách gồm:**
* **STT:** Thứ tự.
* **Tên trường:** Tên mã nội bộ (viết liền, không dấu).
* **Giá trị của trường:** Các giá trị lựa chọn (nếu có).
* **Trạng thái:** Đã kích hoạt / Tạm tắt.
* **Thao tác:** Sửa () / Xoá ().
✅ **Hành động:**
* Bấm  để tạo trường mới.
* Bấm  để chỉnh sửa.
* Bấm  để xoá.
## Thêm mới trường mặc định
✅ **Mục đích:**\
Khai báo một trường thông tin mới cho khách hàng.
✅ **Các trường cần nhập:**
* **Tên trường:** (bắt buộc)
* Tên mã sử dụng trong hệ thống (viết liền, không dấu, không khoảng trắng).
* **Tên trường đầy đủ:** (bắt buộc)
* Tên hiển thị cho khách hàng thấy.
* **Kích hoạt:** Bật/Tắt trạng thái hoạt động.
* **Loại trường:**
* Chữ: nhập text tự do.
* Lựa chọn: chọn từ danh sách cố định.
✅ **Thuộc tính của trường (tùy theo loại):**
* **Chữ:** Đặt giới hạn ký tự tối thiểu / tối đa.
* **Lựa chọn:** (xem ảnh 3) nhập danh sách giá trị phân tách bằng dấu phẩy.
✅ **Hành động:**
* Nhập đầy đủ → bấm  để tạo.
## Cập nhật trường mặc định
✅ **Mục đích:**\
Chỉnh sửa thông tin trường đã tạo.
✅ **Các nội dung chỉnh được:**
* Tên trường (mã).
* Tên hiển thị đầy đủ.
* Loại trường.
* Thuộc tính giá trị (giá trị lựa chọn hoặc giới hạn ký tự).
* Trạng thái Kích hoạt.
✅ **Hành động:**
* Bấm  để lưu thay đổi.
* Bấm  để huỷ.
## **Loại trường – giải thích chi tiết**
✅ **Chữ:**
* Người dùng nhập nội dung tự do.
* Có thể cấu hình độ dài tối thiểu / tối đa.
✅ **Lựa chọn:**
* Người dùng chọn từ danh sách giá trị đã khai báo trước.
* Các giá trị cách nhau bằng dấu phẩy (,).
* Ví dụ: Nam,Nữ,Khác
## Cảnh báo xoá trường
✅ Khi bấm nút xoá trường → sẽ hiện hộp thoại cảnh báo:
> ⚠️ “Dữ liệu sẽ không được phục hồi với thao tác này!”
✅ Quản trị viên cần xác nhận trước khi xoá.
✅ **Lưu ý:**
* Xoá trường sẽ làm mất thông tin khách hàng đã lưu ở trường đó.
## **Khuyến nghị cho admin**
✅ Chỉ tạo trường cần thiết, tên dễ hiểu.\
✅ Tránh đổi “Tên trường” mã nội bộ nếu đã sử dụng.\
✅ Kiểm tra kỹ giá trị lựa chọn, tránh lỗi chính tả.\
✅ Bật/Tắt trường khi cần mà không xoá để giữ dữ liệu cũ.