71 lines
3.3 KiB
Markdown
71 lines
3.3 KiB
Markdown
# Cotizador E3
|
|
|
|
Sistema de cotizaciones de Consultoría E3. Dos backends sobre la misma base de datos PostgreSQL:
|
|
|
|
- **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
|
|
# 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
|
|
```
|
|
|
|
`start.bat` levanta el compose local (`docker-compose.yml`), aplica migraciones y arranca `npm run dev`. Para detener todo: `stop.bat`.
|
|
|
|
Comandos útiles:
|
|
|
|
| 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 |
|
|
|
|
## Despliegue en Coolify
|
|
|
|
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.
|
|
|
|
### Pasos
|
|
|
|
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:
|
|
|
|
| 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 |
|
|
|
|
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).
|
|
|
|
### 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.
|