Add Car Clearance Management System

[coder-contrib-bot]

Summary

• Full-stack Car Clearance Management System built with PHP 8+, MySQL, and Bootstrap 5
• MVC architecture with PDO prepared statements, role-based access control, and dual currency support (USD/SSP)
• Includes dashboard, CRUD operations, filterable reports with print view, and user management

Features

• Authentication: Login with password_hash()/password_verify(), PHP sessions, admin/user roles
• Clearance Records: Date, truck number, consignment, items, truck type, amounts in USD/SSP with currency radio toggle
• Dashboard: Searchable/sortable/filterable table with summary cards
• Reports: Date range and truck number filters, print-friendly view with CSS @media print
• User Management: Admin-only CRUD for users with role assignment
• Security: PDO prepared statements, XSS prevention, input validation (client + server)

Tech Stack

• PHP 8+ with PDO/MySQL
• Bootstrap 5 + Bootstrap Icons
• Vanilla JavaScript
• MVC folder structure: /controllers, /models, /views, /public

Setup

See car-clearance-system/README.md for full XAMPP/Laragon setup instructions.

Default login: admin / admin123

Author

• GIT_AUTHOR_NAME: default
• GIT_AUTHOR_EMAIL: sundaymoses388@gmail.com

Test plan

• Import database/schema.sql into MySQL
• Access public/index.php and verify login page renders
• Login with admin/admin123
• Create a new clearance record with USD payment
• Create a new clearance record with SSP payment
• Verify currency toggle disables the inactive field
• Filter records by date range and truck number
• Test print report view opens in new tab
• Add a new user and verify they can login
• Verify regular users cannot access user management
• Test edit/delete operations as admin

🤖 Generated with Claude Code