# josecjacob/paynext architecture

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

- Interactive diagram: https://gitdiagram.com/josecjacob/paynext
- Repository: https://github.com/josecjacob/paynext

## Overview

PayNext is a REST payment and account service. Its primary workflow creates an account and regular user, then supports balance transfers and account-activity lookup; separate endpoints manage login sessions. The README also documents admin user listing. Controllers own the observed calls to repositories, while JPA repositories represent persistence interfaces. The excerpts do not show database wiring or an admin-listing handler, so those links are marked unverified rather than asserted as observed calls.

Main entry points: [`src/main/java/com/paynext/accountService/AccountController.java`](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountController.java) (Account API), [`src/main/java/com/paynext/accountService/UserController.java`](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserController.java) (User API), [`src/main/java/com/paynext/accountService/UserRepository.java`](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserRepository.java) (User repository), [`src/main/java/com/paynext/accountService/AccountRepository.java`](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountRepository.java) (Account repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and transfers"]
  node_account_api["Account API"]
  node_account["Account<br/>[Account.java]"]
  node_activity["Account activity"]
end

subgraph group_identity["Users and sessions"]
  node_user_api["User API"]
  node_user["User<br/>[User.java]"]
  node_session["Session<br/>[Session.java]"]
  node_admin_listing["Admin user listing"]
end

subgraph group_persistence["Persistence"]
  node_account_repo["Account repository"]
  node_activity_repo["Activity repository"]
  node_user_repo["User repository"]
  node_session_repo["Session repository"]
  node_mysql[("MySQL database")]
end

node_client(("API client"))

node_client -->|"calls REST"| node_account_api
node_client -->|"calls REST"| node_user_api
node_account_api -->|"reads and saves"| node_account_repo
node_account_api -->|"reads and saves"| node_activity_repo
node_account_api -->|"checks and saves"| node_user_repo
node_account_api -->|"creates and updates"| node_account
node_account_api -->|"creates entries"| node_activity
node_user_api -->|"looks up users"| node_user_repo
node_user_api -->|"reads and saves"| node_session_repo
node_user_api -->|"creates and updates"| node_session
node_account_repo -.->|"persists accounts"| node_mysql
node_activity_repo -.->|"persists activity"| node_mysql
node_user_repo -.->|"persists users"| node_mysql
node_session_repo -.->|"persists sessions"| node_mysql
node_client -.->|"requests user list"| node_admin_listing
node_admin_listing -.->|"lists users"| node_user_repo

click node_account_api "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountController.java"
click node_account "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/Account.java"
click node_activity "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountActivity.java"
click node_user_api "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserController.java"
click node_user "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/User.java"
click node_session "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/Session.java"
click node_admin_listing "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserController.java"
click node_account_repo "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountRepository.java"
click node_activity_repo "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountActivityRepository.java"
click node_user_repo "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserRepository.java"
click node_session_repo "https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/SessionRepository.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_account_api,node_account,node_activity,node_client toneBlue
class node_user_api,node_user,node_session,node_admin_listing toneAmber
class node_account_repo,node_activity_repo,node_user_repo,node_session_repo,node_mysql toneMint
```

## Components

### Accounts and transfers

- [Account API](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountController.java): `src/main/java/com/paynext/accountService/AccountController.java`
- [Account](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/Account.java): `src/main/java/com/paynext/accountService/Account.java`
- [Account activity](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountActivity.java): `src/main/java/com/paynext/accountService/AccountActivity.java`

### Users and sessions

- [User API](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserController.java): `src/main/java/com/paynext/accountService/UserController.java`
- [User](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/User.java): `src/main/java/com/paynext/accountService/User.java`
- [Session](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/Session.java): `src/main/java/com/paynext/accountService/Session.java`
- [Admin user listing](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserController.java): `src/main/java/com/paynext/accountService/UserController.java`

### Persistence

- [Account repository](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountRepository.java): `src/main/java/com/paynext/accountService/AccountRepository.java`
- [Activity repository](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/AccountActivityRepository.java): `src/main/java/com/paynext/accountService/AccountActivityRepository.java`
- [User repository](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/UserRepository.java): `src/main/java/com/paynext/accountService/UserRepository.java`
- [Session repository](https://github.com/josecjacob/paynext/blob/master/src/main/java/com/paynext/accountService/SessionRepository.java): `src/main/java/com/paynext/accountService/SessionRepository.java`
- **MySQL database**

### Other components

- **API client**

## Connections

- API client → Account API: calls REST (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- API client → User API: calls REST (evidence: `src/main/java/com/paynext/accountService/UserController.java`)
- Account API → Account repository: reads and saves (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- Account API → Activity repository: reads and saves (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- Account API → User repository: checks and saves (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- Account API → Account: creates and updates (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- Account API → Account activity: creates entries (evidence: `src/main/java/com/paynext/accountService/AccountController.java`)
- User API → User repository: looks up users (evidence: `src/main/java/com/paynext/accountService/UserController.java`)
- User API → Session repository: reads and saves (evidence: `src/main/java/com/paynext/accountService/UserController.java`)
- User API → Session: creates and updates (evidence: `src/main/java/com/paynext/accountService/UserController.java`)
- Account repository → MySQL database: persists accounts
- Activity repository → MySQL database: persists activity
- User repository → MySQL database: persists users
- Session repository → MySQL database: persists sessions
- API client → Admin user listing: requests user list (evidence: `README.md`)
- Admin user listing → User repository: lists users (evidence: `src/main/java/com/paynext/accountService/UserController.java`)
