Laravel Project Structure

Admin-Seller_Portal/
├── app/                          # Application core
│   ├── CentralLogics/            # ✨ CUR orchestration layer (custom)
│   ├── Console/                  # Artisan commands
│   ├── Exceptions/               # Exception handlers
│   ├── Http/                     # Controllers, middleware, requests
│   │   ├── Controllers/
│   │   │   ├── Admin/            # CAD project controllers
│   │   │   ├── Api/V1/           # API controllers (mobile/web)
│   │   │   └── Vendor/           # CAR project controllers
│   │   ├── Middleware/           # Request middleware
│   │   └── Requests/             # Form request validation
│   ├── Library/                  # Third-party integrations
│   ├── Mail/                     # Email templates (Mailable classes)
│   ├── Models/                   # Eloquent models
│   ├── Observers/                # Model observers (events)
│   ├── Providers/                # Service providers
│   ├── Rules/                    # Custom validation rules
│   ├── Scopes/                   # Query scopes
│   ├── Traits/                   # Reusable traits
│   └── helpers.php               # Global helper functions
├── bootstrap/                    # Framework bootstrap
├── config/                       # Configuration files
│   ├── auth.php                  # Authentication guards
│   ├── database.php              # Database connections
│   ├── mail.php                  # Email configuration
│   └── ...
├── database/                     # Database files
│   ├── factories/                # Model factories (testing/seeding)
│   ├── migrations/               # Database migrations
│   └── seeders/                  # Database seeders
├── docs/                         # ✨ Project documentation (BMAD)
│   ├── sprint-artifacts/         # Sprint tracking
│   ├── index.md                  # Documentation hub
│   ├── architecture.md           # This file
│   └── ...
├── Modules/                      # ✨ Modular architecture (nWidart)
│   ├── TaxModule/                # Tax calculation module
│   └── ...                       # Other feature modules
├── public/                       # Publicly accessible files
│   ├── index.php                 # Entry point
│   └── storage/                  # Symlink to storage/app/public
├── resources/                    # Views, assets
│   ├── views/                    # Blade templates
│   │   ├── admin-views/          # CAD dashboard views
│   │   ├── vendor-views/         # CAR dashboard views
│   │   └── layouts/              # Shared layouts
│   └── lang/                     # Localization files
├── routes/                       # Route definitions
│   ├── api/                      # API routes
│   │   ├── v1/                   # API version 1
│   │   │   └── api.php           # Main API routes
│   │   └── v2/                   # API version 2 (future)
│   ├── admin.php                 # Admin dashboard routes (CAD)
│   ├── vendor.php                # Vendor dashboard routes (CAR)
│   ├── web.php                   # Web routes (landing pages)
│   └── channels.php              # Broadcast channels
├── storage/                      # Application storage
│   ├── app/                      # Application files
│   ├── framework/                # Framework files
│   └── logs/                     # Application logs
├── tests/                        # PHPUnit tests
│   ├── Feature/                  # Feature tests
│   └── Unit/                     # Unit tests
├── vendor/                       # Composer dependencies
├── .env                          # Environment configuration
├── artisan                       # Artisan CLI
├── composer.json                 # PHP dependencies
└── package.json                  # Node dependencies

use App\CentralLogics\Helpers;
 
// Error formatting
$errors = Helpers::error_processor($validator);
 
// Get business setting
$scheduleOrderEnabled = Helpers::schedule_order();
 
// Generate full image URL
$imageUrl = Helpers::get_full_url('package', $imageName, 'public');

class PackageController extends Controller
{
    public function index(Request $request)
    {
        // 1. Validate request
        $validator = Validator::make($request->all(), [
            'restaurant_id' => 'required|exists:restaurants,id',
        ]);
 
        if ($validator->fails()) {
            return response()->json(['errors' => Helpers::error_processor($validator)], 403);
        }
 
        // 2. Retrieve data via Eloquent
        $packages = Package::where('restaurant_id', $request->restaurant_id)
            ->where('status', true)
            ->with(['configurations.options.food'])
            ->get();
 
        // 3. Return JSON response
        return response()->json($packages, 200);
    }
}

Modules/TaxModule/
├── Config/
├── Console/
├── Database/
│   ├── Migrations/
│   └── Seeders/
├── Entities/            # Models
├── Http/
│   ├── Controllers/
│   └── Requests/
├── Providers/
│   ├── TaxModuleServiceProvider.php
│   └── RouteServiceProvider.php
├── Resources/
│   ├── assets/
│   └── views/
├── Routes/
│   ├── api.php
│   └── web.php
├── Tests/
├── composer.json
└── module.json