Описание технической архитектуры программы «Папка» (серверная часть)

1. Общая схема

Клиент (веб, настольное и мобильное приложение, виджет) обращается по HTTP к веб-серверу. Веб-сервер передаёт запросы серверному приложению. Серверное приложение работает с базой данных, поисковым индексом, кэшем и хранилищем. Фоновые обработчики индексируют документы. Сервисы моделей строят векторные представления. Языковая модель подключается по HTTP-протоколу, совместимому с OpenAI.

2. Модули серверной части

Модуль Назначение
server маршруты HTTP, middleware, проверка авторизации каждого маршрута
users пользователи, роли, приглашения
areas области доступа
audit журнал аудита
docs конструктор документов, шаблоны, версии
signatures подготовка файла и проверка подписи
actions действия и поручения из чата с подтверждением
decider выбор действия по запросу пользователя
bridge мосты к внешним системам
one_c коннектор 1С
mail личный почтовый ящик
offline автономный режим
policy политика допустимых поставщиков
web_search, doc_reader поиск и чтение страниц

3. База данных

PostgreSQL. Схема меняется миграциями Alembic. Таблица журнала аудита защищена триггерами от изменения.

4. Безопасность

  • Каждый маршрут обязан иметь зависимость авторизации. Иначе сервер не стартует.
  • Права разделены: системный администратор и администратор безопасности.
  • Секреты хранятся в переменных окружения и в зашифрованном виде в базе.
  • Ключ электронной подписи остаётся у пользователя.
  • Списки допустимых поставщиков ограничивают обращения к внешним сервисам (исключение «решателя» действий закрывается до подачи).

5. Логика на стороне сервера

Серверная часть выполняет всю бизнес-логику: вход демонстрационного режима, политику допустимых поставщиков, проверку параметров шаблонов документов, построчное сравнение таблиц, группы признаков и виды источников. Клиент получает готовый результат через API.

6. Интерфейс программирования

Описание API в формате OpenAPI доступно по адресу /openapi.json работающего экземпляра. Около 110 маршрутов с префиксом /papka/.