Guía de entrega Historial Gamer

Qué te entregamos

Tu plataforma está terminada y probada en nuestro entorno. Falta ponerla en tu servidor, con tus cuentas y tu dirección web. Se compone de tres piezas:

La web pública, en español e inglés: perfiles de jugador, listas de juegos, reseñas, logros, gremios y buscador.
El panel de administración: para moderar contenido, gestionar usuarios y ver las estadísticas de visitas. Va en una dirección aparte, solo para tu equipo.
El motor que hace funcionar a las dos: guarda los datos, llena el catálogo de juegos por sí solo y envía los correos automáticos.

También recibes el código fuente completo y la documentación técnica para cualquier equipo que lo mantenga en el futuro.

Puedes verla funcionando en historial.hivecode.cloud. Es una versión de pruebas en nuestro servidor, con nombre, logo y colores provisionales: regístrate, añade juegos, escribe una reseña, crea un gremio. Lo que veas ahí es lo que tendrás en tu dirección.

Las estadísticas de visitas son propias: no usamos Google Analytics ni rastreadores. Por eso la web no necesita el aviso de cookies.

Lo que viene incluido y no tuviste que pedir

Hay cosas que hicimos porque creemos que una plataforma seria las necesita desde el primer día:

Web en español e inglés, con las direcciones preparadas para buscadores.
Sistema de denuncias y herramientas de moderación, para que la comunidad se cuide sola y tú tengas la última palabra.
Privacidad por diseño: estadísticas sin cookies ni rastreo, y las contraseñas guardadas de forma que ni nosotros podemos leerlas.
Revisión de seguridad propia, con los puntos pendientes anotados y priorizados para que ningún equipo futuro parta de cero.
Copias de seguridad automáticas y un catálogo que se llena y se actualiza solo, sin que nadie tenga que tocar nada.
Documentación completa del código, pensada para que el día que quieras cambiar de equipo puedas hacerlo sin depender de nosotros.

Las cuentas que tienes que abrir

Son cinco. Tres imprescindibles, una necesaria para que la gente suba fotos y una opcional. Todas gratuitas para empezar.

Ábrelas tú, a nombre de tu empresa, con un correo de la empresa y tu tarjeta. Así todo es tuyo desde el primer día. Cada cuenta te dará una o dos claves; nos las pasas por el gestor de contraseñas que te indiquemos, nunca por chat ni correo.

Resend · correos automáticos

Imprescindible

Gratis para empezar. Sirve para enviar los correos de "recupera tu contraseña" y "confirma tu correo". Sin esto la plataforma no puede arrancar.

Crea una cuenta en resend.com.
Añade tu dominio (la dirección web que compres). Resend te pedirá añadir unos registros en tu dominio: te acompañamos en ese paso.
Crea una clave ("API key"). Solo se muestra una vez: cópiala en ese momento.

Nos pasas:la clave y la dirección de correo desde la que quieres que salgan los mensajes, por ejemplo hola@tudominio.com.

Twitch · el catálogo de juegos

Imprescindible

Gratis. La base de datos de juegos que usamos (IGDB) pertenece a Twitch y las credenciales se crean allí. Sin esto el catálogo estaría vacío.

Crea una cuenta de Twitch y activa la verificación en dos pasos (te lo exigirán).
Entra en dev.twitch.tv/console/apps y registra una aplicación. Como dirección de redirección pon http://localhost; como categoría, "Application Integration".
Copia los dos códigos que te da: el "Client ID" y el "Client Secret".

Nos pasas:esos dos códigos.

Cloudflare · fotos de perfil y de gremios

Para las fotos

Gratis hasta 10 GB (miles de fotos); te pedirán una tarjeta aunque no cobren. Sin esto la web funciona, pero nadie podrá subir su foto.

Crea una cuenta en cloudflare.com y activa "R2".
Crea un "bucket" (una carpeta en la nube). Nosotros lo conectamos a tu dominio para que las fotos tengan una dirección bonita.
Crea una clave de acceso al bucket con permiso de lectura y escritura. Se muestra una sola vez.

Nos pasas:el nombre del bucket, la clave y su código de acceso.

Discord · entrar con Discord

Opcional

