Полный отказ от LLM: детерминированный rules-анализ
Решение Виктора: ИИ убран из проекта — карточки детей (ПД) не должны покиать контур. Анализ полностью локальный и детерминированный. - services/rules_analysis.py: правила вместо Claude (бывший analyze_with_fallback + rule_based_urgency из closed_cases): urgency по возрасту/профилям, зоны через geo+scoring, behavioral_prediction/immediate_actions/key_locations — справочники. - search_engine: анализатор инъекцией (CaseAnalyzer, Protocol), импорт claude_service удалён; рантайм — rules_analyze. - УДАЛЕНЫ: services/claude_service.py, backend/services/claude_service.py (устаревшая копия), test_claude_service.py; ключевые правила-кейсы перенесены в test_rules_analysis.py (+тест отсутствия LLM-упоминаний). - docker-compose/.env.example: ANTHROPIC_API_KEY удалён. - Фронт: бейдж 'ИИ-анализ' -> 'Локальный расчёт'. - Доки: DEPLOY/SERVICES_README/ANALYZE_API переписаны, FIXES_REPORT помечен историческим, vector_tasks B20: zones/probability — из движка. pytest: 187 passed (было 214; -27 удалённых LLM-тестов, +тест rules). Контракт /analyze не изменён (фронт совместим).
This commit is contained in:
+46
-160
@@ -2,182 +2,68 @@
|
||||
|
||||
## Обзор
|
||||
|
||||
Созданы два основных сервиса для анализа поисково-спасательных операций:
|
||||
Анализ поисково-спасательных операций — **полностью локальный и
|
||||
детерминированный** (внешний ИИ убран: ПД-данные детей не покидают контур).
|
||||
|
||||
### 1. Claude Service (`backend/services/claude_service.py`)
|
||||
### Состав
|
||||
|
||||
**Функция:** `analyze_case(case_data: dict) -> AnalysisResult`
|
||||
| Модуль | Назначение |
|
||||
|---|---|
|
||||
| `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) |
|
||||
|
||||
Использует Claude API (модель `claude-sonnet-4-20250514`) для интеллектуального анализа случаев пропажи людей.
|
||||
### Поток анализа
|
||||
|
||||
**Входные данные (case_data):**
|
||||
- `age` - возраст пропавшего
|
||||
- `gender` - пол
|
||||
- `terrain` - тип местности
|
||||
- `weather` - погодные условия
|
||||
- `time_missing` - время пропажи
|
||||
- `last_location` - последнее известное местоположение
|
||||
- `circumstances` - особые обстоятельства
|
||||
- `physical_condition` - физическое состояние
|
||||
- `experience` - опыт нахождения на природе
|
||||
|
||||
**Возвращаемые данные (AnalysisResult):**
|
||||
```python
|
||||
{
|
||||
"urgency": "критическая|высокая|средняя|низкая",
|
||||
"primary_zones": [
|
||||
{
|
||||
"priority": 1,
|
||||
"name": "Зона А",
|
||||
"direction": "север",
|
||||
"distance": 2.5,
|
||||
"reason": "Обоснование выбора"
|
||||
}
|
||||
],
|
||||
"search_radius_km": 5.0,
|
||||
"key_locations": ["водоемы", "дороги", "постройки"],
|
||||
"team_assignments": {
|
||||
"команда_1": "зона А",
|
||||
"команда_2": "зона Б"
|
||||
},
|
||||
"behavioral_prediction": "Прогноз поведения",
|
||||
"immediate_actions": ["Действие 1", "Действие 2"],
|
||||
"summary": "Краткое резюме"
|
||||
}
|
||||
```
|
||||
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 (веса, профили)
|
||||
```
|
||||
|
||||
### 2. Stats Service (`backend/services/stats_service.py`)
|
||||
## API
|
||||
|
||||
**Функция:** `get_statistical_recommendation(case_data: dict, db_session: AsyncSession) -> StatsResult`
|
||||
|
||||
Анализирует исторические данные из базы для получения статистических рекомендаций.
|
||||
|
||||
**Входные данные:**
|
||||
- `age` - возраст (±2 года для фильтрации)
|
||||
- `season` - сезон (winter, spring, summer, autumn)
|
||||
- `terrain_primary` - основной тип местности
|
||||
|
||||
**Логика фильтрации:**
|
||||
1. Первая попытка: возраст ±2 года + сезон + terrain
|
||||
2. Если sample_size < 5: возраст ±2 года + сезон (без terrain)
|
||||
3. Если данных нет: возвращает дефолтные значения
|
||||
|
||||
**Возвращаемые данные (StatsResult):**
|
||||
```python
|
||||
{
|
||||
"median_distance_km": 2.5,
|
||||
"top_directions": [
|
||||
{
|
||||
"direction": "север",
|
||||
"count": 15,
|
||||
"percentage": 35.0
|
||||
}
|
||||
],
|
||||
"top_location_types": ["водоемы", "дороги", "лесные тропы"],
|
||||
"survival_rate": 87.5,
|
||||
"sample_size": 43
|
||||
}
|
||||
```
|
||||
|
||||
## API Endpoints
|
||||
|
||||
### POST `/api/v1/analyze/text`
|
||||
|
||||
Анализ случая с помощью Claude AI.
|
||||
|
||||
**Request:**
|
||||
```json
|
||||
{
|
||||
"age": 65,
|
||||
"gender": "мужской",
|
||||
"terrain": "лес",
|
||||
"weather": "дождь",
|
||||
"time_missing": "6 часов",
|
||||
"last_location": "лесная тропа у озера",
|
||||
"circumstances": "вышел за грибами",
|
||||
"physical_condition": "хорошее",
|
||||
"experience": "опытный грибник"
|
||||
}
|
||||
```
|
||||
|
||||
**Response:** `AnalysisResult`
|
||||
### POST `/api/v1/analyze`
|
||||
Анализ случая (поле `case_id` опционально — без него анализ «на лету»).
|
||||
|
||||
### POST `/api/v1/analyze/combined`
|
||||
Синоним `/analyze` (оставлен для совместимости).
|
||||
|
||||
Комбинированный анализ: Claude AI + статистические данные.
|
||||
### GET `/api/v1/analyze/{case_id}`
|
||||
Последний сохранённый результат анализа кейса.
|
||||
|
||||
**Request:** Тот же формат, что и `/text`
|
||||
|
||||
**Response:**
|
||||
Ответ `/analyze` (сокращённо):
|
||||
```json
|
||||
{
|
||||
"claude_analysis": { /* AnalysisResult */ },
|
||||
"statistical_data": { /* StatsResult */ }
|
||||
"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
|
||||
}
|
||||
```
|
||||
|
||||
### POST `/api/v1/analyze/document`
|
||||
|
||||
Анализ загруженного документа (пока поддерживается только .txt).
|
||||
|
||||
**Request:** multipart/form-data с файлом
|
||||
|
||||
**Response:** `AnalysisResult`
|
||||
|
||||
## Настройка
|
||||
|
||||
### Переменные окружения
|
||||
|
||||
В файле `.env` должен быть установлен:
|
||||
```
|
||||
ANTHROPIC_API_KEY=your_api_key_here
|
||||
```
|
||||
|
||||
### База данных
|
||||
|
||||
Для работы `stats_service` требуется таблица `cases` со следующими полями:
|
||||
- `age` (integer)
|
||||
- `season` (string)
|
||||
- `terrain_primary` (string)
|
||||
- `found_distance_km` (float)
|
||||
- `found_direction` (string)
|
||||
- `found_location_type` (string)
|
||||
- `outcome` (string: 'alive', 'found_alive', etc.)
|
||||
`fallback_used: true` означает «локальный расчёт» (единственный режим).
|
||||
|
||||
## Тестирование
|
||||
|
||||
### Тест Claude Service
|
||||
|
||||
```bash
|
||||
curl -X POST http://192.168.0.99:8000/api/v1/analyze/text \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"age": 65,
|
||||
"gender": "мужской",
|
||||
"terrain": "лес",
|
||||
"weather": "дождь",
|
||||
"time_missing": "6 часов",
|
||||
"last_location": "лесная тропа у озера"
|
||||
}'
|
||||
```
|
||||
|
||||
### Тест Combined Analysis
|
||||
|
||||
```bash
|
||||
curl -X POST http://192.168.0.99:8000/api/v1/analyze/combined \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"age": 65,
|
||||
"season": "autumn",
|
||||
"terrain_primary": "forest"
|
||||
}'
|
||||
```
|
||||
|
||||
## TODO
|
||||
|
||||
- [ ] Настроить подключение к базе данных
|
||||
- [ ] Добавить миграции Alembic для таблицы cases
|
||||
- [ ] Реализовать извлечение текста из .docx и .pdf
|
||||
- [ ] Добавить кэширование результатов анализа
|
||||
- [ ] Добавить rate limiting для API запросов
|
||||
- [ ] Добавить логирование запросов и ответов
|
||||
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)
|
||||
```
|
||||
Reference in New Issue
Block a user