Cartas Total es una plataforma para coleccionistas de cartas TCG en Perú —Pokémon, Yu-Gi-Oh!, Magic y One Piece—: registrar la colección, encontrar con quién intercambiar y comunicarse. La desarrollo y la opero yo, y está en producción en cartastotal.com.
Este es el primero de varios posts cortos sobre cómo está construida. Empiezo por un resumen general.
Qué hace#
Catálogo por juego, expansión e idioma; perfiles públicos con la colección de cada usuario; feed con publicaciones, menciones y noticias; mensajes directos y casos de intercambio con reseñas. Funciona como PWA instalable, con notificaciones en tiempo real.
La arquitectura#
Todo corre en un único servidor ARM gratuito de Oracle Cloud:
- Next.js 16 con React 19 y TypeScript, gestionado con PM2.
- PostgreSQL 17 con Prisma, en un contenedor Docker.
- SeaweedFS para imágenes y adjuntos, servido detrás de Cloudflare.
- Nginx como reverse proxy; Cloudflare para DNS, caché y protección.
La colección y el feed#
Lo central son dos cosas: que cada coleccionista tenga su vitrina y que pueda hablar con otros.
En móvil funciona como app instalable:
Pagos y requisitos legales#
La plataforma tiene planes Plus y Pro con pagos en línea y facturación electrónica con SUNAT. Además cumple requisitos obligatorios en Perú: libro de reclamaciones y derechos ARCO. Es la parte menos visible y de la que más tardé en entender bien.
SEO#
SEO técnico desde el inicio: sitemaps por tipo de contenido, datos estructurados JSON-LD, y registro en Search Console, Bing Webmaster e IndexNow para indexar las páginas nuevas pronto.
Desarrollo con agentes de IA#
Uso agentes de IA orquestados —Claude, Codex, Gemini y OpenCode— para acelerar el desarrollo; cada cambio pasa por revisión antes de entrar. El despliegue es automático: con runners propios de GitHub Actions y entornos de sandbox y producción separados, cada push que pasa las pruebas llega al servidor. Lo explico en cómo orquesto Claude y agentes de CLI para ahorrar tokens.
Qué sigue#
Iré publicando notas más concretas sobre partes del sistema. Los detalles técnicos del proyecto están en la ficha de Cartas Total, y la plataforma está en cartastotal.com.
