# lucasbradacz/dell-asse architecture

> Architecture diagram of the GitHub repository lucasbradacz/dell-asse, 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/lucasbradacz/dell-asse
- Repository: https://github.com/lucasbradacz/dell-asse

## Overview

Dell'Asse is an event-planning application for discovering and requesting parties, with user accounts and an administrative area for managing event offerings and business data. The documented customer journey is represented by the public-facing pages and the protected custom-party request page, with API services and backend endpoints forming the integration boundary. Backend services implement user, party, product, gallery, and enterprise operations over PostgreSQL-backed repositories. The README describes booking and availability goals, but sampled files do not establish a complete booking or date-availability implementation; some frontend-to-service links are therefore dashed.

Main entry points: [`frontend/src/App.jsx`](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/App.jsx) (Web app routes), [`frontend/src/services/api.js`](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/api.js) (HTTP client), [`backend/src/main/java/com/dellasse/backend/service/UserService.java`](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/UserService.java) (Account rules), [`backend/src/main/java/com/dellasse/backend/repositories`](https://github.com/lucasbradacz/dell-asse/tree/main/backend/src/main/java/com/dellasse/backend/repositories) (Data repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_app["Web app routes<br/>[App.jsx]"]
  node_gallerypage["Event gallery<br/>[Gallery.jsx]"]
  node_partypage["Party discovery<br/>[Parties.jsx]"]
  node_requestpage["Custom party request"]
  node_cartpage["Cart<br/>[Cart.jsx]"]
  node_authui["Login and registration<br/>[Login.jsx]"]
  node_authcontext["Authentication state<br/>[AuthContext.jsx]"]
end

subgraph group_admin["Administration"]
  node_adminui["Admin workspace<br/>[AdminPanel.jsx]"]
  node_adminfeatures["Admin operations"]
end

subgraph group_api["API and security"]
  node_authservice["Account API client<br/>[authService.js]"]
  node_partyclient["Party API client<br/>[partyService.js]"]
  node_productclient["Product API client<br/>[productService.js]"]
  node_enterpriseclient["Enterprise API client"]
  node_http["HTTP client<br/>[api.js]"]
  node_usercontroller["Account endpoints"]
  node_partycontroller["Party endpoints"]
  node_productcontroller["Product endpoints"]
  node_enterprisecontroller["Enterprise endpoints"]
end

subgraph group_domain["Domain and persistence"]
  node_userservice["Account rules<br/>[UserService.java]"]
  node_partyservice["Party operations<br/>[PartyService.java]"]
  node_productservice["Product operations"]
  node_enterpriseservice["Enterprise operations"]
  node_galleryservice["Gallery operations"]
  node_entities["Domain entities"]
  node_repositories["Data repositories"]
  node_postgres[("PostgreSQL")]
end

node_visitor(("Customer"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_gallerypage
node_app -->|"routes to"| node_partypage
node_app -->|"protects and routes"| node_requestpage
node_app -->|"routes to"| node_cartpage
node_app -->|"routes to"| node_authui
node_app -->|"protects and routes"| node_adminui
node_app -->|"routes to"| node_adminfeatures
node_app -->|"provides state"| node_authcontext
node_authcontext -->|"uses"| node_authservice
node_authservice -->|"sends requests"| node_http
node_partyclient -->|"sends requests"| node_http
node_productclient -->|"sends requests"| node_http
node_enterpriseclient -->|"sends requests"| node_http
node_http -.->|"calls API"| node_usercontroller
node_http -.->|"calls API"| node_partycontroller
node_http -.->|"calls API"| node_productcontroller
node_http -.->|"calls API"| node_enterprisecontroller
node_usercontroller -->|"delegates to"| node_userservice
node_partycontroller -->|"delegates to"| node_partyservice
node_productcontroller -.->|"delegates to"| node_productservice
node_enterprisecontroller -->|"delegates to"| node_enterpriseservice
node_partyservice -->|"checks user roles"| node_userservice
node_productservice -->|"validates enterprise"| node_userservice
node_enterpriseservice -->|"validates enterprise"| node_userservice
node_galleryservice -->|"validates enterprise"| node_userservice
node_userservice -->|"queries users and roles"| node_repositories
node_partyservice -->|"reads and saves parties"| node_repositories
node_productservice -->|"reads and saves products"| node_repositories
node_enterpriseservice -->|"reads and saves enterprises"| node_repositories
node_galleryservice -->|"reads and saves galleries"| node_repositories
node_repositories -.->|"persists entities"| node_postgres
node_userservice -->|"manages users"| node_entities
node_partyservice -->|"maps parties"| node_entities
node_productservice -->|"maps products"| node_entities
node_galleryservice -->|"maps galleries"| node_entities

click node_app "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/App.jsx"
click node_gallerypage "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Gallery.jsx"
click node_partypage "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Parties.jsx"
click node_requestpage "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/CreateCustomParty.jsx"
click node_cartpage "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Cart.jsx"
click node_authui "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Login.jsx"
click node_adminui "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/AdminPanel.jsx"
click node_adminfeatures "https://github.com/lucasbradacz/dell-asse/tree/main/frontend/src/pages/admin"
click node_authcontext "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/contexts/AuthContext.jsx"
click node_authservice "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/authService.js"
click node_partyclient "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/partyService.js"
click node_productclient "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/productService.js"
click node_enterpriseclient "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/enterpriseService.js"
click node_http "https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/api.js"
click node_usercontroller "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/UserController.java"
click node_partycontroller "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/PartyController.java"
click node_productcontroller "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/ProductContoller.java"
click node_enterprisecontroller "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/EnterpriseController.java"
click node_userservice "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/UserService.java"
click node_partyservice "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/PartyService.java"
click node_productservice "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/ProductService.java"
click node_enterpriseservice "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/EnterpriseService.java"
click node_galleryservice "https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/GalleryService.java"
click node_entities "https://github.com/lucasbradacz/dell-asse/tree/main/backend/src/main/java/com/dellasse/backend/models"
click node_repositories "https://github.com/lucasbradacz/dell-asse/tree/main/backend/src/main/java/com/dellasse/backend/repositories"

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_app,node_gallerypage,node_partypage,node_requestpage,node_cartpage,node_authui,node_authcontext toneBlue
class node_adminui,node_adminfeatures toneAmber
class node_authservice,node_partyclient,node_productclient,node_enterpriseclient,node_http,node_usercontroller,node_partycontroller,node_productcontroller,node_enterprisecontroller toneMint
class node_userservice,node_partyservice,node_productservice,node_enterpriseservice,node_galleryservice,node_entities,node_repositories,node_postgres toneRose
class node_visitor toneIndigo
```

## Components

### Customer experience

- [Web app routes](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Event gallery](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Gallery.jsx): `frontend/src/pages/Gallery.jsx`
- [Party discovery](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Parties.jsx): `frontend/src/pages/Parties.jsx`
- [Custom party request](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/CreateCustomParty.jsx): `frontend/src/pages/CreateCustomParty.jsx`
- [Cart](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Login and registration](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Authentication state](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/contexts/AuthContext.jsx): `frontend/src/contexts/AuthContext.jsx`

### Administration

- [Admin workspace](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/pages/AdminPanel.jsx): `frontend/src/pages/AdminPanel.jsx`
- [Admin operations](https://github.com/lucasbradacz/dell-asse/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`

### API and security

- [Account API client](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Party API client](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/partyService.js): `frontend/src/services/partyService.js`
- [Product API client](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/productService.js): `frontend/src/services/productService.js`
- [Enterprise API client](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/enterpriseService.js): `frontend/src/services/enterpriseService.js`
- [HTTP client](https://github.com/lucasbradacz/dell-asse/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Account endpoints](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/UserController.java): `backend/src/main/java/com/dellasse/backend/controllers/UserController.java`
- [Party endpoints](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/PartyController.java): `backend/src/main/java/com/dellasse/backend/controllers/PartyController.java`
- [Product endpoints](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/ProductContoller.java): `backend/src/main/java/com/dellasse/backend/controllers/ProductContoller.java`
- [Enterprise endpoints](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/controllers/EnterpriseController.java): `backend/src/main/java/com/dellasse/backend/controllers/EnterpriseController.java`

### Domain and persistence

- [Account rules](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/UserService.java): `backend/src/main/java/com/dellasse/backend/service/UserService.java`
- [Party operations](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/PartyService.java): `backend/src/main/java/com/dellasse/backend/service/PartyService.java`
- [Product operations](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/ProductService.java): `backend/src/main/java/com/dellasse/backend/service/ProductService.java`
- [Enterprise operations](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/EnterpriseService.java): `backend/src/main/java/com/dellasse/backend/service/EnterpriseService.java`
- [Gallery operations](https://github.com/lucasbradacz/dell-asse/blob/main/backend/src/main/java/com/dellasse/backend/service/GalleryService.java): `backend/src/main/java/com/dellasse/backend/service/GalleryService.java`
- [Domain entities](https://github.com/lucasbradacz/dell-asse/tree/main/backend/src/main/java/com/dellasse/backend/models): `backend/src/main/java/com/dellasse/backend/models`
- [Data repositories](https://github.com/lucasbradacz/dell-asse/tree/main/backend/src/main/java/com/dellasse/backend/repositories): `backend/src/main/java/com/dellasse/backend/repositories`
- **PostgreSQL**

### Other components

- **Customer**

## Connections

- Customer → Web app routes: uses (evidence: `frontend/src/App.jsx`)
- Web app routes → Event gallery: routes to (evidence: `frontend/src/App.jsx`)
- Web app routes → Party discovery: routes to (evidence: `frontend/src/App.jsx`)
- Web app routes → Custom party request: protects and routes (evidence: `frontend/src/App.jsx`)
- Web app routes → Cart: routes to (evidence: `frontend/src/App.jsx`)
- Web app routes → Login and registration: routes to (evidence: `frontend/src/App.jsx`)
- Web app routes → Admin workspace: protects and routes (evidence: `frontend/src/App.jsx`)
- Web app routes → Admin operations: routes to (evidence: `frontend/src/App.jsx`)
- Web app routes → Authentication state: provides state (evidence: `frontend/src/App.jsx`)
- Authentication state → Account API client: uses (evidence: `frontend/src/contexts/AuthContext.jsx`)
- Account API client → HTTP client: sends requests (evidence: `frontend/src/services/authService.js`)
- Party API client → HTTP client: sends requests (evidence: `frontend/src/services/partyService.js`)
- Product API client → HTTP client: sends requests (evidence: `frontend/src/services/productService.js`)
- Enterprise API client → HTTP client: sends requests (evidence: `frontend/src/services/enterpriseService.js`)
- HTTP client → Account endpoints: calls API
- HTTP client → Party endpoints: calls API
- HTTP client → Product endpoints: calls API
- HTTP client → Enterprise endpoints: calls API
- Account endpoints → Account rules: delegates to (evidence: `backend/src/main/java/com/dellasse/backend/controllers/UserController.java`)
- Party endpoints → Party operations: delegates to (evidence: `backend/src/main/java/com/dellasse/backend/controllers/PartyController.java`)
- Product endpoints → Product operations: delegates to
- Enterprise endpoints → Enterprise operations: delegates to (evidence: `backend/src/main/java/com/dellasse/backend/controllers/EnterpriseController.java`)
- Party operations → Account rules: checks user roles (evidence: `backend/src/main/java/com/dellasse/backend/service/PartyService.java`)
- Product operations → Account rules: validates enterprise (evidence: `backend/src/main/java/com/dellasse/backend/service/ProductService.java`)
- Enterprise operations → Account rules: validates enterprise (evidence: `backend/src/main/java/com/dellasse/backend/service/EnterpriseService.java`)
- Gallery operations → Account rules: validates enterprise (evidence: `backend/src/main/java/com/dellasse/backend/service/GalleryService.java`)
- Account rules → Data repositories: queries users and roles (evidence: `backend/src/main/java/com/dellasse/backend/service/UserService.java`)
- Party operations → Data repositories: reads and saves parties (evidence: `backend/src/main/java/com/dellasse/backend/service/PartyService.java`)
- Product operations → Data repositories: reads and saves products (evidence: `backend/src/main/java/com/dellasse/backend/service/ProductService.java`)
- Enterprise operations → Data repositories: reads and saves enterprises (evidence: `backend/src/main/java/com/dellasse/backend/service/EnterpriseService.java`)
- Gallery operations → Data repositories: reads and saves galleries (evidence: `backend/src/main/java/com/dellasse/backend/service/GalleryService.java`)
- Data repositories → PostgreSQL: persists entities
- Account rules → Domain entities: manages users (evidence: `backend/src/main/java/com/dellasse/backend/service/UserService.java`)
- Party operations → Domain entities: maps parties (evidence: `backend/src/main/java/com/dellasse/backend/service/PartyService.java`)
- Product operations → Domain entities: maps products (evidence: `backend/src/main/java/com/dellasse/backend/service/ProductService.java`)
- Gallery operations → Domain entities: maps galleries (evidence: `backend/src/main/java/com/dellasse/backend/service/GalleryService.java`)
