# UCEPSA — MESAVAULT Edge-OEE

Repositorio del piloto productivo MESAVAULT Edge-OEE en UCEPSA.

## Estado actual

El sistema está en estado de piloto productivo activo.

Incluye:

- captura real de máquina mediante RevPi y nodos WISE;
- lectura energética mediante Eastron SDM630;
- publicación MQTT de telemetría;
- persistencia en PostgreSQL;
- integración con Odoo PROD mediante order_state;
- control automático de balizas;
- panel de operador para justificación de paros;
- dashboard Grafana con informe de paros, energía, estado máquina y capas de análisis.

## Máquinas incluidas

- CORT-00
- CORT-01
- CORT-02

## Servicios principales

En servidor mv-edge-oee:

- mv_ucepsa_mosquitto
- mv_ucepsa_postgres_hot
- mv_ucepsa_edge_oee_mqtt_pg_sink
- mv_ucepsa_odoo_order_state_publisher
- mv_ucepsa_odoo_order_state_pg_sink
- mv_ucepsa_operator_stop_console
- mv_ucepsa_grafana

En RevPi:

- mesavault-edge-oee-revpi
- mesavault-beacon-controller

## Integración Odoo

La integración con Odoo se realiza mediante un publicador externo:

    tools/odoo_order_state_publisher.py

Este servicio consulta Odoo PROD y publica un mensaje MQTT retained por máquina:

    vertical/ucepsa/ucepsa_onpremise/edge_oee/order_state/CORT-00
    vertical/ucepsa/ucepsa_onpremise/edge_oee/order_state/CORT-01
    vertical/ucepsa/ucepsa_onpremise/edge_oee/order_state/CORT-02

La regla validada es:

    progress_count = 1 -> orden cargada correctamente

Validación real realizada:

    CORT-00
    WH/MO/00090
    [6] BOLSA BD 22X30 TPTE
    state = loaded

## Panel de operador

El panel de operador permite justificar paros detectados automáticamente.

Servicio:

    mv_ucepsa_operator_stop_console

Acceso:

    http://17.126.1.70:8088

Acceso por máquina:

    http://17.126.1.70:8088/?machine_id=CORT-00
    http://17.126.1.70:8088/?machine_id=CORT-01
    http://17.126.1.70:8088/?machine_id=CORT-02

## Estructura del repositorio

    services/              servicios Python/Docker
    tools/                 herramientas de sincronización, diagnóstico y publicación
    sql/                   migraciones, vistas y funciones PostgreSQL
    grafana/               dashboards, scripts e import/export
    deploy/ucepsa-local/   docker-compose y plantillas de entorno
    revpi/                 código y unidades systemd de RevPi
    db/schema/             export de esquema PostgreSQL sin datos
    docs/                  documentación técnica y runbooks
    env-examples/          ejemplos de variables sin secretos

## No versionar

No deben versionarse:

- .env reales;
- .env.local;
- contraseñas;
- tokens;
- claves privadas;
- dumps PostgreSQL con datos;
- volúmenes Docker;
- logs;
- backups comprimidos;
- datos de Grafana;
- datos de PostgreSQL.

Las credenciales deben mantenerse fuera del repositorio.