📊 Simulate GPA - by Chau Nhat Duy

Ứng dụng cá nhân hóa giúp sinh viên tính toán, mô phỏng và quản lý GPA học tập một cách trực quan, hiện đại và tiện lợi.

🚀 Tổng quan

Simulate GPA là ứng dụng web giúp bạn:

• ✅ Tính toán GPA với nhiều thang đo (Việt Nam, Mỹ, Simple...)
• 📈 Mô phỏng kết quả học tập tương lai
• 📅 Quản lý thời khóa biểu, học kỳ, môn học
• 📊 Xuất báo cáo Excel, backup dữ liệu
• 💾 Sao lưu/phục hồi dữ liệu an toàn

👤 Chủ sở hữu

• Tác giả: Chau Nhat Duy (ndyudev)
• Email: [Điền email của bạn ở đây nếu muốn]
• GitHub: https://github.com/ndyudev
• Facebook: https://facebook.com/User.ChauuNhatDuyy.X.DeveloperIT/
• Instagram: https://www.instagram.com/nhyuh.ndyut/
• LinkedIn: https://www.linkedin.com/in/chauu-nhat-duyy-intech/

✨ Tính năng nổi bật

• Tính GPA real-time với nhiều thang đo
• Quản lý học kỳ, môn học linh hoạt
• Mô phỏng điểm số, đặt mục tiêu GPA
• Xuất/nhập dữ liệu Excel, JSON
• Thời khóa biểu trực quan, phát hiện xung đột
• Backup tự động, khôi phục dễ dàng

🛠️ Công nghệ sử dụng

• Next.js 14 (App Router)
• TypeScript
• Tailwind CSS
• React Hooks
• XLSX (xuất Excel)
• Lucide React (icons)

📦 Cài đặt & chạy dự án

1. Clone hoặc tải mã nguồn

git clone <repo-cua-ban-hoac-tai-file-zip>
cd Simulate-GPA-main/Simulate-GPA-main

2. Cài đặt dependencies

npm install

3. Chạy development server

npm run dev

Truy cập: http://localhost:3000

4. Build production

npm run build
npm start

🌐 Deploy lên Vercel

1. Push code lên GitHub
2. Đăng nhập vercel.com, import project
3. Vercel tự động build & deploy

📖 Hướng dẫn sử dụng nhanh

1. Thêm môn học: Click "➕ Thêm môn", nhập thông tin
2. Nhập điểm: Điền điểm số (0-10)
3. Xem GPA: Hiển thị real-time
4. Xuất báo cáo: Click "📊 Xuất Excel"
5. Mô phỏng kết quả: Sử dụng chức năng mô phỏng để đặt mục tiêu

🏗️ Cấu trúc dự án

Simulate-GPA-main/
  └── Simulate-GPA-main/
        ├── app/            # Next.js App Router
        ├── components/     # React components
        ├── types/          # TypeScript types
        ├── utils/          # Logic tính toán, lưu trữ
        ├── public/         # Static assets
        ├── package.json    # Thông tin dependencies
        └── ...

📜 Bản quyền

• Dự án cá nhân hóa bởi Chau Nhat Duy. Bạn có thể sử dụng, chỉnh sửa, chia sẻ cho mục đích học tập và cá nhân.

⚠️ BẢN QUYỀN & ĐIỀU KHOẢN SỬ DỤNG

• Bản quyền thuộc về Chau Nhat Duy.
• Dự án này chỉ phục vụ mục đích tham khảo cá nhân.
• Nghiêm cấm sao chép, sử dụng lại, chỉnh sửa hoặc phân phối dưới bất kỳ hình thức nào khi chưa có sự đồng ý bằng văn bản của tác giả.
• Mọi hành vi vi phạm sẽ bị xử lý theo quy định của pháp luật Việt Nam và quốc tế về bản quyền.

---

Made with ❤️ by Chau Nhat Duy