# puseriokhalil-maker/pixelvault architecture

> Architecture diagram of the GitHub repository puseriokhalil-maker/pixelvault, 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/puseriokhalil-maker/pixelvault
- Repository: https://github.com/puseriokhalil-maker/pixelvault

## Overview

PixelVault is a demonstration digital-art marketplace. Visitors browse artwork; users can register or sign in, manage listings, add published work to a session cart, and create simulated orders at checkout. Admins manage listings and view order totals. The README explicitly rules out payment processing and downloads. The map follows documented routes and source-index references; unsampled modules are represented only where the tree or README supports them, so some internal links are intentionally omitted.

Main entry points: [`routes/web.php`](https://github.com/puseriokhalil-maker/pixelvault/blob/main/routes/web.php) (Web routes), [`app/Models/Artwork.php`](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Artwork.php) (Artwork records), [`app/Http/Controllers/CheckoutController.php`](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/CheckoutController.php) (Simulated checkout), [`app/Http/Controllers/AdminArtworkController.php`](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/AdminArtworkController.php) (Admin listing management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_web["Web bootstrap<br/>[app.php]"]
  node_routes["Web routes<br/>[web.php]"]
end

subgraph group_identity["Accounts"]
  node_login["Sign in and out"]
  node_register["Registration"]
  node_user["User accounts<br/>[User.php]"]
end

subgraph group_catalog["Artwork marketplace"]
  node_browse["Artwork catalog"]
  node_artwork[("Artwork records<br/>[Artwork.php]")]
  node_artist[("Artist profiles<br/>[Artist.php]")]
  node_myartwork["Artist listings"]
end

subgraph group_commerce["Cart and orders"]
  node_cartcontroller["Cart endpoints<br/>[CartController.php]"]
  node_cartservice["Session cart<br/>[CartService.php]"]
  node_checkout["Simulated checkout"]
  node_order[("Order records<br/>[Order.php]")]
  node_orderitem[("Order line items<br/>[OrderItem.php]")]
  node_orders["Order display"]
  node_dashboard["User dashboard"]
end

subgraph group_admin["Administration"]
  node_adminart["Admin listing management"]
  node_policy["Artwork authorization<br/>[ArtworkPolicy.php]"]
  node_admindashboard["Admin dashboard"]
  node_adminview["Admin dashboard view"]
end

node_visitor(("Visitor or user"))

node_visitor -->|"sends requests"| node_web
node_web -->|"loads routes"| node_routes
node_visitor -->|"uses web routes"| node_routes
node_routes -->|"dispatches auth"| node_login
node_routes -->|"dispatches registration"| node_register
node_routes -->|"dispatches catalog"| node_browse
node_routes -->|"dispatches listings"| node_myartwork
node_routes -->|"dispatches admin listings"| node_adminart
node_routes -->|"dispatches cart"| node_cartcontroller
node_routes -->|"dispatches checkout"| node_checkout
node_routes -->|"dispatches orders"| node_orders
node_routes -->|"dispatches dashboard"| node_dashboard
node_routes -->|"dispatches admin"| node_admindashboard
node_register -->|"creates account"| node_user
node_browse -->|"queries listings"| node_artwork
node_myartwork -->|"manages listings"| node_artwork
node_myartwork -->|"creates artist profile"| node_artist
node_adminart -->|"manages listings"| node_artwork
node_adminart -->|"looks up artists"| node_artist
node_cartcontroller -->|"uses cart"| node_cartservice
node_cartservice -->|"loads published work"| node_artwork
node_checkout -->|"reads and clears"| node_cartservice
node_checkout -->|"creates simulated order"| node_order
node_checkout -->|"creates line items"| node_orderitem
node_orders -->|"loads order"| node_order
node_dashboard -->|"queries purchases"| node_orderitem
node_admindashboard -->|"aggregates orders"| node_order
node_admindashboard -->|"renders totals"| node_adminview
node_user -->|"has profile"| node_artist
node_artist -->|"owns listings"| node_artwork
node_order -->|"has line items"| node_orderitem
node_adminart -.->|"authorizes changes"| node_policy

click node_web "https://github.com/puseriokhalil-maker/pixelvault/blob/main/bootstrap/app.php"
click node_routes "https://github.com/puseriokhalil-maker/pixelvault/blob/main/routes/web.php"
click node_login "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_register "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/Auth/RegisterController.php"
click node_user "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/User.php"
click node_browse "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/ArtworkController.php"
click node_artwork "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Artwork.php"
click node_artist "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Artist.php"
click node_myartwork "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/MyArtworkController.php"
click node_adminart "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/AdminArtworkController.php"
click node_policy "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Policies/ArtworkPolicy.php"
click node_cartcontroller "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/CartController.php"
click node_cartservice "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Services/CartService.php"
click node_checkout "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/CheckoutController.php"
click node_order "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Order.php"
click node_orderitem "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/OrderItem.php"
click node_orders "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/OrderController.php"
click node_dashboard "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/DashboardController.php"
click node_admindashboard "https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/AdminDashboardController.php"
click node_adminview "https://github.com/puseriokhalil-maker/pixelvault/blob/main/resources/views/admin/dashboard.blade.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_web,node_routes,node_visitor toneBlue
class node_login,node_register,node_user toneAmber
class node_browse,node_artwork,node_artist,node_myartwork toneMint
class node_cartcontroller,node_cartservice,node_checkout,node_order,node_orderitem,node_orders,node_dashboard toneRose
class node_adminart,node_policy,node_admindashboard,node_adminview toneIndigo
```

## Components

### Web entry

- [Web bootstrap](https://github.com/puseriokhalil-maker/pixelvault/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Web routes](https://github.com/puseriokhalil-maker/pixelvault/blob/main/routes/web.php): `routes/web.php`

### Accounts

- [Sign in and out](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Registration](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/Auth/RegisterController.php): `app/Http/Controllers/Auth/RegisterController.php`
- [User accounts](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/User.php): `app/Models/User.php`

### Artwork marketplace

- [Artwork catalog](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/ArtworkController.php): `app/Http/Controllers/ArtworkController.php`
- [Artwork records](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Artwork.php): `app/Models/Artwork.php`
- [Artist profiles](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Artist.php): `app/Models/Artist.php`
- [Artist listings](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/MyArtworkController.php): `app/Http/Controllers/MyArtworkController.php`

### Cart and orders

- [Cart endpoints](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/CartController.php): `app/Http/Controllers/CartController.php`
- [Session cart](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Services/CartService.php): `app/Services/CartService.php`
- [Simulated checkout](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/CheckoutController.php): `app/Http/Controllers/CheckoutController.php`
- [Order records](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Order line items](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Models/OrderItem.php): `app/Models/OrderItem.php`
- [Order display](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/OrderController.php): `app/Http/Controllers/OrderController.php`
- [User dashboard](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`

### Administration

- [Admin listing management](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/AdminArtworkController.php): `app/Http/Controllers/AdminArtworkController.php`
- [Artwork authorization](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Policies/ArtworkPolicy.php): `app/Policies/ArtworkPolicy.php`
- [Admin dashboard](https://github.com/puseriokhalil-maker/pixelvault/blob/main/app/Http/Controllers/AdminDashboardController.php): `app/Http/Controllers/AdminDashboardController.php`
- [Admin dashboard view](https://github.com/puseriokhalil-maker/pixelvault/blob/main/resources/views/admin/dashboard.blade.php): `resources/views/admin/dashboard.blade.php`

### Other components

- **Visitor or user**

## Connections

- Visitor or user → Web bootstrap: sends requests
- Web bootstrap → Web routes: loads routes (evidence: `bootstrap/app.php`)
- Visitor or user → Web routes: uses web routes (evidence: `routes/web.php`)
- Web routes → Sign in and out: dispatches auth (evidence: `routes/web.php`)
- Web routes → Registration: dispatches registration (evidence: `routes/web.php`)
- Web routes → Artwork catalog: dispatches catalog (evidence: `routes/web.php`)
- Web routes → Artist listings: dispatches listings (evidence: `routes/web.php`)
- Web routes → Admin listing management: dispatches admin listings (evidence: `routes/web.php`)
- Web routes → Cart endpoints: dispatches cart (evidence: `routes/web.php`)
- Web routes → Simulated checkout: dispatches checkout (evidence: `routes/web.php`)
- Web routes → Order display: dispatches orders (evidence: `routes/web.php`)
- Web routes → User dashboard: dispatches dashboard (evidence: `routes/web.php`)
- Web routes → Admin dashboard: dispatches admin (evidence: `routes/web.php`)
- Registration → User accounts: creates account (evidence: `app/Http/Controllers/Auth/RegisterController.php`)
- Artwork catalog → Artwork records: queries listings (evidence: `app/Http/Controllers/ArtworkController.php`)
- Artist listings → Artwork records: manages listings (evidence: `app/Http/Controllers/MyArtworkController.php`)
- Artist listings → Artist profiles: creates artist profile (evidence: `app/Http/Controllers/MyArtworkController.php`)
- Admin listing management → Artwork records: manages listings (evidence: `app/Http/Controllers/AdminArtworkController.php`)
- Admin listing management → Artist profiles: looks up artists (evidence: `app/Http/Controllers/AdminArtworkController.php`)
- Cart endpoints → Session cart: uses cart (evidence: `app/Http/Controllers/CartController.php`)
- Session cart → Artwork records: loads published work (evidence: `app/Services/CartService.php`)
- Simulated checkout → Session cart: reads and clears (evidence: `app/Http/Controllers/CheckoutController.php`)
- Simulated checkout → Order records: creates simulated order (evidence: `app/Http/Controllers/CheckoutController.php`)
- Simulated checkout → Order line items: creates line items (evidence: `app/Http/Controllers/CheckoutController.php`)
- Order display → Order records: loads order (evidence: `app/Http/Controllers/OrderController.php`)
- User dashboard → Order line items: queries purchases (evidence: `app/Http/Controllers/DashboardController.php`)
- Admin dashboard → Order records: aggregates orders (evidence: `app/Http/Controllers/AdminDashboardController.php`)
- Admin dashboard → Admin dashboard view: renders totals (evidence: `app/Http/Controllers/AdminDashboardController.php`)
- User accounts → Artist profiles: has profile (evidence: `app/Models/User.php`)
- Artist profiles → Artwork records: owns listings (evidence: `app/Models/Artist.php`)
- Order records → Order line items: has line items (evidence: `app/Models/Order.php`)
- Admin listing management → Artwork authorization: authorizes changes
