Многие компании в России столкнулись с ситуацией, когда привычные облачные сервисы прекратили работу, а данные оказались заперты в проприетарных форматах, которые без специальных инструментов не открыть.

Концепция «Файл вместо приложения», предложенная Стефаном Ангом, сооснователем Obsidian, предлагает решение: переместить фокус с инструментов на данные, обеспечив их доступность, долговечность и независимость от конкретного ПО.

Всем привет! Меня зовут Катя, я развиваю Open Source-платформу Gramax для управления технической документацией. В этой статье хочу обсудить, почему подход «Файл вместо приложения» набирает популярность, какие преимущества приносит бизнесу, а также как мы реализуем его в Gramax.

Почему концепция набирает популярность

Проблемы с облачными сервисами и проприетарным ПО становятся все заметнее. Ограничения доступа (например, к Atlassian в России) или изменения в политике конфиденциальности подталкивают к поиску устойчивых решений. Основные причины интереса к концепции:

• Контроль над данными. Пользователи и компании хотят владеть своей информацией, а не зависеть от сторонних платформ. Локальное хранение исключает риск потери данных из-за внешних факторов.

• Долговечность. Программное обеспечение устаревает, теряет поддержку или не работает на новых устройствах. Файлы в открытых форматах, таких как Markdown, читаемы десятилетиями, если хранятся локально или в управляемых репозиториях.

• Совместимость. Данные в универсальных форматах (Markdown, JSON, CSV) открываются множеством инструментов, снижая зависимость от одного приложения.

• Независимость от облака. Облачные сервисы требуют постоянного интернета и доверия к провайдеру. Локальные решения работают всегда, даже если сервера «легли» (а они любят это делать в самый неподходящий момент).

• Рост Open Source. По данным GitHub Octoverse 2024, активность в Open Source проектах выросла на 60%, включая создание 70,000 новых публичных и Open Source AI-проектов. Это отражает спрос на автономные решения.

Популярность открытых форматов также подтверждается данными Stack Overflow Developer Survey 2024, где 29.1% разработчиков используют Markdown как асинхронный инструмент. Это подчеркивает, что Markdown становится стандартом для документации благодаря своей простоте и совместимости.

Почему бизнес выбирает self-hosted решения

Для IT-компаний концепция «Файл вместо приложения» — стратегический выбор. Основные причины:

• Безопасность и конфиденциальность. Ужесточение законодательства, такого как ФЗ-152 в России или GDPR в Европе, требует минимизации передачи данных сторонним провайдерам. Выбирая self-hosted решения, бизнес контролирует, где физически хранятся данные, кто имеет к ним доступ и как они обрабатываются. Это снижает юридические риски и упрощает соответствие требованиям регуляторов.

• Надежность. Локальные решения не зависят от внешних серверов, что критично для компаний с высокими требованиями к доступности. Self-hosted решение — это возможность контролировать отказоустойчивость и бэкапы без ожидания от внешнего вендора.

• Гибкость. Self-hosted инструменты можно адаптировать под свои процессы: от интеграции с CI/CD до кастомных шаблонов. Такой подход, как правило, невозможен в закрытых SaaS-сервисах.

• Независимость от вендора. Данные в открытых форматах позволяют мигрировать на другие платформы без потерь, устраняя риск vendor lock-in. Независимость — это свобода менять инструменты без страха потерять данные или тратить месяцы на миграцию. А значит, можно гибко менять архитектуру, не рискуя стабильностью или совместимостью.

Как мы это делаем в Gramax

Gramax — платформа для подготовки технической документации на базе подхода Docs as Code. В отличие от традиционных облачных сервисов (таких как Confluence, Notion или Google Docs), Gramax хранит текст в обычном Markdown, а версионирует его с помощью Git.

Локальное хранение в Markdown

В Gramax документация пишется в удобном визуальном редакторе, а сохраняется в Markdown-файлах. Они существуют локально на компьютере редактора или в Git-репозитории.

• Долговечность. Markdown — открытый формат, читаемый любым редактором, от Notepad до VS Code. Через 20 лет твои данные не превратятся в «цифровую археологию».

• Совместимость. Статьи открываются в Obsidian, Zettlr или обрабатываются скриптами (например, для анализа метаданных в Python).

• Контроль. Данные принадлежат команде или компании, без зависимости от облачных провайдеров.

Markdown, конечно, не дает всей гибкости оформления сложных таблиц или ярких визуальных блоков ?

В Gramax мы расширяем его синтаксис — добавляем кастомные элементы для свободы оформления. Но также лояльно относимся к выбору других нотаций: например, можем хранить исходники в MDX и GitHub Flavored Markdown.

