Consult AS Technology
cb86a5190a
- POST /api/auth/cambiar-password (bcrypt 12, política ≥8+1 número) + modal en las 6 apps con auth - PWA: manifest + íconos de marca en las 7 apps (sin service worker a propósito, documentado); instalable en celular - Dashboards: 'Mi tablero' para vendedor (sus KPIs y funnel) y sección Equipo para coordinador/corporativo/admin - mi-dia: equipo.porVendedor gana leadsNuevosSemana - Tests: api 271, cotizador 88, alta 88, cobranza 81, agente-ia 19, dashboards 15, mi-dia 11, landing 4
84 lines
4.1 KiB
Markdown
84 lines
4.1 KiB
Markdown
# FRASA Ecosystem
|
|
|
|
Ecosistema comercial de Frasa Desarrollos S.A.P.I. de C.V.
|
|
|
|
## Componentes
|
|
|
|
| Componente | Ruta | Descripción |
|
|
|---|---|---|
|
|
| `apps/landing` | `/` | Entrada al ecosistema |
|
|
| `apps/cotizador` | `/quote/` | Cotizador financiero (4 propuestas, PDF ANEXO A) |
|
|
| `apps/alta-clientes` | `/client/` | Alta de clientes (wizard, firma digital, PDFs PLD) |
|
|
| `apps/cobranza` | `/pay/` | Planes de enganche, vencidos, estados de cuenta |
|
|
| `apps/dashboards` | `/dash/` | Tableros KPI (leads, oportunidades, inventario, cobranza) |
|
|
| `apps/mi-dia` | `/hoy/` | Agenda del vendedor (mis leads, actividades, acciones CRM) |
|
|
| `apps/agente-ia` | `/ai/` | Asistente IA con documentos del ecosistema |
|
|
| `api-gateway` | `/api/` | Express 5 + Prisma + integración Monday.com |
|
|
|
|
## PWA (instalabilidad básica)
|
|
|
|
Las 7 apps son instalables (manifest + íconos): cada una tiene
|
|
`public/manifest.webmanifest` ("Frasa · \<app\>", `display: standalone`,
|
|
`theme_color`/`background_color`) e íconos 192/512 en `public/icons/`
|
|
(generados con `scripts/generar-iconos-pwa.py`, venv `/root/.venv-tools`).
|
|
|
|
**Decisión: NO hay service worker.** Solo se busca instalabilidad básica
|
|
(ícono en el teléfono que abre la app a pantalla completa). Un SW con caché
|
|
arriesga servir bundles viejos tras cada deploy (los usuarios son vendedores
|
|
en campo; no van a limpiar caché a mano). Si algún día se quiere modo offline,
|
|
hay que diseñar primero la estrategia de invalidación de caché.
|
|
|
|
## Desarrollo local
|
|
|
|
Cada app es un proyecto Vite independiente: `npm install && npm run dev` (o `npm run preview` tras `npm run build`). Tests: `npx vitest run` en cada paquete. El API: `cd api-gateway && npm install && npx prisma migrate dev && npm run dev`.
|
|
|
|
Variables de entorno: copiar `.env.example` a `.env` y completar (el `.env` nunca se commitea).
|
|
|
|
## Servidor actual (LXC sin Docker)
|
|
|
|
Esta máquina es un contenedor LXC sin nesting: Docker no puede correr contenedores.
|
|
El stack corre directo en el host:
|
|
|
|
- **NGINX** (apt) sirve los `dist/` de las apps y proxifica `/api/` → `127.0.0.1:3000`.
|
|
Config: `deploy/nginx-host.conf` → `/etc/nginx/sites-available/frasa`.
|
|
- **API** como servicio systemd: `deploy/frasa-api.service` → `frasa-api.service`
|
|
(`systemctl status frasa-api`, logs en `/var/log/frasa-api.log`).
|
|
- Rebuild de apps tras cambios: `VITE_API_URL=/api npm run build` en cada app + `systemctl reload nginx` (no requiere restart).
|
|
|
|
El `docker-compose.yml` queda listo para cuando el stack se mude a una VM con Docker.
|
|
|
|
## Deploy con Docker (VM futura)
|
|
|
|
```bash
|
|
git clone https://git.consultoria-as.com/consultoria-as/FRASA-CAS.git /opt/frasa-ecosystem
|
|
cd /opt/frasa-ecosystem
|
|
cp .env.example .env && nano .env # completar secretos
|
|
|
|
# SSL: webroot (funciona con nginx corriendo y renueva sin downtime)
|
|
docker compose up -d nginx # primer arranque SIN ssl: ver nota abajo
|
|
certbot certonly --webroot -w /var/www/certbot -d frasadesarrollos.ddns.net
|
|
|
|
docker compose build && docker compose up -d
|
|
docker compose logs -f api
|
|
curl https://frasadesarrollos.ddns.net/api/health
|
|
```
|
|
|
|
Modo local sin SSL (LAN): `.env` con `NGINX_CONF=nginx.http.conf` hace que NGINX
|
|
sirva todo por HTTP en el puerto 80. Cuando el DDNS apunte a este servidor:
|
|
`certbot certonly --webroot -w /var/www/certbot -d frasadesarrollos.ddns.net`,
|
|
quita `NGINX_CONF` del `.env` (vuelve `nginx.conf` con 443) y
|
|
`docker compose restart nginx`. Renovación: `certbot renew --deploy-hook "docker compose -f /opt/frasa-ecosystem/docker-compose.yml restart nginx"`.
|
|
|
|
Backup: `scripts/backup.sh` (cron sugerido `17 2 * * *`).
|
|
|
|
## Monday.com
|
|
|
|
Workspace `Frasa-CAS`. Tableros: Contactos, Desarrollos, Unidades (inventario importado), Leads, Oportunidades, Apartado, Ventas. Los board IDs están en `.env.example`. Webhook: `POST /api/webhooks/monday` (responde el challenge de activación).
|
|
|
|
## Pendientes conocidos
|
|
|
|
- Migrar Prisma de SQLite a Postgres 16 (dinero a `Decimal`).
|
|
- Auth JWT, helmet, rate-limit, CORS restringido (hoy: red interna).
|
|
- Self-hostear worker/wasm de tesseract.js (OCR sin internet).
|
|
- Automatizaciones Monday (round-robin, recordatorios 10 días) y cron de cobranza en el API.
|