# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Источники: docs/_archive/CONCEPT_user_folder_attachment.md, system/hub/mount.py

BACH USER MOUNTS (CONCEPT)
==========================

По состоянию на: 2026-02-08

ЧТО ТАКОЕ ПОЛЬЗОВАТЕЛЬСКОЕ МОУНТИРОВАНИЕ?
---------------------
Пользовательское монтирование — это реализованная функция (с 28 января 2026 г., задача SYS_001) для прозрачно интегрировать внешние хранилища (например, NAS, внешние жесткие диски, облачные папки, такие как Google Drive) в файловую систему BACH. Вместо копирования данных в папку BACH они связываются виртуально.

КАК ЭТО РАБОТАЕТ
--------------
Система использует «соединения каталогов» или «символические ссылки» для предоставления внешних путей в виде подпапок в каталоге `user/`.
Затем `filesystem_scanner` и `dirscan` могут выполнять поиск по этим путям, например, в локальных папках, индексировать их и обрабатывать файлы (например, для оптического распознавания символов или извлечения).

ЦЕЛЬ
-----------
* **Без избыточности**: Исходные данные остаются на месте.
* **Прозрачность**: все инструменты BACH имеют доступ к данным.
* **Постоянство**: Соединения сохраняются в базе данных (таблица `connections`) и восстанавливаются при необходимости (после перезагрузки).

ПРИМЕР
--------
У пользователя есть налоговые документы в `E:\Archive\Tax`.
Это интегрируется через пользовательское монтирование как: `user/mounts/archiv_steuer/`.
Налоговый агент теперь может получить доступ к `user/mounts/archiv_steuer/2025/`, как если бы он был локальным.

ТЕХНИЧЕСКИЕ ПОДРОБНОСТИ
------------------
* **Таблица БД**: `connections` (type='mount', name='alias', endpoint='source_path')
* **Обработчик**: `system/hub/mount.py` (управляет командами mklink)
* **Команды CLI**:
    - `bach mount add <путь> <псевдоним>` - папка монтирования
    - `bach mount удалить <алиас>` - Удалить монтирование
    - `список баховских маунтов` - Показать активные маунты
    - `bach mount restoration` - Восстановление монтирования после перезагрузки 

СТАТУС
------
ВНЕДРЕНО (с 28 января 2026 г.). Полностью функциональный. Доступны команды CLI. Интеграция графического пользовательского интерфейса запланирована на более поздний этап.

СМОТРИ ТАКЖЕ
----------
wiki/it_tools/filecommander.txt Файловые операции
docs/_archive/CONCEPT_user_folder_attachment.md Техническая концепция (в архиве)
