README для коммита LOGGING-2026-001

# GalaxySimulator v6.11.0 - Расширенная система логирования столкновений

## Описание релиза

Данный релиз реализует комплексную систему диагностики и логирования столкновений галактик (LOGGING-2026-001).

### Новые возможности

#### 1. Запись начальных условий
- Полные орбитальные параметры сохраняются при t=0 для воспроизводимости
- Конфигурации галактик (положение, скорость, компоненты массы)
- Консервативные величины (импульс, угловой момент, энергия)
- Характерные временные масштабы (динамическое время, время пересечения, время трения)

#### 2. Детекция орбитальных событий
- **Детекция перицентра**: автоматическое обнаружение момента максимального сближения
- **Детекция апоцентра**: обнаружение максимального удаления (для связанных орбит)
- **Детекция слияния**: срабатывает когда расстояние падает ниже порога
- **Отслеживание фаз**: автоматическая классификация стадий столкновения

#### 3. Отслеживание энергетического баланса
- Кинетическая энергия каждой галактики
- Потенциальная энергия взаимодействия
- Аппроксимация энергии самогравитации (Hernquist, Miyamoto-Nagai, NFW)
- Эволюция орбитальной энергии
- Накопление потерь энергии от динамического трения

#### 4. Расширенная орбитальная телеметрия
- Удельная орбитальная энергия и угловой момент
- Компоненты вектора углового момента
- Позиции и скорости галактик
- Аннотация фазы столкновения

#### 5. Улучшенные метаданные снимков
- Фаза столкновения включена в метаданные snapshot
- Позволяет фильтровать и анализировать по фазам

---

## Выходные файлы

Все данные симуляции сохраняются в `~/Documents/GalaxySimulator/runs/<timestamp>_run_<id>/`

| Файл | Описание |
|------|----------|
| `manifest.json` | Конфигурация + секция initial_state |
| `config.json` | Полная конфигурация симуляции |
| `events.jsonl` | Поток событий (один JSON на строку) |
| `timeline.csv` | Покадровая телеметрия |
| `status.json` | Итоговый статус запуска |
| `snapshots/` | Снимки состояния частиц |

---

## Новые типы событий

| Событие | Триггер | Ключевые данные |
|---------|---------|-----------------|
| `initial_state_validation` | t=0 | Консервативные величины |
| `pericenter_passage` | v_radial: - → + | Расстояние, энергия, позиции |
| `apocenter_passage` | v_radial: + → - | Расстояние, энергия |
| `merger_started` | separation < threshold | Время с перицентра, счётчики пролётов |
| `collision_phase_changed` | Смена фазы | Старая/новая фаза, счётчики |
| `dynamical_friction_energy_loss` | Каждые 100 шагов | Потеря энергии, доля |
| `orbital_state` | Каждые 500 шагов | Полный энергетический баланс |

---

## Фазы столкновения

| Фаза | Описание |
|------|----------|
| `Initial` | Начальное состояние (t=0) |
| `Infall` | Приближение к первому перицентру |
| `Outfall` | Удаление после перицентра |
| `SecondInfall` | Приближение ко второму перицентру |
| `Merger` | Слияние галактик |
| `PostMerger` | После завершения слияния |

---

## Структура энергетического баланса

```json
{
  "energy_budget": {
    "kinetic_energy_gal1": 2.26e9,
    "kinetic_energy_gal2": 2.26e9,
    "kinetic_energy_total": 4.52e9,
    "potential_energy_interaction": -4.50e9,
    "potential_energy_self_gal1_approx": -1.61e9,
    "potential_energy_self_gal2_approx": -1.61e9,
    "orbital_energy": 1.68e7,
    "total_energy_approximation": -3.20e9
  }
}

---

Технические детали

Изменённые файлы

Файл	Изменения
core/CollisionDiagnostics.h	НОВЫЙ - enum CollisionPhase, структуры ConservedQuantities, PassageEvent
core/GalaxyEncounter.h	Добавлены методы isBound(), isUnbound(), orbitalPeriod()
gpu/GalaxyRenderWidget.h	Добавлены члены и методы отслеживания столкновений
gpu/GalaxyRenderWidget.cpp	Реализована логика детекции и логирования
gpu/RunSessionManager.h/cpp	Расширен startRun() для начального состояния
diagnostics/DiagnosticsEngine.h/cpp	Добавлено отслеживание фазы столкновения
diagnostics/SnapshotManager.h/cpp	Добавлено поле encounterPhase в Result

Объём кода

• Всего добавлено: ~1010 строк
• Новый файл: ~150 строк (CollisionDiagnostics.h)

Влияние на производительность

Метрика	Влияние
Снижение FPS	< 0.02%
Нагрузка на CPU	< 0.1 мс/кадр
Нагрузка на GPU	0 мс (нет новых GPU операций)
Рост размера логов	~3%

---

Пример использования

Скрипт анализа на Python

import json
import matplotlib.pyplot as plt

# Загрузка событий
events = []
with open('events.jsonl', 'r') as f:
    for line in f:
        events.append(json.loads(line))

# Извлечение пролётов через перицентр
pericenters = [e for e in events if e['type'] == 'pericenter_passage']
for p in pericenters:
    d = p['data']
    print(f"Перицентр #{d['passage_number']}: "
          f"t={p['sim_time']:.3f}, "
          f"d={d['actual_distance']:.2f} "
          f"(предсказано: {d['predicted_distance']:.2f})")

# График эволюции энергии
orbital_states = [e for e in events if e['type'] == 'orbital_state']
times = [s['sim_time'] for s in orbital_states]
E_orb = [s['data']['energy_budget']['orbital_energy'] for s in orbital_states]

plt.plot(times, E_orb)
plt.xlabel('Время')
plt.ylabel('Орбитальная энергия')
plt.title('Эволюция энергии')
plt.savefig('energy.png')

---

Совместимость

• Обратная совместимость с существующими конфигурациями
• Новые поля опциональны в JSON-выводе
• Версия схемы обновлена до 1.7

---

Требования

• Qt 6.x
• OpenGL 4.5+
• Компилятор C++17

---

Сборка

mkdir build && cd build
cmake ..
make -j$(nproc)

---

История версий

• v6.11.0 - Расширенное логирование столкновений (текущий релиз)
• v6.10.0 - Система бенчмарков, доступ к диагностике
• v6.9.0 - Рендерер координатной сетки
• v6.8.0 - Диагностика SPH
• v6.7.0 - Визуализация газа
• v6.6.0 - Инициализация температуры SPH
• v6.5.0 - Охлаждение SPH и обновление цветов

---

## Сообщение коммита

feat(logging): реализована расширенная система диагностики столкновений (LOGGING-2026-001)

• Добавлен CollisionDiagnostics.h с отслеживанием фаз и структурами событий
• Реализована детекция орбитальных пролётов (перицентр/апоцентр)
• Добавлена детекция слияния с настраиваемым порогом
• Отслеживание энергетического баланса включая аппроксимацию самогравитации
• Расширены события orbital_state полной телеметрией
• Запись начальных условий для воспроизводимости
• Добавлена фаза столкновения в метаданные snapshot

Новые типы событий:

• initial_state_validation
• pericenter_passage
• apocenter_passage
• merger_started
• collision_phase_changed
• dynamical_friction_energy_loss
• orbital_state (расширенный)

Производительность: влияние на FPS <0.02%, добавлено ~1010 строк кода

Закрывает #LOGGING-2026-001