Nhà Cộng

Documentation Center

System Guide

Resident Management

UP: 07/04/2026
AI MODERATOR
~15 MINS

Quản Lý Cư Dân(Khu Vực Cư Dân)

A. Tổng Quan (Dashboard)

  1. Widget Thông báo: Các bản tin về toà nhà, Các tin nhắn khẩn cấp từ tòa nhà (cắt điện, lịch bảo trì chúng, bảo trì riêng thiết bị bàn giao 3 tháng 1 lần)...).
  2. Trạng thái hóa đơn: Hiển thị số tiền cần đóng ngay và hạn thanh toán.
  3. Lối tắt nhanh (Quick Actions): Nút bấm nhanh để "Báo cháy" "Báo hỏng" "yêu cầu dịch vụ", "Gia hạn" " Trả phòng" hoặc "Lấy mã QR cửa". và Yêu cầu dịch vụ đang diễn ra.
  4. Thông tin nhà:
  • Toà nhà đang ở, Hợp đồng đang thực thi( còn hiệu lực, và còn hiệu lực bao nhiêu ngày)
  • Điểm Cộng đang có , Đồng cộng đã nạp, Đồng cộng đã tích luỹ

B. My Profile (Trang cá nhân)

  • NET ID: Mã QR cá nhân để quét vào cổng hoặc nhận diện cư dân. cấp mã định danh cho cư dân, nếu là cứ dân hiển thị luôn mã hợp đồng.
  • Điểm Cộng (Điểm tín nhiệm): Hiển thị thứ hạng cư dân dựa trên việc đóng tiền đúng hạn và tuân thủ nội quy.
  • Đồng Cộng :
  • Lịch sử xem phòng và Lịch sử thuê phòng
  • Cài Đặt(Settings): Thay đổi avata, thay đổi nickname (không phải thay đổi tên vì đã quy định trên hợp đồng) Thay đổi mật khẩu, cài đặt thông báo, ưu đãi, khuyễn mãi (qua Email/Zalo).

C. My Home

Quản lý mọi thông tin liên quan đến không gian sống cá nhân.

  • Contract (Hợp đồng):

    • Xem file hợp đồng đã ký (PDF).
    • Gia hạn hợp đồng: Nút yêu cầu gia hạn kèm lựa chọn thời gian (3-6-12 tháng).
    • Nhượng phòng/Trả phòng: Form đăng ký trả phòng hoặc đăng tin nhượng phòng để hệ thống hỗ trợ tìm khách mới. (Đề xuất phí nhượng phòng =30% tiền cọc)
    • Lưu ý: Hợp đồng của khách khi trùng vào dịp Tết Nguyên đán thì hợp đồng tự động nhảy thêm 1 tháng ( Tức là chúng ta không nhận trả phòng vào dịp tết nguyên đán, nếu khách cố tình trả thì coi như là vi phạm hợp đồng và mất số tiền đã cọc)

  • Members (Thành viên): Danh sách người ở cùng, đăng ký tạm trú cho khách tới chơi qua đêm.

  • Assets (Tài sản): Danh sách nội thất đi kèm phòng (kèm hình ảnh bàn giao ban đầu để đối chiếu). lưu ý có tài sản bàn giao và tài sản cá nhân( như xe máy cần khai báo để đo lường tài sản và quản lý)

D. Billing (Hóa đơn & Điện nước)

Minh bạch các khoản chi phí hàng tháng.

  • Monthly Bill (Hóa đơn hàng tháng): Liệt kê tổng tiền phòng, phí quản lý, phí xe... (Có tích hợp cổng thanh toán online).
  • Utility Tracker (Theo dõi điện nước , nước ): * Xem ảnh chụp chỉ số đồng hồ thực tế do nhân viên tải lên.
    • Biểu đồ so sánh mức dùng điện nước giữa các tháng để cư dân điều chỉnh.
  • Payment History (Lịch sử thanh toán): Lưu trữ các hóa đơn cũ để đối soát khi cần.

E. Support Services (Dịch vụ hỗ trợ)

