OKAN: Платформа коллективной работы над технической документацией
OKAN — это специализированная B2B-система для строительной отрасли, заменяющая хаос Word-файлов единой средой для совместного редактирования, согласования и версионирования проектной документации.
| Метрика | Значение |
|---|---|
| Сфера | ConTech / Collaborative Editor |
| Архитектура | Custom Isomorphic SSR (Express + Apollo) |
| Сложность | Древовидная структура контента |
| Интеграции | Froala WYSIWYG, RBAC system |
Краткая выжимка (TL;DR)
Проектирование и разработка сложного редактора документов с иерархической структурой “ячеек”, оптимистичными обновлениями и кастомным SSR-движком. Реализация системы согласования (Approval Workflow) и гранулярного доступа.
Ключевые инженерные вызовы
🌲 Документ как дерево данных
Вместо монолитного текста, документ представлен в виде дерева типизированных ячеек (текст, таблицы, изображения).
- Custom Tree: Реализовал сложную навигацию и отображение на базе
react-treebeard(кастомная логика на 1200+ строк). - Drag-to-Bind: Разработал механизм “живой привязки” ячеек через Drag-and-Drop на чистом DOM API для создания ссылочных зависимостей между документами.
🏗️ Архитектурные решения
- Трёхуровневый State: Эффективная связка Redux (глобальное состояние), Apollo Cache (доменные данные с оптимистичными обновлениями) и React Context (режимы редактора и поиск).
- Deep SSR: Настройка изоморфного рендеринга с гидратацией трёх независимых снапшотов состояния (Apollo, Redux, Async Components).
- Design Tokens: Использование Rebass и styled-system для создания масштабируемой и тематизируемой UI-библиотеки.
📝 Профессиональный редактор
- Auto-save: Система гарантированного сохранения данных (интервал 30с + save-on-blur с debounce).
- RBAC: Реализовал 4 режима работы редактора (Полный доступ, Комментирование, Только чтение, Ревизия) с жестким разграничением прав на уровне роутинга и UI.
Технические детали
- Модульность: Применение FSD-подобной структуры с автоматической генерацией маршрутов из функциональных модулей.
- Инструментарий: Интеграция Froala Editor с Redux Form для обеспечения бесшовного ввода данных.