feat: roadmap y diseño inicial — iteración 1 antes de feedback del usuario

Inventario de dispositivos electrónicos no prestables para administración
pública. Esta primera iteración contiene el diseño y la planificación
antes de contactar con el usuario para su validación.

Contenido:
- especificaciones.md: requisitos detallados del programa
- docs/arquitectura.md: propuesta de arquitectura con alternativas
- docs/roadmap-iteracion-1.md: plan de desarrollo iteración 1
- docs/arquitectura-diagrama.html: diagrama visual de arquitectura
- sketches/: mockups de las 4 pantallas principales
  - 001-dashboard: vista resumen
  - 002-inventario: tabla de dispositivos
  - 003-formulario: alta/edición de dispositivos
  - 004-configuracion: ajustes generales

Stack propuesto: Python + Flask + SQLite + Alpine.js
Distribución: PyInstaller → un único .exe autocontenido
Entorno: Windows 11 Pro unida a dominio, sin privilegios de admin
This commit is contained in:
pikaos 2026-08-03 01:34:56 +01:00
commit ee849eb9a8
14 changed files with 3761 additions and 0 deletions

72
README.md Normal file
View file

@ -0,0 +1,72 @@
# Inventschario
Aplicación de inventario de dispositivos electrónicos no prestables para
entornos de administración pública.
## Descripción
Inventschario es una aplicación web local que se ejecuta en el navegador
por defecto del usuario. Gestiona el ciclo de vida completo de dispositivos
electrónicos: ordenadores, monitores, impresoras, dispositivos de red, etc.
### Características principales
- **Gestión de dispositivos** — Alta, edición, baja y enajenación
- **Campos renombrables** — Etiquetas personalizables en la interfaz
- **Ciclo de vida** — Baja por obsolescencia, avería, robo; enajenación por venta, donación, transferencia
- **Copias de seguridad** — Automáticas diarias con recordatorio de limpieza
- **Importación / Exportación** — CSV con mapeo modular de campos
- **Historial** — Registro de todos los cambios realizados
- **Accesibilidad** — Navegación por teclado, contraste WCAG 2.1 AA
## Requisitos
- Windows 11 Pro (unida a dominio)
- Privilegios de instalador (NO se requiere administrador)
- Navegador Edge (incluido en Windows)
## Arquitectura
```
[Browser Edge] ──HTTP──► [Flask API] ──► [SQLite]
│ │
│ HTML/CSS/JS │ Python services
│ (Alpine.js) │ (DeviceService, etc.)
│ │
◄──── JSON ─────────────►│
```
- **Frontend:** HTML + CSS + Alpine.js (sin framework pesado)
- **Backend:** Python 3.11+ con Flask
- **Base de datos:** SQLite con WAL mode
- **Empaquetado:** PyInstaller → un único `.exe`
## Documentación
- [Especificaciones](especificaciones.md) — Requisitos detallados del programa
- [Arquitectura](docs/arquitectura.md) — Documento de arquitectura
- [Roadmap Iteración 1](docs/roadmap-iteracion-1.md) — Plan de desarrollo
- [Diagrama de Arquitectura](docs/arquitectura-diagrama.html) — Diagrama visual (abrir en navegador)
## Mockups de Interfaz
Los bocetos de diseño están en `sketches/`:
- [Dashboard](sketches/001-dashboard/index.html) — Vista resumen
- [Inventario](sketches/002-inventario/index.html) — Tabla de dispositivos
- [Formulario](sketches/003-formulario/index.html) — Alta / edición
- [Configuración](sketches/004-configuracion/index.html) — Ajustes generales
Abrir los archivos `.html` directamente en el navegador para ver los mockups.
## Estado
**Iteración 1** — Roadmap definido, pendiente de feedback del usuario.
Este commit contiene el diseño y la planificación antes de contactar con
el usuario para su validación. El trabajo corresponde a la primera iteración
del proyecto.
## Licencia
Por definir.