Green Tax – Automated Income Tax Management System
Green Tax is a sophisticated, data-driven web application designed to simplify and automate the complex process of income tax calculation for individuals in Bangladesh. Built with Laravel 11, the system ensures compliance with the latest tax regulations, providing a seamless bridge between dynamic administrative configurations and end-user tax filings.
The Challenge
Income tax laws are subject to frequent changes, featuring complex slabs, conditional exemptions, and multifaceted investment rebate rules. Traditional spreadsheets are error-prone and difficult for non-experts to navigate. The project required a solution that was dynamically configurable, highly accurate, and user-friendly with a 3-phase guided wizard.
Technology Stack
PHP 8.3, Laravel 11 (LTS)
Blade Templates, TailwindCSS v4, Alpine.js
Service Layer Pattern, Repository Pattern, Pipeline Pattern
Impact & Results
Simplified a 20+ page tax law document into a 5-minute user journey.
Enabled non-technical tax consultants to update the system for new fiscal years through the Admin Panel.
Achieved 100% accuracy in complex scenarios validated through a robust Pest/PHPUnit test suite.
Core Principles
Architectural Excellence
The project stands out due to its adherence to advanced software design patterns, ensuring maintainability and scalability.
Data-Driven Calculation Engine
Utilizes a Strategy Pattern and Pipeline Pattern. The Pipeline breaks down validation and calculation into discrete stages, while the Strategy pattern dynamically applies different logic for Individual, Female, Senior Citizen, or Disabled categories.
Service Layer & Repository Pattern
Business logic is decoupled from Controllers and stored in dedicated Services (TaxCalculationService.php). Data access is abstracted via Repositories, facilitating easy unit testing.
Smart Caching
Implements a TaxConfigurationCache that stores complex tax slab hierarchies and rebate rules, reducing database load during high-traffic tax seasons.
Experience Design
Key Features
Dynamic Admin Dashboard
Full control over financial years, tax slabs, investment fields, and rebate caps.
3-Phase Tax Wizard
Phase 1: Personal details. Phase 2: Investment profile and Area Type. Phase 3: Instant breakdown and certificate preview.
Secure Certificate Verification
Unique certificate_id generated for every calculation. Public verification portal allows third-party verification via QR code.
Audit Logging
Comprehensive tracking of admin actions and configuration changes to ensure system integrity.