# Сервисы анализа SAR-MCHS

## Обзор

Анализ поисково-спасательных операций — **полностью локальный и
детерминированный** (внешний ИИ убран: ПД-данные детей не покидают контур).

### Состав

| Модуль | Назначение |
|---|---|
| `services/search_engine.py` | Чистый движок: SearchInput → build_search_model → SearchModel (B14) |
| `services/rules_analysis.py` | Правила: urgency, зоны, прогноз поведения, действия (замена LLM) |
| `services/geo_service.py` | Зоны через Overpass (8 направлений × 4 дистанции) |
| `services/scoring_service.py` | WeightedScorer, поведенческие профили (§8) |
| `services/distance_service.py` | Формула Экстремум: макс. дистанция + коэффициенты |
| `services/psychotype_service.py` | Детекция психотипа, модификаторы полос |
| `services/recommendation_service.py` | Стат-рекомендации по истории (B3) |

### Поток анализа

```
analyze_case (роутер, тонкая обёртка)
  └─ build_search_model(SearchInput, analyzer=rules_analyze)
       ├─ derive_profiles / derive_time_of_day   (деривации)
       ├─ detect_psychotype                      (если ответы есть)
       ├─ calculate_max_distance                 (формула Экстремум)
       ├─ rules_analyze                          (urgency/зоны/действия по правилам)
       │    └─ build_search_zones + rank_zones   (если есть координаты)
       └─ WeightedScorer                         (веса, профили)
```

## API

### POST `/api/v1/analyze`
Анализ случая (поле `case_id` опционально — без него анализ «на лету»).

### POST `/api/v1/analyze/combined`
Синоним `/analyze` (оставлен для совместимости).

### GET `/api/v1/analyze/{case_id}`
Последний сохранённый результат анализа кейса.

Ответ `/analyze` (сокращённо):
```json
{
  "max_distance_km": 5.4,
  "coefficients": {"base_speed": 1.2, "terrain": 0.5, "urgency": 5.0, ...},
  "urgency": "высокая",
  "primary_zones": [{"priority": 1, "name": "Зона N 0.5км", ...}],
  "search_radius_km": 5.0,
  "key_locations": ["водоёмы", ...],
  "behavioral_prediction": "...",
  "immediate_actions": ["..."],
  "active_profiles": [{"name": "велосипед", ...}],
  "fallback_used": true
}
```
`fallback_used: true` означает «локальный расчёт» (единственный режим).

## Тестирование

```bash
curl -X POST http://192.168.0.99:8000/api/v1/analyze \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"age": 8, "gender": "м", "terrain": ["лес"], "elapsed_hours": 2.0,
       "has_transport": "bike", "season": "лето"}'
# max_distance_km == 5.4 (регресс B14)
```