From 3d121054ab6a29e6d9f484515d197d04b127da95 Mon Sep 17 00:00:00 2001
From: AI Assistant <ai@clientright.ru>
Date: Sun, 2 Nov 2025 19:25:29 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=A4=D0=B8=D0=BD=D0=B0=D0=BB=D1=8C?=
 =?UTF-8?q?=D0=BD=D0=B0=D1=8F=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD?=
 =?UTF-8?q?=D1=82=D0=B0=D1=86=D0=B8=D1=8F=20=D1=81=20=D0=BF=D1=80=D1=8F?=
 =?UTF-8?q?=D0=BC=D1=8B=D0=BC=20PHP=20=D1=8D=D0=BD=D0=B4=D0=BF=D0=BE=D0=B8?=
 =?UTF-8?q?=D0=BD=D1=82=D0=BE=D0=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 FINAL_SOLUTION.md | 101 ++++++++++++++++++++++++++++++++++++++++++++++
 TEST_REAL_DATA.sh |   2 +-
 2 files changed, 102 insertions(+), 1 deletion(-)
 create mode 100644 FINAL_SOLUTION.md

diff --git a/FINAL_SOLUTION.md b/FINAL_SOLUTION.md
new file mode 100644
index 0000000..f34aa52
--- /dev/null
+++ b/FINAL_SOLUTION.md
@@ -0,0 +1,101 @@
+# ✅ ИТОГОВОЕ РЕШЕНИЕ: Привязка документов
+
+## 🎯 Прямой PHP эндпоинт (рекомендуется)
+
+**URL для n8n:**
+```
+POST https://crm.clientright.ru/api_attach_documents.php
+```
+
+**Почему этот вариант:**
+- ✅ Нет лишних прокси-слоев
+- ✅ Не зависит от backend контейнера
+- ✅ Прямое взаимодействие с CRM
+- ✅ Проще в отладке
+
+---
+
+## 📋 Формат запроса
+
+```json
+[
+  {
+    "claim_id": "CLM-2025-11-02-WNRZZZ",
+    "event_type": "delay_flight",
+    "contact_id": "320096",
+    "project_id": "396868",
+    "ticket_id": "396936",
+    "filename": "boarding_pass.pdf",
+    "file_type": "flight_delay_boarding_or_ticket",
+    "file": "/bucket/path/file.pdf"
+  }
+]
+```
+
+**Обязательные поля:**
+- `contact_id` - ID контакта
+- `project_id` - ID проекта (полиса)
+- `filename` (или `file_name`) - имя файла
+- `file` (или `file_url`) - путь к файлу в S3
+
+**Опциональные поля:**
+- `ticket_id` - ID заявки (**если указан → привязка к HelpDesk, иначе → к Project**)
+- `file_type` - описание типа документа
+- `claim_id`, `event_type` - для логирования
+
+---
+
+## 📊 Ответ
+
+```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",
+      "...": "..."
+    }
+  ],
+  "errors": null
+}
+```
+
+---
+
+## 🔧 Интеграция в n8n
+
+### HTTP Request Node:
+
+**Method:** `POST`  
+**URL:** `https://crm.clientright.ru/api_attach_documents.php`  
+**Authentication:** None  
+**Body Content Type:** JSON
+
+**Body:**
+```
+{{ $json.documents }}
+```
+
+Где `$json.documents` - массив из предыдущей ноды.
+
+---
+
+## 🔍 Логи
+
+```bash
+tail -f /var/www/fastuser/data/www/crm.clientright.ru/logs/api_attach_documents.log
+```
+
+---
+
+## ✅ Готово к использованию!
+
+Эндпоинт протестирован и готов к production! 🚀
+
+Полная документация: `/var/www/fastuser/data/www/crm.clientright.ru/API_ATTACH_DOCS_README.md`
diff --git a/TEST_REAL_DATA.sh b/TEST_REAL_DATA.sh
index 0384187..4343b02 100755
--- a/TEST_REAL_DATA.sh
+++ b/TEST_REAL_DATA.sh
@@ -4,7 +4,7 @@
 echo "🧪 Тест привязки документа с реальными данными"
 echo "=============================================="
 
-curl -X POST "https://crm.clientright.ru/api/n8n/documents/attach" \
+curl -X POST "https://crm.clientright.ru/api_attach_documents.php" \
   -H "Content-Type: application/json" \
   -d '[
   {