DocushkaDocushka
ВойтиСоздать аккаунт

Документация · версия 1.0.0

Документация Docushka

Описание программного обеспечения, функциональные характеристики, руководство пользователя, установка и требования к развёртыванию.

Раздел 1

Описание программного обеспечения

Докушка — программный комплекс для организаций, обрабатывающих финансовые документы (счета, чеки, банковские выписки). Система автоматизирует загрузку сканов и электронных файлов, распознавание текста (OCR, Yandex Vision), извлечение структурированных данных с помощью LLM (YandexGPT по умолчанию; предусмотрена возможность подключения GigaChat), создание операций из документов и экспорт в CSV/XLSX и в форматы для загрузки в «1С». Каналы работы: веб-панель, бот в мессенджере MAX, REST API.

Клиент загружает документы через веб или MAX, отслеживает статус обработки и просматривает только свои загрузки и операции по ним. Бухгалтер работает с несколькими компаниями: приглашает пользователей, загружает документы в карточку компании, ведёт операции. Администратор управляет всеми компаниями и учётными записями, одобряет регистрации, настраивает систему, просматривает логи и тестирует интеграции.

Обработка выполняется в фоновой очереди с отображением прогресса: извлечение текста / OCR → LLM-парсинг → валидация → сохранение в БД → создание операций. Реализованы защита от повторной обработки одного файла, журнал файлов и операций с фильтрами, дашборд со статистикой, мультивалютность и ролевая модель доступа.

План развития (не входит в версию 1.0): прямая выгрузка в 1С, Диадок и банки; Госключ / ЭЦП; саммаризация договоров; расширенный поиск по сканам; дополнительные каналы и аналитика.

Продукт предоставляется как облачный сервис (SaaS, docushka.ru) или развёртывается на инфраструктуре заказчика (on-premise), использует открытые компоненты с лицензиями, допускающими коммерческое использование, российские сервисы OCR/LLM (Yandex Vision, YandexGPT; опционально GigaChat) и мессенджер MAX как канал загрузки документов.

Раздел 2

Функциональные характеристики

  1. Загрузка документов через веб-панель (перетаскивание файлов), бот в мессенджере MAX и REST API.
  2. Поддержка форматов: PDF (текст и скан), JPG/PNG, DOCX, XLSX, TXT.
  3. Категории документов: банковские выписки, входящие счета, исходящие счета.
  4. Пайплайн обработки: извлечение текста / OCR (Yandex Vision) → LLM-парсинг (YandexGPT; опционально GigaChat) → валидация → сохранение в БД → создание операций из документов.
  5. Защита от повторной обработки одного и того же файла.
  6. Очередь фоновых задач с отображением прогресса по этапам и возможностью перезапуска.
  7. Журнал файлов и операций с фильтрами; дашборд со статистикой обработки.
  8. Мультивалютность (поддержка 50+ валют).
  9. Экспорт данных в CSV/XLSX и в форматы для загрузки в «1С».
  10. Ролевая модель доступа: клиент, бухгалтер, администратор; приглашения пользователей по электронной почте.
  11. REST API и интерфейс командной строки для автоматизации.
  12. Уведомления о статусах обработки документов в мессенджерах.
  13. Веб-панель клиента: загрузка и просмотр файлов, список операций из документов, профиль.
  14. Веб-панель бухгалтера: несколько компаний, пользователи, загрузка документов в карточку компании.
  15. Панель администратора: все компании и учётные записи, одобрение регистраций, настройки системы, логи, тест интеграций.
  16. Модель поставки: облачный сервис SaaS (docushka.ru) и on-premise развёртывание на инфраструктуре заказчика.

Раздел 3

Руководство пользователя

Как войти в систему и работать с документами в зависимости от роли.

Вход

Откройте https://docushka.ru, нажмите «Вход». Введите email и пароль. После входа открывается панель в соответствии с ролью.

Клиент

  • Документы — загрузка файлов (перетаскивание), просмотр статуса обработки.
  • Операции из документов — список операций, извлечённых из загруженных файлов.
  • Профиль — смена данных и пароля.

Бухгалтер

  • Управление несколькими компаниями и пользователями.
  • Загрузка документов в карточку выбранной компании.
  • Просмотр операций по компаниям.

Администратор

  • Все компании и учётные записи, одобрение регистраций.
  • Настройки системы, логи, очереди задач, тест интеграций.

Типовой сценарий

  1. Загрузить счёт / чек / выписку.
  2. Дождаться OCR и LLM-распознавания (по умолчанию Yandex Vision и YandexGPT; опционально GigaChat; прогресс в интерфейсе).
  3. Проверить карточку файла и операции.
  4. Экспортировать данные в CSV/XLSX или в формат для загрузки в «1С».

Боты

MAX: регистрация/привязка, загрузка файла, выбор категории, уведомления о статусе.

Раздел 4

Установка / SaaS и on-premise

Основная модель поставки — облачный сервис; для экспертизы и локального развёртывания доступен on-premise экземпляр.

Облачный сервис (основная модель)

Докушка предоставляется как облачный интернет-сервис: https://docushka.ru.

  1. Открыть сайт, зарегистрироваться или войти.
  2. Подтвердить email; при необходимости дождаться активации администратором.
  3. Загружать документы в разделе «Документы», просматривать «Операции из документов» и экспортировать данные.

Проверочный / on-premise экземпляр

Для экспертизы и локального развёртывания предоставляется исходный код и конфигурация. Типовой порядок:

# установить зависимости Python
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# настроить .env (БД, Redis; по умолчанию ключи Yandex Vision / YandexGPT)
cp .env.example .env

# миграции и запуск API
python -m db.migrations.run_migrations
uvicorn api.main:app --host 0.0.0.0 --port 8000

# frontend
cd frontend && npm ci && npm run build && npm run preview

Дополнительно: воркеры Celery, Redis, PostgreSQL.

Раздел 5

Требования и поддержка

Минимальные требования к серверу и клиенту, контакты службы поддержки.

Минимальные требования сервера

2 vCPU, 4 GB RAM, 40 GB SSD, Linux, Docker (опционально) или Python 3.11+, Node.js 18+, PostgreSQL, Redis; доступ к API OCR/LLM.

Клиент

Современный браузер, разрешение экрана от 1280×720.

Поддержка

mail@smartproektsystems.ru, +7 (495) 183-33-50

Готовы попробовать?

Создайте аккаунт и загрузите первый документ — или посмотрите актуальные тарифы.

Создать аккаунтТарифы