Nơi tương tác trực tiếp với bộ phận Kỹ thuật và Tạp vụ.

  • Maintenance (Báo hỏng kỹ thuật): * Gửi yêu cầu sửa chữa (có đính kèm ảnh/video lỗi). Lưu ý: có ghi hiểu để Kỹ thuật nắm được hỏng có nẳm trong thời gian bảo hành hay không? Nếu trong thời gian bảo hành là miễn phí, nếu ngoài bảo hành sẽ tính phí. Kỹ thuật sẽ tạo hoá đơn dịch vụ.
    • Theo dõi tiến độ: "Tiếp nhận" ->"Kỹ thuật đang đến" -> "Đang sửa" -> "Hoàn thành".
  • Cleaning (Dịch vụ dọn dẹp): * Đặt lịch dọn phòng định kỳ hoặc đột xuất (Tạp vụ phụ trách).
    • Ghi chú đặc biệt cho nhân viên (Ví dụ: "Không di chuyển đồ trên bàn làm việc").
  • Feedback (Đánh giá & Góp ý): Chấm sao và gửi lời cảm ơn sau mỗi lần nhân viên hỗ trợ. Sau khi Kỹ thuật hoặc Tạp vụ xong việc, cư dân có thể chấm sao (1-5 sao). Đây là dữ liệu để bạn quản lý chất lượng nhân viên.

F. Tiện ích và Cộng đồng cư dân(Utilities và Community Hub)

Xây dựng văn hóa "Net Partners" kết nối mọi người.

  • News (Bản tin): Cập nhật các sự kiện, quy định mới của tòa nhà.
  • Sổ tay cư dân số: Chứa các nội quy tòa nhà, hướng dẫn sử dụng thiết bị, số điện thoại khẩn cấp. Hướng dẫn sơ cứu , cấp cứu, cứu hộ cứu nạn khi có hoả hoạn. Hướng dẫn sơ cứu ý tế cơ bản.
  • Ưu đãi/Khuyến mại : Danh sách các ưu đãi khi xếp hạng cư dân, Danh sách các mã giảm giá khi thuê phòng, Danh sách các cửa hàng, quán cafe quanh khu vực đang giảm giá cho cư dân Nhà Cộng
  • Marketplace (Chợ cư dân): Nơi cư dân đăng tin pass đồ cũ, đồ gia dụng (vừa giúp nhượng phòng hiệu quả).

G. Đăng ký Nhà Tiếp Thị ( Affiliate/CTV)

  • Top các nhà tiếp thị đang có doanh số tốt nhất . Doanh thu ( RV) , Số tiền hàng bán , Có avata để tăng độ uy tín.
  • Chính sách và quyền lợi khi trở thành nhà tiếp thị
  • Nút đăng ký.

CURRENT IMPLEMENTATION STATUS & MISSING FEATURES

Last Updated: 2026-04-07

✅ Implemented Features

Navigation & Core Structure ✓

  1. Navigation Structure: Sidebar menu (
    DOCUMENTATION CODE
    CuDanSidebar
    ) exists with links to key sections
  2. Dashboard Overview: Basic "Tổng quan" page implemented at
    DOCUMENTATION CODE
    /quan-ly-cu-dan

History & Activity ✓

  1. History Tracking:
    • DOCUMENTATION CODE
      Lịch sử xem phòng
      (View History) - IMPLEMENTED
    • DOCUMENTATION CODE
      Lịch sử thuê phòng
      (Rental History) - IMPLEMENTED

Points & Rewards System ✓

  1. Points & Rewards:
    • DOCUMENTATION CODE
      Điểm cộng
      (Points) page exists
    • DOCUMENTATION CODE
      Đồng cộng
      (Coins) page exists
    • DOCUMENTATION CODE
      Ưu đãi
      (Deals) page exists
    • DOCUMENTATION CODE
      Khuyến mãi
      (Promotions) page exists
    • Status: IMPLEMENTED

Financial ✓

  1. Billing:
    • DOCUMENTATION CODE
      Hóa đơn
      (Billing) page exists
    • Basic invoice viewing functionality

Service Requests ✓

  1. Requests:
    • DOCUMENTATION CODE
      Trang yêu cầu
      (Request Page) exists
    • DOCUMENTATION CODE
      Báo cháy
      (Fire Report) - IMPLEMENTED
    • DOCUMENTATION CODE
      Báo sửa chữa
      (Repair Request) - IMPLEMENTED

CTV Registration ✓

  1. Affiliate:
    • DOCUMENTATION CODE
      Đăng ký CTV
      (Register Affiliate) page exists

✅ Implemented Features (Verified)

Section C: My Home (Căn hộ của tôi) ✓

  1. Contract Management (Hợp đồng):

    • View PDF, Request Extension, Contract History.
    • Status: FULLY IMPLEMENTED

  2. Members (Cư dân cùng phòng):

    • Manage shared residents, registered guests.
    • Status: FULLY IMPLEMENTED

  3. Room Assets (Bàn giao tài sản):

    • Itemized list of inventory with photos/status.
    • Status: FULLY IMPLEMENTED