Gratis. Permite registrarse y entrar con la cuenta de Discord en un clic. Si no lo activas, la gente entra con correo y contraseña igualmente.

Entra en discord.com/developers y crea una aplicación.
Copia el "Client ID" y genera el "Client Secret".
Nosotros añadimos la dirección de vuelta que Discord necesita.

Nos pasas:esos dos códigos.

GitHub · donde vivirá tu código

Imprescindible

Gratis. GitHub es el sitio donde se guarda el código de la web, con todo su historial de cambios. Debe estar en una cuenta tuya para que el código sea tuyo, y nosotros lo subimos ahí.

Crea una cuenta en github.com con el correo de tu empresa. Mejor aún, crea una organización a nombre de la empresa (GitHub lo ofrece al registrarte).
Crea un repositorio nuevo, privado, con el nombre que quieras (por ejemplo el de la plataforma). Déjalo vacío.
En el repositorio, ve a "Settings → Collaborators" e invítanos con los usuarios de GitHub que te daremos. Necesitamos permiso de escritura ("Write").

Nos pasas:el enlace del repositorio. Nosotros subimos el código y, a partir de ahí, todo cambio queda registrado en tu cuenta.

Traductor automático

Lo ponemos nosotros

Las descripciones de los juegos llegan en inglés y las traducimos al español con un traductor que instalamos junto a la web. No tienes que abrir ninguna cuenta ni pagar nada por él.

Dónde vivirá la web

La web necesita un servidor: un ordenador alquilado por meses que está siempre encendido. Tú lo contratas a tu nombre y nosotros lo configuramos. Los datos de tus usuarios se guardan en ese mismo servidor, con copia de seguridad diaria en tu cuenta de Cloudflare.

Hemos comparado siete empresas por su trayectoria, por dónde tienen sus servidores y por precio. Nuestra recomendación:

Empresa	Al mes	Por qué
Vultr Recomendada	$20 a $40	Doce años en el mercado, sin permanencia, y es la única con servidores en Madrid, Ciudad de México, São Paulo, Santiago y Miami: lo ponemos donde estén tus usuarios.
Hostinger	$9, luego $15	La más barata, pero exige pagar dos años por adelantado. Solo tiene servidores en Brasil, Estados Unidos y Europa.
Hetzner	≈ €9	Muy buena y barata, pero solo en Alemania y Finlandia. Solo si tus usuarios están en Europa.
Linode	$24 a $48	Parecida a Vultr, algo más cara y con menos ciudades.

La cifra menor es si el traductor automático no va en tu servidor; la mayor, si va todo junto. Precios de septiembre de 2026.

El nombre y la dirección web

"Historial Gamer" es un nombre provisional. Buscamos nombres cortos y fáciles de recordar, en inglés o con juego de palabras, y con la dirección web libre. Comprobado contra los registros el 9 de septiembre de 2026; puede cambiar en cualquier momento, así que el elegido se compra el mismo día.

Con todas las direcciones libres (.com, .gg, .app, .io)

Nombre	El juego de palabras	Direcciones libres
Gamoir	Game + memoir: tus memorias como jugador. Seis letras, suena a marca. No existe ninguna empresa ni app con ese nombre.	gamoir.com · .gg · .app · .io
Memkard	La memory card donde se guardaban las partidas. Nostalgia gamer con una letra cambiada.	memkard.com · .gg · .app · .io
Playhist	Play history: tu historial de juego, dicho en ocho letras.	playhist.com · .gg · .app · .io
Gamerito	Gamer con diminutivo español. Cariñoso, muy latino.	gamerito.com · .gg · .app · .io

Solo con la dirección .gg libre

La terminación .gg es la de la cultura gamer (la usan Discord, op.gg o tracker.gg) y basta como única dirección. Eso abre estos nombres, cuyo .com ya está cogido:

Nombre	El juego de palabras	Dirección libre
Questory	Quest + story: la historia de tus misiones.	questory.gg
Roll Credits	Lo que pasa cuando terminas un juego: ruedan los créditos.	rollcredits.gg
Memcard	La misma idea de Memkard, sin la letra cambiada.	memcard.gg
Played That	"Ese ya lo jugué". Conversacional.	playedthat.gg
Histo	De "historial", rematado con GG: histo.gg.	histo.gg

