1. Общая схема
Клиент (веб, настольное и мобильное приложение, виджет) обращается по HTTP к веб-серверу. Веб-сервер передаёт запросы серверному приложению. Серверное приложение работает с базой данных, поисковым индексом, кэшем и хранилищем. Фоновые обработчики индексируют документы. Сервисы моделей строят векторные представления. Языковая модель подключается по HTTP-протоколу, совместимому с OpenAI.
2. Модули серверной части
| Модуль | Назначение |
|---|---|
| server | маршруты HTTP, middleware, проверка авторизации каждого маршрута |
| users | пользователи, роли, приглашения |
| areas | области доступа |
| audit | журнал аудита |
| docs | конструктор документов, шаблоны, версии |
| signatures | подготовка файла и проверка подписи |
| actions | действия и поручения из чата с подтверждением |
| decider | выбор действия по запросу пользователя |
| bridge | мосты к внешним системам |
| one_c | коннектор 1С |
| личный почтовый ящик | |
| offline | автономный режим |
| policy | политика допустимых поставщиков |
| web_search, doc_reader | поиск и чтение страниц |
3. База данных
PostgreSQL. Схема меняется миграциями Alembic. Таблица журнала аудита защищена триггерами от изменения.
4. Безопасность
- Каждый маршрут обязан иметь зависимость авторизации. Иначе сервер не стартует.
- Права разделены: системный администратор и администратор безопасности.
- Секреты хранятся в переменных окружения и в зашифрованном виде в базе.
- Ключ электронной подписи остаётся у пользователя.
- Списки допустимых поставщиков ограничивают обращения к внешним сервисам (исключение «решателя» действий закрывается до подачи).
5. Логика на стороне сервера
Серверная часть выполняет всю бизнес-логику: вход демонстрационного режима, политику допустимых поставщиков, проверку параметров шаблонов документов, построчное сравнение таблиц, группы признаков и виды источников. Клиент получает готовый результат через API.
6. Интерфейс программирования
Описание API в формате OpenAPI доступно по адресу /openapi.json работающего экземпляра. Около 110 маршрутов с префиксом /papka/.