crm.clientright.ru/WORKFLOW_ПРИЛОЖЕНИЯ_NEXTCLOUD.md

🔄 WORKFLOW ПРИЛОЖЕНИЯ В NEXTCLOUD

1️⃣ Workflow OCR Backend (workflow_ocr)

ЧТО ЭТО:

Приложение для автоматического распознавания текста (OCR) из изображений и PDF файлов.

КАК РАБОТАЕТ:

PDF/Изображение загружено → 
→ Workflow Engine видит событие → 
→ Tesseract OCR обрабатывает → 
→ Создаёт текстовый файл с распознанным текстом

ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ:

1. Автоматическое распознавание сканов:

Правило: Если загружен файл *.pdf в папку /Scans
Действие: Распознать текст и создать .txt файл

2. Обработка чеков:

Правило: Если загружена фотография в /Receipts
Действие: OCR → поиск по тексту

3. Юридические документы:

Правило: Если загружен скан решения суда
Действие: Распознать текст → сделать документ searchable

НАСТРОЙКА:

1. Создать правило:

Settings → Flow → Add rule:
  - When: File created
  - And: Mime type is image/* OR application/pdf
  - And: Path matches /Scans/*
  - Then: OCR processing

2. Выбрать язык:

• Russian (rus)
• English (eng)
• Multi (rus+eng)

ТЕКУЩИЙ СТАТУС:

• ✅ Установлено: workflow_ocr 1.31.3
• ✅ Tesseract OCR: 5.5.0 (движок распознавания)
• ❌ Правил НЕТ (не настроено)

Вывод: Приложение установлено, но НЕ ИСПОЛЬЗУЕТСЯ (нет правил).

---

2️⃣ Flow Notifications (flow_notifications)

ЧТО ЭТО:

Приложение для отправки уведомлений на основе событий Workflow.

КАК РАБОТАЕТ:

Событие в Nextcloud → 
→ Workflow Engine проверяет правила → 
→ Flow Notifications отправляет уведомление

ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ:

1. Уведомление при загрузке важного файла:

Правило: Если файл загружен в /Important
Действие: Отправить уведомление "Загружен важный файл"

2. Уведомление о новом контракте:

Правило: Если PDF загружен в /Contracts
Действие: Уведомить юриста

3. Алерт при большом файле:

Правило: Если размер файла > 100MB
Действие: Уведомить администратора

ТИПЫ УВЕДОМЛЕНИЙ:

• 🔔 Push-уведомления в браузере
• 📧 Email
• 📱 Nextcloud app (Android/iOS)
• 🔗 Webhook (для интеграций)

НАСТРОЙКА:

Пример правила:

Settings → Flow → Add rule:
  - When: File created
  - And: File size > 100000000 (100MB)
  - Then: Send notification
    - User: admin
    - Message: "Large file uploaded: {file}"

ТЕКУЩИЙ СТАТУС:

• ✅ Установлено: flow_notifications 2.0.1
• ❌ Правил НЕТ (не настроено)

Вывод: Приложение установлено, но НЕ ИСПОЛЬЗУЕТСЯ.

---

3️⃣ Workflow Engine (workflowengine)

ЧТО ЭТО:

Основной движок для всех workflow - автоматизация действий на основе событий.

АРХИТЕКТУРА:

                 ┌─────────────────┐
                 │ Workflow Engine │
                 │   (ядро)        │
                 └────────┬─────────┘
                          │
        ┌─────────────────┼─────────────────┐
        │                 │                 │
        ▼                 ▼                 ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ workflow_ocr  │ │flow_notifications││workflow_script│
│ (OCR)         │ │ (уведомления) │ │ (скрипты)     │
└───────────────┘ └───────────────┘ └───────────────┘

ДОСТУПНЫЕ ДЕЙСТВИЯ:

Стандартные:

• ✅ Отправить уведомление
• ✅ Добавить тег
• ✅ Переместить файл
• ✅ Конвертировать в PDF
• ✅ Запустить скрипт

С установленными приложениями:

• ✅ OCR обработка (workflow_ocr)
• ✅ Конвертация PDF (workflow_pdf_converter)
• ✅ Запуск скриптов (workflow_script)

---

4️⃣ Другие установленные Workflow приложения:

workflow_pdf_converter

Конвертация документов в PDF:

• Word → PDF
• Excel → PDF
• Images → PDF

workflow_script

Запуск произвольных скриптов при событиях:

#!/bin/bash
# Пример: отправка файла по API
curl -X POST https://api.example.com/upload \
  -F "file=@$1"

---

🎯 ТЕКУЩАЯ СИТУАЦИЯ:

Установлено:

✅ workflowengine: 2.13.0       (ядро)
✅ workflow_ocr: 1.31.3         (OCR)
✅ workflow_pdf_converter: 2.0.0 (PDF конвертер)
✅ workflow_script: 2.0.0       (скрипты)
✅ flow_notifications: 2.0.1    (уведомления)

Активных правил: 0 ❌

Вывод: Все приложения установлены, но НЕ НАСТРОЕНЫ и НЕ ИСПОЛЬЗУЮТСЯ.

---

💡 РЕКОМЕНДАЦИИ:

Вариант 1: ИСПОЛЬЗОВАТЬ для автоматизации

Полезные сценарии для CRM:

1. OCR судебных решений:

Правило: PDF загружен в Documents/Project/*/Судебные решения
Действие: OCR → текст извлечён → можно искать

2. Уведомления о новых документах:

Правило: Файл загружен в Documents/Project/*
Действие: Уведомить ответственного юриста

3. Автоматическая конвертация в PDF:

Правило: Word/Excel загружен
Действие: Конвертировать в PDF

Вариант 2: ОТКЛЮЧИТЬ если не нужно

Если не планируете использовать автоматизацию:

docker exec -u www-data nextcloud-fresh php occ app:disable workflow_ocr
docker exec -u www-data nextcloud-fresh php occ app:disable flow_notifications
docker exec -u www-data nextcloud-fresh php occ app:disable workflow_pdf_converter
docker exec -u www-data nextcloud-fresh php occ app:disable workflow_script

Оставить только ядро: workflowengine (базовая функциональность)

---

🔧 КАК НАСТРОИТЬ (если нужно):

Шаг 1: Открыть настройки Flow

https://office.clientright.ru:8443/settings/admin/workflow

Шаг 2: Создать правило

1. Add rule
2. Выбрать событие (File created, File updated, etc.)
3. Добавить условия (path, mime type, size)
4. Выбрать действие (OCR, notification, convert)
5. Save

Шаг 3: Протестировать

Загрузить тестовый файл → проверить что правило сработало

---

📊 ИСПОЛЬЗУЕМЫЕ РЕСУРСЫ:

Tesseract OCR:

• Версия: 5.5.0
• Языки: русский, английский (установлены)
• CPU: ~50-100% на файл
• Время: ~10-30 сек на страницу

Дисковое пространство:

OCR создаёт дополнительные текстовые файлы = +10-20% от размера PDF

---

⚠️ ВАЖНО:

Если НЕ используете эти функции → лучше отключить:

• Меньше нагрузка на систему
• Меньше ошибок в логах
• Проще поддержка

Если НУЖНА автоматизация → настроить правила workflow

---

Вам нужна автоматизация (OCR, уведомления)? Или отключить эти приложения? 🤔