Nuestro favorito es Gamoir: corto, sonoro, significa algo, no existe como marca y quedan libres las cuatro direcciones. Memkard si prefieres el guiño retro; Playhist si prefieres que el nombre se explique solo.

Cómo comprar la dirección

En porkbun.com, con tu cuenta y tu tarjeta. La terminación .com cuesta unos $11 al año; la .gg, unos $52. Si el nombre tiene las dos libres, compra ambas el mismo día que lo decidas: una será la principal y la otra redirige.
Activa la renovación automática para no perderla.
Antes de decidir, comprueba que el nombre esté libre en Instagram, X, TikTok y Discord, y que no exista una marca registrada igual. Eso tienes que hacerlo tú o tu asesor.

Logo y colores

Falta el logo. El que ves ahora en la web es provisional, hecho por nosotros para poder trabajar. Cuando tengas el nombre definitivo, necesitamos el logo de tu marca:

En formato vectorial (SVG o el archivo original de Illustrator o Figma). Si no lo tienes, un PNG grande, de al menos 1000 píxeles.
Dos versiones: el símbolo solo, cuadrado, para el icono de la pestaña y del móvil; y el logo con el nombre, horizontal, para la cabecera.
Pensado para verse sobre fondo oscuro, que es como está diseñada la web. Si solo lo tienes para fondo claro, lo adaptamos.

Si aún no tienes diseñador, dinos y te pasamos un presupuesto para hacerlo.

El color principal se puede cambiar. Hoy la web usa un violeta con detalles en azul turquesa. Los colores están definidos en un único sitio, así que cambiar el violeta por el color de tu marca es un trabajo de medio día: se cambia el color, se revisa que los textos sigan leyéndose bien encima y se regeneran los iconos. Lo que no es rápido es cambiar el fondo oscuro por uno claro: eso sería rediseñar.

Cuánto cuesta al mes

Concepto	Al mes	Notas
Servidor	$20 a $40	Más un 20 % si activas las copias automáticas del servidor, recomendado.
Dirección web	≈ $1	$11 al año. $52 al año más si compras también la `.gg`.
Correos, catálogo, fotos, Discord	$0	En sus planes gratuitos, suficientes para los primeros meses. Las fotos empezarían a costar a partir de 10 GB.
Total infraestructura	$25 a $50	Lo caro no es esto, sino las horas de moderación y mantenimiento (ver abajo).

Lo que debes saber antes de lanzar

Diez cosas que no son técnicas pero afectan a tu negocio. Las ordenamos por lo que puede costarte más caro ignorar.

Legal

Los textos legales son un borrador

La web ya tiene términos de uso, política de privacidad, aviso de cookies y normas de la comunidad. Pero les falta el nombre de tu empresa, un correo de contacto y la edad mínima para registrarse. Tu asesor legal debe completarlos y firmarlos como suyos.

Legal

Hoy un usuario no puede borrar su cuenta por sí mismo

La ley de protección de datos obliga a permitirlo. Hay que añadir esa opción antes de lanzar, o comprometerse a hacerlo a mano en pocos días cuando alguien lo pida. Recomendamos añadirla.

Legal

Si ganas dinero con la web, avisa a IGDB

El catálogo de juegos es gratuito para uso no comercial. Si vas a poner publicidad o suscripciones, sus condiciones piden llegar a un acuerdo con ellos (partner@igdb.com). Normalmente es un trámite, pero hay que hacerlo.

Legal

Tus usuarios publicarán cosas, y eres responsable de revisarlas

Reseñas, gremios y fotos de perfil las suben ellos. Existe un sistema de denuncias y el panel permite ocultar contenido y suspender cuentas, pero no hay un filtro automático de fotos: alguien de tu equipo tiene que revisar las denuncias con regularidad.

Funcionamiento

La web necesita cuidados periódicos

Como un local: hay que actualizarla, vigilar que esté en marcha y comprobar las copias de seguridad. Recomendamos un mantenimiento trimestral y un avisador gratuito que nos alerte si la web se cae. Ya hay un ajuste pendiente por nuestra parte en el traductor automático.

Funcionamiento

Cosas que tardan y son normales

El catálogo tarda unos días en llenarse la primera vez. Un juego recién estrenado aparece cuando la base de datos de Twitch lo puntúa. Las descripciones en español son traducción automática: correctas, no perfectas.

