> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taho.com.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Tương tác cư dân

> Cách tiếp nhận ý kiến, xử lý yêu cầu dịch vụ, phản hồi và tài liệu đính kèm.

Bạn dùng khu vực này để tiếp nhận ý kiến, xử lý yêu cầu dịch vụ và theo dõi trao đổi với cư dân.

## Chọn đúng màn hình

| Nhu cầu | Màn hình |
| - | - |
| Ghi nhận và xử lý phản ánh | **Ý kiến cư dân** |
| Đăng ký phương tiện, hủy phương tiện hoặc cấp lại thẻ | **Yêu cầu dịch vụ** |
| Quản lý mẫu thu thập ý kiến | **Thiết lập mẫu Form** |
| Theo dõi hồ sơ sửa chữa căn hộ | **Đăng ký sửa chữa** |

## Tiếp nhận ý kiến hoặc yêu cầu

**1. Mở màn hình phù hợp**

Chọn **Ý kiến cư dân** hoặc **Yêu cầu dịch vụ** trong menu quản trị.

**2. Chọn Thêm mới**

Nhập căn hộ, nội dung và các thông tin được biểu mẫu yêu cầu.

**3. Đính kèm tài liệu nếu cần**

Hệ thống nhận JPEG, PNG, WebP hoặc PDF. Bạn được gửi tối đa 4 file, mỗi file tối đa 2 MB.

**4. Gửi yêu cầu**

Bản ghi mới bắt đầu ở trạng thái chờ xử lý.

## Xử lý và phản hồi

Khi mở một ý kiến hoặc yêu cầu, người có quyền có thể:

* đổi trạng thái xử lý;
* gửi phản hồi và đính kèm file;
* xem lịch sử trao đổi;
* tạo và hoàn thành công việc đối với ý kiến cư dân;
* xóa ý kiến khi có quyền xóa.

Khi phản hồi một bản ghi đang chờ, hệ thống có thể chuyển bản ghi sang trạng thái đang xử lý. Các trạng thái được hiển thị tại [State machines](https://docs.taho.com.vn/product-specs/state-machines.md).

> [!NOTE]
>
> Với ý kiến đã **Đã hoàn thành**, giao diện chỉ giữ trạng thái hoàn thành và server chặn mở lại qua cập nhật trạng thái. Yêu cầu dịch vụ hiện có tập lựa chọn trạng thái khác; giới hạn chuyển trạng thái được mô tả tại [Tình trạng tính năng](https://docs.taho.com.vn/reference/release-status.md).

## Xử lý lỗi

| Khi gặp | Điều kiện source đang kiểm tra |
| - | - |
| Không tải được file đính kèm | File phải là JPEG, PNG, WebP hoặc PDF; tối đa 4 file, 2 MB mỗi file và 10 MB cho toàn request. |
| Không thao tác được bản ghi | Request phải thuộc active tower và tài khoản phải có quyền tương ứng. |
| Không tạo được task cho service request | Task create/complete chỉ được tìm thấy trong feedback workflow. |

> [accordion] Dành cho kỹ thuật
>
> Mọi thao tác trên đi qua `POST /admin/resident-workflow`. Comments, attachments và tasks được lưu riêng, sau đó liên kết với feedback hoặc service request. Tổng request body bị giới hạn 10 MB; file được kiểm tra MIME, extension và signature.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.