inventschario/README.md

73 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

# 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.