# Discographic **Tu colección de Discogs, por fin en casa.** Una app autohospedada que convierte tu colección de Discogs en algo que da gusto recorrer: portadas, datos útiles y todos los detalles de cada copia que tienes. [![Última versión](https://img.shields.io/github/v/release/SimonBlancoE/discographic?color=d1a45a&label=versión)](https://github.com/SimonBlancoE/discographic/releases) [![Licencia MIT](https://img.shields.io/badge/licencia-MIT-57534e.svg)](LICENSE) [![Docker](https://img.shields.io/badge/docker-listo-57534e.svg?logo=docker&logoColor=white)](#inicio-rápido) [Read in English](./README.md)
Panel principal de Discographic: bienvenida, cifras clave y valor según Discogs

## Por qué Discographic - **Ves tu colección, no una hoja de cálculo.** Recórrela por portadas, filtra por lo que quieras y llega al disco que tienes en mente. - **Sabes lo que tienes.** Cuánto vale, qué discos buscan los coleccionistas y en qué estado está cada copia. - **Tus datos se quedan contigo.** Funciona en tu ordenador o servidor y guarda una copia local de tu colección. Los cambios se sincronizan con Discogs. ## Lo más destacado
Colección en vista de portadas, ordenada por demanda

Explora por portadas
Alterna entre cuadrícula de portadas y tabla detallada. Filtra por género, estilo, década, formato, sello, carpeta o estado. Se recuerdan la página, el orden y los filtros.

 Ficha de un disco con datos de la comunidad y los de tu copia

Cada copia, a fondo
Lista de temas, datos de la comunidad, estado del disco y de la funda, carpeta y notas, todo guardado directamente en Discogs. Consulta el resto de ediciones del álbum y cuáles ya tienes.
Rankings de rareza y demanda

Rareza y demanda
Descubre tus discos más deseados, más codiciados y más raros, según cuántos coleccionistas de Discogs los tienen y los buscan.

 Discographic en el móvil

Cómoda también en el móvil
El diseño se adapta de monitores anchos a teléfonos, en español e inglés.
### Y además | | | |---|---| | 💰 **Valor de la colección** | La estimación de Discogs (mínimo / mediana / máximo) con su evolución, más el precio de mercado de cada disco. | | 🏷️ **Precios sugeridos** | Lo que Discogs sugiere pedir según el estado, con el de tu copia resaltado (requiere ajustes de vendedor en Discogs). | | 📊 **Estadísticas** | Géneros, estilos, décadas, formatos, sellos, crecimiento en el tiempo y tus artistas principales. | | 🖼️ **Mosaico de portadas** | Un mosaico con tus portadas, exportable como póster de hasta 7200 px. | | 🖨️ **Catálogo imprimible** | Una lista limpia para imprimir, de toda la colección o de cualquier filtro. | | 📥 **Importar / exportar** | Excel y CSV. Edita valoraciones y notas en una hoja de cálculo y vuelve a importarlas. | | 🎯 **Gestor de Wantlist** | Revisa tu Wantlist con precios, prioridades y notas locales. | | 🎲 **Qué pincho hoy** | Deja que la app elija un disco al azar y desbloquea logros a medida que crece tu colección. | | 👥 **Multiusuario** | Cada persona conecta su propia cuenta de Discogs y solo ve su colección. | ## Inicio rápido Necesitas [Docker](https://docs.docker.com/get-docker/). ```bash git clone https://github.com/SimonBlancoE/discographic.git cd discographic docker compose up -d ``` Abre **http://localhost:3800** y: 1. **Crea tu cuenta.** El primer usuario es el administrador. 2. **Conecta Discogs.** En *Ajustes*, escribe tu usuario de Discogs y un token personal ([consíguelo aquí](https://www.discogs.com/settings/developers) → *Generate new token*). 3. **Sincroniza.** Pulsa *Sincronizar con Discogs* en el panel principal. Las colecciones grandes tardan unos minutos la primera vez. ### Actualizar ```bash git pull docker compose up -d --build ``` Tus datos viven en un volumen de Docker y se conservan entre actualizaciones. Los cambios de base de datos se aplican solos al arrancar. Haz una copia del volumen antes de actualizaciones importantes. ## Configuración Opcional. Copia `.env.example` a `.env` para cambiar cualquiera de estas variables: | Variable | Por defecto | Para qué sirve | |---|---|---| | `PORT` | `3800` | Puerto publicado en el host con Docker Compose; el contenedor escucha en `3800`. Si ejecutas el servidor directamente, define el puerto de escucha. | | `HOST_IP` | `127.0.0.1` | Interfaz a la que se enlaza Docker. Usa tu IP de red local para abrirla desde otros dispositivos. | | `COOKIE_SECURE` | `false` | Ponlo en `true` si sirves la app por HTTPS. | | `TRUST_PROXY` | `1` si `COOKIE_SECURE=true` | Saltos de proxy de confianza, por ejemplo detrás de Cloudflare Tunnel o de un proxy inverso. | | `SESSION_SECRET` | *(generado)* | Secreto para firmar las cookies. Si está vacío, se crea uno aleatorio y se guarda en el volumen de datos. | Las credenciales de Discogs nunca se configuran aquí: cada usuario añade las suyas dentro de la app. ## Preguntas frecuentes **¿Está seguro mi token de Discogs?** Se guarda en tu servidor y solo el servidor lo usa para hablar con Discogs. El navegador solo ve una vista previa abreviada. **¿Por qué tarda la primera sincronización?** Discogs limita las apps a 60 peticiones por minuto. La primera sincronización, la revisión de precios y la descarga de datos de comunidad respetan ese límite. Después todo es local y rápido. **¿Puedo usarla sin Docker?** Sí. Mira *Desarrollo* más abajo. Necesitas Node.js 24 y pnpm. ## Desarrollo ```bash pnpm install pnpm run dev:server # API en http://localhost:3800 pnpm run dev # app en http://localhost:5173 ``` Hecha con React 19, React Router 7, Tailwind CSS 4, Vite 8, Express 5, SQLite (better-sqlite3), Recharts y Sharp, todo en TypeScript. Antes de abrir un pull request, lee [CONTRIBUTING.md](./CONTRIBUTING.md) para ver las normas del proyecto y los comandos de verificación. ## Licencia [MIT](LICENSE)