1

2026-06-10 02:16:08 -06:00
parent 4334052267
commit c3f4449296
10 changed files with 284 additions and 23 deletions
@@ -1,36 +1,70 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# Cotizador E3

-## Getting Started
+Sistema de cotizaciones de Consultoría E3. Dos backends sobre la misma base de datos PostgreSQL:

-First, run the development server:
+- **Web (Next.js 16)** — `src/`, puerto 3000. UI completa: cotizaciones, clientes, catálogo, configuración, export PDF/Excel. Prisma es dueño del esquema y las migraciones.
+- **API (FastAPI + MCP)** — `api/`, puerto 8000. REST para integraciones (n8n, agentes de IA) con servidor MCP en `/mcp`. Referencia completa en `api/COTIZADOR_API_SKILL.md`.
+
+## Desarrollo local (Windows)
+
+Requisitos: Node 20+, Docker Desktop.

 ```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
+# 1. Copia las variables de entorno
+copy .env.example .env   # y define JWT_SECRET
+
+# 2. Levanta PostgreSQL + API Python y el dev server de Next.js
+start.bat
 ```

-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+`start.bat` levanta el compose local (`docker-compose.yml`), aplica migraciones y arranca `npm run dev`. Para detener todo: `stop.bat`.

-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+Comandos útiles:

-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+| Comando | Propósito |
+|---------|-----------|
+| `npm run dev` | Dev server Next.js (puerto 3000) |
+| `npm run build` | Build de producción |
+| `npx prisma migrate dev` | Crear/aplicar migración |
+| `npx tsx prisma/seed.ts` | Seed (idempotente; usuarios vía `SEED_*`) |
+| `npx prisma studio` | GUI de la base de datos |

-## Learn More
+## Despliegue en Coolify

-To learn more about Next.js, take a look at the following resources:
+El stack de producción está en [docker-compose.coolify.yml](docker-compose.coolify.yml): `postgres` + `web` (Next.js) + `api` (FastAPI). El contenedor `web` aplica las migraciones de Prisma automáticamente en cada arranque.

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+### Pasos

-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+1. **Sube el repo a GitHub** (privado recomendado).
+2. En Coolify: **+ New Resource → Docker Compose**, conecta el repo y la rama.
+3. En la configuración del recurso, define **Docker Compose Location** = `/docker-compose.coolify.yml`.
+4. 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.
+5. Define las variables de entorno en Coolify:

-## Deploy on Vercel
+| 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 |

-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+6. **Deploy.** Orden de arranque: `postgres` (healthy) → `web` (migra + seed + sirve) → `api`.
+7. Después del primer despliegue exitoso, cambia `RUN_SEED` a `false` y redeploya (el seed es idempotente, pero no hace falta correrlo cada vez).

-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+### 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 servidor MCP queda en `https://<dominio-api>/mcp` (auth por `X-API-Key`).
+- 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.
+
+## Arquitectura
+
+Ver [AGENTS.md](AGENTS.md) para convenciones, gotchas de Prisma 7 / PDFKit / Next 16 y el modelo de datos.