Servicios (repositorios)

Hay 3 repositorios que componen el sistema. Los 3 son privados y viven en GitHub bajo yoeldtrujillo.

`tcgcards-web`

Aplicación pública en tcgcards.cl. Frontend completo, server components + server actions hacia el backend.


Repo	https://github.com/yoeldtrujillo/tcgcards-web
Producción	https://tcgcards.cl
Hosting	Vercel
Deploy	Automático en cada push a `main`
Local	`/Users/yoel/Documents/Repos/tcgcards-web`
Stack	Next.js 16, React 19, Tailwind 4, Auth.js 5
Tests	`npm test` (Vitest + Testing Library)
Dev local	`npm run dev` → http://localhost:3000

Qué contiene

Todas las páginas públicas (catálogo, listing detail, perfiles, etc.)
Dashboard de usuario (/me/...) y admin (/admin/...)
Server actions que llaman al API
Componentes UI (shadcn + custom)

Cómo se deploya

Push a main → Vercel detecta y deploya automáticamente. No requiere comando manual. Tarda 2-3 min.

`tcgcards-api`

Backend HTTP que sirve datos y maneja órdenes, pagos, wallet, etc.


Repo	https://github.com/yoeldtrujillo/tcgcards-api
Producción	https://tcgcards-api-1033181994095.us-central1.run.app
Hosting	Google Cloud Run (project `api-cards-prod`, region `us-central1`)
Deploy	Manual con `gcloud run deploy`
Local	`/Users/yoel/Documents/Repos/tcgcards-api`
Stack	Node 20, Express 4, Mongoose 8, Zod 3
Tests	`npm test` (Vitest + supertest + mongodb-memory-server)
Dev local	`npm run dev` → http://localhost:3000

Qué contiene

Endpoints REST en /api/v1/... (ver endpoints API)
Servicios de dominio (listings, orders, cart, wallet, disputes, etc.)
Cron jobs (ver crons)
Jobs de sincronización con TCGplayer (npm run sync:initial / sync:incremental)
Scripts de backfill en /scripts

Cómo se deploya

NO se auto-deploya con git push. Requiere comando manual:

cd /Users/yoel/Documents/Repos/tcgcards-api
gcloud run deploy tcgcards-api \
  --source . \
  --region us-central1 \
  --project api-cards-prod \
  --quiet

Tarda 5-8 min. Crea una revisión nueva y enruta 100% del tráfico a ella.

Después de cualquier upgrade o migración de Mongo Atlas, redeploy obligatorio para refrescar los connection pools.

`tcgcards-docs`

Este sitio que estás leyendo.


Repo	https://github.com/yoeldtrujillo/tcgcards-docs
Producción	https://docs.tcgcards.cl
Hosting	Cloudflare Pages
Deploy	Automático en cada push a `main`
Auth	Cloudflare Access (Google + whitelist por email)
Local	`/Users/yoel/Documents/Repos/tcgcards-docs`
Stack	Astro Starlight
Dev local	`npm run dev` → http://localhost:4321