Memory Card · MC-Alpha

Aplicación de registro y valoración de juegos. Repositorio monorepo con frontend (Nuxt 3) y backend (Express + Prisma) en dos carpetas independientes.

Estructura

MC-Alpha/
├── AGENTS.md   # reglas comunes del monorepo (raíz)
├── MEMORY.md   # estado y decisiones del proyecto
├── spec/       # specs de dominio, constitución y Casos de uso
├── frontend/   # Cliente Nuxt 3 (Tailwind, Pinia)
└── backend/    # API Express + Prisma (PostgreSQL, Docker)

Frontend y backend se desarrollan en este mismo repositorio (el backend ya no lo lleva un tercero). Cada carpeta tiene su propia configuración de package.json, dependencias y scripts; los documentos de trabajo con IA viven en la raíz.

Documentación

• Reglas comunes → AGENTS.md; reglas por paquete → frontend/AGENTS.md y backend/AGENTS.md.
• Estado y decisiones → MEMORY.md.
• Specs, constitución y flujo de trabajo → spec/README.md.

Requisitos previos

• Node.js y npm
• Docker Desktop (para la base de datos del backend)

Frontend

cd frontend
npm install
npm run dev

Servidor de desarrollo en http://localhost:3000.

npm run build    # build de producción
npm run preview  # previsualizar build de producción

Backend

cd backend
npm install

1. Base de datos

docker compose up -d
docker compose ps

2. Configuración

Copia .env.example a .env y rellena los valores:

cp .env.example .env

3. Migraciones y seed

npx prisma migrate dev
npx prisma generate
npx prisma db seed

4. Arrancar la API

npm run dev

5. Sincronizar datos de IGDB

npm run sync:companies
npm run sync:platforms
npm run sync:genres
npm run sync:games

Notas

• Los archivos .env son personales y NO se suben al repositorio (están en .gitignore). Cada persona crea el suyo a partir de .env.example.
• Los artefactos de build (node_modules, .nuxt, dist, .output, logs, etc.) tampoco se suben.
• El .gitignore raíz se aplica a todo el monorepo.