Univer Office SDK: Crea tu Workspace con IA y POS en Node.js

La integración de herramientas ofimáticas nativas dentro de plataformas web privadas ha sido, durante mucho tiempo, un desafío técnico monumental. Depender de soluciones de terceros suele implicar pérdida de control sobre los datos y altos costos de licenciamiento. Sin embargo, el panorama del desarrollo de software está cambiando drásticamente gracias al Univer Office SDK, un proyecto de código abierto diseñado específicamente para la era de la inteligencia artificial.

Hoy quiero hablarles del inmenso potencial del Univer Office SDK y cómo, a partir de este revolucionario repositorio, he creado OfficeAI, una variante personalizada pensada para empresas "AI native". Esta solución busca integrar un entorno de trabajo colaborativo (Workspace), capacidades ofimáticas avanzadas, y un sistema de Punto de Venta (POS) en un único ecosistema local gestionado bajo Node.js.

En esta guía exhaustiva, exploraremos por qué la tecnología base de Univer es tan disruptiva, cómo está estructurada nuestra variante OfficeAI, y te proporcionaré el manual de instalación completo paso a paso para que puedas desplegarlo en tu propio servidor o máquina local.

Hoy quiero hablarles del inmenso potencial del Univer Office SDK y cómo, a partir de este revolucionario proyecto, he creado OfficeAI, una variante personalizada pensada específicamente para empresas "AI native". Esta solución busca integrar un entorno de trabajo colaborativo (Workspace), capacidades ofimáticas avanzadas, y un sistema de Punto de Venta (POS) en un único ecosistema local.

En esta guía exhaustiva, exploraremos por qué la tecnología base de Univer es tan disruptiva, cómo está estructurada nuestra variante OfficeAI, y te proporcionaré el manual de instalación completo paso a paso para que puedas desplegarlo en tu propio servidor o máquina local.

¿Qué es Univer Office SDK y por qué está revolucionando el desarrollo?

Para entender el potencial de nuestra solución, primero debemos analizar su motor principal: Univer. Univer Office SDK es un kit de desarrollo de código abierto que proporciona una arquitectura unificada para integrar hojas de cálculo, documentos de texto, presentaciones, lienzos infinitos (boards) y gestión de PDFs directamente en tu propia aplicación web.

A diferencia de un simple visor de archivos, Univer Office SDK es un marco de trabajo completo construido sobre una arquitectura robusta de complementos (plugins) y un motor de renderizado ultrarrápido basado en Canvas2D. Con miles de estrellas en GitHub, se ha posicionado como la alternativa definitiva para crear experiencias colaborativas "multiplayer" sin depender de Google Workspace o Microsoft 365.

Lo que hace a Univer verdaderamente especial para el ecosistema moderno es su diseño "AI-first". Permite que tanto usuarios humanos como agentes de inteligencia artificial interactúen en el mismo archivo de forma simultánea. Su "Facade API" unificada facilita que los agentes de IA lean, editen y apliquen formatos a los datos de las hojas de cálculo sin fricción, convirtiéndolo en el arnés ofimático perfecto para flujos de trabajo automatizados en aplicaciones de Node.js.

Presentando OfficeAI: Expandiendo el Poder de Univer

Aprovechando toda la potencia de Univer Office SDK, he desarrollado OfficeAI Business. Más que una simple implementación del SDK, OfficeAI es un monorepo integral basado en Node.js y TypeScript que centraliza operaciones operativas y comerciales de un negocio moderno.

La arquitectura de OfficeAI está dividida estratégicamente para ofrecer máxima modularidad, exprimiendo al máximo las capacidades de Univer:

• apps/workspace: Es el corazón del sistema. Contiene el servidor, el navegador de la aplicación y la gestión del almacenamiento local de todo tu entorno de trabajo impulsado por Univer Office SDK.
• apps/agent: Un agente local diseñado para mantener conversaciones, revisar documentos en tiempo real y ejecutar tareas automatizadas dentro de tu Workspace.
• apps/cli: Una interfaz de línea de comandos (CLI) potente para automatizar tareas del Workspace directamente desde la terminal.
• packages/: Una biblioteca de componentes, visores de documentos e integraciones reutilizables que conectan todo el sistema.
• apps/sales-pos: Un sistema de Punto de Venta (POS) local, completamente conectado con la base de datos SQLite del Workspace, permitiendo que las ventas y el inventario interactúen directamente con los reportes generados en la interfaz ofimática.

