📊 SandFlow Offline Exporter

Автономная утилита для извлечения данных клиентов, записей сессий и фотографий из локальной базы данных SandFlow Suite в формат Excel (.xlsx) и структурированные ZIP-архивы.

🔒 100% Конфиденциально и Офлайн

Эта утилита — обычный веб-файл (index.html), который работает прямо на вашем компьютере:

• Не требуется установка программ и сторонних зависимостей.
• Не требуется запуск локальных серверов.
• Данные не отправляются в интернет и обрабатываются исключительно в оперативной памяти вашего браузера. Вы можете полностью отключить интернет перед использованием утилиты для максимальной уверенности в безопасности.

🛠 Инструкция по использованию

1. Запуск:
   Просто распакуйте скачанный ZIP-архив и дважды кликните по файлу index.html. Он откроется в любом современном веб-браузере (Google Chrome, Яндекс.Браузер, Microsoft Edge, Opera).
2. Выбор данных:
   • Способ A (Рекомендуется): Нажмите левую плашку «Выбрать папку SandFlowSuite» и укажите папку данных приложения.
     • Где она лежит на Windows? Обычно по пути: C:\Users\<Имя_Пользователя>\Documents\SandFlowSuite
     • Браузер покажет стандартный запрос на чтение файлов папки — подтвердите его. Утилита автоматически найдет файл базы данных sand_therapy.db и папку со всеми фотографиями media.
   • Способ Б (Только текст): Нажмите правую плашку «Выбрать только базу данных» и укажите непосредственно файл sand_therapy.db. Фотографии в этом случае экспортированы не будут.
3. Скачивание отчета:
   После успешного чтения базы на экране отобразится статистика и интерактивная таблица предпросмотра. Вам станут доступны кнопки экспорта:
   • 🟢 Скачать Excel с фото (в ячейках): Генерирует файл Excel, в котором миниатюры снимков песочниц автоматически встроены в соответствующие ячейки напротив каждой сессии.
   • 📦 Скачать ZIP-архив: Создает архив, внутри которого лежит легкий файл Excel с текстом, а в отдельной папке Фотографии_Песочниц лежат все снимки сессий, переименованные по формату ФИО_Клиента_Сессия_Дата.jpg.
   • 📝 Скачать Excel (Только текст): Быстрый выгруз текстовой таблицы без медиафайлов.
   • ⚙️ Экспорт в JSON: Сырой дамп структуры базы данных для бэкапа.

📥 Резервное копирование и спасение данных (Импорт)

Утилита содержит встроенный инструмент для аварийного восстановления или переноса базы данных из резервной копии JSON. Если у вас повредился файл базы данных sand_therapy.db в результате программного или аппаратного сбоя компьютера:

1. Перейдите на вкладку:
   Откройте index.html и переключитесь на вкладку «Импорт (Восстановить базу из JSON)» в верхней панели.
2. Загрузите файл бэкапа:
   Нажмите кнопку «Выбрать JSON-файл бэкапа» и укажите ваш JSON-файл резервной копии (который вы ранее экспортировали из приложения или утилиты).
3. Сборка базы данных:
   Утилита автоматически обработает структуру, создаст чистую, оптимизированную структуру таблиц SQLite и соберет из нее новый файл sand_therapy.db прямо в оперативной памяти браузера.
4. Сохранение и замена:
   Нажмите кнопку «Скачать восстановленную БД (.db)». Скачанный файл сохраните под именем sand_therapy.db и замените им поврежденный файл в папке документов приложения:
   • Путь по умолчанию на Windows: C:\Users\<Имя_Пользователя>\Documents\SandFlowSuite\sand_therapy.db

💡 Технические особенности (Информация для разработчиков)

• Парсинг базы данных SQLite выполняется на стороне клиента с помощью WebAssembly-версии библиотеки sql.js.
• Excel-файлы формируются с помощью библиотеки exceljs, поддерживающей программное встраивание медиафайлов.
• Локальная архивация файлов производится библиотекой jszip.
• Все сторонние библиотеки подключаются через стабильные публичные CDN-сети. Для первого открытия страницы желательно наличие интернета (чтобы браузер закешировал необходимые библиотеки в кэш), после чего страницу можно использовать полностью в автономном режиме.