Section E: Support Services (Dịch vụ hỗ trợ) ✓

  1. Maintenance (Báo hỏng & Sửa chữa):

    • Upload photos, track status from 'Pending' to 'Done'.
    • Status: FULLY IMPLEMENTED

  2. Cleaning & Fire Protection (Vệ sinh & PCCC):

    • Book cleaning, report fire hazards.
    • Status: FULLY IMPLEMENTED

  3. Complaints (Khiếu nại):

    • Direct feedback/tickets to management.
    • Status: FULLY IMPLEMENTED

Section F: Community & Utilities ✓

  1. Community Hub ✓

    • Status: IMPLEMENTED
    • Done: Landing page (
      DOCUMENTATION CODE
      /cong-dong
      ), News List (
      DOCUMENTATION CODE
      /tin-tuc
      ), Handbook (
      DOCUMENTATION CODE
      /cam-nang
      ).

  2. Digital Handbook ✓

    • Status: IMPLEMENTED
    • Done: Categorized handbook reader.

  3. Marketplace ✓

    • Status: IMPLEMENTED
    • Done: Listing grid and "Post Item" modal (
      DOCUMENTATION CODE
      /cho
      ).

❌ Missing Features (Not Implemented)

Section D: Billing Details ⚠️

  1. Utility Tracker ❌
    • No visual chart/graph for electricity/water usage
    • No monthly comparison feature
    • Current system likely only shows meter readrings
    • Priority: LOW (Nice to have)
    • Effort: Low (Frontend charting)

⚠️ Needs Improvement/Verification

Section A: Dashboard Widgets ⚠️

  1. Quick Actions Completeness ⚠️
    • Verify if all planned quick actions are present:
      • ✓ Báo cháy (Fire)
      • ✓ Báo hỏng (Repair)
      • ? Yêu cầu dịch vụ (Service Request)
      • ? Gia hạn hợp đồng (Extend Contract)
      • ? Trả phòng (Checkout)
      • ? Lấy mã QR cửa (Get Door QR)
    • Action: Review dashboard to verify all buttons exist

Section B: Profile & Chat ⚠️

  1. NET ID QR Code ⚠️

    • Needs verification if QR code is displayed on Profile or Dashboard
    • QR should show: Resident ID + Contract info
    • Action: Verify implementation

  2. Chat/Messaging ⚠️

    • Status: IMPLEMENTED (UI) / NEEDS BACKEND FIX
    • Path:
      DOCUMENTATION CODE
      /quan-ly-cu-dan/chat
    • Note: Backend chat đang lỗi runtime (Forbidden, unknown column
      DOCUMENTATION CODE
      conversationId
      ).

Points System Logic ⚠️

  • Pages exist but need to verify:
    • Is the 100 points/month allocation automated?
    • Are tier rankings (Đồng, Bạc, Vàng, Kim Cương) functional?
    • Do benefits/discounts actually apply based on tier?
  • Action: Test points system end-to-end

Đồng Cộng Wallet ⚠️

  • Verify that:
    • Top-up functionality works
    • Withdrawal is restricted correctly (nạp: can withdraw, thưởng: cannot)
    • 1 DC = 1 VND display is correct
  • Action: Test wallet operations

Dashboard Widgets ⚠️

  • Contract info widget (building, days remaining, expiry date)
  • Points/Coins balance display
  • Action: Verify all widgets show correct data

Summary & Priority Action Items

High Priority (Implement Soon)

  1. ✅ Contract Management Page - View PDF, extend, checkout requests
  2. ✅ Chat/Messaging Feature - Communicate with landlord/support
  3. ✅ Service Request Improvements - Add cleaning service booking

Medium Priority

  1. ⚠️ Assets Management - Room inventory and handover photos
  2. ⚠️ Feedback System - Rate technicians and services
  3. ⚠️ News/Announcements Section - Dedicated news feed
  4. ⚠️ Digital Handbook - Emergency guides and resources

Low Priority

  1. ❓ Marketplace - Resident-to-resident trading
  2. ❓ Utility Usage Charts - Visual consumption tracking

Verification Needed

  1. 🔍 Test Points & Coins system thoroughly
  2. 🔍 Verify Quick Actions completeness on Dashboard
  3. 🔍 Check NET ID QR code implementation
Previous Page
Host Management
Next Page
Affiliate Management