Esta estructura permite a las empresas tener el control absoluto de su información, ejecutando procesos ofimáticos complejos de forma local sin depender de la nube pública.

Sinergia con el Ecosistema de Herramientas IA

Implementar una solución basada en Univer Office SDK como OfficeAI en tu infraestructura abre la puerta a un nivel de automatización empresarial sin precedentes, especialmente si ya estás utilizando otras herramientas de código abierto que hemos explorado anteriormente en el blog.

Por ejemplo, puedes conectar los datos generados en el POS de OfficeAI con herramientas de atención al cliente automatizadas. Si te interesa esta ruta, te recomiendo revisar el proyecto de AIReceptionist Open Source: Tu propia recepcionista IA, el cual puede complementarse perfectamente para gestionar citas o consultas leyendo datos de tu Workspace.

Del mismo modo, si necesitas extraer reportes generados con Univer Office SDK y enviarlos a tus clientes, puedes integrar soluciones de mensajería siguiendo nuestra guía para instalar OpenWA en Windows, corregir dependencias y desplegar en VPS.

Y para los desarrolladores que buscan crear nuevos plugins para Univer y modificar a fondo el código TypeScript de OfficeAI, optimizar su entorno de programación local es crucial. Aprende cómo integrar asistentes de código avanzados en nuestro tutorial sobre cómo instalar OmniRoute, OpenCode y Cline en VSCode.

Manual Completo de Instalación y Puesta a Punto

A continuación, te presento el manual técnico oficial para desplegar, configurar y operar esta implementación de Univer Office SDK de manera exitosa en tu entorno local.

1. Requisitos Previos del Sistema

El ecosistema de OfficeAI es moderno y exigente. Antes de comenzar a ejecutar comandos, asegúrate de cumplir con los siguientes requerimientos en tu máquina:

• Node.js: Versión 24 o superior. Es vital para soportar las últimas características de V8 y optimizaciones de red.
• Gestor de paquetes: pnpm en su versión 11. (Esencial para gestionar eficientemente las dependencias del monorepo).
• Licencia: Licencia Univer válida para habilitar las capacidades ofimáticas avanzadas que la requieran.
• Terminal: En sistemas Windows, se recomienda encarecidamente utilizar PowerShell o una terminal compatible moderna.

Para verificar que tu entorno está listo, ejecuta en tu terminal:

node --version
pnpm --version

2. Instalación Inicial y Configuración de Entorno

Una vez confirmados los requisitos, el primer paso es obtener el código e instalar sus dependencias. Sitúate en la raíz donde alojarás el proyecto y ejecuta:

cd C:\proyectos\officeai
pnpm install
Copy-Item apps/workspace/.env.example apps/workspace/.env

El almacenamiento local (bases de datos SQLite, archivos ofimáticos de Univer) de tu Workspace quedará alojado en la ruta apps/workspace/.data/. Esta carpeta contiene datos operativos sensibles y debe mantenerse estrictamente fuera del control de versiones.

3. Arranque en Entorno de Desarrollo

Para levantar el entorno completo y ver Univer Office SDK en acción, necesitaremos correr múltiples servicios de manera simultánea.

En la Terminal 1 (Servidor de Backend): Inicia el servidor principal que gestiona la API y los websockets:

cd C:\proyectos\officeai
pnpm workspace:dev:server

Al iniciarse, el servidor Workspace expondrá los siguientes endpoints:

• API y servidor principal: http://127.0.0.1:3020
• Esquema OpenAPI: http://127.0.0.1:3020/openapi.yaml
• Documentación de la API: http://127.0.0.1:3020/api-docs

En la Terminal 2 (Navegador y Frontend): Ahora, levanta la interfaz de usuario:

cd C:\proyectos\officeai
pnpm workspace:dev:web

Una vez compilado, puedes abrir tu navegador en: http://127.0.0.1:5173

4. Arranque del Sistema POS Integrado

Uno de los grandes atractivos de OfficeAI es su aplicación de Punto de Venta (Sales-POS), la cual lee y escribe sobre la misma base de datos SQLite que alimenta la interfaz de Univer. Con el servidor Workspace ya corriendo, abre una tercera terminal e inicia el POS:

