retro-hardware-database
Catálogo autoalojado para colecciones de hardware retro. Gestiona máquinas, componentes, fotos e historial con etiquetas QR. Usa FastAPI, MariaDB y Docker Compose.
Ficha actualizada 23 sept 2026, 19:23 · upstream 23 sept 2026, 18:51 · release v0.1.0
Qué es retro-hardware-database
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio ofrece un catálogo autoalojado diseñado específicamente para colecciones de ordenadores antiguos y consolas. Permite rastrear máquinas completas, piezas individuales, fotografías y proyectos, generando etiquetas imprimibles con códigos QR para cada activo. La arquitectura se basa en FastAPI, MariaDB y Caddy, todo orquestado mediante Docker Compose para una implementación sencilla y segura.
El sistema distingue entre dos tipos de objetos: componentes ensamblables (como tarjetas de expansión) y máquinas selladas (como consolas), gestionando ambos modelos a la vez. Incluye una galería con búsqueda avanzada, historial de cambios datado, gestión de archivos adjuntos como manuales o ROMs, y estadísticas visuales. La interfaz web es pública para visualización, mientras que la edición requiere autenticación.
La base de datos utiliza columnas tipadas para especificaciones técnicas, permitiendo consultas precisas sobre hardware. El proyecto incluye una API REST en JSON y herramientas de línea de comandos para generar etiquetas directamente desde impresoras conectadas o importar informes desde disquetes de arranque. Está licenciado bajo AGPLv3, fomentando la mejora comunitaria y el uso institucional sin restricciones comerciales.
- Inventario detallado de colecciones de hardware retro con códigos QR para identificación rápida
- Gestión de proyectos de restauración o construcción de máquinas con seguimiento de tareas
- Catálogo público de piezas desechadas o disponibles para intercambio entre coleccionistas
- Archivo digital de documentación técnica (manuales, ROMs) vinculado a activos específicos
- Generación automática de etiquetas imprimibles para etiquetar componentes físicos
- Diferenciación clara entre máquinas ensamblables y consolas selladas en la base de datos
- Sistema de historial datado que registra cada cambio o reparación realizada en un activo
- API REST completa y herramientas CLI para integración con impresoras de etiquetas
- Licencia AGPLv3 que permite uso comercial e institucional sin obligación de pago
- Arquitectura contenerizada con Caddy para HTTPS automático y gestión de certificados
- Requiere conocimientos básicos de Docker Compose y configuración de variables de entorno
- La interfaz web depende de plantillas Jinja renderizadas en el servidor, no es SPA
- No incluye autenticación OAuth2 por defecto, solo login básico o similar según implementación
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Copiar .env.example a .env y editar contraseñas antes de ejecutar docker compose up --build. El sitio estará en localhost:8000. Para producción, usar el dominio propio con Caddy para HTTPS automático. Consultar INSTALL.md para servidores existentes y DEPLOY.md para actualizaciones diarias.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.