# johnpaulmanalo-a11y/artiva-laravel architecture

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

- Interactive diagram: https://gitdiagram.com/johnpaulmanalo-a11y/artiva-laravel
- Repository: https://github.com/johnpaulmanalo-a11y/artiva-laravel

## Overview

Artiva is a Laravel digital-art marketplace. Customers browse and save artwork, manage a cart, submit checkout details, receive a pending-payment order, and access purchased downloads after verification; admins manage catalogue, orders, customers, and reports. The graph separates storefront, purchase/account, administration, and domain data, with Laravel routing as the request entry point. The README documents several unsampled capabilities; source excerpts confirm checkout persistence and review eligibility. The repository also includes phpdotenv, represented as a separate runtime library; its internal links follow the sampled Dotenv source.

Main entry points: [`routes/web.php`](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/routes/web.php) (Web routes), [`app/Models`](https://github.com/johnpaulmanalo-a11y/artiva-laravel/tree/main/app/Models) (Marketplace records), [`phpdotenv/src/Dotenv.php`](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Dotenv.php) (Dotenv loader), [`app/Http/Controllers/CheckoutController.php`](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CheckoutController.php) (Checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_discovery["Artwork discovery"]
  node_category["Category pages"]
  node_home["Home page<br/>[HomeController.php]"]
  node_contact["Contact form"]
end

subgraph group_purchase["Customer and purchase"]
  node_auth["Authentication"]
  node_cart["Cart<br/>[CartController.php]"]
  node_checkout["Checkout"]
  node_orders["Order history"]
  node_library["Purchased library"]
  node_wishlist["Wishlist"]
  node_reviews["Reviews"]
  node_profile["Profile"]
end

subgraph group_admin["Administration"]
  node_admincatalog["Catalogue management"]
  node_admincategories["Category management"]
  node_admindashboard["Dashboard and reports"]
  node_adminorders["Order administration"]
  node_admincustomers["Customer management"]
end

subgraph group_domain["Domain data"]
  node_domainmodels[("Marketplace records")]
  node_salesreport["Sales reporting<br/>[SalesReport.php]"]
end

subgraph group_environment["Environment loading"]
  node_dotenv["Dotenv loader<br/>[Dotenv.php]"]
  node_dotenvparser["Environment parser<br/>[Parser.php]"]
  node_dotenvstore["Environment stores<br/>[StoreBuilder.php]"]
  node_dotenvrepo["Environment repository"]
  node_dotenvutil["String utilities<br/>[Str.php]"]
end

node_shopper(("Shopper"))
node_routes["Web routes<br/>[web.php]"]

node_shopper -->|"requests"| node_routes
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_discovery
node_routes -->|"routes to"| node_category
node_routes -->|"routes to"| node_contact
node_routes -->|"routes to"| node_auth
node_routes -->|"routes to"| node_cart
node_routes -->|"routes to"| node_checkout
node_routes -->|"routes to"| node_orders
node_routes -->|"routes to"| node_library
node_routes -->|"routes to"| node_wishlist
node_routes -->|"routes to"| node_reviews
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_admincatalog
node_routes -->|"routes to"| node_admincategories
node_routes -->|"routes to"| node_admindashboard
node_routes -->|"routes to"| node_adminorders
node_routes -->|"routes to"| node_admincustomers
node_checkout -->|"creates orders and payments"| node_domainmodels
node_reviews -->|"saves reviews"| node_domainmodels
node_profile -->|"reads account data"| node_domainmodels
node_admincatalog -->|"manages artwork"| node_domainmodels
node_admincategories -->|"manages categories"| node_domainmodels
node_adminorders -->|"updates orders"| node_domainmodels
node_admindashboard -->|"builds reports"| node_salesreport
node_salesreport -->|"queries sales data"| node_domainmodels
node_dotenv -->|"parses contents"| node_dotenvparser
node_dotenv -->|"reads files"| node_dotenvstore
node_dotenv -->|"configures repository"| node_dotenvrepo
node_dotenvparser -->|"uses string helpers"| node_dotenvutil
node_dotenvrepo -.-> node_dotenvutil

click node_routes "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/routes/web.php"
click node_discovery "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ArtworkController.php"
click node_category "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CategoryController.php"
click node_home "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/HomeController.php"
click node_contact "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ContactController.php"
click node_auth "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Auth/RegisterController.php"
click node_cart "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CartController.php"
click node_checkout "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CheckoutController.php"
click node_orders "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/OrderController.php"
click node_library "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/LibraryController.php"
click node_wishlist "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/WishlistController.php"
click node_reviews "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ReviewController.php"
click node_profile "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ProfileController.php"
click node_admincatalog "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/ArtworkController.php"
click node_admincategories "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/CategoryController.php"
click node_admindashboard "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/DashboardController.php"
click node_adminorders "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/OrderController.php"
click node_admincustomers "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/CustomerController.php"
click node_domainmodels "https://github.com/johnpaulmanalo-a11y/artiva-laravel/tree/main/app/Models"
click node_salesreport "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Support/SalesReport.php"
click node_dotenv "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Dotenv.php"
click node_dotenvparser "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Parser/Parser.php"
click node_dotenvstore "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Store/StoreBuilder.php"
click node_dotenvrepo "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Repository/RepositoryBuilder.php"
click node_dotenvutil "https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Util/Str.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_discovery,node_category,node_home,node_contact toneBlue
class node_auth,node_cart,node_checkout,node_orders,node_library,node_wishlist,node_reviews,node_profile toneAmber
class node_admincatalog,node_admincategories,node_admindashboard,node_adminorders,node_admincustomers,node_routes toneMint
class node_domainmodels,node_salesreport toneRose
class node_dotenv,node_dotenvparser,node_dotenvstore,node_dotenvrepo,node_dotenvutil,node_shopper toneIndigo
```

## Components

### Storefront

- [Artwork discovery](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ArtworkController.php): `app/Http/Controllers/ArtworkController.php`
- [Category pages](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CategoryController.php): `app/Http/Controllers/CategoryController.php`
- [Home page](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/HomeController.php): `app/Http/Controllers/HomeController.php`
- [Contact form](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ContactController.php): `app/Http/Controllers/ContactController.php`

### Customer and purchase

- [Authentication](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Auth/RegisterController.php): `app/Http/Controllers/Auth/RegisterController.php`
- [Cart](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CartController.php): `app/Http/Controllers/CartController.php`
- [Checkout](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/CheckoutController.php): `app/Http/Controllers/CheckoutController.php`
- [Order history](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/OrderController.php): `app/Http/Controllers/OrderController.php`
- [Purchased library](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/LibraryController.php): `app/Http/Controllers/LibraryController.php`
- [Wishlist](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/WishlistController.php): `app/Http/Controllers/WishlistController.php`
- [Reviews](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ReviewController.php): `app/Http/Controllers/ReviewController.php`
- [Profile](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/ProfileController.php): `app/Http/Controllers/ProfileController.php`

### Administration

- [Catalogue management](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/ArtworkController.php): `app/Http/Controllers/Admin/ArtworkController.php`
- [Category management](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/CategoryController.php): `app/Http/Controllers/Admin/CategoryController.php`
- [Dashboard and reports](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/DashboardController.php): `app/Http/Controllers/Admin/DashboardController.php`
- [Order administration](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/OrderController.php): `app/Http/Controllers/Admin/OrderController.php`
- [Customer management](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Http/Controllers/Admin/CustomerController.php): `app/Http/Controllers/Admin/CustomerController.php`

### Domain data

- [Marketplace records](https://github.com/johnpaulmanalo-a11y/artiva-laravel/tree/main/app/Models): `app/Models`
- [Sales reporting](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/app/Support/SalesReport.php): `app/Support/SalesReport.php`

### Environment loading

- [Dotenv loader](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Dotenv.php): `phpdotenv/src/Dotenv.php`
- [Environment parser](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Parser/Parser.php): `phpdotenv/src/Parser/Parser.php`
- [Environment stores](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Store/StoreBuilder.php): `phpdotenv/src/Store/StoreBuilder.php`
- [Environment repository](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Repository/RepositoryBuilder.php): `phpdotenv/src/Repository/RepositoryBuilder.php`
- [String utilities](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/phpdotenv/src/Util/Str.php): `phpdotenv/src/Util/Str.php`

### Other components

- **Shopper**
- [Web routes](https://github.com/johnpaulmanalo-a11y/artiva-laravel/blob/main/routes/web.php): `routes/web.php`

## Connections

- Shopper → Web routes: requests (evidence: `README.md`)
- Web routes → Home page: routes to (evidence: `routes/web.php`)
- Web routes → Artwork discovery: routes to (evidence: `routes/web.php`)
- Web routes → Category pages: routes to (evidence: `routes/web.php`)
- Web routes → Contact form: routes to (evidence: `routes/web.php`)
- Web routes → Authentication: routes to (evidence: `routes/web.php`)
- Web routes → Cart: routes to (evidence: `routes/web.php`)
- Web routes → Checkout: routes to (evidence: `routes/web.php`)
- Web routes → Order history: routes to (evidence: `routes/web.php`)
- Web routes → Purchased library: routes to (evidence: `routes/web.php`)
- Web routes → Wishlist: routes to (evidence: `routes/web.php`)
- Web routes → Reviews: routes to (evidence: `routes/web.php`)
- Web routes → Profile: routes to (evidence: `routes/web.php`)
- Web routes → Catalogue management: routes to (evidence: `routes/web.php`)
- Web routes → Category management: routes to (evidence: `routes/web.php`)
- Web routes → Dashboard and reports: routes to (evidence: `routes/web.php`)
- Web routes → Order administration: routes to (evidence: `routes/web.php`)
- Web routes → Customer management: routes to (evidence: `routes/web.php`)
- Checkout → Marketplace records: creates orders and payments (evidence: `app/Http/Controllers/CheckoutController.php`)
- Reviews → Marketplace records: saves reviews (evidence: `app/Http/Controllers/ReviewController.php`)
- Profile → Marketplace records: reads account data (evidence: `app/Http/Controllers/ProfileController.php`)
- Catalogue management → Marketplace records: manages artwork (evidence: `app/Http/Controllers/Admin/ArtworkController.php`)
- Category management → Marketplace records: manages categories (evidence: `app/Http/Controllers/Admin/CategoryController.php`)
- Order administration → Marketplace records: updates orders (evidence: `app/Http/Controllers/Admin/OrderController.php`)
- Dashboard and reports → Sales reporting: builds reports
- Sales reporting → Marketplace records: queries sales data (evidence: `app/Support/SalesReport.php`)
- Dotenv loader → Environment parser: parses contents (evidence: `phpdotenv/src/Dotenv.php`)
- Dotenv loader → Environment stores: reads files (evidence: `phpdotenv/src/Dotenv.php`)
- Dotenv loader → Environment repository: configures repository (evidence: `phpdotenv/src/Dotenv.php`)
- Environment parser → String utilities: uses string helpers (evidence: `phpdotenv/src/Parser/Parser.php`)
- Environment repository → String utilities
