# michaelnic505/proyecto-lyra-erp-completo- architecture

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

- Interactive diagram: https://gitdiagram.com/michaelnic505/proyecto-lyra-erp-completo-
- Repository: https://github.com/michaelnic505/proyecto-lyra-erp-completo-

## Overview

1. **Repository shape**
   This is a Java ERP suite organized as a multi-module system rather than a single app. The active architecture is split into **lyra-gui** (desktop client), **lyra-service** (backend), and **lyra-shared** (transport/domain contracts). The **app** module is a large older/legacy monolithic variant that still contains the original client, resources, database metadata, and custom Swing components.

2. **Top-level runtime model**
   The intended production flow is: **desktop client → network request/response layer → server → MySQL database**. The client and server do not share business logic directly; they communicate through shared request/response DTOs and exception types in `lyra-shared`.

3. **Client boundary**
   `lyra-gui` is the user-facing Swing application. Its entry point is `com.simplecore.erp.client.main.LyraClient`, with the main navigation centered around a login screen, splash screen, and a workspace shell (`MainFrame`, `Workspace`, `TreeMenu`). Most screens are custom Swing forms, not browser pages.

4. **Client presentation and navigation**
   The client is built around a **workspace + tree menu + panel loader** pattern. The tree menu drives transaction selection, and the selected transaction is loaded into a central content area. The codebase includes reusable UI primitives for search boxes, match-code dialogs, custom tables, tabs, popups, panels, and window customization.

5. **Client business modules**
   The client groups functionality into business domains such as:
   - **System access**: users, roles, transactions, permissions, sessions
   - **Financial accounting**: companies, chart of accounts, account classes/models/subclasses, account setup
   - **Logistics / plant maintenance**: master data, locations, plants, equipment, maintenance plans, work orders, strategies, routine sheets
   Many modules follow the same structure: controller, service, UI form, auxiliary search/list windows, and DTO injection/mapping helpers.

6. **Client-side interaction pattern**
   Most client features follow a pattern of **form controller → validation/filtering → service call → server request → DTO response → UI refresh**. The client has many reusable abstractions for form state, list selection, match-code lookup, DTO injection, and table editing. That suggests a strong emphasis on consistent CRUD workflows across modules.

7. **Server boundary**
   `lyra-service` is the backend runtime. Its entry points are `LyraServer`, `LyraConsole`, and `ClientHandler`. Incoming client requests are routed by `RequestDispatcher` to specific request handlers, which then delegate to managers/services. This is the main server-side separation: **transport/dispatch → handler → manager/service → persistence**.

8. **Server business services**
   The backend mirrors the client’s key domains, especially around:
   - authentication and sessions
   - system users and transactions
   - financial accounting entities
   - countries, currencies, tax schemas, time zones
   - company and cost-center setup
   - account models, classes, subclasses, and account ranges
   The handler/service split is fairly granular, with one request type often mapping to one handler and one service.

9. **Shared contract layer**
   `lyra-shared` is the architectural glue. It defines:
   - request/response envelopes and request types
   - DTOs for business entities
   - shared exceptions
   - session and user models
   - query filter models
   This module is what keeps client and server aligned without duplicating protocol definitions.

10. **Persistence and configuration**
   Database access is centered on **MySQL**, with pooled connections and generated/handwritten table metadata classes. The repo contains connection/config files, database descriptors, and SQL helper utilities. The server also has JSON-based configuration, while the client/legacy app retains `.ly` connection files and local preference resources.

11. **Security and access control**
   Authentication is a first-class subsystem. Login/logout and session management exist on both sides of the client-server boundary, and the system access module models **users, roles, transactions, and role-transaction permissions**. There are also dedicated handlers/services for session state and permission-driven UI behavior.

12. **Localization and presentation assets**
   The UI is internationalized with resource bundles for multiple locales, and the client includes extensive icon, sound, and style resources. This matters architecturally because the UI is designed to be highly localized and interactive, not minimal or data-only.

13. **Reporting and document workflows**
   There are Jasper report templates and report/data-source helpers in the client, especially around maintenance work orders. That indicates a secondary output path besides CRUD screens: **structured document/report generation** from business data.

14. **Legacy monolith**
   The `app` module is effectively a historical snapshot of the same ERP concepts in a more monolithic form. It contains older database configs, many legacy Swing forms, and extensive domain modules. For an architecture diagram, it should be treated as a **legacy/previous-generation client application** that overlaps functionally with the newer split `lyra-gui` / `lyra-service` / `lyra-shared` architecture.

