OKAN: Plataforma de colaboración para documentación técnica
OKAN es un sistema B2B especializado para la industria de la construcción, que reemplaza el caos de los archivos Word por un entorno único para la edición colaborativa, la aprobación y el versionado de la documentación de proyectos.
| Métrica | Valor |
|---|---|
| Dominio | ConTech / Collaborative Editor |
| Arquitectura | Custom Isomorphic SSR (Express + Apollo) |
| Complejidad | Estructura de contenido en árbol |
| Integraciones | Froala WYSIWYG, RBAC system |
Resumen rápido (TL;DR)
Diseño y desarrollo de un complejo editor de documentos con una estructura jerárquica de “celdas”, actualizaciones optimísticas y un motor custom SSR. Implementación de un sistema de flujo de trabajo de aprobación (Approval Workflow) y acceso granular.
Desafíos de ingeniería clave
🌲 Documento como árbol de datos
En lugar de texto monolítico, el documento se presenta como un árbol de celdas tipificadas (texto, tablas, imágenes).
- Custom Tree: Implementé navegación y visualización complejas basadas en
react-treebeard(lógica personalizada de más de 1200 líneas). - Drag-to-Bind: Desarrollé un mecanismo de “vinculación dinámica” de celdas mediante Drag-and-Drop en el DOM API puro para crear dependencias de referencia entre documentos.
🏗️ Soluciones arquitectónicas
- State de tres niveles: Una combinación eficiente de Redux (estado global), Apollo Cache (datos de dominio con actualizaciones optimísticas) y React Context (modos de editor y búsqueda).
- Deep SSR: Configuración de renderizado isomorfo con hidratación de tres snapshots de estado independientes (Apollo, Redux, Async Components).
- Design Tokens: Uso de Rebass y styled-system para crear una biblioteca de UI escalable y tematizable.
📝 Editor profesional
- Auto-save: Sistema de guardado garantizado de datos (intervalo de 30s + save-on-blur con debounce).
- RBAC: Implementé 4 modos de trabajo del editor (Acceso completo, Comentar, Solo lectura, Revisión) con una estricta separación de permisos a nivel de routing y UI.
Detalles técnicos
- Modularidad: Aplicación de una estructura similar a FSD con generación automática de rutas a partir de módulos funcionales.
- Tooling: Integración de Froala Editor con Redux Form para garantizar la entrada de datos sin interrupciones.