Changelog

v0.0.6-alpha actual pre-release

18 de abril de 2026

Rediseño de UI

• Sidebar minimal de 60px con iconos lucide para los 7 módulos top-level (Inicio, Inventario, Ventas, Compras, Interlocutores, Contabilidad, Plugins, Ajustes)
• Topbar con sub-tabs del módulo activo
• Avatar de usuario y selector de empresa al pie del sidebar como popovers
• Tablas a ancho completo (sin el padding excesivo anterior)
• Hover scale 1.1 + cambio de color (200ms) en los iconos del sidebar

Tablas compactas

• Densidad compact por defecto en @openfactu/ui Table, con prop density opcional (compact | normal | comfy)
• Multi-select con checkbox tristate (selectable, selectedKeys, onSelectionChange)
• Nuevo componente <BulkActionsBar> que aparece encima de la tabla cuando hay filas seleccionadas
• Fix de dark mode striping (filas no se ven lavadas)
• thead y SearchableSelect dropdown sin transparencia (no se ven a través de modales)
• Modal con backdrop opaco al 90% + blur, constraint de altura max-h-90vh y scroll interno

Dashboard con gráficos (recharts)

• Línea: tendencia mensual de Ventas vs Compras (12 meses)
• Donut: distribución de facturas por estado (Abiertas / Cerradas / Parcial / Anuladas)
• Barras horizontales: Top 5 clientes y Top 5 proveedores por volumen
• KPIs y secciones de stock se mantienen
• Todos los charts respetan el modo dark/light

Plugin SDK extendido (@openfactu/plugin-sdk v0.1.0)

• Nuevos tipos PluginModule y PluginSubTab en PluginManifest.ui
• Plugins pueden registrar módulos top-level propios (icono nuevo en el sidebar)
• Plugins pueden inyectar sub-tabs en módulos core
• Nuevo ListFetchContext<T> y eventos <entity>.list.afterFetch para inyectar/mutar filas en listados core (items, partners)
• Backwards compatible: menuItems legacy se mapean automáticamente al módulo “Plugins”

Bug fixes (~180 instancias)

• Eliminadas todas las clases dark: duplicadas (dark:text-X dark:text-Y) que dejaban texto lavado en oscuro
• Reparados patrones hover:bg-X dark:bg-Y mal-paireados (ahora dark:hover:bg-Y)
• TenantSwitcher adaptado a tema light/dark
• Card header sólido (sin opacity 30 en dark)
• PermToggle con ring + dot adaptados a dark mode

---

v0.0.5-alpha pre-release

17 de abril de 2026

Sandbox de desarrollo de plugins

• Hot reload: edita un plugin y se recarga automaticamente sin reiniciar el servidor
• File watcher con chokidar para deteccion de cambios
• WebSocket /ws/plugins para notificar al frontend en tiempo real
• Componentes UI se actualizan en el browser sin refrescar la pagina
• HookManager.unregisterPlugin() para evitar duplicacion de hooks al recargar

Desarrollo remoto de plugins

• Dev API Keys: genera credenciales (clientId/clientSecret) desde la UI del ERP
• POST /api/plugins/upload — sube un plugin como ZIP
• POST /api/plugins/:id/push — sync incremental de archivos
• Autenticacion por dev key o JWT de admin
• Pantalla de gestion de API Keys en Plugins > Desarrollo

CLI: nuevos comandos de plugins

• openfactu plugin search — buscador interactivo con autocomplete
• openfactu plugin install/update/remove — gestion completa
• openfactu plugin push — sube plugin a servidor remoto
• openfactu plugin watch — auto-sync al guardar (desarrollo remoto)
• openfactu plugin link/unlink — symlinks para desarrollo local
• openfactu plugin dev — servidor en modo desarrollo con logs filtrados

CLI: comandos de Docker

• openfactu rebuild — reconstruye y reinicia contenedores
• openfactu logs — muestra logs de los servicios
• openfactu stop / openfactu restart — control de servicios

Fixes de Docker

