Files

T

urieljarethandClaude Opus 5 20f535d485 Retirar el servidor MCP y fijar todas las dependencias del API

MCP: se retira por completo (endpoint, paquete api/app/mcp/ y dependencia).
Tres razones, en orden de peso:

- Nadie lo usa.
- Llevaba roto desde antes de este trabajo. Con credencial valida devolvia 500:
  el handler construia un StreamableHTTPServerTransport nuevo por peticion, sin
  manejo de sesion. Lo que estaba expuesto a internet era la puerta abierta de un
  cuarto averiado.
- Su SDK sin fijar tumbo el API entero en produccion al saltar a 2.0.0.

Retirarlo es una mitigacion mas fuerte que autenticarlo, que fue lo que hizo el
commit anterior. Recuperable con `git show edb500f5:api/app/mcp/server.py`.
Se limpia tambien la ruta "/mcp" que el endpoint raiz seguia anunciando, y las
menciones a MCP del docstring y la descripcion de Swagger.

Dependencias: once de las doce eran rangos `>=` sin techo, o sea que cada
reconstruccion era una tirada de dados contra PyPI. `pydantic>=2.0` habria
aceptado pydantic 3 con la misma alegria con la que `mcp>=1.0.0` acepto 2.0.0.
Ahora todas van fijadas a la version exacta que corre sana en produccion,
capturada con pip freeze del contenedor healthy.

El lado Next.js ya era reproducible via package-lock.json; por eso el web nunca
se cayo durante el incidente y el api si.

Docs actualizados: AGENTS.md, README.md, api/COTIZADOR_API_SKILL.md y el spec,
que ademas registra en su seccion 0 las tres desviaciones de Fase 0 respecto a
lo disenado (el Despliegue B cancelado, la retirada del MCP y la deriva de
dependencia).

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>

2026-07-28 17:51:21 -06:00

4.2 KiB

Raw Blame History

Cotizador E3

Sistema de generación de cotizaciones para Consultoría E3 (marketing digital, Querétaro MX). Servicios organizados en 4 fases, dos tipos de pago (único / mensual), planes CRM Bucéfalo y financiamiento opcional. Exporta a PDF y Excel.

Stack

Frontend / app web: Next.js 16 (App Router) + React 19 + Tailwind CSS v4 + Zustand
ORM: Prisma 7 (cliente generado en src/generated/prisma, driver adapter PrismaPg)
Base de datos: PostgreSQL 16 (vía Docker)
Auth: JWT (jose) en cookie httpOnly, contraseñas con bcryptjs
API alterna: servicio Python FastAPI en api/ (para n8n / integraciones)

Requisitos

Node.js 20+
Docker (para PostgreSQL)
Un archivo .env en la raíz — copia .env.example y define al menos JWT_SECRET

Arranque rápido (Windows)

start.bat   :: levanta PostgreSQL en Docker, aplica migraciones y arranca Next.js
stop.bat    :: detiene todo

Arranque manual

docker compose up -d postgres   # base de datos
npx prisma migrate deploy        # aplica migraciones
npx tsx prisma/seed.ts           # carga catálogo (idempotente)
npm run dev                      # http://localhost:3000

Comandos

Comando	Propósito
`npm run dev`	Servidor de desarrollo (puerto 3000)
`npm run build`	Build de producción (incluye chequeo de tipos)
`npm run lint`	ESLint
`npm run db:migrate`	`prisma migrate dev`
`npm run db:seed`	Carga de datos semilla
`npm run db:studio`	Prisma Studio
`npm run db:generate`	Regenera el cliente Prisma

API Python (opcional)

cd api
pip install -r requirements.txt
uvicorn main:app --reload --port 8000   # Swagger en /docs

Referencia completa de endpoints en api/COTIZADOR_API_SKILL.md.

Despliegue en Coolify

El stack de producción está en docker-compose.coolify.yml: postgres + web (Next.js) + api (FastAPI). El contenedor web aplica las migraciones de Prisma automáticamente en cada arranque.

Pasos

Sube el repo a GitHub (privado recomendado).
En Coolify: + New Resource → Docker Compose, conecta el repo y la rama.
En la configuración del recurso, define Docker Compose Location = /docker-compose.coolify.yml.
Coolify detecta los servicios y asigna dominio a web (puerto 3000) y api (puerto 8000) vía las variables SERVICE_FQDN_* — configura los dominios deseados en la UI.
Define las variables de entorno en Coolify:

Variable	Obligatoria	Notas
`JWT_SECRET`	Sí	`openssl rand -base64 32`
`API_KEY`	Sí (para el API)	Clave para agentes/n8n
`DB_PASSWORD`	Recomendada	Password de PostgreSQL (default `postgres`)
`RUN_SEED`	Primer deploy	`true` solo la primera vez; luego `false`
`SEED_ADMIN_EMAIL` / `SEED_ADMIN_PASSWORD` / `SEED_ADMIN_NAME`	Primer deploy	Usuario admin inicial
`SEED_ASESOR_EMAIL` / `SEED_ASESOR_PASSWORD` / `SEED_ASESOR_NAME`	No	Asesor opcional

Deploy. Orden de arranque: postgres (healthy) → web (migra + seed + sirve) → api.
Después del primer despliegue exitoso, cambia RUN_SEED a false y redeploya (el seed es idempotente, pero no hace falta correrlo cada vez).

Healthchecks

Web: GET /api/health (verifica también la conexión a la BD)
API: GET /health

Notas

No expongas el puerto 5432: los servicios se comunican por la red interna del compose.
El volumen postgres_data persiste la base de datos entre deploys. No lo borres.
El API expone REST en https://<dominio-api> con auth por X-API-Key o JWT. El servidor MCP se retiro el 2026-07-28 (ver AGENTS.md).
Las versiones de api/requirements.txt estan fijas a proposito: un rango abierto dejo entrar mcp 2.0.0 y tumbo el API en produccion. Sube dependencias a proposito, no al redesplegar.
La fórmula de financiamiento y los cálculos viven duplicados en src/lib/calculators.ts y api/app/services/calculators.py — mantenlos en paridad.

Documentación para agentes

Las convenciones del proyecto, gotchas de Prisma 7 / PDFKit / Next.js 16 y el modelo de datos están en AGENTS.md (importado por CLAUDE.md).

4.2 KiB Raw Blame History