Main entry points: [`lyra-gui/src/main/java/com/simplecore/erp/client/services/login/LoginService.java`](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/services/login/LoginService.java) (Client service), [`lyra-service/src/main/java/com/simplecore/erp/server/handlers/LoginHandler.java`](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/handlers/LoginHandler.java) (Handlers), [`lyra-service/src/main/java/com/simplecore/erp/server/services/AuthenticationService.java`](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/services/AuthenticationService.java) (Services), [`lyra-gui/src/main/java/com/simplecore/erp/client/abstractions/AbstractFormController.java`](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/abstractions/AbstractFormController.java) (Form layer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["lyra-gui"]
  node_lyra_client_main["LyraClient<br/>client entrypoint<br/>[LyraClient.java]"]
  node_client_login["Login UI<br/>client auth ui<br/>[Login.java]"]
  node_client_workspace["Workspace<br/>client shell<br/>[Workspace.java]"]
  node_client_tree["Tree menu<br/>client navigation<br/>[TreeMenu.java]"]
  node_client_panel["Panel loader<br/>client ui flow<br/>[PanelLoader.java]"]
  node_client_abstractions{{"Form layer<br/>client framework"}}
  node_client_financial["Financial<br/>client domain module"]
  node_client_logistics["Logistics<br/>client domain module<br/>[Location.java]"]
  node_client_access["Access UI<br/>client security ui"]
  node_client_shared_boundary{{"Client service<br/>[LoginService.java]"}}
end

subgraph group_server["lyra-service"]
  node_server_main["Server main<br/>server entrypoint<br/>[LyraServer.java]"]
  node_server_dispatch{{"Dispatcher<br/>server transport"}}
  node_server_handlers["Handlers<br/>server request layer<br/>[LoginHandler.java]"]
  node_server_managers{{"Managers<br/>server service layer"}}
  node_server_services{{"Services"}}
  node_server_persistence[("DB access<br/>server persistence")]
  node_server_security{{"Security<br/>server auth<br/>[HashSecurity.java]"}}
end

subgraph group_shared["lyra-shared"]
  node_shared_requests["Requests<br/>shared protocol<br/>[Request.java]"]
  node_shared_responses["Responses<br/>shared protocol<br/>[Response.java]"]
  node_shared_dtos["DTOs<br/>shared models"]
  node_shared_exceptions{{"Exceptions<br/>shared errors"}}
end

subgraph group_legacy["app"]
  node_legacy_app["Legacy app<br/>legacy monolith<br/>[App.java]"]
  node_legacy_workspace["Legacy workspace<br/>legacy ui shell<br/>[LyraWorkspace.java]"]
  node_legacy_domain["Legacy modules<br/>legacy domain"]
  node_legacy_persistence[("Legacy DB cfg<br/>legacy persistence")]
end

subgraph group_runtime["Core flow"]
end

node_lyra_client_main -->|"starts"| node_client_login
node_lyra_client_main -->|"opens"| node_client_workspace
node_client_workspace -->|"navigates"| node_client_tree
node_client_tree -->|"loads"| node_client_panel
node_client_panel -->|"uses"| node_client_abstractions
node_client_financial -->|"builds on"| node_client_abstractions
node_client_logistics -->|"builds on"| node_client_abstractions
node_client_access -->|"builds on"| node_client_abstractions
node_client_shared_boundary -->|"sends"| node_shared_requests
node_client_shared_boundary -->|"receives"| node_shared_responses
node_client_shared_boundary -->|"maps"| node_shared_dtos
node_client_shared_boundary -->|"handles"| node_shared_exceptions
node_client_shared_boundary -->|"calls"| node_server_dispatch
node_server_main -->|"hosts"| node_server_dispatch
node_server_dispatch -->|"routes"| node_server_handlers
node_server_handlers -->|"delegates"| node_server_managers
node_server_managers -->|"coordinates"| node_server_services
node_server_services -->|"queries"| node_server_persistence
node_server_handlers -->|"binds"| node_shared_requests
node_server_handlers -->|"emits"| node_shared_responses
node_server_handlers -->|"uses"| node_shared_dtos
node_server_services -->|"authenticates"| node_server_security
node_server_services -->|"throws"| node_shared_exceptions
node_legacy_app -->|"contains"| node_legacy_workspace
node_legacy_workspace -->|"opens"| node_legacy_domain
node_legacy_domain -->|"queries"| node_legacy_persistence
node_legacy_app -.->|"overlaps"| node_client_workspace
node_legacy_app -.->|"shares schema"| node_server_persistence
node_shared_dtos -->|"contracts"| node_server_services

click node_lyra_client_main "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/main/LyraClient.java"
click node_client_login "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/login/Login.java"
click node_client_workspace "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/Workspace.java"
click node_client_tree "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/TreeMenu.java"
click node_client_panel "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/controllers/gui/PanelLoader.java"
click node_client_abstractions "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/abstractions/AbstractFormController.java"
click node_client_financial "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/chartofaccount/controller/ChartOfAccountController.java"
click node_client_logistics "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/logistics/masterdata/locations/create/Location.java"
click node_client_access "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/company/controller/FICompanyController.java"
click node_client_shared_boundary "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/services/login/LoginService.java"
click node_server_main "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/optionalmain/LyraServer.java"
click node_server_dispatch "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/main/RequestDispatcher.java"
click node_server_handlers "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/handlers/LoginHandler.java"
click node_server_managers "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/managers/AuthenticationManager.java"
click node_server_services "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/services/AuthenticationService.java"
click node_server_persistence "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/config/PooledConnectionService.java"
click node_server_security "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/security/HashSecurity.java"
click node_shared_requests "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/requests/base/Request.java"
click node_shared_responses "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/responses/base/Response.java"
click node_shared_dtos "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/models/dto/ChartOfAccountDTO.java"
click node_shared_exceptions "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/exceptions/DatabaseException.java"
click node_legacy_app "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/main/App.java"
click node_legacy_workspace "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/gui/workspace/LyraWorkspace.java"
click node_legacy_domain "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/modules/logistics/plantmaintenance/workorders/legacy/orders/o01_creation_of_orders/O01_Creacion_Ordenes_Trabajo.java"
click node_legacy_persistence "https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/config/database/DatabaseConfig.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_lyra_client_main,node_client_login,node_client_workspace,node_client_tree,node_client_panel,node_client_abstractions,node_client_financial,node_client_logistics,node_client_access,node_client_shared_boundary toneBlue
class node_server_main,node_server_dispatch,node_server_handlers,node_server_managers,node_server_services,node_server_persistence,node_server_security toneAmber
class node_shared_requests,node_shared_responses,node_shared_dtos,node_shared_exceptions toneMint
class node_legacy_app,node_legacy_workspace,node_legacy_domain,node_legacy_persistence toneRose
```

## Components

### lyra-gui

Current desktop client runtime and UI modules.

- [LyraClient](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/main/LyraClient.java): client entrypoint · Desktop client entrypoint. · `lyra-gui/src/main/java/com/simplecore/erp/client/main/LyraClient.java`
- [Login UI](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/login/Login.java): client auth ui · Login and splash presentation. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/login/Login.java`
- [Workspace](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/Workspace.java): client shell · Main frame, workspace, and tree menu navigation. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/Workspace.java`
- [Tree menu](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/TreeMenu.java): client navigation · Transaction tree and menu routing. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/frontend/TreeMenu.java`
- [Panel loader](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/controllers/gui/PanelLoader.java): client ui flow · Loads selected transactions into the workspace. · `lyra-gui/src/main/java/com/simplecore/erp/client/controllers/gui/PanelLoader.java`
- [Form layer](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/abstractions/AbstractFormController.java): client framework · Reusable controllers, DTO injectors, validators, and persistence abstractions. · `lyra-gui/src/main/java/com/simplecore/erp/client/abstractions/AbstractFormController.java`
- [Financial](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/chartofaccount/controller/ChartOfAccountController.java): client domain module · Financial accounting and company/account setup flows. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/chartofaccount/controller/ChartOfAccountController.java`
- [Logistics](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/logistics/masterdata/locations/create/Location.java): client domain module · Master data for locations, plants, and maintenance setup. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/logistics/masterdata/locations/create/Location.java`
- [Access UI](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/company/controller/FICompanyController.java): client security ui · User, role, and transaction permission management. · `lyra-gui/src/main/java/com/simplecore/erp/client/gui/workspace/modules/financial/financialaccounting/company/controller/FICompanyController.java`
- [Client service](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-gui/src/main/java/com/simplecore/erp/client/services/login/LoginService.java): client service boundary · Client-side services that talk to server contracts and dispatch. · `lyra-gui/src/main/java/com/simplecore/erp/client/services/login/LoginService.java`

### lyra-service

Backend request handling, services, and persistence coordination.

- [Server main](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/optionalmain/LyraServer.java): server entrypoint · Server entrypoints and dispatcher. · `lyra-service/src/main/java/com/simplecore/erp/server/optionalmain/LyraServer.java`
- [Dispatcher](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/main/RequestDispatcher.java): server transport · Client handler and request dispatcher. · `lyra-service/src/main/java/com/simplecore/erp/server/main/RequestDispatcher.java`
- [Handlers](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/handlers/LoginHandler.java): server request layer · Request-specific handlers for login, company, account, and lookup operations. · `lyra-service/src/main/java/com/simplecore/erp/server/handlers/LoginHandler.java`
- [Managers](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/managers/AuthenticationManager.java): server service layer · Business managers coordinating requests and domain logic. · `lyra-service/src/main/java/com/simplecore/erp/server/managers/AuthenticationManager.java`
- [Services](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/services/AuthenticationService.java): server domain services · Domain services for accounting, company, access, and lookup data. · `lyra-service/src/main/java/com/simplecore/erp/server/services/AuthenticationService.java`
- [DB access](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/config/PooledConnectionService.java): server persistence · Server database config, pooled connections, and SQL utilities. · `lyra-service/src/main/java/com/simplecore/erp/server/config/PooledConnectionService.java`
- [Security](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-service/src/main/java/com/simplecore/erp/server/security/HashSecurity.java): server auth · Password hashing and session/authentication support. · `lyra-service/src/main/java/com/simplecore/erp/server/security/HashSecurity.java`

### lyra-shared

Shared protocol, DTO, and exception contracts.

- [Requests](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/requests/base/Request.java): shared protocol · Base request model and request types. · `lyra-shared/src/main/java/com/simplecore/erp/shared/requests/base/Request.java`
- [Responses](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/responses/base/Response.java): shared protocol · Base response model and response types. · `lyra-shared/src/main/java/com/simplecore/erp/shared/responses/base/Response.java`
- [DTOs](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/models/dto/ChartOfAccountDTO.java): shared models · Business DTOs, sessions, users, and query filters. · `lyra-shared/src/main/java/com/simplecore/erp/shared/models/dto/ChartOfAccountDTO.java`
- [Exceptions](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/lyra-shared/src/main/java/com/simplecore/erp/shared/exceptions/DatabaseException.java): shared errors · Shared exception types used across client and server. · `lyra-shared/src/main/java/com/simplecore/erp/shared/exceptions/DatabaseException.java`

### app

Older monolithic ERP client and legacy support code.

- [Legacy app](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/main/App.java): legacy monolith · Older monolithic ERP client with embedded configs and modules. · `app/src/main/java/com/simplecore/erp/main/App.java`
- [Legacy workspace](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/gui/workspace/LyraWorkspace.java): legacy ui shell · Older workspace, tree menu, and custom Swing shell. · `app/src/main/java/com/simplecore/erp/gui/workspace/LyraWorkspace.java`
- [Legacy modules](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/modules/logistics/plantmaintenance/workorders/legacy/orders/o01_creation_of_orders/O01_Creacion_Ordenes_Trabajo.java): legacy domain · Legacy business modules and custom CRUD screens. · `app/src/main/java/com/simplecore/erp/modules/logistics/plantmaintenance/workorders/legacy/orders/o01_creation_of_orders/O01_Creacion_Ordenes_Trabajo.java`
- [Legacy DB cfg](https://github.com/michaelnic505/proyecto-lyra-erp-completo-/blob/main/app/src/main/java/com/simplecore/erp/config/database/DatabaseConfig.java): legacy persistence · Old database metadata, connection files, and SQL helpers. · `app/src/main/java/com/simplecore/erp/config/database/DatabaseConfig.java`

## Connections

- LyraClient → Login UI: starts · Client launches the login flow.
- LyraClient → Workspace: opens · Successful login leads to the main workspace.
- Workspace → Tree menu: navigates · Workspace exposes transaction navigation.
- Tree menu → Panel loader: loads · Tree selections load screens into the content area.
- Panel loader → Form layer: uses · Screen loading relies on shared form/controller abstractions.
- Financial → Form layer: builds on · Financial workflows use the common form pattern.
- Logistics → Form layer: builds on · Logistics workflows use the common form pattern.
- Access UI → Form layer: builds on · Access screens use the common form pattern.
- Client service → Requests: sends · Client services issue shared request types.
- Client service → Responses: receives · Client services consume shared responses.
- Client service → DTOs: maps · Client maps forms and DTOs.
- Client service → Exceptions: handles · Client handles shared exception types.
- Client service → Dispatcher: calls · Client service boundary talks to the server dispatcher.
- Server main → Dispatcher: hosts · Server runtime hosts request dispatch.
- Dispatcher → Handlers: routes · Dispatcher routes requests to handlers.
- Handlers → Managers: delegates · Handlers delegate business work to managers.
- Managers → Services: coordinates · Managers coordinate domain services.
- Services → DB access: queries · Services persist and query through pooled DB access.
- Handlers → Requests: binds · Handlers decode shared request contracts.
- Handlers → Responses: emits · Handlers produce shared responses.
- Handlers → DTOs: uses · Handlers and services work with shared DTOs.
- Services → Security: authenticates · Security supports login and session management.
- Services → Exceptions: throws · Shared exceptions represent domain and protocol failures.
- Legacy app → Legacy workspace: contains · Legacy app contains the older workspace shell.
- Legacy workspace → Legacy modules: opens · Legacy navigation loads many domain screens.
- Legacy modules → Legacy DB cfg: queries · Legacy modules use old DB helpers and table metadata.
- Legacy app → Workspace: overlaps · Legacy architecture overlaps the newer split client.
- Legacy app → DB access: shares schema · Legacy and current server share database-oriented metadata.
- DTOs → Services: contracts · Shared DTOs align client and server data models.
