FiveTech_ERP: driver de datos opcional "hdbc" (RDDHDBC sobre MariaDB)

[russimicro]

Resumen

erp_db.prg ya tiene una capa de datos intercambiable (json por defecto,
dbfcdx, openads). Este PR agrega un cuarto driver, hdbc, respaldado
por RDDHDBC — un RDD de terceros (Manu Expósito) que traduce los verbos
xBase estándar a MariaDB.

Por qué encaja como RDD (y no como SQL crudo)

erp_db.prg ya habla con cada backend exclusivamente a través de verbos RDD
planos — dbUseArea / dbGoTop / dbSkip / FieldGet / dbAppend / RLock / FieldPut / dbDelete / dbCommit — nunca arma SQL a mano. RDDHDBC opera
exactamente a ese nivel (USE <tabla> VIA "HDBC"), así que el cambio es
puramente aditivo: cero cambios en erp_http.prg (su despacho if ErpDbDriver() != "json" ya es genérico) y cero cambios en
ErpDbReadRows/ErpDbApply.

Qué NO incluye este PR (importante)

Este PR no distribuye, vincula ni referencia ningún código o nombre de
API de RDDHDBC/HDBC. Es software comercial de Manu Expósito con licencia
propia — conseguirlo y usarlo es un acuerdo entre cada usuario y él, igual
que con MariaDB.

• La rama nueva en ErpDbConfig/ErpDbOpen/ErpDbStatus solo compila
  cuando el build define HB_WITH_HDBC.
• Solo llama a una función (ErpDbHdbcUserConnect) que cada usuario
  implementa en su propio archivo aparte, con su propio paquete HDBC
  licenciado — nunca parte de este repo.
• build_win64.bat sigue el mismo contrato "compila limpio sin ello" que
  ya usa para ace64.dll de OpenADS, adaptado para una lib estática:
  requiere hdbctools.lib propia del usuario en %HBLIB% y
  HDBC_CONNECT_PRG apuntando a su conector. Sin ambos, el build es
  idéntico a hoy (verificado: erp_db.prg compila limpio con y sin
  -dHB_WITH_HDBC usando harbour.exe local).

Detalle completo del contrato, cómo activarlo y límites conocidos (no
auto-crea tablas; RLock() es por-proceso, no por-base) en
docs/hdbc-driver.md.

Verificación

harbour.exe erp_db.prg -n -w -es2 -q   → OK
harbour.exe erp_db.prg -n -w -es2 -q -dHB_WITH_HDBC   → OK (mismos symbols, sin linkear nada)

🤖 Generado con Claude Code

[russimicro]

Actualización: generador de esquema propio (no un migrador externo)

El mensaje anterior de este PR mencionaba de forma vaga que "existe tooling
de migración" para provisionar el esquema de MariaDB. Eso no era preciso —
en su lugar, esta actualización aporta el generador real:

• ErpDbHdbcSchemaSql() en erp_db.prg: reutiliza la misma inferencia de
  esquema que dbfcdx ya usa (ErpDbInferSchema) para emitir un
  CREATE TABLE IF NOT EXISTS por cada dataset data.*, agregando las
  columnas de control _h_rowid_/deleted_at que las tablas de RDDHDBC
  necesitan. Solo genera texto — cero dependencia de HDBC, cero conexión
  viva, nada se ejecuta contra ninguna base.
• GET /api/db/schema-sql (misma autenticación de sesión que
  /api/db/status ya usa) expone ese texto para revisar y ejecutar a mano
  (curl ... > schema.sql && mysql -u ... < schema.sql).

La tabla propia de metadatos de índices de RDDHDBC queda explícitamente
fuera de alcance — eso sigue siendo de su propia documentación.

Verificado: erp_db.prg/erp_http.prg compilan limpio con y sin
-dHB_WITH_HDBC.

🤖 Generado con Claude Code

[russimicro]

Actualización: UI de configuración + validación end-to-end del esquema

• www/db-config.html (nuevo): página admin standalone que lee/escribe
  meta/app.json -> "database" vía el contrato ya existente
  GET/POST /api/meta (mismo que usa el runtime form designer, gateado por
  ErpSessIsAdmin). Permite elegir driver (json/dbfcdx/openads/hdbc)
  y host/port/dataPath/user/password sin editar JSON a mano, y muestra
  GET /api/db/status en vivo.
• Fix: ErpDbHdbcSchemaSql() generaba el DDL pero no persistía el
  .map.json inferido — sin eso, ErpDbReadRows/ErpDbApply no podrían
  funcionar aunque el driver esté disponible. Ya corregido (mismo
  comportamiento que el path dbfcdx: ErpDbLoadMap primero, ErpDbSaveMap
  solo si no existía).
• Validado contra una base MariaDB real (entorno local propio, no
  parte de este repo): el DDL que genera ErpDbHdbcTableSql/
  ErpDbHdbcSchemaSql — incluyendo el fix de identificadores reservados
  (`columna` con backticks; user/key/when rompían sin esto en
  algunos datasets) — crea y puebla correctamente las 45 tablas del sample
  demo a partir de meta/data/*.json. Corregí el mismo problema de
  backticks en ErpDbHdbcTableSql (Harbour) para que coincida con lo
  probado.

🤖 Generado con Claude Code

[russimicro]

Validado end-to-end contra una MariaDB real (entorno propio, no en este repo)

Compilé este driver con mi propia licencia de RDDHDBC (fuera del repo) y lo
corrí contra una base MariaDB real. Encontré y corregí 2 bugs reales:

1. Nombre de RDD incorrecto: el RDD se registra como "RDDHDBC", no
   "HDBC" — corregido en dbUseArea(). También quité el REQUEST del
   encabezado: no existe un símbolo de link directo para eso; basta con que
   ErpDbHdbcUserConnect() (ya exigido por el contrato) llame a cualquier
   función pública real del RDD, que fuerza el enlace del mismo módulo
   compilado que registra el RDD.
2. Falso negativo en delete: el chequeo Deleted() post-dbDelete()
   en ErpDbApply() es un workaround específico de una peculiaridad de
   OpenADS; con hdbc reportaba error aunque el borrado sí se persistía
   (deleted_at seteado, confirmado con SQL directo). Ahora acotado a
   driver == "openads".

Resultado tras los fixes (verificado con SQL directo en paralelo):

• GET /api/db/status → hdbcAvailable:true, driver activo hdbc.
• GET /api/dataset?key=data.products → filas reales desde MariaDB
  (UTF-8/tildes intactos), no del JSON.
• POST /api/dataset (add/update/delete) → los tres round-trips
  correctos, confirmados con SELECT directo contra la tabla.

docs/hdbc-driver.md actualizado con el detalle de lo verificado.

🤖 Generado con Claude Code

[russimicro]

Alcanzable desde la rama PC también

Con el patrocinio del usuario: agregué en `Form1.prg` que `ZWEB_FRONT` acepte
un archivo suelto (`ZWEB_FRONT=db-config.html`), no solo una carpeta con
`index.html` — retrocompatible con `ZWEB_FRONT=web-vainilla`/`=portal` del
PR #24. Así la vista de escritorio (WebView2 embebido) también puede cargar
la página de configuración de driver directamente, sin depender de un
navegador aparte. Además agregué un enlace "Base de datos" en el portal
del PR #24 (`www/portal/index.html`), que ya se carga dentro del propio
exe vía `ZWEB_FRONT=portal`.

🤖 Generado con Claude Code