feat: AR-ElecArrangement initial commit — Python FastAPI + uvicorn (LAN desktop app, packaged as .exe via PyInstaller)

2026-07-03 12:18:12 -04:00
commit 5f552ca8ab
22 changed files with 1444 additions and 0 deletions
@@ -0,0 +1,70 @@
+# AR-ElecArrangement
+
+Aplicación para el diseño completo de la instalación eléctrica de un buque
+desde la silueta hasta el plano de arrangement firmable.
+
+Familia AR ShipDesign. Cubre yates a motor, yates a vela, pesqueros, lanchas
+de pasaje y embarcaciones de trabajo de hasta ~50 m.
+
+## Arquitectura
+
+Servidor Windows + clientes web. Un solo `.exe` empaca el backend FastAPI y
+el frontend estático. El PC del usuario es el servidor; iPad, Android u otro
+PC se conectan por navegador a `http://<server-ip>:5505`.
+
+```
+.exe (Windows)
+ ├─ Backend Python  (FastAPI, cálculo eléctrico, exports)
+ ├─ Frontend web    (HTML + Vue 3 + Konva.js)
+ └─ Auto-abre browser a http://localhost:5505
+
+Tablets / otros PC → http://<server-ip>:5505  (LAN, sin Internet)
+```
+
+Sin telemetría. Offline absoluto. Catálogos editables por el usuario.
+
+## Normativas soportadas
+
+- ABYC E-11 (small craft USA)
+- IEC 60092 (mercante / clase)
+- NMEA 2000 y NMEA 0183
+- IEEE 45 (buques grandes)
+- ISO 10133 (DC small craft) e ISO 13297 (AC small craft)
+
+## Stack
+
+| Capa | Tecnología |
+|---|---|
+| Backend | Python 3.11 + FastAPI + uvicorn |
+| Frontend | Vue 3 + Konva.js |
+| Cálculo | numpy, scipy, pandas, networkx |
+| Exports | ezdxf (DXF), reportlab (PDF), openpyxl (Excel BOM) |
+| Persistencia | `.area` (ZIP con JSON + assets) |
+| Empaquetado | PyInstaller |
+
+## Desarrollo local
+
+```bash
+# Backend
+python -m venv venv
+venv\Scripts\activate
+pip install -r backend/requirements.txt
+python -m uvicorn backend.main:app --reload --port 5505
+
+# Frontend (dev)
+cd frontend
+npm install
+npm run dev    # http://localhost:5173 con proxy al backend
+```
+
+## Empaquetado .exe
+
+```bash
+pyinstaller arelec.spec
+# dist/AR-ElecArrangement/AR-ElecArrangement.exe
+```
+
+## Licencia
+
+Propietaria. Copyright © 2026 Alvaro Enrique Romero Donado. Ver `LICENSE.txt`.
+Para licenciamiento contactar: alro65@gmail.com