# minhseu/mini-wallet-api architecture

> Architecture diagram of the GitHub repository minhseu/mini-wallet-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/minhseu/mini-wallet-api
- Repository: https://github.com/minhseu/mini-wallet-api

## Overview

Mini Wallet API exposes account creation and lookup. An HTTP client submits a validated owner name or requests an account by UUID; the controller delegates to AccountService, which creates or retrieves Account data through AccountRepository and returns AccountResponse. The entity and repository represent the persistence layer. The README provides no further capability detail, and the sampled source does not show database configuration, so persistence wiring is represented as unverified.

Main entry points: [`src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java`](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java) (Account Controller), [`src/main/java/com/minhseu/miniwalletapi/service/AccountService.java`](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/service/AccountService.java) (Account Service), [`src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.java`](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.java) (Account Repository), [`src/main/java/com/minhseu/miniwalletapi/dto/AccountResponse.java`](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/dto/AccountResponse.java) (Account Response)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Account Controller"]
  node_create_request["Create Request"]
  node_response["Account Response"]
end

subgraph group_logic["Account Logic"]
  node_service["Account Service"]
end

subgraph group_persistence["Persistence"]
  node_account["Account Entity<br/>[Account.java]"]
  node_repository["Account Repository"]
  node_database[("Database")]
end

node_client(("HTTP Client"))

node_client -->|"sends requests"| node_controller
node_controller -->|"accepts body"| node_create_request
node_controller -->|"delegates"| node_service
node_service -->|"creates"| node_account
node_service -->|"saves or finds"| node_repository
node_repository -->|"persists entity"| node_account
node_service -->|"builds"| node_response
node_controller -->|"returns body"| node_response
node_repository -.->|"uses JPA store"| node_database

click node_controller "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java"
click node_create_request "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/dto/CreateAccountRequest.java"
click node_response "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/dto/AccountResponse.java"
click node_service "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/service/AccountService.java"
click node_account "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/entity/Account.java"
click node_repository "https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.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_controller,node_create_request,node_response,node_client toneBlue
class node_service toneAmber
class node_account,node_repository,node_database toneMint
```

## Components

### HTTP API

- [Account Controller](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java): `src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java`
- [Create Request](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/dto/CreateAccountRequest.java): `src/main/java/com/minhseu/miniwalletapi/dto/CreateAccountRequest.java`
- [Account Response](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/dto/AccountResponse.java): `src/main/java/com/minhseu/miniwalletapi/dto/AccountResponse.java`

### Account Logic

- [Account Service](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/service/AccountService.java): `src/main/java/com/minhseu/miniwalletapi/service/AccountService.java`

### Persistence

- [Account Entity](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/entity/Account.java): `src/main/java/com/minhseu/miniwalletapi/entity/Account.java`
- [Account Repository](https://github.com/minhseu/mini-wallet-api/blob/main/src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.java): `src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.java`
- **Database**

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Account Controller: sends requests
- Account Controller → Create Request: accepts body (evidence: `src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java`)
- Account Controller → Account Service: delegates (evidence: `src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java`)
- Account Service → Account Entity: creates (evidence: `src/main/java/com/minhseu/miniwalletapi/service/AccountService.java`)
- Account Service → Account Repository: saves or finds (evidence: `src/main/java/com/minhseu/miniwalletapi/service/AccountService.java`)
- Account Repository → Account Entity: persists entity (evidence: `src/main/java/com/minhseu/miniwalletapi/repository/AccountRepository.java`)
- Account Service → Account Response: builds (evidence: `src/main/java/com/minhseu/miniwalletapi/service/AccountService.java`)
- Account Controller → Account Response: returns body (evidence: `src/main/java/com/minhseu/miniwalletapi/controller/AccountController.java`)
- Account Repository → Database: uses JPA store