Funcionamiento

La web está oculta para Google hasta que tú digas

Así puedes probarla con calma. Cuando quieras aparecer en buscadores, nos avisas y la hacemos visible en minutos.

Propiedad

Todo a tu nombre

Servidor, dirección web y las cinco cuentas deben estar a nombre de tu empresa. El código vive en tu GitHub, y nosotros entramos como colaboradores invitados: si un día cambias de equipo, solo tienes que quitar la invitación. Si alguien de tu equipo se va, cambiamos las claves.

Propiedad

Cambiar el nombre lleva medio día de trabajo

El nombre provisional aparece en más de 200 sitios: textos legales, correos, títulos. Es mejor decidirlo antes de anunciar la web y antes de que Google la indexe.

Propiedad

Hay una sorpresa escondida

Si alguien escribe "hivecode" en la web aparece una abeja en píxel volando. Es una firma del estudio. Tú decides si se queda.

Pasos hasta el lanzamiento

TúDecides el nombre y compras la dirección web el mismo día. Nos pasas el logo y, si quieres cambiarlo, el color de tu marca.
TúAbres las cinco cuentas de la sección 2, nos invitas a tu repositorio de GitHub y contratas el servidor. Nos pasas las claves por el gestor de contraseñas.
NosotrosSubimos el código a tu GitHub, configuramos el servidor, conectamos las cuentas, ponemos el nuevo nombre, el logo y los colores, y activamos las copias de seguridad. Dos o tres días.
NosotrosEl catálogo empieza a llenarse solo. Mientras, creamos tu cuenta de administrador y te enseñamos el panel.
Tú y nosotrosProbamos juntos: registro, recuperar contraseña, entrar con Discord, subir una foto, crear un gremio, escribir y moderar una reseña.
TúTu asesor revisa los textos legales y decides quién modera.
NosotrosHacemos la web visible en buscadores cuando des el visto bueno. Lanzamiento.

Cómo te acompañamos

Entregar el código no es el final del trabajo. Esto es lo que te garantizamos a partir de hoy:

Puesta en marcha con nosotros al lado

Configuramos tu servidor, conectamos tus cuentas y hacemos las pruebas contigo. Hasta que la web esté funcionando en tu dirección, no damos el proyecto por entregado.

30 días de garantía tras el lanzamiento

Si algo no funciona como debería, lo corregimos sin coste. Cualquier error que aparezca en ese periodo es nuestro, no tuyo.

Una persona de contacto y un canal directo

Sabrás a quién escribir y por dónde. Respondemos en el mismo día laborable; si es urgente y la web está caída, antes.

Formación del panel, grabada

Una sesión de una hora para tu equipo: moderar, gestionar usuarios, leer las estadísticas. Te dejamos la grabación para quien se incorpore después.

Revisión a los 30 días

Nos sentamos contigo a mirar los datos reales: cuánta gente entra, qué usan, qué se atasca. Y te proponemos los siguientes pasos con calma, sin compromiso.

Todo tuyo, sin letra pequeña

Código, cuentas, dominio y datos están a tu nombre. Si un día decides seguir con otro equipo, te lo llevas todo y la documentación les servirá para continuar.

Ideas para seguir creciendo

Mientras construíamos la plataforma anotamos lo que la haría aún mejor. No está incluido en esta entrega, pero está pensado y estimado, para cuando quieras dar el siguiente paso:

Diario de juego: fechas, horas jugadas y plataforma de cada partida, incluidas las segundas vueltas.
Seguir a otros jugadores y un muro de actividad: "Ana completó Hades", "Luis reseñó Celeste".
Me gusta y comentarios en las reseñas, para que la comunidad converse.
Listas propias: "Mis 10 JRPG favoritos", ordenables y compartibles.
Estadísticas del perfil: juegos por año, por género, por plataforma; la nota media de cada jugador.
Métricas de negocio en tu panel: reseñas por semana, juegos más comentados del mes.

Gracias por confiar en nosotros para construir esto. Sabemos que detrás de cada proyecto hay alguien que se la juega, y lo hemos tratado como si fuera nuestro. Ahora toca que sea tuyo del todo.

