Задания, тренировки, рекорды

{
  "name": "…", "type": "race",          // race | elapsed | open_distance
  "location": "ongudai",                 // локация (configs/locations/<id>.json)
  "start_site": "",                      // id старта локации; пусто — пилот ставится на пункт takeoff
  "takeoff_heading_deg": 180,            // курс разбега, если start_site пуст
  "start_gates_s": [900, 1500, 2100],    // открытие стартовых окон, с от начала полёта (Telemetry.time_s)
  "deadline_s": 12600,                   // крайний срок, с от начала полёта (нет — без срока)
  "cylinder_tolerance": 0.005,           // доля радиуса; полоса = max(r·доля, min_tolerance_m)
  "turnpoints": [
    {"name": "…", "type": "takeoff", "lat": 50.78, "lon": 86.23, "radius_m": 400},
    {"name": "Старт", "type": "sss", "direction": "exit", "lat": …, "lon": …, "radius_m": 3000},
    {"name": "…", "lat": …, "lon": …, "radius_m": 1000},              // type по умолчанию turnpoint
    {"name": "…", "type": "ess", …},
    {"name": "…", "type": "goal", "goal_type": "line", "line_length_m": 400, …}
  ]
}

# Задание
var task := Task.load_config("ongudai_demo", terrain.latlon_to_local, terrain.height_at)
var task2 := Task.load_file("user://tasks/comp_day1.xctsk", terrain.latlon_to_local, terrain.height_at)
Task.list_available() -> [{id, name, source: "config"|"file", path}]   # для меню
task.errors            # PackedStringArray, пусто — задание корректно
task.location, task.start_site, task.takeoff_heading_deg, task.points[i].position
task.task_distance_m() # оптимизированная дистанция задания, м
task.instrument_points() -> [{name, position, radius_m}]   # формат FlightInstrument.set_task

# Прохождение
var tracker := TaskTracker.new()
tracker.setup(task)                    # reset() — новая попытка
tracker.update(t: Telemetry)           # каждый шаг физики, после планера
signal start_taken(time_s)             # засчитанное время старта (race — окно, elapsed — своё)
signal turnpoint_reached(index, point_name, time_s)
signal ess_reached(time_s)
signal goal_reached(result)
signal task_failed(result)             # приземлился (status "landed") или вышел срок ("deadline")
tracker.get_state() -> {phase, next_index, next_name, instrument_active, start_open, time_to_start_s,
	start_time_s, early_start, distance_to_next_m, remaining_distance_m, task_distance_m,
	required_glide, elapsed_s}
tracker.result() -> {task_id, task_name, status, made_goal, reached_ess, start_time_s, ess_time_s,
	goal_time_s, speed_section_time_s, task_distance_m, distance_m, turnpoints_reached}
tracker.instrument_points(), tracker.instrument_active_index()

# Рекорды
var records := FlightRecords.new()     # user://records.json
records.add_flight(result) -> {"<категория>": {value, previous}}   # новые рекорды, пусто — нет
# result: FlightStats.summary() + {location, wing, [task: tracker.result()]}; категории задания — "task_*"
records.free_records(location, wing), records.task_records(task_id, wing)

# Тренировки
var mode: TrainingMode = TrainingSpotLanding.new()   # / TrainingThermalCentering / TrainingRidgeSoaring
mode.latlon_fn = terrain.latlon_to_local             # для мишени из lat/lon
var cfg := Config.get_config("tasks/training_spot_landing").duplicate(true)
cfg.location = current_location_id
mode.setup(cfg)
mode.update(t)                   # каждый шаг; тренировка идёт с момента взлёта
mode.on_landed(landing_result)   # из Glider.landed (оценка посадки для точности)
mode.is_finished(), mode.result() -> {mode, title, success, score 0..100, reason, elapsed_s, …}
signal finished(result)

# меню «Режим»: свободный полёт / задание (Task.list_available()) / тренировка (training_*)
var task := Task.load_config(id, terrain.latlon_to_local, terrain.height_at)
if task.start_site != "": site = <старт локации с этим id>
else: glider.reset_on_ground(task.points[task.takeoff_index].position, task.takeoff_heading_deg)
tracker.setup(task)
instrument.set_task(tracker.instrument_points(), tracker.instrument_active_index())   # стр. 2 и 4
tracker.turnpoint_reached.connect(func(_i, _n, _s):
	instrument.set_task(tracker.instrument_points(), tracker.instrument_active_index()))
tracker.start_taken.connect(...)       # звук/мигание на приборе — у агента instruments
tracker.goal_reached.connect(_show_result)   # экран итога: result() + records.add_flight(...)
tracker.task_failed.connect(_show_result)

# в Game.tick() после шага планера:
tracker.update(glider.telemetry)
training.update(glider.telemetry)
glider.landed.connect(training.on_landed)

# итог полёта → рекорды (FR-37)
var r := stats.summary(end_pos)        # FlightStats: flight_time_s, distance_m, max_altitude_msl_m
r.merge({"location": loc_id, "wing": wing_id})
if tracker: r["task"] = tracker.result()   # рекорды задания: время скоростного участка, дистанция
var new_records := records.add_flight(r)   # показать «Новый рекорд!» на экране итога