From ec44f43ca0910c7628e85e163c5e0f0ea79d37d7 Mon Sep 17 00:00:00 2001
From: AI Assistant <ai@clientright.ru>
Date: Sun, 2 Nov 2025 19:21:37 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20=D0=BA=D1=80=D0=B0=D1=82=D0=BA=D0=B0=D1=8F?=
 =?UTF-8?q?=20=D1=88=D0=BF=D0=B0=D1=80=D0=B3=D0=B0=D0=BB=D0=BA=D0=B0=20?=
 =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D0=B1=D1=8B=D1=81=D1=82=D1=80=D0=BE=D0=B3?=
 =?UTF-8?q?=D0=BE=20=D1=81=D1=82=D0=B0=D1=80=D1=82=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 QUICK_START_DOCUMENTS.md | 116 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 QUICK_START_DOCUMENTS.md

diff --git a/QUICK_START_DOCUMENTS.md b/QUICK_START_DOCUMENTS.md
new file mode 100644
index 0000000..af70674
--- /dev/null
+++ b/QUICK_START_DOCUMENTS.md
@@ -0,0 +1,116 @@
+# 🚀 Быстрый старт: Привязка документов
+
+## Эндпоинт
+```
+POST https://crm.clientright.ru/api/n8n/documents/attach
+```
+
+---
+
+## 💡 Простейший пример (из n8n)
+
+```json
+[
+  {
+    "contact_id": "{{ $json.contact_id }}",
+    "project_id": "{{ $json.project_id }}",
+    "ticket_id": "{{ $json.ticket_id }}",
+    "filename": "{{ $json.filename }}",
+    "file_type": "{{ $json.file_type }}",
+    "file": "{{ $json.file }}"
+  }
+]
+```
+
+**Важно:**
+- ✅ Всегда передавать как **массив** `[...]`
+- ✅ Поле `file` может быть без хоста (автоматически добавится `https://s3.twcstorage.ru`)
+- ✅ Если `ticket_id` указан → документ привязывается к **заявке**
+- ✅ Если `ticket_id` НЕ указан → документ привязывается к **проекту**
+
+---
+
+## 🧪 Тестирование
+
+### Быстрый тест (в консоли сервера):
+```bash
+cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform
+./TEST_REAL_DATA.sh
+```
+
+### Проверка логов:
+```bash
+# Backend логи
+docker-compose logs -f backend | grep "Attaching document"
+
+# CRM логи
+tail -f /var/www/fastuser/data/www/crm.clientright.ru/logs/upload_documents.log
+```
+
+---
+
+## ✅ Ожидаемый ответ
+
+```json
+{
+  "success": true,
+  "total_processed": 1,
+  "successful": 1,
+  "failed": 0,
+  "results": [
+    {
+      "document_id": "15x396941",
+      "attached_to": "ticket",
+      "attached_to_id": "396936",
+      "file_name": "boarding_pass.pdf",
+      "file_type": "flight_delay_boarding_or_ticket",
+      "s3_bucket": "...",
+      "s3_key": "...",
+      "file_size": 85320
+    }
+  ],
+  "errors": null
+}
+```
+
+---
+
+## 🔧 Интеграция в n8n
+
+### HTTP Request Node:
+
+**Method:** `POST`  
+**URL:** `https://crm.clientright.ru/api/n8n/documents/attach`  
+**Authentication:** None  
+**Body Content Type:** JSON
+
+**Body:**
+```json
+{{ $json.documents }}
+```
+
+Где `$json.documents` - это массив документов из предыдущего node.
+
+---
+
+## 📊 Типы документов (file_type)
+
+| Код | Описание |
+|-----|----------|
+| `flight_delay_boarding_or_ticket` | Посадочный талон / билет |
+| `flight_delay_confirmation` | Подтверждение задержки |
+| `flight_cancel_confirmation` | Подтверждение отмены рейса |
+| `medical_receipt` | Медицинский чек |
+| `medical_report` | Медицинское заключение |
+| `luggage_delay_report` | Акт о задержке багажа |
+| `passport_scan` | Скан паспорта |
+| `policy_scan` | Скан полиса |
+
+---
+
+## 🎯 Готово!
+
+Эндпоинт работает и готов к использованию! 🚀
+
+Подробная документация: `DOCUMENT_ATTACH_API.md`
+