🧾 Hệ Thống Tính Thuế Thu Nhập Cá Nhân (PIT System)

Hệ thống web giúp quản lý, khai báo và tính toán thuế thu nhập cá nhân (TNCN) cho cá nhân tại Việt Nam. Hỗ trợ quản lý người dùng, nguồn thu nhập, người phụ thuộc, các khoản giảm trừ, và xuất báo cáo PDF.
📑 Mục lục
🚀 Tính năng chính
- Đăng ký, đăng nhập, xác thực email, phân quyền Admin/người dùng.
- Quản lý thông tin cá nhân, đổi mật khẩu, xóa tài khoản.
- Khai báo nguồn thu nhập, khoản thu nhập hàng tháng/năm.
- Quản lý người phụ thuộc, khai báo thời gian giảm trừ.
- Tính toán thuế TNCN tự động theo quy định hiện hành.
- Quản lý các bậc thuế, tham số hệ thống (giảm trừ, tỷ lệ bảo hiểm…).
- Xuất báo cáo quyết toán thuế cuối năm và khai báo thu nhập ra file PDF.
- Giao diện hiện đại, responsive, hỗ trợ tiếng Việt.
🛠️ Công nghệ sử dụng
- Backend: Laravel 12+, PHP 8.2+
- Frontend: Blade, TailwindCSS, FontAwesome
- Database: MySQL
- PDF: barryvdh/laravel-dompdf
- Xác thực: Laravel Breeze, Sanctum
⚡ Cài đặt nhanh
git clone https://github.com/duongnv12/personal-income-tax-system.git
cd personal-income-tax-system
composer install
npm install
cp .env.example .env
# Chỉnh sửa thông tin kết nối DB trong .env
php artisan key:generate
php artisan migrate --seed
npm run build
php artisan serve
Truy cập hệ thống tại: http://localhost:8000
👤 Tài khoản mẫu
Loại tài khoản |
Email |
Mật khẩu |
Admin |
admin@example.com |
password |
User thường |
user@example.com |
password |
🧩 Lệnh Artisan hữu ích
- Làm mới database và seed lại dữ liệu:
php artisan migrate:fresh --seed
- Xóa cache:
php artisan config:clear
php artisan cache:clear
php artisan route:clear
📂 Cấu trúc thư mục
app/Http/Controllers/
– Controllers cho các chức năng chính
app/Services/TaxCalculationService.php
– Logic tính toán thuế
resources/views/
– Giao diện Blade
database/seeders/
– Seeder dữ liệu mẫu
routes/web.php
– Định nghĩa route web
🔄 Quy trình nghiệp vụ
Toàn bộ logic tính toán thuế thu nhập cá nhân được đóng gói trong app/Services/TaxCalculationService.php
.
Quy trình tổng quát:
- Thu thập dữ liệu đầu vào:
- Thông tin cá nhân, thu nhập, người phụ thuộc, các khoản giảm trừ, bảo hiểm, v.v.
- Tính tổng thu nhập chịu thuế:
- Tổng hợp các khoản thu nhập hợp lệ theo quy định.
- Áp dụng các khoản giảm trừ:
- Giảm trừ gia cảnh cho bản thân, người phụ thuộc, bảo hiểm bắt buộc, các khoản đóng góp hợp lệ.
- Tính thu nhập tính thuế:
- Thu nhập chịu thuế = Tổng thu nhập - Tổng giảm trừ.
- Phân bậc thuế và tính số thuế phải nộp:
- Áp dụng biểu thuế lũy tiến từng phần theo quy định hiện hành.
- Xuất kết quả:
- Trả về số thuế phải nộp, chi tiết từng bậc thuế, tổng giảm trừ, và các thông tin liên quan để hiển thị hoặc xuất báo cáo PDF.
Lưu ý:
Mọi thay đổi về quy định thuế, mức giảm trừ, hoặc biểu thuế đều được cấu hình tập trung tại Service này để dễ bảo trì và cập nhật.
🤝 Đóng góp
Mọi đóng góp, báo lỗi hoặc đề xuất đều được hoan nghênh!
Vui lòng tạo issue hoặc gửi pull request.
📬 Liên hệ
©️ Bản quyền
Bản quyền © 2025 – Dự án mã nguồn mở phục vụ mục đích học tập và tham khảo.