# jyiro/ppai-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/jyiro/ppai-2026
- Repository: https://github.com/jyiro/ppai-2026

## Overview

PPAI is a JavaFX application for managing medical-documentation bags between medical commissions. Its main workflow is CU-28: an employee reviews eligible bags, selects a bag and receipt option, checks the delivery note’s documents, and records receipt and document status changes; the manager also prepares a receipt notification. The graph highlights the UI-to-manager flow, domain stages, mock data, and Iterator layer. Some source is unsampled, so uncertain links are omitted; CU-29 is documented as a stub, not a separate implemented workflow.

Main entry points: [`src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java) (Reception manager), [`src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java) (Reception screen), [`src/main/java/com/ppai/domain/model/cu28/Bolsin.java`](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Bolsin.java) (Bag receipt state), [`src/main/java/com/ppai/domain/model/cu28/Remito.java`](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Remito.java) (Delivery note)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Application entry<br/>[Main.java]"]
  node_javafx["JavaFX launcher<br/>[JavaFxApp.java]"]
end

subgraph group_workflow["CU-28 Workflow"]
  node_screen["Reception screen"]
  node_manager["Reception manager"]
  node_mockdata["Bag mock repository"]
  node_mail["Mail interface"]
end

subgraph group_domain["Domain Model"]
  node_receipt["Bag receipt state<br/>[Bolsin.java]"]
  node_delivery["Delivery note<br/>[Remito.java]"]
  node_detail["Document detail<br/>[DetalleRemito.java]"]
  node_documentation["Documentation status<br/>[Documentacion.java]"]
  node_receiptoption["Receipt options"]
  node_identity["Employee session<br/>[Sesion.java]"]
  node_states["Status history"]
end

subgraph group_iteration["Iterator Layer"]
  node_iteratorapi["Iterator contracts<br/>[IIterador.java]"]
  node_iterators["Collection iterators"]
end

node_employee(("Employee"))

node_employee -->|"uses"| node_screen
node_main -->|"launches"| node_javafx
node_javafx -->|"opens"| node_screen
node_screen -->|"invokes"| node_manager
node_manager -->|"loads bags"| node_mockdata
node_manager -->|"notifies through"| node_mail
node_manager -->|"updates"| node_receipt
node_manager -->|"selects"| node_receiptoption
node_screen -->|"shows documents"| node_delivery
node_screen -->|"renders rows"| node_documentation
node_receipt -->|"accepts remits"| node_delivery
node_delivery -->|"accepts details"| node_detail
node_detail -->|"delegates acceptance"| node_documentation
node_receipt -->|"records changes"| node_states
node_manager -->|"reads session"| node_identity
node_screen -->|"uses bag iterator"| node_iterators
node_receipt -->|"creates remit iterator"| node_iterators
node_delivery -->|"implements contract"| node_iteratorapi
node_iterators -->|"implements contract"| node_iteratorapi

