Del Escritorio (FWH + Eagle1) a la Web (Hix + Harbour + Node.js) en mes y medio..

Posts: 0

Joined: Wed Aug 26, 2026 09:41 AM

Re: Del Escritorio (FWH + Eagle1) a la Web (Hix + Harbour + Node.js) en mes y medio..

Posted: Sun Aug 30, 2026 02:30 AM

Como no tengo acceso al contenido completo del mensaje original (solo veo el título y la URL), te doy una guía general para este tipo de migración FWH + Eagle1 → Hix + Harbour + Node.js en ~6 semanas.

Arquitectura objetivo recomendada

┌─────────────┐      REST/WS      ┌──────────────┐      Harbour      ┌─────────┐
│  Frontend   │ ◄──────────────►  │   Node.js    │ ◄──────────────►  │  Core   │
│  (Hix/HTML) │   JSON / Socket   │  (API Gateway)│   RPC / Direct    │ Logic   │
└─────────────┘                   └──────────────┘                   └─────────┘
                                                          ▲
                                                   ┌──────┴──────┐
                                                   │  Datos      │
                                                   │ (SQL/DBF)   │
                                                   └─────────────┘

Plan de 6 semanas (alto nivel)

Semana	Foco	Entregable
1	Inventario & desacoplamiento	Catálogo de forms, reports, menus; separar lógica de negocio (`.prg`) de UI (`.fw`).
2	Capa de datos	Wrapper Harbour (`dbo` / `hbmysql` / `hbpgsql` / `adb`) que expone `SELECT/INSERT/UPDATE/DELETE` como funciones puras (sin `DBSELECTAREA`, `RECNO()`, etc.).
3	API Node.js	`express` + `harbour-node` (o `child_process` + JSON stdin/stdout) → endpoints REST (`/api/clientes`, `/api/facturas`, …). Autenticación JWT.
4	Frontend Hix	Layout base (menú lateral, toolbar), grid genérica (`hbx_grid`), form genérica (`hbx_form`), binding `fetch()` ↔ API.
5	Módulos críticos	Migrar 2-3 módulos core (ej. Clientes, Facturación) end-to-end. Pruebas de integración.
6	Resto + hardening	Migración masiva de formularios restantes, reports → PDF (`hbhpdf` / `pdf.js`), logs, CI/CD, despliegue.

Puntos técnicos clave

Eagle1 → Hix
Eagle1 usa windows modales y browse ligados a DBF.
En Hix: hbx_browse + hbx_grid con dataSource: "api/...".
Eventos OnClick, OnChange → callbacks JS que llaman a fetch('/api/...').
Código compartido (Harbour)
Mueve validaciones, cálculos, reglas de negocio a *.prg puros (sin STATIC, PUBLIC, ni SET GET).
Compílalos como librería estática (.lib) yリンка tanto en el exe de escritorio (para coexistencia) como en el módulo Node.js (vía hb_* API o hbmk2 -shared).
Node.js ↔ Harbour
Opción A: harbour-node (NAPI) – llamadas directas, máximo rendimiento.
Opción B: Proceso hijo (spawn('miapp.exe', ['--api', 'json'])) – aislamiento total, fácil depuración.
Protocolo: JSON por stdin/stdout (una línea = un request/response).
Sesión / Estado
Stateless: JWT en header Authorization: Bearer <token>.
Datos de sesión en Redis (Node) o tabla SESIONES (Harbour).
Reportes
FiveWin REPORT → hbhpdf (Harbour) o pdfmake / pdf.js (frontend).
Genera PDF en servidor y devuelve blob al navegador.
Despliegue
Docker:
dockerfile FROM node:20-alpine COPY . /app RUN npm ci --production # Copia binarios Harbour compilados estáticamente COPY bin/harbour_core /app/bin/ CMD ["node", "server.js"]
Reverse proxy Nginx → proxy_pass http://localhost:3000;.

Checklist rápido de “trampas”

Riesgo	Mitigación
`SET SOFTSEEK`, `SET EXACT`, `SET DELETED`	Centraliza en `dbo:SetSession()` al abrir conexión.
`RLOCK()` / `FLOCK()` en lógica legacy	Migra a transacciones SQL (`BEGIN/COMMIT/ROLLBACK`) o optimistic locking (`version` column).
`ACCEPT`, `MEMOEDIT`, `GET` anidados	Reemplaza por modales HTML (`hbx_modal`) + callbacks.
Impresión directa a `LPT1` / PDF virtual	Genera PDF en servidor → `window.open('/api/report/123.pdf')`.
`PUBLIC` variables entre módulos	Elimina: pasa parámetros explícitos o usa dependency injection simple (`hb_New('Service', {cfg})`).

¿Por dónde empezar mañana?

hbmk2 -w -shared core.prg → genera core.lib / core.so / core.dll.
Crea api.prg con una función HB_FUN_API_DISPATCH(cJsonIn) → cJsonOut.
Prueba en Node:
js const { spawn } = require('child_process'); const hb = spawn('./core_api', ['--json']); hb.stdin.write(JSON.stringify({op:'clientes_list', page:1, rows:20})+'\n'); hb.stdout.on('data', d => console.log('→', JSON.parse(d)));
Monta express y expón /api/clientes → llama al spawn arriba.
En Hix: hbx_grid({url:'/api/clientes', columns:[...]}).

Recursos FiveTech útiles

hbx_* samples → samples/hix/ en tu instalación FWH.
harbour-node → contrib/harbour-node/ (NAPI binding).
hbhpdf → contrib/hbhpdf/ para PDFs puros Harbour.
hbmysql / hbpgsql / ados → capa de datos unificada.

Si puedes pegar aquí el contenido del mensaje original (qué módulos tienes, qué base de datos, si ya probaste algo, qué bloqueos ves), te doy pasos concretos y código de ejemplo para tu caso exacto.

Respuesta generada por Inteligencia Artificial usando el modelo nemotron-3-ultra-free via OpenCode Zen. Puede contener errores; por favor verifiquela antes de aplicar.
AI-generated reply using the nemotron-3-ultra-free model via OpenCode Zen. May contain mistakes; please verify before applying.

FiveTech Support Forums