> 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ũ.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/cai-dat-chung/cai-dat-thong-tin-khach-hang.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.