click node_main "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/Main.java"
click node_javafx "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/JavaFxApp.java"
click node_screen "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java"
click node_manager "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java"
click node_mockdata "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/repository/cu28/RepositorioMockBolsines.java"
click node_mail "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/boundary/cu28/InterfazServidorCorreo.java"
click node_receipt "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Bolsin.java"
click node_delivery "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Remito.java"
click node_detail "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/DetalleRemito.java"
click node_documentation "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Documentacion.java"
click node_receiptoption "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/OpcionRecepcion.java"
click node_identity "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Sesion.java"
click node_states "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/CambioEstadoBolsin.java"
click node_iteratorapi "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/iterator/IIterador.java"
click node_iterators "https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/iterator/IteradorBolsin.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_main,node_javafx toneBlue
class node_screen,node_manager,node_mockdata,node_mail toneAmber
class node_receipt,node_delivery,node_detail,node_documentation,node_receiptoption,node_identity,node_states toneMint
class node_iteratorapi,node_iterators toneRose
class node_employee toneIndigo
```

## Components

### Application

- [Application entry](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/Main.java): `src/main/java/com/ppai/Main.java`
- [JavaFX launcher](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/JavaFxApp.java): `src/main/java/com/ppai/JavaFxApp.java`

### CU-28 Workflow

- [Reception screen](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java): `src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`
- [Reception manager](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java): `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`
- [Bag mock repository](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/repository/cu28/RepositorioMockBolsines.java): `src/main/java/com/ppai/repository/cu28/RepositorioMockBolsines.java`
- [Mail interface](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/boundary/cu28/InterfazServidorCorreo.java): `src/main/java/com/ppai/boundary/cu28/InterfazServidorCorreo.java`

### Domain Model

- [Bag receipt state](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Bolsin.java): `src/main/java/com/ppai/domain/model/cu28/Bolsin.java`
- [Delivery note](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Remito.java): `src/main/java/com/ppai/domain/model/cu28/Remito.java`
- [Document detail](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/DetalleRemito.java): `src/main/java/com/ppai/domain/model/cu28/DetalleRemito.java`
- [Documentation status](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Documentacion.java): `src/main/java/com/ppai/domain/model/cu28/Documentacion.java`
- [Receipt options](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/OpcionRecepcion.java): `src/main/java/com/ppai/domain/model/cu28/OpcionRecepcion.java`
- [Employee session](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/Sesion.java): `src/main/java/com/ppai/domain/model/cu28/Sesion.java`
- [Status history](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/domain/model/cu28/CambioEstadoBolsin.java): `src/main/java/com/ppai/domain/model/cu28/CambioEstadoBolsin.java`

### Iterator Layer

- [Iterator contracts](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/iterator/IIterador.java): `src/main/java/com/ppai/iterator/IIterador.java`
- [Collection iterators](https://github.com/jyiro/ppai-2026/blob/main/src/main/java/com/ppai/iterator/IteradorBolsin.java): `src/main/java/com/ppai/iterator/IteradorBolsin.java`

### Other components

- **Employee**

## Connections

- Employee → Reception screen: uses (evidence: `README.md`)
- Application entry → JavaFX launcher: launches (evidence: `src/main/java/com/ppai/Main.java`)
- JavaFX launcher → Reception screen: opens (evidence: `src/main/java/com/ppai/JavaFxApp.java`)
- Reception screen → Reception manager: invokes (evidence: `src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`)
- Reception manager → Bag mock repository: loads bags (evidence: `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`)
- Reception manager → Mail interface: notifies through (evidence: `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`)
- Reception manager → Bag receipt state: updates (evidence: `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`)
- Reception manager → Receipt options: selects (evidence: `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`)
- Reception screen → Delivery note: shows documents (evidence: `src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`)
- Reception screen → Documentation status: renders rows (evidence: `src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`)
- Bag receipt state → Delivery note: accepts remits (evidence: `src/main/java/com/ppai/domain/model/cu28/Bolsin.java`)
- Delivery note → Document detail: accepts details (evidence: `src/main/java/com/ppai/domain/model/cu28/Remito.java`)
- Document detail → Documentation status: delegates acceptance (evidence: `src/main/java/com/ppai/domain/model/cu28/DetalleRemito.java`)
- Bag receipt state → Status history: records changes (evidence: `src/main/java/com/ppai/domain/model/cu28/Bolsin.java`)
- Reception manager → Employee session: reads session (evidence: `src/main/java/com/ppai/controller/cu28/GestorRecepcionBolsin.java`)
- Reception screen → Collection iterators: uses bag iterator (evidence: `src/main/java/com/ppai/boundary/cu28/PantallaRecepcionBolsin.java`)
- Bag receipt state → Collection iterators: creates remit iterator (evidence: `src/main/java/com/ppai/domain/model/cu28/Bolsin.java`)
- Delivery note → Iterator contracts: implements contract (evidence: `src/main/java/com/ppai/domain/model/cu28/Remito.java`)
- Collection iterators → Iterator contracts: implements contract (evidence: `src/main/java/com/ppai/iterator/IteradorBolsin.java`)
