Chức Năng — Hệ Thống Quản Lý Chung Cư
1. Đăng nhập & Xác thực
Đăng nhập bằng tài khoản, xác thực JWT. Hỗ trợ xem thông tin cá nhân, đổi mật khẩu. Phân quyền 4 vai trò: Admin, Manager, Employee, Resident.
2. Dashboard
Thống kê tổng quan: số căn hộ, cư dân, hóa đơn, doanh thu. Resident chỉ xem thống kê căn hộ của mình. Quyền: Tất cả (Resident giới hạn)
3. Quản lý Cư dân
Xem danh sách, thêm, sửa, xóa cư dân. Thông tin gồm: họ tên, SĐT, email, CCCD, ngày sinh, giới tính. Hỗ trợ phân trang và tìm kiếm. Quyền: Admin, Manager, Employee
4. Quản lý Căn hộ
Xem danh sách, thêm, sửa, xóa căn hộ. Thông tin gồm: mã căn hộ, tầng, diện tích, số phòng, trạng thái. Gán/xóa cư dân vào căn hộ (quan hệ nhiều-nhiều), ghi nhận ngày chuyển đến/chuyển đi. Quyền: Admin, Manager, Employee (gán/xóa cư dân chỉ Admin, Manager)
5. Quản lý Dịch vụ
Xem danh sách, thêm, sửa, xóa dịch vụ (nước, phí quản lý, gửi xe...). Đăng ký dịch vụ cho từng căn hộ (quan hệ nhiều-nhiều). Quyền: Admin, Manager
6. Quản lý Nhân viên
Xem danh sách, thêm, sửa, xóa nhân viên. Thông tin gồm: họ tên, SĐT, email, chức vụ, phòng ban. Hỗ trợ phân trang và tìm kiếm. Quyền: Admin, Manager
7. Quản lý Hóa đơn
Xem danh sách, tạo, sửa, xóa hóa đơn. Lọc theo tháng, năm, trạng thái. Xem hóa đơn quá hạn. Chi tiết gồm các dịch vụ, số lượng, đơn giá, thành tiền. Resident xem hóa đơn của mình. Quyền: Admin, Manager, Employee
8. Thanh toán
Tạo thanh toán cho hóa đơn, xem lịch sử thanh toán. Tự động cập nhật trạng thái hóa đơn sau thanh toán. Quyền: Admin, Manager, Employee
9. Quy định Chung cư
Xem danh sách, thêm, sửa, xóa các quy định nội bộ của chung cư. Quyền: Admin, Manager
10. Báo cáo & Thống kê
Doanh thu theo tháng, theo năm, theo từng dịch vụ. Tỷ lệ thu phí (collection rate). Lọc theo tháng/năm. Quyền: Admin, Manager
11. Quản lý Tài khoản
Xem danh sách, tạo, sửa, xóa tài khoản người dùng. Gán vai trò, liên kết với cư dân hoặc nhân viên. Reset mật khẩu. Quyền: chỉ Admin
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
Yêu cầu hệ thống
Node.js >= 16
SQL Server 2019+
npm >= 8
Cài đặt
1. Setup Database
Kết nối SQL Server và chạy các script theo thứ tự:
-- Tạo database
CREATE DATABASE apa_db;
GO
-- Chạy schema
-- Mở file database/schema.sql và execute
-- Chạy seed data
-- Mở file database/seed.sql và execute
... xem thêm chi tiết trong file readme.md
Nguồn: Topcode.vn
