# johnwilliams2050/personapp-hexa-spring-boot architecture

> Architecture diagram of the GitHub repository johnwilliams2050/personapp-hexa-spring-boot, 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/johnwilliams2050/personapp-hexa-spring-boot
- Repository: https://github.com/johnwilliams2050/personapp-hexa-spring-boot

## Overview

PersonApp is a person-and-related-records application with REST and CLI entry points and MariaDB/MongoDB persistence options. Its workflow accepts person, phone, profession, or study operations, passes them through application use cases and ports, and stores or retrieves domain data. The sampled study use case confirms persistence-port calls; the source index confirms selected controller, CLI-menu, and repository references. Other adapter-to-use-case and storage wiring is not shown, so those relationships are marked unverified.

Main entry points: [`rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller`](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller) (REST controllers), [`cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu`](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu) (CLI menus), [`application/src/main/java/co/edu/javeriana/as/personapp/application/port/out`](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/port/out) (Output ports), [`domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java`](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java) (Study)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rest["REST interface"]
  node_restcontrollers["REST controllers"]
  node_restadapters["REST input adapters"]
  node_restmodels["REST models"]
end

subgraph group_cli["CLI interface"]
  node_menus["CLI menus"]
  node_cliadapters["CLI input adapters"]
  node_climodels["CLI models"]
end

subgraph group_app["Application core"]
  node_inputports["Input ports"]
  node_usecases["Use cases"]
  node_outputports["Output ports"]
end

subgraph group_domain["Person domain"]
  node_person["Person<br/>[Person.java]"]
  node_phone["Phone<br/>[Phone.java]"]
  node_profession["Profession<br/>[Profession.java]"]
  node_study["Study<br/>[Study.java]"]
end

subgraph group_storage["Persistence"]
  node_maria["MariaDB adapter"]
  node_mariadb[("MariaDB store")]
  node_mongo["MongoDB adapter"]
  node_mongodb[("MongoDB store")]
end

node_client(("REST client"))
node_terminal(("CLI user"))

node_client -->|"sends requests"| node_restcontrollers
node_restcontrollers -->|"delegates to"| node_restadapters
node_restcontrollers -->|"accepts and returns"| node_restmodels
node_terminal -.->|"selects operations"| node_menus
node_menus -->|"uses"| node_cliadapters
node_menus -->|"uses"| node_climodels
node_restadapters -.->|"dispatches to"| node_inputports
node_cliadapters -.->|"dispatches to"| node_inputports
node_inputports -.->|"implemented by"| node_usecases
node_usecases -->|"calls"| node_outputports
node_person -->|"aggregates"| node_phone
node_person -->|"aggregates"| node_study
node_study -->|"references"| node_person
node_study -->|"references"| node_profession
node_outputports -.->|"implemented by"| node_maria
node_outputports -.->|"implemented by"| node_mongo
node_maria -.->|"reads and writes"| node_mariadb
node_mongo -.->|"reads and writes"| node_mongodb

click node_restcontrollers "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller"
click node_restadapters "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/adapter"
click node_restmodels "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/model"
click node_menus "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu"
click node_cliadapters "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/adapter"
click node_climodels "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/model"
click node_inputports "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/port/in"
click node_usecases "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/usecase"
click node_outputports "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/port/out"
click node_person "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Person.java"
click node_phone "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Phone.java"
click node_profession "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Profession.java"
click node_study "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java"
click node_maria "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/maria-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mariadb/adapter"
click node_mongo "https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/mongo-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mongo/adapter"

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_restcontrollers,node_restadapters,node_restmodels,node_client,node_terminal toneBlue
class node_menus,node_cliadapters,node_climodels toneAmber
class node_inputports,node_usecases,node_outputports toneMint
class node_person,node_phone,node_profession,node_study toneRose
class node_maria,node_mariadb,node_mongo,node_mongodb toneIndigo
```

## Components

### REST interface

- [REST controllers](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller): `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller`
- [REST input adapters](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/adapter): `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/adapter`
- [REST models](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/model): `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/model`

### CLI interface

- [CLI menus](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu): `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu`
- [CLI input adapters](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/adapter): `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/adapter`
- [CLI models](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/model): `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/model`

### Application core

- [Input ports](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/port/in): `application/src/main/java/co/edu/javeriana/as/personapp/application/port/in`
- [Use cases](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/usecase): `application/src/main/java/co/edu/javeriana/as/personapp/application/usecase`
- [Output ports](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/application/src/main/java/co/edu/javeriana/as/personapp/application/port/out): `application/src/main/java/co/edu/javeriana/as/personapp/application/port/out`

### Person domain

- [Person](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Person.java): `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Person.java`
- [Phone](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Phone.java): `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Phone.java`
- [Profession](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Profession.java): `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Profession.java`
- [Study](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/blob/main/domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java): `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java`

### Persistence

- [MariaDB adapter](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/maria-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mariadb/adapter): `maria-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mariadb/adapter`
- **MariaDB store**
- [MongoDB adapter](https://github.com/johnwilliams2050/personapp-hexa-spring-boot/tree/main/mongo-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mongo/adapter): `mongo-output-adapter/src/main/java/co/edu/javeriana/as/personapp/mongo/adapter`
- **MongoDB store**

### Other components

- **REST client**
- **CLI user**

## Connections

- REST client → REST controllers: sends requests
- REST controllers → REST input adapters: delegates to (evidence: `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller/EstudioControllerV1.java`)
- REST controllers → REST models: accepts and returns (evidence: `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/controller/EstudioControllerV1.java`)
- CLI user → CLI menus: selects operations
- CLI menus → CLI input adapters: uses (evidence: `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu/EstudioMenu.java`)
- CLI menus → CLI models: uses (evidence: `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/menu/EstudioMenu.java`)
- REST input adapters → Input ports: dispatches to (evidence: `rest-input-adapter/src/main/java/co/edu/javeriana/as/personapp/adapter/EstudioInputAdapterRest.java`)
- CLI input adapters → Input ports: dispatches to (evidence: `cli-input-adapter/src/main/java/co/edu/javeriana/as/personapp/terminal/adapter/EstudioInputAdapterCli.java`)
- Input ports → Use cases: implemented by (evidence: `application/src/main/java/co/edu/javeriana/as/personapp/application/usecase/StudyUseCase.java`)
- Use cases → Output ports: calls (evidence: `application/src/main/java/co/edu/javeriana/as/personapp/application/usecase/StudyUseCase.java`)
- Person → Phone: aggregates (evidence: `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Person.java`)
- Person → Study: aggregates (evidence: `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Person.java`)
- Study → Person: references (evidence: `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java`)
- Study → Profession: references (evidence: `domain/src/main/java/co/edu/javeriana/as/personapp/domain/Study.java`)
- Output ports → MariaDB adapter: implemented by
- Output ports → MongoDB adapter: implemented by
- MariaDB adapter → MariaDB store: reads and writes
- MongoDB adapter → MongoDB store: reads and writes
