personal-income-tax-system

🧾 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
Công nghệ sử dụng
Cài đặt nhanh
Tài khoản mẫu
Lệnh Artisan hữu ích
Cấu trúc thư mục
Quy trình nghiệp vụ
Đóng góp
Liên hệ
Bản quyền

🚀 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ệ

Email: ngduog.04@gmail.com
Github: duongnv12