Automated Tax

Automated Tax is a modern Tax Management System built using Laravel 12, Blade templating, and the Spatie Laravel Permission package. The system enables organisations to efficiently manage tax records, monitor payments and control access using role-based permissions.

Features

• User management with role-based access control (via Spatie)
• Tax record management: create, view, update and delete tax records
• Dashboard: clean, intuitive interface built with Blade templates
• Reports: generate tax reports for analysis and auditing

Technology Stack

• Backend: Laravel 12
• Frontend: Blade templating engine
• Authentication & Authorization: Spatie Laravel Permission
• Database: MySQL (configurable via .env)

Installation

1. Clone the repository:

   git clone https://github.com/esteham/automated-tax.git  
   cd automated-tax  

2. Install dependencies:

   composer install  
   npm install  
   npm run dev  

3. Setup environment file:

   cp .env.example .env  

   Then update your database & other settings in .env (for example):

   DB_CONNECTION=mysql  
   DB_HOST=127.0.0.1  
   DB_PORT=3306  
   DB_DATABASE=automated_tax  
   DB_USERNAME=root  
   DB_PASSWORD=  
   

4. Generate the application key:

   php artisan key:generate  

5. Run migrations and seeders:

   php artisan migrate --seed  

6. Start the development server:

   php artisan serve  

   Visit http://localhost:8000 in your browser.

Usage

• Admin users can manage roles, permissions and all tax records.
• Regular users can view and manage only the tax records assigned to them.
• Generate reports from the dashboard for auditing and analysis.

Packages Used

• Spatie Laravel Permission – Role & permission management
• Laravel 12 – PHP framework
• Blade – Templating engine

Host Hint

If deploying to a server and your framework root isn’t pointing to /public, you may need to add to your .htaccess in the root directory:

RewriteEngine On  
RewriteRule ^(.*)$ public/$1 [L]  

Contributing

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to your branch (git push origin feature/your-feature)
5. Open a Pull Request

License

This project is open-source and available under the MIT License.

Author

Created by Esteham.

---

If you like, I can generate a detailed README version with more sections (e.g., configuration details, screenshots, deployment instructions, tests) for you. Would you like that?