Backend Architecture

Table of Contents

• Backend Architecture
  • Table of Contents
  • Overview
    • Key Architecture Principles
    • Technology Stack
    • Related Documentation
  • Laravel Project Structure
    • Top-Level Directory Structure
    • Key Directories Explained
      • (CUR Orchestration)
      • (Modular Architecture)
  • Design Patterns
    • Model-View-Controller (MVC)
    • Controller → Model Pattern (Simplified)
    • Repository Pattern (Emerging)
    • Observer Pattern
  • Modular Architecture
    • Laravel Modules (nWidart)
    • Creating a New Module
    • Module Best Practices
  • CentralLogics Orchestration Layer (CUR)
    • Purpose
    • Key Files
    • CUR Orchestration Patterns
  • Package System Architecture (CPFP)
    • Overview
    • Data Model
    • Model Relationships
      • Package Model ()
      • PackageConfiguration Model
      • PackageOption Model
    • Package Customization Flow
  • Subscription System Architecture
    • Overview
    • Restaurant Subscription Model
    • Customer Subscription Model
    • Subscription Scheduling Logic
    • Pause Functionality
  • Order System Architecture
    • Overview
    • Order Models
    • Order Placement Flow
    • Order Status State Machine
  • Restaurant System Architecture
    • Overview
    • Business Model Toggle
    • Zone-Based Filtering (Global Scope)
  • Service Layer & Business Logic
    • Current State
    • Recommended Service Layer Architecture
  • Payment Gateway Integration
    • Supported Gateways (12+)
    • Payment Gateway Trait
    • Payment Flow
    • Payment Methods in Order Schema
  • Notification System
    • Multi-Channel Architecture
    • Notification Models
    • Notification Trait
    • Notification Events
  • File Storage & CDN
    • Storage Configuration
    • Storage Model (Polymorphic)
    • Dynamic URL Generation
    • File Upload Locations
    • Upload Helper
  • Caching Strategy
    • Current Implementation
    • Recommended Caching Strategy
  • Architecture Gaps & Future Improvements
    • Critical Gaps (High Priority)
    • Medium Priority Gaps
    • Low Priority Gaps
    • Recommendations Priority Matrix
  • Authentication & Authorization
    • JWT Token-Based Authentication
    • Authentication Guards
    • Middleware Protection
    • Role-Based Access Control (RBAC)
  • Code Organization Principles
    • 1. Single Responsibility Principle
    • 2. Dependency Injection
    • 3. Eloquent Relationships
    • 4. Query Scopes
    • 5. Form Request Validation
  • Data Flow
    • Typical API Request Flow
    • Example: Creating a Package
  • Cross-Project Integration
    • Backend ↔ Mobile/Web
    • Admin Dashboard ↔ Vendor Dashboard
  • Next Steps
    • For Developers
    • For Architects
    • For Product Managers
  • Version History