# apakle/customerinvoicer architecture

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

## Overview

Customer Invoicer is a React/Spring Boot application for maintaining customers, invoices with line items, and issuer details. Users navigate to customer and invoice lists or forms; the frontend submits invoice create/update requests to the REST API, where controllers delegate to services and persistence. Invoice services generate invoice numbers and manage soft deletion; JPA entities represent customers, invoices, positions, addresses, and issuer details. The README describes MySQL persistence, with H2 also present in backend configuration. Some UI-to-API links beyond the sampled invoice form are not evidenced, so they are omitted.

Main entry points: [`frontend/src/App.js`](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/App.js) (Routes and navigation), [`backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java`](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java) (Invoice endpoints), [`backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java`](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java) (Invoice operations), [`backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java`](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java) (Customer operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["React interface"]
  node_app["Routes and navigation<br/>[App.js]"]
  node_customer_ui["Customer screens<br/>[CustomerForm.jsx]"]
  node_customer_list["Customer list<br/>[CustomerList.jsx]"]
  node_invoice_form["Invoice editor<br/>[InvoiceForm.jsx]"]
  node_invoice_list["Invoice list<br/>[InvoiceList.jsx]"]
  node_invoice_details["Invoice details<br/>[InvoiceDetails.jsx]"]
  node_issuer_ui["Issuer details screens"]
  node_issuer_list["Issuer details list"]
end

subgraph group_api["REST API"]
  node_customer_api["Customer endpoints"]
  node_invoice_api["Invoice endpoints"]
  node_issuer_api["Issuer endpoints"]
end

subgraph group_logic["Application services"]
  node_customer_service["Customer operations"]
  node_invoice_service["Invoice operations"]
  node_issuer_service["Issuer operations"]
end

subgraph group_domain["Invoice domain"]
  node_customer_model["Customer and address<br/>[Customer.java]"]
  node_invoice_model["Invoice<br/>[Invoice.java]"]
  node_position_model["Invoice position"]
  node_issuer_model["Issuer and address<br/>[UserDetails.java]"]
end

subgraph group_persistence["Persistence"]
  node_customer_repo["Customer repository"]
  node_invoice_repo["Invoice repository"]
  node_issuer_repo["Issuer repository"]
  node_database[("MySQL or H2")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_customer_ui
node_app -->|"routes to"| node_customer_list
node_app -->|"routes to"| node_invoice_form
node_app -->|"routes to"| node_invoice_list
node_app -->|"routes to"| node_invoice_details
node_app -->|"routes to"| node_issuer_ui
node_app -->|"routes to"| node_issuer_list
node_invoice_form -->|"sends HTTP"| node_invoice_api
node_customer_api -->|"delegates to"| node_customer_service
node_invoice_api -->|"delegates to"| node_invoice_service
node_invoice_api -->|"loads customer"| node_customer_service
node_issuer_api -->|"delegates to"| node_issuer_service
node_customer_service -->|"reads and writes"| node_customer_repo
node_invoice_service -->|"reads and writes"| node_invoice_repo
node_invoice_service -->|"loads customer"| node_customer_service
node_issuer_service -->|"reads and writes"| node_issuer_repo
node_invoice_api -->|"links customer"| node_customer_model
node_invoice_service -->|"assigns number"| node_invoice_model
node_invoice_model -->|"contains positions"| node_position_model
node_customer_model -->|"relates invoices"| node_invoice_model
node_customer_repo -.->|"persists entities"| node_database
node_invoice_repo -.->|"persists entities"| node_database
node_issuer_repo -.->|"persists entities"| node_database

click node_app "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/App.js"
click node_customer_ui "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/CustomerForm.jsx"
click node_customer_list "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/CustomerList.jsx"
click node_invoice_form "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceForm.jsx"
click node_invoice_list "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceList.jsx"
click node_invoice_details "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceDetails.jsx"
click node_issuer_ui "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/UserDetailsForm.jsx"
click node_issuer_list "https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/UserDetailsList.jsx"
click node_customer_api "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/CustomerController.java"
click node_invoice_api "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java"
click node_issuer_api "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/UserDetailsController.java"
click node_customer_service "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java"
click node_invoice_service "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java"
click node_issuer_service "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/UserDetailsService.java"
click node_customer_model "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/Customer.java"
click node_invoice_model "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/Invoice.java"
click node_position_model "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/InvoicePosition.java"
click node_issuer_model "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/UserDetails.java"
click node_customer_repo "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/CustomerRepository.java"
click node_invoice_repo "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/InvoiceRepository.java"
click node_issuer_repo "https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/UserDetailsRepository.java"

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_customer_ui,node_customer_list,node_invoice_form,node_invoice_list,node_invoice_details,node_issuer_ui,node_issuer_list,node_user toneBlue
class node_customer_api,node_invoice_api,node_issuer_api toneAmber
class node_customer_service,node_invoice_service,node_issuer_service toneMint
class node_customer_model,node_invoice_model,node_position_model,node_issuer_model toneRose
class node_customer_repo,node_invoice_repo,node_issuer_repo,node_database toneIndigo
```

## Components

### React interface

- [Routes and navigation](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/App.js): `frontend/src/App.js`
- [Customer screens](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/CustomerForm.jsx): `frontend/src/components/CustomerForm.jsx`
- [Customer list](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/CustomerList.jsx): `frontend/src/components/CustomerList.jsx`
- [Invoice editor](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceForm.jsx): `frontend/src/components/InvoiceForm.jsx`
- [Invoice list](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceList.jsx): `frontend/src/components/InvoiceList.jsx`
- [Invoice details](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/InvoiceDetails.jsx): `frontend/src/components/InvoiceDetails.jsx`
- [Issuer details screens](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/UserDetailsForm.jsx): `frontend/src/components/UserDetailsForm.jsx`
- [Issuer details list](https://github.com/apakle/customerinvoicer/blob/master/frontend/src/components/UserDetailsList.jsx): `frontend/src/components/UserDetailsList.jsx`

### REST API

- [Customer endpoints](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/CustomerController.java): `backend/src/main/java/com/saelfmade/customerinvoicer/controller/CustomerController.java`
- [Invoice endpoints](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java): `backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java`
- [Issuer endpoints](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/controller/UserDetailsController.java): `backend/src/main/java/com/saelfmade/customerinvoicer/controller/UserDetailsController.java`

### Application services

- [Customer operations](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java): `backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java`
- [Invoice operations](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java): `backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java`
- [Issuer operations](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/service/UserDetailsService.java): `backend/src/main/java/com/saelfmade/customerinvoicer/service/UserDetailsService.java`

### Invoice domain

- [Customer and address](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/Customer.java): `backend/src/main/java/com/saelfmade/customerinvoicer/model/Customer.java`
- [Invoice](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/Invoice.java): `backend/src/main/java/com/saelfmade/customerinvoicer/model/Invoice.java`
- [Invoice position](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/InvoicePosition.java): `backend/src/main/java/com/saelfmade/customerinvoicer/model/InvoicePosition.java`
- [Issuer and address](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/model/UserDetails.java): `backend/src/main/java/com/saelfmade/customerinvoicer/model/UserDetails.java`

### Persistence

- [Customer repository](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/CustomerRepository.java): `backend/src/main/java/com/saelfmade/customerinvoicer/repository/CustomerRepository.java`
- [Invoice repository](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/InvoiceRepository.java): `backend/src/main/java/com/saelfmade/customerinvoicer/repository/InvoiceRepository.java`
- [Issuer repository](https://github.com/apakle/customerinvoicer/blob/master/backend/src/main/java/com/saelfmade/customerinvoicer/repository/UserDetailsRepository.java): `backend/src/main/java/com/saelfmade/customerinvoicer/repository/UserDetailsRepository.java`
- **MySQL or H2**

### Other components

- **User**

## Connections

- User → Routes and navigation: uses (evidence: `frontend/src/App.js`)
- Routes and navigation → Customer screens: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Customer list: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Invoice editor: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Invoice list: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Invoice details: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Issuer details screens: routes to (evidence: `frontend/src/App.js`)
- Routes and navigation → Issuer details list: routes to (evidence: `frontend/src/App.js`)
- Invoice editor → Invoice endpoints: sends HTTP (evidence: `frontend/src/components/InvoiceForm.jsx`)
- Customer endpoints → Customer operations: delegates to (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/controller/CustomerController.java`)
- Invoice endpoints → Invoice operations: delegates to (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java`)
- Invoice endpoints → Customer operations: loads customer (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java`)
- Issuer endpoints → Issuer operations: delegates to (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/controller/UserDetailsController.java`)
- Customer operations → Customer repository: reads and writes (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/service/CustomerService.java`)
- Invoice operations → Invoice repository: reads and writes (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java`)
- Invoice operations → Customer operations: loads customer (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java`)
- Issuer operations → Issuer repository: reads and writes (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/service/UserDetailsService.java`)
- Invoice endpoints → Customer and address: links customer (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/controller/InvoiceController.java`)
- Invoice operations → Invoice: assigns number (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/service/InvoiceService.java`)
- Invoice → Invoice position: contains positions (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/model/Invoice.java`)
- Customer and address → Invoice: relates invoices (evidence: `backend/src/main/java/com/saelfmade/customerinvoicer/model/Customer.java`)
- Customer repository → MySQL or H2: persists entities (evidence: `README.md`)
- Invoice repository → MySQL or H2: persists entities (evidence: `README.md`)
- Issuer repository → MySQL or H2: persists entities (evidence: `README.md`)
