# piraemi/correoelectronico architecture

> Architecture diagram of the GitHub repository piraemi/correoelectronico, 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/piraemi/correoelectronico
- Repository: https://github.com/piraemi/correoelectronico

## Overview

Caminos y Piragine es un gestor simulado de envío y recepción de correo, sin conexión a servidores ni base de datos. El flujo principal valida un correo, distribuye copias a las bandejas de destinatarios y lo archiva como enviado, retirándolo de borradores. El modelo también incluye contactos, búsqueda, filtros, favoritos, estadísticas y papelera. Los vínculos sólidos reflejan llamadas o herencia visibles en los fragmentos; para módulos no muestreados se omiten relaciones inciertas, aunque se preservan como componentes.

Main entry points: [`src/gestorbandejas.ts`](https://github.com/piraemi/correoelectronico/blob/main/src/gestorbandejas.ts) (Gestor de bandejas), [`src/correo.ts`](https://github.com/piraemi/correoelectronico/blob/main/src/correo.ts) (Correo), [`src/enviadorCorreo.ts`](https://github.com/piraemi/correoelectronico/blob/main/src/enviadorCorreo.ts) (Enviador), [`src/bandejas.ts`](https://github.com/piraemi/correoelectronico/blob/main/src/bandejas.ts) (Tipos de bandeja)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_contacts["Contactos"]
  node_agenda["Agenda<br/>[agenda.ts]"]
  node_contact["Contacto<br/>[contacto.ts]"]
end

subgraph group_mail["Correo"]
  node_message["Correo<br/>[correo.ts]"]
  node_validator["Validador<br/>[validadorCorreo.ts]"]
end

subgraph group_mailflow["Bandejas y flujo"]
  node_sender["Enviador<br/>[enviadorCorreo.ts]"]
  node_mailboxes["Tipos de bandeja<br/>[bandejas.ts]"]
  node_mailbox_manager["Gestor de bandejas<br/>[gestorbandejas.ts]"]
  node_trash["Papelera<br/>[papelera.ts]"]
end

subgraph group_discovery["Consulta y organización"]
  node_search["Buscador<br/>[buscador.ts]"]
  node_predicates["Predicados<br/>[predicados.ts]"]
  node_filters["Filtro<br/>[filtro.ts]"]
  node_multi_filters["Filtros múltiples"]
  node_filter_registry["Registro de filtros<br/>[registroFiltros.ts]"]
  node_favorites["Vista de favoritos<br/>[vistaFavoritos.ts]"]
  node_statistics["Estadísticas<br/>[estadisticas.ts]"]
end

node_user(("Usuario"))

node_user -->|"envía correo"| node_sender
node_agenda -->|"gestiona contactos"| node_contact
node_message -->|"usa contactos"| node_contact
node_validator -->|"valida correo"| node_message
node_validator -->|"verifica remitente"| node_contact
node_sender -->|"valida antes"| node_validator
node_sender -->|"distribuye y archiva"| node_mailboxes
node_sender -->|"clona para entrega"| node_message
node_mailboxes -->|"hereda gestión"| node_mailbox_manager
node_mailboxes -->|"edita destinatarios"| node_contact
node_mailbox_manager -->|"almacena correos"| node_message
node_mailbox_manager -->|"filtra no leídos"| node_predicates
node_trash -->|"mueve y restaura"| node_mailbox_manager
node_trash -->|"usa eliminados"| node_mailboxes
node_search -->|"busca en campos"| node_message
node_filters -->|"lee bandeja"| node_mailbox_manager
node_filters -->|"aplica predicado"| node_predicates

click node_agenda "https://github.com/piraemi/correoelectronico/blob/main/src/agenda.ts"
click node_contact "https://github.com/piraemi/correoelectronico/blob/main/src/contacto.ts"
click node_message "https://github.com/piraemi/correoelectronico/blob/main/src/correo.ts"
click node_validator "https://github.com/piraemi/correoelectronico/blob/main/src/validadorCorreo.ts"
click node_sender "https://github.com/piraemi/correoelectronico/blob/main/src/enviadorCorreo.ts"
click node_mailboxes "https://github.com/piraemi/correoelectronico/blob/main/src/bandejas.ts"
click node_mailbox_manager "https://github.com/piraemi/correoelectronico/blob/main/src/gestorbandejas.ts"
click node_trash "https://github.com/piraemi/correoelectronico/blob/main/src/papelera.ts"
click node_search "https://github.com/piraemi/correoelectronico/blob/main/src/buscador.ts"
click node_predicates "https://github.com/piraemi/correoelectronico/blob/main/src/predicados.ts"
click node_filters "https://github.com/piraemi/correoelectronico/blob/main/src/filtro.ts"
click node_multi_filters "https://github.com/piraemi/correoelectronico/blob/main/src/filtrosMultiples.ts"
click node_filter_registry "https://github.com/piraemi/correoelectronico/blob/main/src/registroFiltros.ts"
click node_favorites "https://github.com/piraemi/correoelectronico/blob/main/src/vistaFavoritos.ts"
click node_statistics "https://github.com/piraemi/correoelectronico/blob/main/src/estadisticas.ts"

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_agenda,node_contact toneBlue
class node_message,node_validator toneAmber
class node_sender,node_mailboxes,node_mailbox_manager,node_trash toneMint
class node_search,node_predicates,node_filters,node_multi_filters,node_filter_registry,node_favorites,node_statistics toneRose
class node_user toneIndigo
```

## Components

### Contactos

- [Agenda](https://github.com/piraemi/correoelectronico/blob/main/src/agenda.ts): `src/agenda.ts`
- [Contacto](https://github.com/piraemi/correoelectronico/blob/main/src/contacto.ts): `src/contacto.ts`

### Correo

- [Correo](https://github.com/piraemi/correoelectronico/blob/main/src/correo.ts): `src/correo.ts`
- [Validador](https://github.com/piraemi/correoelectronico/blob/main/src/validadorCorreo.ts): `src/validadorCorreo.ts`

### Bandejas y flujo

- [Enviador](https://github.com/piraemi/correoelectronico/blob/main/src/enviadorCorreo.ts): `src/enviadorCorreo.ts`
- [Tipos de bandeja](https://github.com/piraemi/correoelectronico/blob/main/src/bandejas.ts): `src/bandejas.ts`
- [Gestor de bandejas](https://github.com/piraemi/correoelectronico/blob/main/src/gestorbandejas.ts): `src/gestorbandejas.ts`
- [Papelera](https://github.com/piraemi/correoelectronico/blob/main/src/papelera.ts): `src/papelera.ts`

### Consulta y organización

- [Buscador](https://github.com/piraemi/correoelectronico/blob/main/src/buscador.ts): `src/buscador.ts`
- [Predicados](https://github.com/piraemi/correoelectronico/blob/main/src/predicados.ts): `src/predicados.ts`
- [Filtro](https://github.com/piraemi/correoelectronico/blob/main/src/filtro.ts): `src/filtro.ts`
- [Filtros múltiples](https://github.com/piraemi/correoelectronico/blob/main/src/filtrosMultiples.ts): `src/filtrosMultiples.ts`
- [Registro de filtros](https://github.com/piraemi/correoelectronico/blob/main/src/registroFiltros.ts): `src/registroFiltros.ts`
- [Vista de favoritos](https://github.com/piraemi/correoelectronico/blob/main/src/vistaFavoritos.ts): `src/vistaFavoritos.ts`
- [Estadísticas](https://github.com/piraemi/correoelectronico/blob/main/src/estadisticas.ts): `src/estadisticas.ts`

### Other components

- **Usuario**

## Connections

- Usuario → Enviador: envía correo (evidence: `src/enviadorCorreo.ts`)
- Agenda → Contacto: gestiona contactos (evidence: `src/agenda.ts`)
- Correo → Contacto: usa contactos (evidence: `src/correo.ts`)
- Validador → Correo: valida correo (evidence: `src/validadorCorreo.ts`)
- Validador → Contacto: verifica remitente (evidence: `src/validadorCorreo.ts`)
- Enviador → Validador: valida antes (evidence: `src/enviadorCorreo.ts`)
- Enviador → Tipos de bandeja: distribuye y archiva (evidence: `src/enviadorCorreo.ts`)
- Enviador → Correo: clona para entrega (evidence: `src/enviadorCorreo.ts`)
- Tipos de bandeja → Gestor de bandejas: hereda gestión (evidence: `src/bandejas.ts`)
- Tipos de bandeja → Contacto: edita destinatarios (evidence: `src/bandejas.ts`)
- Gestor de bandejas → Correo: almacena correos (evidence: `src/gestorbandejas.ts`)
- Gestor de bandejas → Predicados: filtra no leídos (evidence: `src/gestorbandejas.ts`)
- Papelera → Gestor de bandejas: mueve y restaura (evidence: `src/papelera.ts`)
- Papelera → Tipos de bandeja: usa eliminados (evidence: `src/papelera.ts`)
- Buscador → Correo: busca en campos (evidence: `src/buscador.ts`)
- Filtro → Gestor de bandejas: lee bandeja (evidence: `src/filtro.ts`)
- Filtro → Predicados: aplica predicado (evidence: `src/filtro.ts`)
