Руководство по эксплуатации программы «Папка» (серверная часть)

1. Роли

Роль Что делает
Системный администратор настраивает службы, модели, источники; не управляет ролями пользователей
Администратор безопасности создаёт роли, области доступа, назначает роли; читает журнал аудита
Пользователь работает в чате, создаёт документы, подписывает их

Система не оставляет организацию без активного системного администратора и администратора безопасности.

2. Ежедневные операции

  • Проверка состояния: docker compose ps и страница состояния служб в администрировании.
  • Просмотр журнала служб: docker compose logs <служба>.
  • Подключение источника: раздел «Источники» в администрировании. Укажите тип источника, учётные данные и область доступа.
  • Назначение прав: администратор безопасности привязывает источник к роли. Пользователь видит документы только тех источников, которые доступны его ролям.

3. Политика допустимых сервисов

Переменные PAPKA_ALLOWED_LLM_PROVIDERS, PAPKA_ALLOWED_SOURCES, PAPKA_ALLOWED_WEB_SEARCH_PROVIDERS задают списки разрешённых поставщиков. Пустое значение запрещает всё. Не заданная переменная включает значения по умолчанию: локальные поставщики моделей. После изменения перезапустите службы.

4. Журнал аудита

Журнал хранится в таблице papka_audit_event. Триггеры запрещают операции UPDATE, DELETE и TRUNCATE. Администратор безопасности просматривает журнал в интерфейсе и выгружает его для проверки.

5. Резервное копирование

Данные лежат в томах Docker: база данных, объектное хранилище, индекс. Резервное копирование по расписанию программа не выполняет. Организация настраивает его средствами сервера. Минимум: дамп PostgreSQL (pg_dump) и копия тома объектного хранилища перед каждым обновлением. Индекс можно построить заново.

6. Типовые неисправности

Признак Причина Действие
Чат не отвечает не доступен сервер модели проверьте адрес модели в администрировании и сетевой доступ
Источник не индексируется неверные учётные данные проверьте учётные данные, запустите синхронизацию заново
Пользователь не видит документ нет роли с доступом к источнику назначьте роль или область доступа
Подпись со статусом «не определена» не подключён сервис проверки подписи установите сервис проверки
Служба в состоянии «unhealthy» нехватка памяти или диска освободите ресурсы, перезапустите службу

7. Обращение в поддержку

Контакты поддержки: [ЗАПОЛНИТЬ: адрес и время работы поддержки].