refactor: adds complete integration system with secure proxy architecture:

- minimal FastAPI proxy with single endpoint protection
- dynamic endpoint creation based on env variables
- proper error handling and timeout management
- health check endpoint for monitoring
- README

README.md

@@ -9,4 +9,113 @@ app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Yandex Forms Proxy Service
+🔒 Сервисное приложение для разработчиков и администраторов
+
+⚠️ ВНИМАНИЕ
+Это сервисное приложение, предназначенное исключительно для системной интеграции.
+Обычным пользователям оно бесполезно и не предоставляет пользовательского интерфейса.
+
+📋 Назначение
+Этот прокси-сервер выполняет одну задачу:
+
+Принимает входящие вебхуки от Яндекс Форм
+
+Перенаправляет их в приватное пространство Hugging Face
+
+Возвращает ответ от приватного пространства обратно в Яндекс
+
+🔧 Принцип работы
+text
+Яндекс Формы → [Публичный прокси] → [Приватное пространство] → Google Sheets
+      ↑                                          ↓
+      ←──────────────────────────────────────────←
+Яндекс Формы отправляют данные на публичный URL прокси
+
+Прокси проверяет секретный путь и перенаправляет запрос
+
+Приватное пространство обрабатывает данные и сохраняет в Google Sheets
+
+Ответ возвращается через цепочку обратно в Яндекс
+
+⚙️ Конфигурация
+Переменные окружения:
+env
+PRIVATE_SPACE_URL=https://ваш-приватный-space.hf.space/yandex-form-webhook
+PUBLIC_ENDPOINT=секретный-уникальный-путь
+Настройка Яндекс Форм:
+text
+URL вебхука: https://ваш-публичный-space.hf.space/секретный-уникальный-путь
+Метод: POST
+Content-Type: application/json
+📊 Доступные эндпоинты
+Метод	Путь	Назначение
+POST	/{PUBLIC_ENDPOINT}	Прием вебхуков от Яндекс Форм
+GET	/health	Проверка работоспособности сервиса
+GET	/	Базовая информация о сервисе
+*	/*	Любые другие пути → 404 Not Found
+🔐 Безопасность
+Секретный путь - вебхук доступен только по пути из PUBLIC_ENDPOINT
+
+Все остальные пути возвращают 404
+
+Безопасное логирование - не логируются тела запросов и конфиденциальные данные
+
+Проверка конфигурации - приложение не работает без корректной настройки
+
+🚀 Развертывание
+Создайте Space на Hugging Face
+
+Добавьте переменные окружения в Settings
+
+Загрузите этот код
+
+Настройте Яндекс Формы на отправку вебхуков
+
+🐛 Отладка
+Проверка конфигурации:
+
+bash
+curl https://ваш-space.hf.space/health
+Тестовый запрос:
+
+bash
+curl -X POST https://ваш-space.hf.space/секретный-путь \
+  -H "Content-Type: application/json" \
+  -d '{"test": "data"}'
+📝 Логирование
+Сервис ведет минимальное логирование для безопасности:
+
+✅ Статус коды ответов
+
+✅ IP-адреса клиентов
+
+✅ Размеры запросов и ответов
+
+❌ НЕ логируются: тела запросов, секретные пути, URL
+
+⚠️ Ограничения
+Максимальный размер запроса: 10MB
+
+Таймаут подключения: 30 секунд
+
+Только POST запросы на вебхук
+
+Нет пользовательского интерфейса
+
+🛠️ Технические детали
+Фреймворк: FastAPI
+
+Python: 3.10+
+
+Зависимости: FastAPI, Uvicorn, Requests
+
+Архитектура: Микросервис, прокси-слой
+
+📞 Поддержка
+Этот сервис является частью инфраструктурного решения.
+Для вопросов и проблем обращайтесь к администратору системы.
+
+Статус: ✅ Активно поддерживается
+Версия: 1.0.0
+Назначение: Инфраструктурный сервис для интеграции Яндекс Форм

app.py

@@ -0,0 +1,46 @@
+import os
+import requests
+from fastapi import FastAPI, Request, HTTPException
+from fastapi.responses import JSONResponse
+
+app = FastAPI()
+
+PRIVATE_SPACE_URL = os.getenv("PRIVATE_SPACE_URL")
+PUBLIC_ENDPOINT = os.getenv("PUBLIC_ENDPOINT")
+
+if PUBLIC_ENDPOINT:
+    @app.post(f"/{PUBLIC_ENDPOINT}")
+    async def proxy(request: Request):
+        if not PRIVATE_SPACE_URL:
+            raise HTTPException(500, "Service misconfigured")
+            
+        # ПРОСТО используем PRIVATE_SPACE_URL как есть
+        target = PRIVATE_SPACE_URL
+        
+        try:
+            response = requests.post(
+                target,  # Уже полный URL
+                data=await request.body(),
+                headers={"Content-Type": request.headers.get("content-type")},
+                timeout=30
+            )
+            return JSONResponse(
+                content=response.json() if response.content else {},
+                status_code=response.status_code
+            )
+        except requests.exceptions.Timeout:
+            raise HTTPException(504, "Timeout")
+        except requests.exceptions.ConnectionError:
+            raise HTTPException(502, "Connection error")
+        except Exception:
+            raise HTTPException(500, "Internal error")
+
+@app.get("/health")
+def health():
+    return {
+        "status": "ok" if PRIVATE_SPACE_URL and PUBLIC_ENDPOINT else "error"
+    }
+
+@app.api_route("/{path:path}", methods=["GET", "POST", "PUT", "DELETE"])
+def catch_all(path: str):
+    raise HTTPException(404, "Not found")

requirements.txt

@@ -0,0 +1,3 @@
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+requests==2.31.0