tcgcards docs

Documentación interna del marketplace TCG Chile. Visión, arquitectura, infra, runbooks y onboarding en un solo lugar.

Empezar onboarding Ver arquitectura

Atajos por rol

Soy nuevo, empiezo acá

Lee la visión del producto, después el onboarding y termina con el glosario.

Vengo a operar

Salta a runbooks para deploy, rollback, restore de backup y rotación de credenciales.

Vengo a programar

Mira la arquitectura, los servicios y los inventarios técnicos (DB, endpoints, web).

Necesito un dato puntual

Usa la búsqueda arriba a la derecha. Busca por nombre de variable, endpoint, modelo o servicio externo.

¿Qué es tcgcards?

tcgcards.cl es un marketplace de cartas TCG (Pokémon, One Piece, Magic, Yu-Gi-Oh, Digimon, etc.) operando en Chile. Vendedores publican sus cartas, accesorios, lotes (challa) y productos sellados; compradores pagan vía Mercado Pago y reciben el producto por envío o entrega presencial. La plataforma se queda una comisión sobre cada venta completada.

Sitio público: https://tcgcards.cl

Mapa rápido del sistema

2 repos: tcgcards-web (frontend Next.js) y tcgcards-api (backend Express + Mongo)
3 servicios principales: Vercel (web), Cloud Run (api), MongoDB Atlas (datos)
Auth: Google OAuth + JWT propio
Pagos: Mercado Pago Chile
Imágenes: Cloudinary
Email: Resend (envío) + Cloudflare Email Routing (recepción)
DNS y CDN: Cloudflare
Crons: Cloud Scheduler (5 jobs)

Detalles completos en arquitectura e infraestructura.