# aliffnazrii/invoicemaker architecture

> Architecture diagram of the GitHub repository aliffnazrii/invoicemaker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aliffnazrii/invoicemaker
- Repository: https://github.com/aliffnazrii/invoicemaker

## Overview

This is a Laravel/Backpack business application centered on creating and administering invoices, contacts, products, users, and company settings. The main workflow enters through Backpack routes, where invoice handling looks up or creates client and product records, records invoices and line items, and prepares invoice PDF output. Separate admin branches manage the supporting records and dashboard. The graph follows the excerpts and SOURCE INDEX; unsampled routing details and middleware behavior are not expanded beyond documented references.

Main entry points: [`app/Http/Controllers/Admin/InvoiceCrudController.php`](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/InvoiceCrudController.php) (Invoice workflow), [`routes/backpack/custom.php`](https://github.com/aliffnazrii/invoicemaker/blob/main/routes/backpack/custom.php) (Backpack routes), [`app/Http/Controllers/Admin/SettingCrudController.php`](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/SettingCrudController.php) (Settings management), [`app/Models/Invoice.php`](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Invoice.php) (Invoice records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin workflows"]
  node_admin_routes["Backpack routes<br/>[custom.php]"]
  node_admin_controller["Dashboard controller"]
  node_contact_crud["Contact management"]
  node_product_crud["Product management"]
  node_user_crud["User management"]
  node_setting_crud["Settings management"]
  node_admin_guard["Admin middleware<br/>[CheckIfAdmin.php]"]
  node_phone_trait["Phone formatting<br/>[TraitPhone.php]"]
end

subgraph group_billing["Invoicing"]
  node_invoice_crud["Invoice workflow"]
  node_invoice_view["Invoice template<br/>[invoice.blade.php]"]
end

subgraph group_domain["Business records"]
  node_invoice_model["Invoice records<br/>[Invoice.php]"]
  node_invoice_item_model["Invoice items<br/>[InvoiceItem.php]"]
  node_contact_model["Contact records<br/>[Contact.php]"]
  node_product_model["Product records<br/>[Product.php]"]
  node_user_model["User accounts<br/>[User.php]"]
end

subgraph group_support["Settings and dashboard"]
  node_setting_model["Setting records<br/>[Setting.php]"]
  node_company_settings["Company settings"]
  node_dashboard_stats["Dashboard statistics<br/>[DashboardStats.php]"]
  node_app_provider["Settings bootstrap"]
end

node_database[("Application database<br/>[database.php]")]
node_public_storage[("Public file storage")]

node_admin_routes -->|"routes to"| node_admin_controller
node_admin_routes -->|"routes to"| node_contact_crud
node_admin_routes -->|"routes to"| node_product_crud
node_admin_routes -->|"routes to"| node_user_crud
node_admin_routes -->|"routes to"| node_invoice_crud
node_admin_routes -->|"routes to"| node_setting_crud
node_admin_controller -->|"uses"| node_dashboard_stats
node_contact_crud -->|"manages"| node_contact_model
node_contact_crud -->|"uses"| node_phone_trait
node_product_crud -->|"manages"| node_product_model
node_user_crud -->|"manages"| node_user_model
node_setting_crud -->|"reads and writes"| node_setting_model
node_setting_crud -->|"uses"| node_phone_trait
node_setting_crud -->|"handles logo"| node_company_settings
node_invoice_crud -->|"reads and writes"| node_invoice_model
node_invoice_crud -->|"looks up"| node_contact_model
node_invoice_crud -->|"looks up"| node_product_model
node_invoice_crud -->|"creates items"| node_invoice_item_model
node_invoice_crud -->|"loads settings"| node_company_settings
node_invoice_crud -->|"renders PDF view"| node_invoice_view
node_invoice_model -->|"belongs to"| node_contact_model
node_invoice_model -->|"has many"| node_invoice_item_model
node_invoice_item_model -->|"belongs to"| node_product_model
node_app_provider -->|"loads settings"| node_setting_model
node_company_settings -->|"reads and writes logos"| node_public_storage
node_dashboard_stats -->|"queries"| node_invoice_model
node_dashboard_stats -->|"queries"| node_invoice_item_model
node_admin_guard -.->|"guards access"| node_admin_routes

click node_admin_routes "https://github.com/aliffnazrii/invoicemaker/blob/main/routes/backpack/custom.php"
click node_admin_controller "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/AdminController.php"
click node_contact_crud "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/ContactCrudController.php"
click node_product_crud "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/ProductCrudController.php"
click node_user_crud "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/UserCrudController.php"
click node_setting_crud "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/SettingCrudController.php"
click node_admin_guard "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Middleware/CheckIfAdmin.php"
click node_invoice_crud "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/InvoiceCrudController.php"
click node_invoice_view "https://github.com/aliffnazrii/invoicemaker/blob/main/resources/views/admin/invoice.blade.php"
click node_invoice_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Invoice.php"
click node_invoice_item_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/InvoiceItem.php"
click node_contact_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Contact.php"
click node_product_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Product.php"
click node_user_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/User.php"
click node_setting_model "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Setting.php"
click node_phone_trait "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/Traits/TraitPhone.php"
click node_company_settings "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Support/CompanySettings.php"
click node_dashboard_stats "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Support/DashboardStats.php"
click node_app_provider "https://github.com/aliffnazrii/invoicemaker/blob/main/app/Providers/AppServiceProvider.php"
click node_database "https://github.com/aliffnazrii/invoicemaker/blob/main/config/database.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin_routes,node_admin_controller,node_contact_crud,node_product_crud,node_user_crud,node_setting_crud,node_admin_guard,node_phone_trait toneBlue
class node_invoice_crud,node_invoice_view,node_database,node_public_storage toneAmber
class node_invoice_model,node_invoice_item_model,node_contact_model,node_product_model,node_user_model toneMint
class node_setting_model,node_company_settings,node_dashboard_stats,node_app_provider toneRose
```

## Components

### Admin workflows

- [Backpack routes](https://github.com/aliffnazrii/invoicemaker/blob/main/routes/backpack/custom.php): `routes/backpack/custom.php`
- [Dashboard controller](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/AdminController.php): `app/Http/Controllers/Admin/AdminController.php`
- [Contact management](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/ContactCrudController.php): `app/Http/Controllers/Admin/ContactCrudController.php`
- [Product management](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/ProductCrudController.php): `app/Http/Controllers/Admin/ProductCrudController.php`
- [User management](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/UserCrudController.php): `app/Http/Controllers/Admin/UserCrudController.php`
- [Settings management](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/SettingCrudController.php): `app/Http/Controllers/Admin/SettingCrudController.php`
- [Admin middleware](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Middleware/CheckIfAdmin.php): `app/Http/Middleware/CheckIfAdmin.php`
- [Phone formatting](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/Traits/TraitPhone.php): `app/Http/Controllers/Admin/Traits/TraitPhone.php`

### Invoicing

- [Invoice workflow](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Http/Controllers/Admin/InvoiceCrudController.php): `app/Http/Controllers/Admin/InvoiceCrudController.php`
- [Invoice template](https://github.com/aliffnazrii/invoicemaker/blob/main/resources/views/admin/invoice.blade.php): `resources/views/admin/invoice.blade.php`

### Business records

- [Invoice records](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Invoice.php): `app/Models/Invoice.php`
- [Invoice items](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/InvoiceItem.php): `app/Models/InvoiceItem.php`
- [Contact records](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Contact.php): `app/Models/Contact.php`
- [Product records](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Product.php): `app/Models/Product.php`
- [User accounts](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/User.php): `app/Models/User.php`

### Settings and dashboard

- [Setting records](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Models/Setting.php): `app/Models/Setting.php`
- [Company settings](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Support/CompanySettings.php): `app/Support/CompanySettings.php`
- [Dashboard statistics](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Support/DashboardStats.php): `app/Support/DashboardStats.php`
- [Settings bootstrap](https://github.com/aliffnazrii/invoicemaker/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`

### Other components

- [Application database](https://github.com/aliffnazrii/invoicemaker/blob/main/config/database.php): `config/database.php`
- **Public file storage**

## Connections

- Backpack routes → Dashboard controller: routes to (evidence: `routes/backpack/custom.php`)
- Backpack routes → Contact management: routes to (evidence: `routes/backpack/custom.php`)
- Backpack routes → Product management: routes to (evidence: `routes/backpack/custom.php`)
- Backpack routes → User management: routes to (evidence: `routes/backpack/custom.php`)
- Backpack routes → Invoice workflow: routes to (evidence: `routes/backpack/custom.php`)
- Backpack routes → Settings management: routes to (evidence: `routes/backpack/custom.php`)
- Dashboard controller → Dashboard statistics: uses (evidence: `app/Http/Controllers/Admin/AdminController.php`)
- Contact management → Contact records: manages (evidence: `app/Http/Controllers/Admin/ContactCrudController.php`)
- Contact management → Phone formatting: uses (evidence: `app/Http/Controllers/Admin/ContactCrudController.php`)
- Product management → Product records: manages (evidence: `app/Http/Controllers/Admin/ProductCrudController.php`)
- User management → User accounts: manages (evidence: `app/Http/Controllers/Admin/UserCrudController.php`)
- Settings management → Setting records: reads and writes (evidence: `app/Http/Controllers/Admin/SettingCrudController.php`)
- Settings management → Phone formatting: uses (evidence: `app/Http/Controllers/Admin/SettingCrudController.php`)
- Settings management → Company settings: handles logo (evidence: `app/Http/Controllers/Admin/SettingCrudController.php`)
- Invoice workflow → Invoice records: reads and writes (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice workflow → Contact records: looks up (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice workflow → Product records: looks up (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice workflow → Invoice items: creates items (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice workflow → Company settings: loads settings (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice workflow → Invoice template: renders PDF view (evidence: `app/Http/Controllers/Admin/InvoiceCrudController.php`)
- Invoice records → Contact records: belongs to (evidence: `app/Models/Invoice.php`)
- Invoice records → Invoice items: has many (evidence: `app/Models/Invoice.php`)
- Invoice items → Product records: belongs to (evidence: `app/Models/InvoiceItem.php`)
- Settings bootstrap → Setting records: loads settings (evidence: `app/Providers/AppServiceProvider.php`)
- Company settings → Public file storage: reads and writes logos (evidence: `app/Support/CompanySettings.php`)
- Dashboard statistics → Invoice records: queries (evidence: `app/Support/DashboardStats.php`)
- Dashboard statistics → Invoice items: queries (evidence: `app/Support/DashboardStats.php`)
- Admin middleware → Backpack routes: guards access
