---
id: architecture-overview
title: Arquitectura del sistema
category: architecture
version: 1.0
status: stable
audience:
  - user
  - administrator
  - developer
  - ai
updated_at: 2026-07-14
related:
  - architecture-components
  - architecture-database
  - architecture-filesystem
  - architecture-esp-platform-architecture-v1-0
tags:
  - architecture
  - spring
  - postgresql
  - nginx
---

# Arquitectura del sistema

ESP Platform separa navegador, backend, metadatos y archivos binarios.

## Flujo principal

Browser over HTTPS -> Nginx -> Spring Boot -> PostgreSQL metadata
Browser Web Serial -> ESP32 connected by USB
Spring Boot -> protected filesystem for artifacts and backups

El navegador es responsable de la conexión física, lectura y escritura con esptool-js. Spring Boot administra catálogo, validaciones de servidor, artifacts, sesiones, auditoría, documentación y descargas. PostgreSQL conserva relaciones y estado transaccional. El filesystem conserva binarios grandes.

## Límites

No se guardan firmware ni dumps como BLOB. Nginx sirve el acceso interno en el puerto 88 y NPM termina HTTPS para el dominio operativo. systemd controla el proceso Java. No hay contenedores.

Las SPEC de la Constitución son la arquitectura oficial. Cualquier cambio arquitectónico se propone y aprueba antes de implementarse.