# erick1-618/automatonverify architecture

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

- Interactive diagram: https://gitdiagram.com/erick1-618/automatonverify
- Repository: https://github.com/erick1-618/automatonverify

## Overview

Automaton Verify is a web application for publishing software-file hashes, checking integrity, searching titles, and favoriting them. Users register or log in, then use the React SPA to create or inspect titles; the API handles requests, persists user/title state, and uses cellular-automaton code for hashing. The graph preserves documented product capabilities and sampled request paths. Some title, security, and automaton implementation links are only documented or implied by the tree, so those links are dashed where source evidence was not shown.

Main entry points: [`autoverify-front/src/App.js`](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/App.js) (SPA routing), [`autoverify-front/src/pages/Search/Search.js`](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Search/Search.js) (Title search), [`autoverify-front/src/pages/Login/Login.js`](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Login/Login.js) (Login), [`autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.java`](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["SPA routing<br/>[App.js]"]
  node_authstate["Auth state<br/>[authSlice.js]"]
  node_expiry["Session expiry<br/>[expireSlice.js]"]
  node_apiurl["API endpoint config<br/>[api.js]"]
  node_register["Registration<br/>[Register.js]"]
  node_login["Login<br/>[Login.js]"]
  node_search["Title search<br/>[Search.js]"]
  node_titleview["Title integrity view<br/>[Title.js]"]
  node_create["Create title<br/>[CreateTitle.js]"]
  node_userpage["User and favorites<br/>[User.js]"]
  node_modal["Session modal<br/>[Modal.js]"]
  node_searchparts["Search components<br/>[Search.js]"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security["JWT security"]
  node_jwtfilter["JWT filter<br/>[JwtFilter.java]"]
end

subgraph group_titles["Title workflows"]
  node_titlecontroller["Title endpoints"]
  node_titleservice["Title operations<br/>[TitleServices.java]"]
  node_automata["Automaton hashing"]
  node_automatafactory["Automaton factory"]
  node_framecrusher["Frame processing<br/>[FrameCrusher.java]"]
  node_usercontroller["User endpoints"]
  node_userservice["User operations<br/>[UserService.java]"]
end

subgraph group_persistence["Domain persistence"]
  node_titlemodel["Title entity<br/>[Title.java]"]
  node_usermodel["User entity<br/>[User.java]"]
  node_titlerepo[("Title repository")]
  node_userrepo[("User repository")]
end

node_visitor(("Visitor"))
node_postgres[("PostgreSQL")]
node_api["Spring API"]

node_visitor -->|"uses"| node_app
node_app -->|"routes"| node_register
node_app -->|"routes"| node_login
node_app -->|"routes"| node_search
node_app -->|"routes"| node_titleview
node_app -->|"routes"| node_create
node_app -->|"routes"| node_userpage
node_app -->|"dispatches"| node_authstate
node_app -->|"dispatches"| node_expiry
node_app -->|"renders"| node_modal
node_register -.->|"requests"| node_api
node_login -->|"requests"| node_api
node_login -->|"stores token"| node_authstate
node_search -->|"searches"| node_api
node_search -->|"renders"| node_searchparts
node_search -->|"marks expired"| node_expiry
node_titleview -->|"requests"| node_api
node_create -->|"submits title"| node_api
node_userpage -->|"requests"| node_api
node_userpage -->|"renders"| node_modal
node_register -->|"uses endpoint"| node_apiurl
node_login -->|"uses endpoint"| node_apiurl
node_search -->|"uses endpoint"| node_apiurl
node_api -->|"routes auth"| node_authcontroller
node_api -.->|"routes titles"| node_titlecontroller
node_api -.->|"routes users"| node_usercontroller
node_authcontroller -->|"delegates"| node_authservice
node_authservice -->|"generates token"| node_jwt
node_authservice -->|"loads and saves"| node_userrepo
node_security -.->|"configures"| node_jwtfilter
node_titlecontroller -->|"delegates"| node_titleservice
node_titleservice -.->|"reads and writes"| node_titlerepo
node_titleservice -.->|"hashes"| node_automata
node_automatafactory -.->|"creates"| node_automata
node_framecrusher -.->|"processes frames"| node_automata
node_usercontroller -->|"delegates"| node_userservice
node_userservice -->|"reads and writes"| node_userrepo
node_titlerepo -->|"persists"| node_titlemodel
node_userrepo -->|"persists"| node_usermodel
node_titlemodel -->|"relates favorites"| node_usermodel
node_titlerepo -.->|"stores"| node_postgres
node_userrepo -.->|"stores"| node_postgres

click node_app "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/App.js"
click node_authstate "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/redux/authSlice.js"
click node_expiry "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/redux/expireSlice.js"
click node_apiurl "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/services/api.js"
click node_register "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Register/Register.js"
click node_login "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Login/Login.js"
click node_search "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Search/Search.js"
click node_titleview "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Title/Title.js"
click node_create "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/CreateTitle/CreateTitle.js"
click node_userpage "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/User/User.js"
click node_modal "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/components/Modal/Modal.js"
click node_searchparts "https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/components/Search/Search.js"
click node_authcontroller "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/AuthController.java"
click node_authservice "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/AuthService.java"
click node_jwt "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/JwtService.java"
click node_security "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/security/SecurityConfig.java"
click node_jwtfilter "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/security/JwtFilter.java"
click node_titlecontroller "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/TitleController.java"
click node_titleservice "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/TitleServices.java"
click node_automata "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/CellularAutomata.java"
click node_automatafactory "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/CellularAutomataFactory.java"
click node_framecrusher "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/FrameCrusher.java"
click node_usercontroller "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/UserController.java"
click node_userservice "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/UserService.java"
click node_titlemodel "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/model/Title.java"
click node_usermodel "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/model/User.java"
click node_titlerepo "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/repositories/TitleRepository.java"
click node_userrepo "https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.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_authstate,node_expiry,node_apiurl,node_register,node_login,node_search,node_titleview,node_create,node_userpage,node_modal,node_searchparts toneBlue
class node_authcontroller,node_authservice,node_jwt,node_security,node_jwtfilter,node_postgres toneAmber
class node_titlecontroller,node_titleservice,node_automata,node_automatafactory,node_framecrusher,node_usercontroller,node_userservice,node_api toneMint
class node_titlemodel,node_usermodel,node_titlerepo,node_userrepo toneRose
class node_visitor toneIndigo
```

## Components

### Web client

- [SPA routing](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/App.js): `autoverify-front/src/App.js`
- [Auth state](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/redux/authSlice.js): `autoverify-front/src/redux/authSlice.js`
- [Session expiry](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/redux/expireSlice.js): `autoverify-front/src/redux/expireSlice.js`
- [API endpoint config](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/services/api.js): `autoverify-front/src/services/api.js`
- [Registration](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Register/Register.js): `autoverify-front/src/pages/Register/Register.js`
- [Login](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Login/Login.js): `autoverify-front/src/pages/Login/Login.js`
- [Title search](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Search/Search.js): `autoverify-front/src/pages/Search/Search.js`
- [Title integrity view](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/Title/Title.js): `autoverify-front/src/pages/Title/Title.js`
- [Create title](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/CreateTitle/CreateTitle.js): `autoverify-front/src/pages/CreateTitle/CreateTitle.js`
- [User and favorites](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/pages/User/User.js): `autoverify-front/src/pages/User/User.js`
- [Session modal](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/components/Modal/Modal.js): `autoverify-front/src/components/Modal/Modal.js`
- [Search components](https://github.com/erick1-618/automatonverify/blob/main/autoverify-front/src/components/Search/Search.js): `autoverify-front/src/components/Search/Search.js`

### Identity and access

- [Auth endpoints](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/AuthController.java): `autoverify-api/src/main/java/com/erick/autoverify_api/controller/AuthController.java`
- [Auth service](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/AuthService.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/AuthService.java`
- [JWT service](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/JwtService.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/JwtService.java`
- [JWT security](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/security/SecurityConfig.java): `autoverify-api/src/main/java/com/erick/autoverify_api/security/SecurityConfig.java`
- [JWT filter](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/security/JwtFilter.java): `autoverify-api/src/main/java/com/erick/autoverify_api/security/JwtFilter.java`

### Title workflows

- [Title endpoints](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/TitleController.java): `autoverify-api/src/main/java/com/erick/autoverify_api/controller/TitleController.java`
- [Title operations](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/TitleServices.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/TitleServices.java`
- [Automaton hashing](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/CellularAutomata.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/CellularAutomata.java`
- [Automaton factory](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/CellularAutomataFactory.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/CellularAutomataFactory.java`
- [Frame processing](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/FrameCrusher.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/ca/tools/FrameCrusher.java`
- [User endpoints](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/controller/UserController.java): `autoverify-api/src/main/java/com/erick/autoverify_api/controller/UserController.java`
- [User operations](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/service/UserService.java): `autoverify-api/src/main/java/com/erick/autoverify_api/service/UserService.java`

### Domain persistence

- [Title entity](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/model/Title.java): `autoverify-api/src/main/java/com/erick/autoverify_api/model/Title.java`
- [User entity](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/model/User.java): `autoverify-api/src/main/java/com/erick/autoverify_api/model/User.java`
- [Title repository](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/repositories/TitleRepository.java): `autoverify-api/src/main/java/com/erick/autoverify_api/repositories/TitleRepository.java`
- [User repository](https://github.com/erick1-618/automatonverify/blob/main/autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.java): `autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.java`

### Other components

- **Visitor**
- **PostgreSQL**
- **Spring API**

## Connections

- Visitor → SPA routing: uses (evidence: `autoverify-front/src/App.js`)
- SPA routing → Registration: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → Login: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → Title search: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → Title integrity view: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → Create title: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → User and favorites: routes (evidence: `autoverify-front/src/App.js`)
- SPA routing → Auth state: dispatches (evidence: `autoverify-front/src/App.js`)
- SPA routing → Session expiry: dispatches (evidence: `autoverify-front/src/App.js`)
- SPA routing → Session modal: renders (evidence: `autoverify-front/src/App.js`)
- Registration → Spring API: requests (evidence: `autoverify-front/src/pages/Register/Register.js`)
- Login → Spring API: requests (evidence: `autoverify-front/src/pages/Login/Login.js`)
- Login → Auth state: stores token (evidence: `autoverify-front/src/redux/authSlice.js`)
- Title search → Spring API: searches (evidence: `autoverify-front/src/pages/Search/Search.js`)
- Title search → Search components: renders (evidence: `autoverify-front/src/pages/Search/Search.js`)
- Title search → Session expiry: marks expired (evidence: `autoverify-front/src/pages/Search/Search.js`)
- Title integrity view → Spring API: requests (evidence: `autoverify-front/src/pages/Title/Title.js`)
- Create title → Spring API: submits title (evidence: `autoverify-front/src/pages/CreateTitle/CreateTitle.js`)
- User and favorites → Spring API: requests (evidence: `autoverify-front/src/pages/User/User.js`)
- User and favorites → Session modal: renders (evidence: `autoverify-front/src/pages/User/User.js`)
- Registration → API endpoint config: uses endpoint (evidence: `autoverify-front/src/pages/Register/Register.js`)
- Login → API endpoint config: uses endpoint (evidence: `autoverify-front/src/pages/Login/Login.js`)
- Title search → API endpoint config: uses endpoint (evidence: `autoverify-front/src/pages/Search/Search.js`)
- Spring API → Auth endpoints: routes auth (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/controller/AuthController.java`)
- Spring API → Title endpoints: routes titles
- Spring API → User endpoints: routes users
- Auth endpoints → Auth service: delegates (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/controller/AuthController.java`)
- Auth service → JWT service: generates token (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/service/AuthService.java`)
- Auth service → User repository: loads and saves (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/service/AuthService.java`)
- JWT security → JWT filter: configures
- Title endpoints → Title operations: delegates (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/controller/TitleController.java`)
- Title operations → Title repository: reads and writes (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/service/TitleServices.java`)
- Title operations → Automaton hashing: hashes (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/service/TitleServices.java`)
- Automaton factory → Automaton hashing: creates
- Frame processing → Automaton hashing: processes frames
- User endpoints → User operations: delegates (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/controller/UserController.java`)
- User operations → User repository: reads and writes (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/service/UserService.java`)
- Title repository → Title entity: persists (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/repositories/TitleRepository.java`)
- User repository → User entity: persists (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/repositories/UserRepository.java`)
- Title entity → User entity: relates favorites (evidence: `autoverify-api/src/main/java/com/erick/autoverify_api/model/Title.java`)
- Title repository → PostgreSQL: stores
- User repository → PostgreSQL: stores
