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. Обращение в поддержку
Контакты поддержки: [ЗАПОЛНИТЬ: адрес и время работы поддержки].