Fix: Configure Render for Python runtime instead of Docker, add Swagger documentation info

README.md

@@ -2,6 +2,20 @@
 
 Сервис для матчинга лидов с объектами недвижимости на основе семантического поиска с использованием эмбеддингов.
 
+## 🚀 Быстрый старт
+
+### API Документация (Swagger)
+FastAPI автоматически генерирует интерактивную документацию:
+
+- **Swagger UI**: `http://localhost:8082/docs` (локально) или `https://your-service.onrender.com/docs`
+- **ReDoc**: `http://localhost:8082/redoc`
+- **OpenAPI Schema**: `http://localhost:8082/openapi.json`
+
+В Swagger UI можно:
+- ✅ Просмотреть все эндпоинты с описаниями
+- ✅ Увидеть схемы request/response
+- ✅ **Протестировать API прямо в браузере** (кнопка "Try it out")
+- ✅ Скопировать curl команды
 
 ### 1. Embedding Service (Python)
 FastAPI сервис для генерации эмбеддингов текста:

render.yaml

@@ -1,11 +1,12 @@
 services:
   - type: web
     name: matching-embedding-service
-    env: python
-    region: frankfurt
-    plan: free
-    buildCommand: chmod +x build.sh && ./build.sh
-    startCommand: cd embedding-service && uvicorn main:app --host 0.0.0.0 --port $PORT
+    runtime: python
+    region: frankfurt  # или oregon для США
+    plan: free  # бесплатный план, можно изменить на starter
+    rootDir: embedding-service
+    buildCommand: pip install --no-cache-dir -r requirements.txt && python -c "from sentence_transformers import SentenceTransformer; SentenceTransformer('sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2')"
+    startCommand: uvicorn main:app --host 0.0.0.0 --port $PORT
     healthCheckPath: /health
     envVars:
       - key: EMBEDDING_MODEL