Но суть остается прежней: данные хранятся в обычных текстовых файлах, которые легко просмотреть в исходном виде и перенести в любую совместимую систему.

Интеграция с Git

Gramax использует Git для синхронизации и версионирования. Можно подключить GitHub, GitLab, Bitbucket, Gitea или любого другого провайдера.

• Версионирование. Все правки фиксируются в Git. Ошибся? Откатывай. Нужен ревью? Делай запрос слияния.

• Self-hosted. Портал документации разворачивается на своем сервере в виде статического сайта или Docker-контейнера. Никаких внешних зависимостей.

• Коллаборация. Разработчики работают с Markdown в VS Code, аналитики — через интерфейс Gramax. Все изменения синхронизируются через Git.

Поддержка миграции

Gramax, ко всему прочему, делает упор на экспорт и переносимость данных:

• Универсальный формат. Markdown-файлы легко экспортируются и импортируются в другие системы, что минимизирует риск vendor lock-in.

• Экспорт в популярные форматы. DOCX и PDF на случай, если партнеры или заказчики не поддерживают «модное».

• Импорт из популярных систем. Gramax помогает «вытащить» контент из Confluence, Notion и Yandex Wiki в Markdown. После импорта не обязательно использовать Gramax: можно просто сохранить все файлы в репозитории и просматривать в исходниках.

• Простота перехода. Данные, хранящиеся в Git, можно перенести в другую систему, просто скопировав репозиторий, или использовать API для автоматизации миграции.

Предвосхищаем комментарий: «Gramax — коробка, это уже vendor lock» ?

Любую систему, на которую компания не имеет прав, можно охарактеризовать как vendor lock. Исходный код Gramax выложен в открытый доступ под лицензией GPL-3.0 license. Это означает, что Gramax можно дорабатывать под свои задачи.

Также в ближайшее время в Gramax появится механизм модулей — достаточно будет написать необходимую возможность и подключить ее в виде дополнительного модуля.

Инструменты для команд

Gramax предлагает функциональность, ориентированную на IT-команды, сохраняя при этом принципы «Файл вместо приложения»:

• Шаблоны. Централизованные шаблоны в Git-репозитории упрощают создание однотипных документов (технических заданий, отчетов), сохраняя их в Markdown.

• Свойства (properties). Метаданные для структурирования статей (например, статус задачи, дедлайн) хранятся в Markdown, что позволяет фильтровать и анализировать данные без привязки к платформе.

• Интерактивные диаграммы. Поддержка визуальных редакторов для диаграмм снижает барьер для участников команды, не знакомых с синтаксисом Mermaid или PlantUML.

Если вы посчитали статью рекламой и приготовили минусомет ?

Как мы писали в статье «От Docs as Code к Everything as Code: как Gramax меняет работу с документацией» — у нас есть концептуальная идея о том, что мы можем сделать работу многих команд удобнее и легче.

Потому мы выложили Gramax в Open Source. При этом никак не отслеживаем (и не можем это сделать) использование Gramax.

Безопасность и автономия

Gramax не использует облачные бэкенды, что идеально для компаний с высокими требованиями к безопасности. Развертывание на своем сервере и хранение в Git соответствуют ФЗ-152 и GDPR.

Так чего, микротренд или..?

В России концепция «Файл вместо приложения» особенно актуальна из-за локальных реалий:

• Санкции и уход вендоров. Закрытие доступа к некоторым облачным сервисам (например, Microsoft 365, Google Workspace) подтолкнуло компании к поиску self-hosted решений.

• Законодательство. ФЗ-152 и требования к локализации данных заставляют бизнес искать инструменты, которые можно развернуть на своих серверах.

• Open Source культура. Российские IT-команды активно используют Open Source инструменты, что делает Gramax и подобные решения привлекательными.

На глобальном уровне концепция «Файл вместо приложения» также набирает обороты:

• Рост Open Source. Инструменты вроде Obsidian, Logseq и Zettlr показывают, что пользователи ценят независимость данных. Gramax вписывается в этот тренд, предлагая командную версию такого подхода.

• Data sovereignty. В Европе (GDPR), США (HIPAA) и других регионах требования к конфиденциальности данных усиливают спрос на локальные и переносимые решения.

Файл вместо приложения — это философия: если вы хотите создавать цифровые артефакты, которые сохранятся надолго, они должны быть файлами, которые вы контролируете, в форматах, которые легко извлечь и прочитать. Используйте инструменты, которые дают вам эту свободу.

Открыто, бесплатно, и с сообществом

• Смотрите наш сайт — https://gram.ax

• Проверяйте исходники в GitHub и GitVerse.

• Вступайте в комьюнити — https://t.me/gramax_chat