# rolly93/solicitud_retiro architecture

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

- Interactive diagram: https://gitdiagram.com/rolly93/solicitud_retiro
- Repository: https://github.com/rolly93/solicitud_retiro

## Overview

##### Project type and purpose
- This is a Python-based desktop application (likely using PyQt, given the `.ui` files) whose main goal is to collect user data via forms, then generate/fill PDF documents using a set of predefined templates.

##### File structure
Top-level directories and files:
- assets/ – raw PDF templates (e.g. “cfi-solicitud-retiro.pdf”, etc.)
- config/templates.json – metadata/configuration mapping template IDs to asset files and field definitions
- core/ – the business logic layer
· data.py – domain data structures or models
· data_manager.py – orchestrates data validation, persistence or in-memory storage
· pdf_service.py – loads a PDF template and merges in field data to produce an output PDF
- ui/ – the presentation layer
· .ui files & generated UI classes (e.g. main_ui.py, adress_form_ui.py, transfer_form_ui.py)
· form_manager.py – coordinates between the raw UI widgets and the core data/API
- main.py – app entry point, initializes UI and core services
- popout.py – likely responsible for previewing or opening the generated PDF in a secondary window or external viewer
- requirements.txt – lists external dependencies (e.g. PyQt5, PyPDF2, etc.)

##### README
- The README is empty, so all architectural clues must come from the directory layout, naming, and file responsibilities.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        MainWindow["Main Window"]:::ui
        AddressForm["Address Form"]:::ui
        TransferForm["Transfer Form"]:::ui
        FormManager["Form Manager"]:::ui
    end

    %% Core Layer
    subgraph "Core Layer"
        DataModels["Data Models"]:::core
        DataManager["Data Manager"]:::core
        PDFService["PDF Service"]:::core
    end

    %% Config & Assets
    subgraph "Configuration & Assets"
        TemplatesConfig["templates.json"]:::config
        PDFTemplates["PDF Templates"]:::config
    end

    %% Application Bootstrap & Auxiliary
    subgraph "Application"
        EntryPoint["main.py"]:::auxiliary
        Popout["popout.py"]:::auxiliary
    end

    %% User Interaction
    User["User"]:::external
    User -->|"interacts with"| MainWindow

    %% UI Flow
    MainWindow -->|"opens"| AddressForm
    MainWindow -->|"opens"| TransferForm
    AddressForm -->|"submits form data"| FormManager
    TransferForm -->|"submits form data"| FormManager

    %% Core Flow
    FormManager -->|"passes form data"| DataManager
    DataManager -->|"validates & stores data"| PDFService
    PDFService -->|"loads metadata"| TemplatesConfig
    PDFService -->|"reads templates"| PDFTemplates
    PDFService -->|"generates PDF bytes"| Popout

    %% Initialization
    EntryPoint -->|"initializes UI & core services"| MainWindow
    EntryPoint -->|"initializes services"| DataManager
    EntryPoint -->|"initializes services"| PDFService

    %% Click Events
    click MainWindow "https://github.com/rolly93/solicitud_retiro/blob/main/ui/main_ui.py"
    click AddressForm "https://github.com/rolly93/solicitud_retiro/blob/main/ui/adress_form_ui.py"
    click TransferForm "https://github.com/rolly93/solicitud_retiro/blob/main/ui/transfer_form_ui.py"
    click FormManager "https://github.com/rolly93/solicitud_retiro/blob/main/ui/form_manager.py"
    click DataModels "https://github.com/rolly93/solicitud_retiro/blob/main/core/data.py"
    click DataManager "https://github.com/rolly93/solicitud_retiro/blob/main/core/data_manager.py"
    click PDFService "https://github.com/rolly93/solicitud_retiro/blob/main/core/pdf_service.py"
    click TemplatesConfig "https://github.com/rolly93/solicitud_retiro/blob/main/config/templates.json"
    click PDFTemplates "https://github.com/rolly93/solicitud_retiro/tree/main/assets/"
    click EntryPoint "https://github.com/rolly93/solicitud_retiro/blob/main/main.py"
    click Popout "https://github.com/rolly93/solicitud_retiro/blob/main/popout.py"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef core fill:#90EE90,stroke:#333,stroke-width:1px
    classDef config fill:#FFA500,stroke:#333,stroke-width:1px
    classDef auxiliary fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef external fill:#ffffff,stroke:#000,stroke-dasharray: 5 5
```