Apéndice para quien configure el servidor

Esta parte sí es técnica. El cliente no necesita leerla; es para el equipo que haga la instalación. El detalle completo está en la carpeta docs/ del código fuente.

Requisitos del servidor

VPS con Docker y Coolify. RAM: 8 GB cómodo con LibreTranslate en el stack; 4 GB si LibreTranslate corre fuera. PostgreSQL 16 como recurso aparte en Coolify con pg_dump diario a R2. Tres dominios: web, api. y admin.; opcional media. para R2.

Migraciones automáticas al arrancar. Primer administrador: /app/api create-admin correo@cliente.com desde el contenedor de la API, con el usuario ya registrado en la web.

Variables de la API

Variable	Obligatoria	Valor
`APP_ENV`	sí	`production`
`DATABASE_URL`	sí	Cadena completa de PostgreSQL. Contraseña solo alfanumérica.
`JWT_SECRET`	sí	`openssl rand -base64 48`, mínimo 32 caracteres. Rotarlo cierra todas las sesiones.
`FRONTEND_URL`	sí	URL pública de la web.
`TRUSTED_PROXIES`	sí	CIDR del proxy (Coolify: `10.0.0.0/8,172.16.0.0/12`) o `none`.
`RESEND_API_KEY` · `MAIL_FROM` · `MAIL_FROM_NAME`	sí	Resend. Alternativa SMTP: `SMTP_HOST/PORT/USERNAME/PASSWORD`.
`IGDB_CLIENT_ID` · `IGDB_CLIENT_SECRET`	sí en la práctica	Twitch Developers.
`R2_ENDPOINT` · `R2_BUCKET` · `R2_ACCESS_KEY_ID` · `R2_SECRET_ACCESS_KEY` · `R2_PUBLIC_BASE_URL`	para subidas	Cloudflare R2. `R2_REGION=auto`.
`DISCORD_CLIENT_ID` · `DISCORD_CLIENT_SECRET` · `DISCORD_REDIRECT_URL`	no	Redirect: `https://<web>/api/auth/discord/callback`, idéntico al del portal.
`TRANSLATE_URL`	no	`http://libretranslate:5000` en el compose, o la URL del traductor externo con `TRANSLATE_API_KEY`.
`SYNC_INTERVAL` · `SYNC_MIN_RATINGS` · `SYNC_BATCH`	no	`6h` · `1` · `300`.
`ANALYTICS_RETENTION_DAYS`	no	`90`.
`INTERNAL_API_KEY` · `REAL_IP_HEADER`	no	Solo con CDN delante; con Cloudflare, `CF-Connecting-IP`.

Variables de la web y del panel

App	Variable	Notas
web	`NEXT_PUBLIC_API_URL`	En build. URL pública de la API + `/api/v1`.
web	`FRONTEND_URL`	URL pública de la web.
web	`COOKIE_DOMAIN`	`.tudominio.com`, mismo valor en el panel. Cambiarlo cierra sesiones.
web	`DISCORD_CLIENT_ID`	Igual que en la API.
web	`SITE_INDEXABLE`	`true` solo cuando deba indexarse. Por defecto la web va con `noindex`.
admin	`NEXT_PUBLIC_API_URL` · `NEXT_PUBLIC_WEB_URL`	En build.
admin	`COOKIE_DOMAIN`	Mismo valor que en la web.

Pendientes técnicos conocidos

No existe endpoint de borrado ni exportación de cuenta (DELETE /me): desarrollar antes del lanzamiento.
Traducciones: una traducción fallida al importar queda en inglés para siempre; la API arranca antes que LibreTranslate y su tope de memoria (1024 MB) es justo. Corrección propuesta: backfill acotado en cada pasada del sync, depends_on y subir LT_MEM_LIMIT. Remedio inmediato: /app/api translate-backfill.
Imágenes Docker de web y panel en Node 20 (fin de vida abril 2026): pasar a Node 22 o 24.
Sin monitorización de errores ni de disponibilidad: añadir un monitor externo.
Panel sin doble factor: lista blanca de IPs o autenticación básica en el proxy.
Endurecimientos de seguridad de prioridad baja en TODO-SECURITY.md.
Renombrado: "Historial Gamer" aparece 218 veces en 69 archivos.