# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

MOUNT HANDLER
-------------

Подключение внешних папок как символических ссылок/переходов в рабочей области. администрация о
таблица подключений к базе данных с сохранением после перезапуска системы.


ОПИСАНИЕ
------------

Обработчик монтирования включает внешние папки в каталоге user/ (hub/user/).
Используются соединения Windows, которые автоматически восстанавливаются при восстановлении.
стать. Все монтирования управляются в data/bach.db со статусом is_active.


ОПЕРАЦИИ
-----------

ДОБАВИТЬ: Присоединить внешнюю папку
  Синтаксис: bach mount add <путь> <псевдоним>
  Пример: bach mount добавить C:\Data\Research Research
  - Создан переход: хаб/пользователь/исследования -> C:\Data\Research.
  - Сохраняет в таблице подключений к БД (type='mount')
  - Перезаписывает существующие крепления с тем же псевдонимом

УДАЛИТЬ: удалить соединение.
  Синтаксис: bach mount удалить <псевдоним>
  Пример: крепление Баха удалить исследование
  - Удаляет соединение с хабом/пользователем/<псевдоним>
  - Удалена запись из таблицы подключений к БД.
  - Соединение должно существовать, иначе ошибка будет проигнорирована

СПИСОК: Показать активные подключения (стандартная операция)
  Синтаксис: список монтирования Баха
  - Показывает все монтирования из БД со статусом [ОК]/[--] и [СУЩЕСТВУЕТ]/[ОТСУТСТВУЕТ]
  - [OK] = is_active=1, [--] = is_active=0
  - [EXISTS] = путь соединения существует, [MISSING] = не существует

 RESTORE: восстановить соединения из БД
  Синтаксис: восстановление монтирования Баха
  - Воссоздает все соединения для активных маунтов (если они потеряны после перемещения)
  - Пропускает существующие перекрестки
  - Сообщает об ошибках, если исходный путь не существует


ПРИМЕРЫ
---------

1. Включить файловый сервер в проект:
   bach mount add \\SERVER\shared projdata
   -> Hub/user/projdata становится символической ссылкой на \\SERVER\shared

2. Подключите несколько папок:
   bach mount add C:\Daten data
   bach mount add D:\Archive archive
   bach mount list

3. Восстановление после переноса системы:
   bach mount restore
   -> Все соединения воссозданы из БД (если исходные пути еще доступны)

4. Пробный прогон перед операцией:
   bach mount --dry-run add C:\Quelle test
   bach mount --dry-run remove test


ФАЙЛЫ
-------

Затронутые файлы (относительно системы/):
  hub/mount.py — реализация обработчика
  Hub/user/ - Каталог для узлов
  data/bach.db — Постоянное хранилище (таблица подключений)
  docs/help/mount.txt — Этот файл


СМОТРИ ТАКЖЕ
----------

  hub/base.py — интерфейс BaseHandler
  data/ — Схема базы данных для соединений
  bach.py --help — Общая справка по BACH