cd C:\proyectos\officeai\apps\sales-pos
node src/server.js

Accede al panel del POS desde tu navegador en: http://127.0.0.1:4050

La skill nativa officeai habilitada en este módulo te permitirá consultar tu catálogo de productos, revisar métricas, generar cotizaciones o facturas en formato PDF, e incluso enviarlas por correo SMTP (siempre que se solicite expresamente), todo conectado a los datos de tus hojas de cálculo.

5. Verificación de Funcionamiento

Antes de considerar que la instalación fue exitosa o de empezar a desarrollar plugins para Univer, es una excelente práctica validar la integridad del código:

pnpm typecheck
pnpm test
pnpm build

Si tu objetivo es probar el flujo local rápidamente, asegúrate de cumplir este checklist manual:

1. El frontend del Workspace basado en Univer carga correctamente en el puerto 5173.
2. La API responde peticiones en el puerto 3020.
3. El dashboard del POS carga correctamente en el puerto 4050.
4. El archivo de base de datos .data/univer-workspace.sqlite ha sido creado.
5. Puedes generar exitosamente un PDF a partir de una cotización de prueba en el POS.
6. El envío de correos SMTP funciona correctamente usando una cuenta de pruebas.

Guía Fundamental para la Puesta en Producción

Pasar de un entorno local a un servidor de producción requiere rigor técnico. Si planeas desplegar esta implementación de Univer Office SDK de forma pública, sigue obligatoriamente estas directrices:

• Entorno Limpio: Ejecuta pnpm install, pnpm typecheck, pnpm test y pnpm build en un entorno CI/CD o en una instalación fresca.
• Inicio Seguro: Usa pnpm workspace:start para iniciar el servidor compilado, abandonando los comandos de dev.
• Proxy Inverso: Es imperativo configurar un reverse proxy (como Nginx o Traefik) con soporte HTTPS delante de tu aplicación.
• Aislamiento de Puertos: Mantén los puertos internos 3020 y 4050 bloqueados detrás del firewall; nunca los expongas públicamente de forma directa.
• Gestión de Secretos: Define las variables críticas mediante el entorno del servidor o utiliza un gestor de secretos profesional.
• OAuth Diferenciado: Crea aplicaciones OAuth separadas para desarrollo local y producción.
• Seguridad Web: Configura cookies seguras (Secure, HttpOnly, SameSite).
• Backups: Implementa rutinas automáticas para respaldar .data/univer-workspace.sqlite, .data/univer-collaboration.sqlite y los blobs binarios.
• Base de Datos: Ejecuta migraciones de forma controlada. ¡Jamás uses el comando db:reset sobre bases de datos en producción!

Higiene y Control de Versiones en GitHub

Un error común al trabajar con monorepos complejos es subir archivos sensibles accidentalmente. Al hacer commits en tu variante, asegúrate estrictamente de NO incluir:

• El archivo apps/workspace/.env.
• El directorio apps/workspace/.data/.
• Bases de datos SQLite (.sqlite), documentos de Univer, PDFs, o cualquier tipo de PII.
• Credenciales SMTP o tokens.
• Carpetas de dependencias (node_modules/) o binarios compilados (dist/).

Antes de ejecutar un git push, recomiendo pasar este filtro de seguridad en PowerShell:

git status --short
git diff --check
git ls-files | Select-String -Pattern '(^|/)(\.env|\.data|node_modules|dist)(/|$)|\.sqlite$|\.pdf$'

Conclusión

Integrar el Univer Office SDK a través de la arquitectura de OfficeAI representa un salto tecnológico masivo para cualquier empresa que desee dominar la edición de documentos, análisis de datos, IA local y control de ventas bajo un solo techo de código abierto. Al dominar estas herramientas, adquieres el poder de moldear el software ofimático exactamente a la medida de los procesos de tu negocio.

¡Clona el repositorio de OfficeAI Business, sigue los pasos de este manual y lleva la infraestructura tecnológica de tu proyecto al siguiente nivel! Como siempre, si tienes dudas durante la implementación, déjalas en los comentarios o revisa la documentación completa en los repositorios oficiales.