Introducción y alcance | Documentación de Guaba Core

Estado: especificación inicial para implementación.
Fecha: 15 de octubre de 2026.
Alcance: estructura visual y comportamiento del contenedor compartido entre web y escritorio.

Objetivo

Construir la estructura que recibe y organiza las pantallas de Guaba Core: encabezado, menús, navegación, pestañas, contenido, panel contextual y barra de estado. Se toma como referencia el diseño existente en el prototipo HTML del proyecto.

En esta documentación, contenedor significa la estructura de la interfaz —también llamada application shell—. Las pantallas se incorporarán a esa estructura mediante un contrato común.

Alcance de esta etapa

Incluido	Se definirá en otra etapa
Diseño, dimensiones y distribución de las regiones	Reglas y procesos bancarios
Navegación y ciclo de vida de las pestañas	Formularios definitivos de cada módulo
Estado independiente por pantalla abierta	APIs, autenticación y permisos de negocio
Temas, densidad y adaptación al tamaño disponible	Persistencia de información de clientes
Diálogos, mensajes y búsqueda de pantallas	Indicadores y reportes bancarios
Configuración para web y escritorio	Funcionamiento bancario sin conexión

Estructura acordada

┌─────────────────────────────────────────────────────────────────────┐
│ HEADER: marca, título del espacio y acciones globales                │
├─────────────────────────────────────────────────────────────────────┤
│ MENU BAR: Archivo · Ver · Herramientas · Ayuda · extensiones          │
├───────────────┬─────────────────────────────────────────────────────┤
│               │ TOOLBAR: ubicación y acciones del espacio            │
│ SIDEBAR       ├─────────────────────────────────────────────────────┤
│               │ TABS: Inicio │ Vista A │ Vista B                     │
│ Búsqueda      ├─────────────────────────────┬───────────────────────┤
│ Navegación    │                             │                       │
│ Preferencias  │ CONTAINER                   │ PANEL CONTEXTUAL      │
│               │ Pantalla activa             │ Contenido opcional    │
│               │                             │ de la pantalla activa │
├───────────────┴─────────────────────────────┴───────────────────────┤
│ FOOTER: estado de la interfaz, plataforma y versión                  │
└─────────────────────────────────────────────────────────────────────┘

En escritorio, el sistema operativo administra inicialmente el marco exterior de la ventana. En web, ese marco corresponde al navegador. El header de la aplicación es una región compartida dentro de ambos.

Documentos

Estado real del proyecto

Existe una referencia HTML navegable, con temas oscuro y claro.
El prototipo permite abrir dos altas de clientes en pestañas independientes; esto demuestra el comportamiento de varias instancias.
La implementación del contenedor en Rust todavía no existe.
La compilación y ejecución con egui/eframe en web y escritorio están pendientes.

Los nombres de componentes, estructuras y configuraciones de los documentos son el diseño de la implementación futura. No son APIs que ya estén disponibles en este repositorio.