Skip to main content
Bạn dùng khu vực Căn hộ - cư dân để quản lý danh sách căn hộ, hồ sơ cư dân và mối quan hệ giữa cư dân với căn hộ.
Bạn chỉ thấy và thay đổi dữ liệu thuộc tòa nhà đang chọn. Nút tạo, sửa hoặc xóa chỉ xuất hiện khi tài khoản có quyền tương ứng.

Các màn hình chính

Danh sách căn hộ

Giao diện danh sách căn hộ theo tòa nhà đang chọn

Thêm căn hộ

1

Mở danh sách căn hộ

Trong menu Căn hộ - cư dân, chọn Danh sách căn hộ.
2

Chọn Thêm mới

Nhập tên, mã căn hộ và trạng thái theo biểu mẫu đang hiển thị.
3

Lưu căn hộ

Hệ thống kiểm tra mã căn hộ trong tòa nhà hiện tại trước khi tạo bản ghi.

Gắn cư dân vào căn hộ

1

Mở chi tiết căn hộ

Từ Danh sách căn hộ, chọn xem căn hộ cần cập nhật.
2

Chọn cư dân

Bạn có thể tạo cư dân mới cùng liên kết hoặc chọn một cư dân chưa gắn với căn hộ này.
3

Chọn quan hệ và ngày chuyển vào

Lưu thông tin quan hệ cư dân–căn hộ theo biểu mẫu.
Bạn cũng có thể mở chi tiết một cư dân để gắn thêm căn hộ, sửa quan hệ hoặc xóa một liên kết hiện có. Xóa liên kết không đồng nghĩa xóa hồ sơ cư dân.

Tình huống thực tế

Ví dụ: Căn hộ A0101 có chủ hộ mới chuyển vào:
  1. Vào Danh sách căn hộ, bấm xem chi tiết căn hộ A0101.
  2. Trong phần cư dân, liên kết thành viên mới với vai trò Chủ hộ (owner) và ngày chuyển vào.
  3. Hồ sơ cư dân được liên kết thành công với căn hộ và sẵn sàng để quản lý phương tiện hoặc duyệt tài khoản Zalo Mini App.

Import hiện tại

Bạn nhập dữ liệu qua Import căn hộ hoặc Import danh sách cư dân. Biểu mẫu nhận XLSX hoặc CSV, tối đa 5 MB.
1

Kiểm tra file

Chọn file rồi bấm Kiểm tra dữ liệu. Hệ thống hiển thị dữ liệu và lỗi theo dòng; bước này chưa tạo căn hộ hoặc hồ sơ cư dân.
2

Ghi dữ liệu hợp lệ

Khi dữ liệu hợp lệ, bấm Ghi dữ liệu vào hệ thống. Import căn hộ ghi các bản ghi vào tòa nhà đang chọn. Import cư dân đưa dữ liệu vào hàng chờ đối soát, chưa tự tạo hồ sơ hoặc liên kết cư dân–căn hộ.
3

Đối soát cư dân

Với dữ liệu cư dân, mở khu vực đối soát và quyết định tạo hồ sơ mới, gắn hồ sơ có sẵn hoặc bỏ qua từng mục.
Xem Nhập và xuất dữ liệu để phân biệt luồng xem trước với luồng import tài chính.

Xử lý lỗi

Quan hệ được lưu trong ResidentApartmentMemberships. Tạo cư dân mới phải đi qua /admin/resident-memberships; generic create cho residents bị chặn bằng workflow-required. Đổi mã căn hộ dùng transaction chuyên biệt để cập nhật các reference liên quan.
Xem quan hệ dữ liệu tại Domain model.