Apartment-Management

Ứng dụng quản lý căn hộ (Apartment Management) giúp theo dõi và quản lý các thông tin về căn hộ, cư dân, thu – chi, bảo trì, và các chức năng liên quan khác.

---

📑 Mục lục

• Giới thiệu
• Tính năng
• Kiến trúc & Công nghệ
• Cài đặt & Chạy dự án
• Cấu trúc thư mục
• Hướng phát triển trong tương lai
• Đóng góp
• Liên hệ

---

👋 Giới thiệu

Apartment-Management là ứng dụng web giúp:

• Quản lý danh sách căn hộ, tòa nhà, các đơn vị cư dân
• Theo dõi tình trạng thuê, thanh toán (thu tiền nhà, phí dịch vụ)
• Quản lý các yêu cầu bảo trì, sửa chữa
• Báo cáo, thống kê thu chi

Ứng dụng được xây dựng với mục tiêu học tập và có thể áp dụng thực tế cho quản lý nhà trọ / chung cư.

---

✨ Tính năng

• Đăng nhập / phân quyền người dùng (Admin, Quản lý, Cư dân)
• Thêm / sửa / xoá căn hộ, cư dân, tòa nhà
• Quản lý tủ đồ online
• Quản lý thẻ xe
• Quản lý khảo sát, phản ánh
• Quản lý hợp đồng thuê, thanh toán
• Quản lý các yêu cầu bảo trì, lịch sử xử lý
• Dashboard báo cáo tổng quan: thu nhập, chi phí, trạng thái căn hộ
• Giao diện người dùng dễ sử dụng

---

🛠️ Kiến trúc & Công nghệ

• Backend: Java Spring MVC
• Frontend: ReactJS
• Database: MySQL
• Xác thực & phân quyền: Spring Security (JWT / Session)
• Công cụ hỗ trợ: Git, Postman

---

🚀 Cài đặt & Chạy dự án

Yêu cầu

• Node.js (>= 16.x)
• Java JDK 17+
• MySQL
• Maven

Các bước cài đặt

1. Clone repo:

git clone https://github.com/HoDucLinh/Apartment-Management.git

2. Backend setup

cd Apartment-Management/BE
mvn install
mvn spring-boot:run
- Cấu hình application.properties hoặc application.yml theo thông tin DB của bạn.
- Backend chạy mặc định tại http://localhost:8080.

3. Backend setup

cd Apartment-Management/FE
npm install
npm start

📂 Cấu trúc thư mục

Apartment-Management/
├── BE/                    # Backend Spring Boot
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/       # Source code Java
│   │   │   └── resources/  # Config, SQL, properties
│   └── pom.xml
├── FE/                    # Frontend ReactJS
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   └── services/
│   └── package.json
└── README.md

📈 Hướng phát triển trong tương lai

• Tích hợp gửi email / SMS thông báo khi có yêu cầu bảo trì hoặc thanh toán muộn
• Thêm tính năng tìm kiếm, lọc nâng cao
• Viết test unit & integration cho backend/frontend
• Deploy ứng dụng lên cloud (AWS, Heroku, Vercel...)

🤝 Đóng góp

Mọi đóng góp đều được hoan nghênh!

Fork repo này

Tạo nhánh mới cho tính năng hoặc bug fix (git checkout -b feature/ten-tinh-nang)

Commit thay đổi (git commit -m "Thêm tính năng X")

Push branch (git push origin feature/ten-tinh-nang)

Tạo Pull Request

📧 Liên hệ

Tác giả: Ho Duc Linh

GitHub: HoDucLinh

Email: hoduclinh080204@gmail.com