# ercanpekdemir/eagle architecture

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

- Interactive diagram: https://gitdiagram.com/ercanpekdemir/eagle
- Repository: https://github.com/ercanpekdemir/eagle

## Overview

eagle is a JavaFX desktop accounting application for managing firms and customers, their purchases, payments, and balances. Users enter through the main window, find or create a business/customer, open its profile, and review or add/edit purchase and payment records; repository operations persist the domain data, while calculation utilities support balance totals. The README also identifies ObjectBox as the persistence technology. Several screens and repository internals are unsampled, so the graph shows only relationships established by excerpts, the source index, or README.

Main entry points: [`src/main/java/com/ercan/repo/Repository.java`](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/Repository.java) (Repository facade), [`src/main/java/com/ercan/controller/ProfileFirmaController.java`](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileFirmaController.java) (Firm profile), [`src/main/java/com/ercan/controller/ProfileMusteriController.java`](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileMusteriController.java) (Customer profile), [`src/main/java/com/ercan/controller/SceneController.java`](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/SceneController.java) (Scene and tabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Application startup<br/>[MainApp.java]"]
  node_navigation["Scene and tabs"]
  node_firmprofile["Firm profile"]
  node_customerprofile["Customer profile"]
  node_partyforms["Party forms"]
  node_purchaseforms["Purchase forms"]
  node_paymentforms["Payment forms"]
  node_productedit["Product editing"]
  node_purchaseedit["Purchase editing"]
  node_paymentedit["Payment editing"]
end

subgraph group_records["Accounting records"]
  node_party["Firm and customer<br/>[User.java]"]
  node_purchase["Purchase record<br/>[Purchase.java]"]
  node_payment["Payment transaction"]
  node_balance["Account balance<br/>[Balance.java]"]
  node_types["Record types"]
  node_products["Products<br/>[Product.java]"]
end

subgraph group_storage["Persistence and calculations"]
  node_repository["Repository facade<br/>[Repository.java]"]
  node_datasource[("ObjectBox data source<br/>[DataSource.java]")]
  node_calculator["Balance calculations"]
end

subgraph group_shared["Shared application logic"]
  node_tabledata["Table view data"]
  node_alerts["Alerts and confirmation<br/>[AlertUtil.java]"]
end

node_accountant(("Accountant"))

node_accountant -->|"launches"| node_app
node_app -->|"initializes"| node_navigation
node_app -->|"configures"| node_repository
node_navigation -->|"checks records"| node_repository
node_navigation -->|"opens"| node_firmprofile
node_navigation -->|"opens"| node_customerprofile
node_navigation -->|"opens"| node_partyforms
node_navigation -->|"opens"| node_productedit
node_firmprofile -->|"loads records"| node_repository
node_customerprofile -->|"loads records"| node_repository
node_firmprofile -->|"maps records"| node_tabledata
node_customerprofile -->|"maps records"| node_tabledata
node_firmprofile -->|"opens editor"| node_paymentedit
node_firmprofile -->|"opens editor"| node_purchaseedit
node_customerprofile -->|"opens editor"| node_paymentedit
node_customerprofile -->|"opens editor"| node_purchaseedit
node_firmprofile -->|"opens entry"| node_paymentforms
node_firmprofile -->|"opens entry"| node_purchaseforms
node_customerprofile -->|"opens entry"| node_paymentforms
node_customerprofile -->|"opens entry"| node_purchaseforms
node_purchaseedit -->|"updates records"| node_repository
node_paymentedit -->|"updates records"| node_repository
node_partyforms -->|"persists parties"| node_repository
node_purchaseforms -->|"persists purchases"| node_repository
node_paymentforms -->|"persists payments"| node_repository
node_productedit -->|"persists products"| node_repository
node_repository -->|"delegates storage"| node_datasource
node_datasource -->|"calculates totals"| node_calculator
node_datasource -->|"stores"| node_party
node_datasource -->|"stores"| node_purchase
node_datasource -->|"stores"| node_payment
node_datasource -->|"stores"| node_balance
node_datasource -->|"stores"| node_products
node_firmprofile -->|"uses totals"| node_calculator
node_customerprofile -->|"uses totals"| node_calculator
node_navigation -->|"shows prompts"| node_alerts
node_party -->|"relates"| node_purchase
node_party -->|"relates"| node_payment
node_purchase -->|"uses unit"| node_types
node_payment -->|"uses payment type"| node_types

click node_app "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/MainApp.java"
click node_navigation "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/SceneController.java"
click node_firmprofile "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileFirmaController.java"
click node_customerprofile "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileMusteriController.java"
click node_partyforms "https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller"
click node_purchaseforms "https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller"
click node_paymentforms "https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller"
click node_productedit "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProductEditController.java"
click node_purchaseedit "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/EditPurchaseController.java"
click node_paymentedit "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/EditPaymentController.java"
click node_party "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/User.java"
click node_purchase "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Purchase.java"
click node_payment "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/PaymentTransaction.java"
click node_balance "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Balance.java"
click node_types "https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/entity"
click node_products "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Product.java"
click node_repository "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/Repository.java"
click node_datasource "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/DataSource.java"
click node_calculator "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/CalculatorUtil.java"
click node_tabledata "https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/tabledata"
click node_alerts "https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/util/AlertUtil.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_navigation,node_firmprofile,node_customerprofile,node_partyforms,node_purchaseforms,node_paymentforms,node_productedit,node_purchaseedit,node_paymentedit toneBlue
class node_party,node_purchase,node_payment,node_balance,node_types,node_products toneAmber
class node_repository,node_datasource,node_calculator toneMint
class node_tabledata,node_alerts toneRose
class node_accountant toneIndigo
```

## Components

### Desktop interface

- [Application startup](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/MainApp.java): `src/main/java/com/ercan/MainApp.java`
- [Scene and tabs](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/SceneController.java): `src/main/java/com/ercan/controller/SceneController.java`
- [Firm profile](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileFirmaController.java): `src/main/java/com/ercan/controller/ProfileFirmaController.java`
- [Customer profile](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProfileMusteriController.java): `src/main/java/com/ercan/controller/ProfileMusteriController.java`
- [Party forms](https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller): `src/main/java/com/ercan/controller`
- [Purchase forms](https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller): `src/main/java/com/ercan/controller`
- [Payment forms](https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/controller): `src/main/java/com/ercan/controller`
- [Product editing](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/ProductEditController.java): `src/main/java/com/ercan/controller/ProductEditController.java`
- [Purchase editing](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/EditPurchaseController.java): `src/main/java/com/ercan/controller/EditPurchaseController.java`
- [Payment editing](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/controller/EditPaymentController.java): `src/main/java/com/ercan/controller/EditPaymentController.java`

### Accounting records

- [Firm and customer](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/User.java): `src/main/java/com/ercan/entity/User.java`
- [Purchase record](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Purchase.java): `src/main/java/com/ercan/entity/Purchase.java`
- [Payment transaction](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/PaymentTransaction.java): `src/main/java/com/ercan/entity/PaymentTransaction.java`
- [Account balance](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Balance.java): `src/main/java/com/ercan/entity/Balance.java`
- [Record types](https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/entity): `src/main/java/com/ercan/entity`
- [Products](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/entity/Product.java): `src/main/java/com/ercan/entity/Product.java`

### Persistence and calculations

- [Repository facade](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/Repository.java): `src/main/java/com/ercan/repo/Repository.java`
- [ObjectBox data source](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/DataSource.java): `src/main/java/com/ercan/repo/DataSource.java`
- [Balance calculations](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/repo/CalculatorUtil.java): `src/main/java/com/ercan/repo/CalculatorUtil.java`

### Shared application logic

- [Table view data](https://github.com/ercanpekdemir/eagle/tree/master/src/main/java/com/ercan/tabledata): `src/main/java/com/ercan/tabledata`
- [Alerts and confirmation](https://github.com/ercanpekdemir/eagle/blob/master/src/main/java/com/ercan/util/AlertUtil.java): `src/main/java/com/ercan/util/AlertUtil.java`

### Other components

- **Accountant**

## Connections

- Accountant → Application startup: launches
- Application startup → Scene and tabs: initializes (evidence: `src/main/java/com/ercan/MainApp.java`)
- Application startup → Repository facade: configures (evidence: `src/main/java/com/ercan/MainApp.java`)
- Scene and tabs → Repository facade: checks records (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Scene and tabs → Firm profile: opens (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Scene and tabs → Customer profile: opens (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Scene and tabs → Party forms: opens (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Scene and tabs → Product editing: opens (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Firm profile → Repository facade: loads records (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Customer profile → Repository facade: loads records (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Firm profile → Table view data: maps records (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Customer profile → Table view data: maps records (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Firm profile → Payment editing: opens editor (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Firm profile → Purchase editing: opens editor (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Customer profile → Payment editing: opens editor (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Customer profile → Purchase editing: opens editor (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Firm profile → Payment forms: opens entry (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Firm profile → Purchase forms: opens entry (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Customer profile → Payment forms: opens entry (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Customer profile → Purchase forms: opens entry (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Purchase editing → Repository facade: updates records (evidence: `src/main/java/com/ercan/controller/EditPurchaseController.java`)
- Payment editing → Repository facade: updates records (evidence: `src/main/java/com/ercan/controller/EditPaymentController.java`)
- Party forms → Repository facade: persists parties (evidence: `src/main/java/com/ercan/repo/Repository.java`)
- Purchase forms → Repository facade: persists purchases (evidence: `src/main/java/com/ercan/repo/Repository.java`)
- Payment forms → Repository facade: persists payments (evidence: `src/main/java/com/ercan/repo/Repository.java`)
- Product editing → Repository facade: persists products (evidence: `src/main/java/com/ercan/repo/Repository.java`)
- Repository facade → ObjectBox data source: delegates storage (evidence: `src/main/java/com/ercan/repo/Repository.java`)
- ObjectBox data source → Balance calculations: calculates totals (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- ObjectBox data source → Firm and customer: stores (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- ObjectBox data source → Purchase record: stores (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- ObjectBox data source → Payment transaction: stores (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- ObjectBox data source → Account balance: stores (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- ObjectBox data source → Products: stores (evidence: `src/main/java/com/ercan/repo/DataSource.java`)
- Firm profile → Balance calculations: uses totals (evidence: `src/main/java/com/ercan/controller/ProfileFirmaController.java`)
- Customer profile → Balance calculations: uses totals (evidence: `src/main/java/com/ercan/controller/ProfileMusteriController.java`)
- Scene and tabs → Alerts and confirmation: shows prompts (evidence: `src/main/java/com/ercan/controller/SceneController.java`)
- Firm and customer → Purchase record: relates (evidence: `src/main/java/com/ercan/entity/User.java`)
- Firm and customer → Payment transaction: relates (evidence: `src/main/java/com/ercan/entity/User.java`)
- Purchase record → Record types: uses unit (evidence: `src/main/java/com/ercan/entity/Purchase.java`)
- Payment transaction → Record types: uses payment type (evidence: `src/main/java/com/ercan/entity/PaymentTransaction.java`)
