# ggheimer/financial-control-app architecture

> Architecture diagram of the GitHub repository ggheimer/financial-control-app, 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/ggheimer/financial-control-app
- Repository: https://github.com/ggheimer/financial-control-app

## Overview

This is a Spring-based financial-control application for managing personal income and expenses. The README establishes those two domain capabilities, but no source excerpts were provided, so internal call paths, persistence behavior, and page routing cannot be verified. The graph identifies the main implementation areas from the file tree and shows only the documented user-to-product and product-to-capability relationships.

Main entry points: [`src/main/java/com/example/FinancialControlAppApplication.java`](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/FinancialControlAppApplication.java) (Financial control app), [`src/main/java/com/example/service/IncomingsService.java`](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/IncomingsService.java) (Income management), [`src/main/java/com/example/service/OutgoingsService.java`](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/OutgoingsService.java) (Expense management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app_controller["App controller<br/>[AppController.java]"]
  node_income_controller["Income controller"]
  node_expense_controller["Expense controller"]
  node_templates["Page templates"]
end

subgraph group_domain["Income and expenses"]
  node_income_capability["Income management"]
  node_expense_capability["Expense management"]
  node_income_model["Income records<br/>[Incomings.java]"]
  node_expense_model["Expense records<br/>[Outgoings.java]"]
end

subgraph group_support["Application support"]
  node_application["Financial control app"]
  node_user_model["User model<br/>[User.java]"]
  node_income_repository["Income repository"]
  node_expense_repository["Expense repository"]
  node_security["Security configuration"]
  node_configuration["Application configuration"]
end

node_user(("Personal user"))

node_user -->|"uses"| node_application
node_application -->|"manages income"| node_income_capability
node_application -->|"manages expenses"| node_expense_capability

click node_application "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/FinancialControlAppApplication.java"
click node_income_capability "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/IncomingsService.java"
click node_expense_capability "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/OutgoingsService.java"
click node_app_controller "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/AppController.java"
click node_income_controller "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/IncomingsController.java"
click node_expense_controller "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/OutgoingsingsController.java"
click node_income_model "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/Incomings.java"
click node_expense_model "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/Outgoings.java"
click node_user_model "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/User.java"
click node_income_repository "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/repositories/IncomingsRepository.java"
click node_expense_repository "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/repositories/OutgoingsRepository.java"
click node_security "https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/config/SecurityConfig.java"
click node_templates "https://github.com/ggheimer/financial-control-app/tree/master/src/main/resources/templates"
click node_configuration "https://github.com/ggheimer/financial-control-app/blob/master/src/main/resources/application.properties"

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_controller,node_income_controller,node_expense_controller,node_templates,node_user toneBlue
class node_income_capability,node_expense_capability,node_income_model,node_expense_model toneAmber
class node_application,node_user_model,node_income_repository,node_expense_repository,node_security,node_configuration toneMint
```

## Components

### Web interface

- [App controller](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/AppController.java): `src/main/java/com/example/controller/AppController.java`
- [Income controller](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/IncomingsController.java): `src/main/java/com/example/controller/IncomingsController.java`
- [Expense controller](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/controller/OutgoingsingsController.java): `src/main/java/com/example/controller/OutgoingsingsController.java`
- [Page templates](https://github.com/ggheimer/financial-control-app/tree/master/src/main/resources/templates): `src/main/resources/templates`

### Income and expenses

- [Income management](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/IncomingsService.java): `src/main/java/com/example/service/IncomingsService.java`
- [Expense management](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/service/OutgoingsService.java): `src/main/java/com/example/service/OutgoingsService.java`
- [Income records](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/Incomings.java): `src/main/java/com/example/model/Incomings.java`
- [Expense records](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/Outgoings.java): `src/main/java/com/example/model/Outgoings.java`

### Application support

- [Financial control app](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/FinancialControlAppApplication.java): `src/main/java/com/example/FinancialControlAppApplication.java`
- [User model](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/model/User.java): `src/main/java/com/example/model/User.java`
- [Income repository](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/repositories/IncomingsRepository.java): `src/main/java/com/example/repositories/IncomingsRepository.java`
- [Expense repository](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/repositories/OutgoingsRepository.java): `src/main/java/com/example/repositories/OutgoingsRepository.java`
- [Security configuration](https://github.com/ggheimer/financial-control-app/blob/master/src/main/java/com/example/config/SecurityConfig.java): `src/main/java/com/example/config/SecurityConfig.java`
- [Application configuration](https://github.com/ggheimer/financial-control-app/blob/master/src/main/resources/application.properties): `src/main/resources/application.properties`

### Other components

- **Personal user**

## Connections

- Personal user → Financial control app: uses (evidence: `README.txt`)
- Financial control app → Income management: manages income (evidence: `README.txt`)
- Financial control app → Expense management: manages expenses (evidence: `README.txt`)
