add ai functions

DEVELOPMENT.md

@@ -17,11 +17,12 @@
 ## Локальное окружение
 
 ### Порты
-| Сервис | Порт |
-|--------|------|
-| Frontend (React) | 4000 |
-| Backend (NestJS) | 4001 |
-| PostgreSQL | 5432 |
+| Сервис | Порт | Описание |
+|--------|------|----------|
+| Frontend (React) | 4000 | Vite dev server |
+| Backend (NestJS) | 4001 | NestJS API |
+| PostgreSQL | 5432 | Docker container |
+| AI Proxy (туннель) | 3000 | SSH туннель к K8s |
 
 ### База данных
 PostgreSQL поднимается в Docker. Файл `docker-compose.yml` в корне проекта.
@@ -31,6 +32,63 @@ PostgreSQL поднимается в Docker. Файл `docker-compose.yml` в к
 docker-compose up -d postgres
 ```
 
+### Настройка Backend
+
+Создай файл `backend/.env`:
+
+```bash
+# Database
+DB_HOST=localhost
+DB_PORT=5432
+DB_USERNAME=teamplanner
+DB_PASSWORD=teamplanner
+DB_DATABASE=teamplanner
+
+# Keycloak
+KEYCLOAK_REALM_URL=https://auth.vigdorov.ru/realms/team-planner
+
+# AI Proxy (для Фазы 3)
+AI_PROXY_BASE_URL=http://localhost:3000
+AI_PROXY_API_KEY=<your-ai-proxy-api-key>
+```
+
+### AI Proxy — port-forward
+
+Для локальной работы с AI Proxy нужен port-forward:
+
+```bash
+# Запуск port-forward (в отдельном терминале или в фоне)
+kubectl port-forward svc/ai-proxy-service 3000:3000 -n ai-proxy
+```
+
+Проверка:
+```bash
+curl http://localhost:3000/health
+# {"status":"ok","service":"ai-proxy-service","version":"0.0.1",...}
+```
+
+**Примечание:** kubectl настроен для доступа к production кластеру.
+
+---
+
+## Работа с Production кластером
+
+kubectl настроен для доступа к production кластеру:
+
+```bash
+# Проверка статуса приложения
+kubectl get pods -n team-planner
+
+# Просмотр логов
+kubectl logs -f deployment/team-planner-backend -n team-planner
+
+# Проверка AI Proxy
+kubectl get pods -n ai-proxy
+kubectl logs -f deployment/ai-proxy-service -n ai-proxy
+```
+
+**⚠️ Внимание:** Будьте осторожны при работе с production окружением!
+
 ---
 
 ## Правила работы