# isaborit/controlame_esta architecture

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

- Interactive diagram: https://gitdiagram.com/isaborit/controlame_esta
- Repository: https://github.com/isaborit/controlame_esta

## Overview

This is a JavaFX peer-contact application with UDP discovery and presence messaging. The user submits a username, the login controller validates and requests a uniqueness check, then an accepted identity begins broadcasting and requests peer discovery; incoming events are dispatched to controllers and reflected in the contact list. The graph also preserves rename, logout, and message-handler capabilities. Several controller and network methods are marked “LAYOUT ONLY,” so those intended behaviors are shown as unverified rather than established calls.

Main entry points: [`src/main/java/app/controller/LoginController.java`](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/LoginController.java) (Login controller), [`src/main/java/app/App.java`](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/App.java) (Application wiring), [`src/main/java/app/network/NetworkManager.java`](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkManager.java) (UDP network manager), [`src/main/java/app/controller/ContactController.java`](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/ContactController.java) (Contact controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application setup"]
  node_app_entry["Application wiring<br/>[App.java]"]
  node_config["Network configuration<br/>[AppConfig.java]"]
end

subgraph group_ui["Login and contacts"]
  node_login_view["Login view<br/>[LoginView.java]"]
  node_contact_view["Contact list view"]
  node_login_controller["Login controller"]
  node_contact_controller["Contact controller"]
end

subgraph group_domain["Identity and contacts"]
  node_profile["User profile"]
  node_identity["Identity validation<br/>[User.java]"]
  node_username_validator["Username validator"]
  node_username_error["Invalid username error"]
  node_contacts["Contact list model"]
  node_contact_observer["Contact observer"]
end

subgraph group_network["UDP messaging"]
  node_network_service["Network service API"]
  node_network_manager["UDP network manager"]
  node_protocol["Message types and format"]
  node_listener["Network listener API"]
  node_handler_registry["Handler registry"]
  node_handlers["Message handlers"]
end

node_user(("User"))
node_peers(("Other peers"))

node_user -.->|"submits username"| node_login_view
node_app_entry -->|"loads defaults"| node_config
node_app_entry -->|"creates"| node_network_manager
node_app_entry -->|"wires"| node_login_controller
node_app_entry -->|"wires"| node_contact_controller
node_app_entry -->|"shows"| node_login_view
node_app_entry -->|"observes contacts"| node_contact_view
node_app_entry -->|"builds handlers"| node_handler_registry
node_login_view -->|"submits to"| node_login_controller
node_contact_view -->|"routes actions"| node_contact_controller
node_login_controller -->|"validates with"| node_username_validator
node_login_controller -->|"requests uniqueness"| node_network_service
node_login_controller -->|"sets current identity"| node_profile
node_login_controller -->|"starts presence"| node_network_service
node_login_controller -->|"requests discovery"| node_network_service
node_login_controller -->|"handles validation error"| node_username_error
node_contact_controller -.->|"updates contacts"| node_contacts
node_contact_controller -.->|"requests rename or logout"| node_network_service
node_contact_controller -.->|"reads identity"| node_profile
node_contact_view -->|"implements updates"| node_contact_observer
node_network_manager -->|"reads port"| node_config
node_network_manager -->|"deserializes packets"| node_protocol
node_network_manager -->|"dispatches messages"| node_handlers
node_handler_registry -->|"registers by type"| node_handlers
node_handlers -.->|"notifies listeners"| node_listener
node_network_manager -.->|"exchanges UDP messages"| node_peers
node_peers -.->|"sends messages"| node_network_manager
node_network_manager -.->|"notifies registered listeners"| node_listener
node_contact_controller -.->|"receives peer events"| node_contacts
node_contacts -.->|"notifies observer"| node_contact_view
node_identity -->|"validates username"| node_username_validator

click node_app_entry "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/App.java"
click node_config "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/AppConfig.java"
click node_login_view "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/view/LoginView.java"
click node_contact_view "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/view/ContactListView.java"
click node_login_controller "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/LoginController.java"
click node_contact_controller "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/ContactController.java"
click node_profile "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/UserProfileModel.java"
click node_identity "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/User.java"
click node_username_validator "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/UsernameValidator.java"
click node_username_error "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/InvalidUsernameException.java"
click node_contacts "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/ContactListModel.java"
click node_contact_observer "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/ContactListObserver.java"
click node_network_service "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkService.java"
click node_network_manager "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkManager.java"
click node_protocol "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkMessage.java"
click node_listener "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkListener.java"
click node_handler_registry "https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/handler/HandlerRegistry.java"
click node_handlers "https://github.com/isaborit/controlame_esta/tree/main/src/main/java/app/network/handler"

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_entry,node_config,node_user toneBlue
class node_login_view,node_contact_view,node_login_controller,node_contact_controller toneAmber
class node_profile,node_identity,node_username_validator,node_username_error,node_contacts,node_contact_observer toneMint
class node_network_service,node_network_manager,node_protocol,node_listener,node_handler_registry,node_handlers toneRose
class node_peers toneIndigo
```

## Components

### Application setup

- [Application wiring](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/App.java): `src/main/java/app/App.java`
- [Network configuration](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/AppConfig.java): `src/main/java/app/AppConfig.java`

### Login and contacts

- [Login view](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/view/LoginView.java): `src/main/java/app/view/LoginView.java`
- [Contact list view](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/view/ContactListView.java): `src/main/java/app/view/ContactListView.java`
- [Login controller](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/LoginController.java): `src/main/java/app/controller/LoginController.java`
- [Contact controller](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/controller/ContactController.java): `src/main/java/app/controller/ContactController.java`

### Identity and contacts

- [User profile](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/UserProfileModel.java): `src/main/java/app/model/UserProfileModel.java`
- [Identity validation](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/User.java): `src/main/java/app/model/User.java`
- [Username validator](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/UsernameValidator.java): `src/main/java/app/model/UsernameValidator.java`
- [Invalid username error](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/InvalidUsernameException.java): `src/main/java/app/model/InvalidUsernameException.java`
- [Contact list model](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/ContactListModel.java): `src/main/java/app/model/ContactListModel.java`
- [Contact observer](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/model/ContactListObserver.java): `src/main/java/app/model/ContactListObserver.java`

### UDP messaging

- [Network service API](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkService.java): `src/main/java/app/network/NetworkService.java`
- [UDP network manager](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkManager.java): `src/main/java/app/network/NetworkManager.java`
- [Message types and format](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkMessage.java): `src/main/java/app/network/NetworkMessage.java`
- [Network listener API](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/NetworkListener.java): `src/main/java/app/network/NetworkListener.java`
- [Handler registry](https://github.com/isaborit/controlame_esta/blob/main/src/main/java/app/network/handler/HandlerRegistry.java): `src/main/java/app/network/handler/HandlerRegistry.java`
- [Message handlers](https://github.com/isaborit/controlame_esta/tree/main/src/main/java/app/network/handler): `src/main/java/app/network/handler`

### Other components

- **User**
- **Other peers**

## Connections

- User → Login view: submits username
- Application wiring → Network configuration: loads defaults (evidence: `src/main/java/app/App.java`)
- Application wiring → UDP network manager: creates (evidence: `src/main/java/app/App.java`)
- Application wiring → Login controller: wires (evidence: `src/main/java/app/App.java`)
- Application wiring → Contact controller: wires (evidence: `src/main/java/app/App.java`)
- Application wiring → Login view: shows (evidence: `src/main/java/app/App.java`)
- Application wiring → Contact list view: observes contacts (evidence: `src/main/java/app/App.java`)
- Application wiring → Handler registry: builds handlers (evidence: `src/main/java/app/App.java`)
- Login view → Login controller: submits to (evidence: `src/main/java/app/App.java`)
- Contact list view → Contact controller: routes actions (evidence: `src/main/java/app/App.java`)
- Login controller → Username validator: validates with (evidence: `src/main/java/app/controller/LoginController.java`)
- Login controller → Network service API: requests uniqueness (evidence: `src/main/java/app/controller/LoginController.java`)
- Login controller → User profile: sets current identity (evidence: `src/main/java/app/controller/LoginController.java`)
- Login controller → Network service API: starts presence (evidence: `src/main/java/app/controller/LoginController.java`)
- Login controller → Network service API: requests discovery (evidence: `src/main/java/app/controller/LoginController.java`)
- Login controller → Invalid username error: handles validation error (evidence: `src/main/java/app/controller/LoginController.java`)
- Contact controller → Contact list model: updates contacts (evidence: `src/main/java/app/controller/ContactController.java`)
- Contact controller → Network service API: requests rename or logout (evidence: `src/main/java/app/controller/ContactController.java`)
- Contact controller → User profile: reads identity (evidence: `src/main/java/app/controller/ContactController.java`)
- Contact list view → Contact observer: implements updates (evidence: `src/main/java/app/view/ContactListView.java`)
- UDP network manager → Network configuration: reads port (evidence: `src/main/java/app/network/NetworkManager.java`)
- UDP network manager → Message types and format: deserializes packets (evidence: `src/main/java/app/network/NetworkManager.java`)
- UDP network manager → Message handlers: dispatches messages (evidence: `src/main/java/app/network/NetworkManager.java`)
- Handler registry → Message handlers: registers by type (evidence: `src/main/java/app/network/handler/HandlerRegistry.java`)
- Message handlers → Network listener API: notifies listeners (evidence: `src/main/java/app/network/handler/HandlerRegistry.java`)
- UDP network manager → Other peers: exchanges UDP messages
- Other peers → UDP network manager: sends messages
- UDP network manager → Network listener API: notifies registered listeners (evidence: `src/main/java/app/network/NetworkManager.java`)
- Contact controller → Contact list model: receives peer events (evidence: `src/main/java/app/controller/ContactController.java`)
- Contact list model → Contact list view: notifies observer
- Identity validation → Username validator: validates username (evidence: `src/main/java/app/model/User.java`)