• Dockerfiles compilar paquetes compartidos (@openfactu/pdf, common, ui) antes del server/web
• Crear tablas del schema publico automaticamente al arrancar
• .dockerignore para evitar copiar storage/db_data

SDK (@openfactu/plugin-sdk v0.0.3)

• Tipos completos: PluginContext, HookContext, PluginManifest, CoreTableName
• Hooks tipados: DocumentType, HookEvent, HookHandler
• Documentacion actualizada con ejemplos

---

v0.0.4-alpha

16 de abril de 2026

Primera version funcional completa de OpenFactu.

CLI (@openfactu/cli)

• openfactu install — Descarga e instala desde releases de GitHub, con soporte Docker (Windows/Mac/Linux)
• openfactu deploy — Wizard para configurar acceso externo (LAN / dominio publico / SSL)
• openfactu deploy:status — Estado de contenedores Docker
• openfactu update — Actualiza a la ultima version sin perder datos (plugins, storage, .env)
• openfactu setup — Configuracion inicial interactiva (BD, admin, primer tenant)
• openfactu migrate / migrate:status — Gestion de migraciones de base de datos por tenant
• openfactu tenant list/create/sync — Gestion de empresas
• openfactu plugin list — Estado de plugins por empresa
• Soporte sudo para instalar en cualquier directorio del sistema
• Funciona desde cualquier ruta con --path o OPENFACTU_HOME

Plugins por empresa

• Activar/desactivar plugins por tenant desde la UI o API
• Nueva tabla TenantPlugin con cache en memoria para rendimiento
• HookManager filtra hooks segun la activacion del plugin en el tenant
• Pantalla de gestion de plugins en el frontend con toggles

FactuAPI

• FactuApi.transaction() — Operaciones atomicas (todo o nada)
• IDs pre-asignados antes de save() para referencias cruzadas entre documentos
• FactuApi.session() — Login + seleccion de tenant + conexion a BD en una sola llamada
• Helpers de consulta: getPartner(), getItem(), getSeries(), getOpenPeriods()
• FactuApi.connect() — Acceso a la BD del tenant sin transaccion

Docker

• Fix del build de la web (TypeScript deprecations, type imports con verbatimModuleSyntax)
• VITE_API_URL como build arg en el Dockerfile de la web
• Eliminado atributo version deprecado de docker-compose
• docker-compose.prod.yml generado por el CLI con binding a 0.0.0.0

ERP Core

• Multi-empresa con esquemas PostgreSQL aislados
• Facturacion completa: pedidos, albaranes y facturas (venta y compra)
• Inventario: almacenes, zonas, lotes, series, stock por ubicacion
• Socios de negocio: clientes, proveedores, grupos, direcciones multiples
• Impuestos configurables (IVA 0%, 4%, 10%, 21%)
• Series de numeracion por tipo de documento y periodo
• Plantillas PDF personalizables con HTML/Handlebars
• Dashboard con metricas de ventas, compras, stock y documentos recientes
• Busqueda global en todas las entidades
• Audit log completo (CREATE/UPDATE/DELETE con valores anterior y nuevo)
• Sistema de permisos granulares por usuario y tenant
• Datos geograficos: paises, regiones, provincias, municipios
• Dark mode completo en la interfaz web

---

v0.0.3-alpha

16 de abril de 2026

Cambios

• Primera version del CLI publicada en npm (@openfactu/cli)
• Comando install con seleccion de releases de GitHub
• Comando deploy para configurar acceso externo
• Correcciones menores

---

v0.0.2-alpha

16 de abril de 2026

Cambios

• Primera release publica de OpenFactu
• ERP funcional con facturacion, inventario y multi-empresa
• Interfaz web con React 19 y Tailwind CSS
• API REST completa
• Sistema de plugins
• Docker Compose para despliegue

---

Proximas versiones

Funcionalidades planificadas para futuras versiones:

• OCR para escaneo de facturas
• Contabilidad integrada
• Reportes y graficos avanzados
• Marketplace de plugins
• Soporte multi-idioma en la interfaz