{
    "project": "EE DataCollector Esoteric API v2.3.0",
    "generated_at": "2026-05-10T01:10:43+00:00",
    "export_type": "ai_single_file",
    "source": "doc/index.php?download=ai",
    "toc_meta": {
        "project": "API V2.3 Beta",
        "version": "2.3.0",
        "updated_at": "2026-03-18",
        "author": "Евгений Ефимченко",
        "description": "Актуальная техническая документация по асинхронному API портрета, прогноза, Synthesis++ и новому синхронному почасовому geocentric-прогнозу Луны."
    },
    "sections": [
        {
            "id": "01_introduction",
            "title": "1. Введение и архитектура",
            "description": "Общая модель API, очередь задач, разделение SubjectContext/TemporalContext и синхронный hourly-endpoint.",
            "file_name": "doc_01_intro.json",
            "content": {
                "title": "1. Введение",
                "version": "2.3.0",
                "last_updated": "2026-03-18",
                "description": "EE DataCollector API сочетает асинхронный контур расчётов портрета/прогноза и новый синхронный hourly-endpoint для geocentric-прогноза Луны. Архитектура по-прежнему разделяет SubjectContext и TemporalContext, а hourly-метод работает поверх отдельного серверного кэша эфемерид.",
                "key_changes": [
                    "Сохранён асинхронный контур `create_task -> worker -> get_result` для тяжёлых составных расчётов.",
                    "Добавлен новый синхронный `GET /get_hourly_forecast` для почасового прогноза Луны и планет на локальные сутки.",
                    "Hourly-endpoint возвращает geocentric-позиции Луны/планет, текущие аспекты Луны, окно `void of course`, лунный день и флаг «сатанинского» дня.",
                    "Для hourly-endpoint добавлен двухуровневый кэш: batch-cache эфемерид NASA и result-cache по `date + lat + lng + timezone`.",
                    "Канонический слой Synthesis++ и export_result продолжают работать без изменения контракта."
                ],
                "info_block": {
                    "base_url": "https://digihash.ru/datacollector/api.php",
                    "version": "2.3.0",
                    "protocol": "HTTPS / JSON"
                },
                "features": [
                    "Асинхронная очередь задач для портрета, периодического прогноза и Synthesis++.",
                    "Синхронный hourly-endpoint для UI и сервисов, которым нужен готовый почасовой результат сразу.",
                    "Разделение SubjectContext/TemporalContext во всех вычислениях.",
                    "Серверное кэширование портретов, дневных прогнозов и нового почасового geocentric-прогноза.",
                    "Режим критического отказа для внешних источников: при проблемах NASA JPL Horizons API не отдаёт фальшивый частичный успех."
                ],
                "architecture": {
                    "title": "Как работает API",
                    "description": "В системе теперь два рабочих контура: асинхронный и синхронный.",
                    "lifecycle_steps": [
                        {
                            "step": 1,
                            "actor": "Клиент",
                            "action": "POST create_task",
                            "description": "Запускает тяжёлую составную задачу для портрета/прогноза/Synthesis++."
                        },
                        {
                            "step": 2,
                            "actor": "Worker",
                            "action": "Асинхронный расчёт",
                            "description": "Собирает итоговый payload и сохраняет его для последующего `get_result`."
                        },
                        {
                            "step": 3,
                            "actor": "Клиент",
                            "action": "GET get_result",
                            "description": "Опрос статуса или получение итогового async-результата."
                        },
                        {
                            "step": 4,
                            "actor": "Клиент",
                            "action": "GET get_hourly_forecast",
                            "description": "Синхронный запрос почасового прогноза на local-день с отдельным result-cache."
                        }
                    ]
                },
                "caching_policy": {
                    "title": "Модель хранения и кэширования",
                    "description": "Кэш разделён по доменам данных. В публичных ответах файловые пути никогда не раскрываются.",
                    "strategies": [
                        {
                            "data_type": "Портретные данные",
                            "ttl": "Постоянно",
                            "icon": "database",
                            "desc": "Immutable SubjectContext и производные portrait-расчёты."
                        },
                        {
                            "data_type": "Периодические forecast-данные",
                            "ttl": "По temporal-контексту",
                            "icon": "clock",
                            "desc": "Классический дневной/недельный/месячный forecast."
                        },
                        {
                            "data_type": "Hourly geocentric forecast",
                            "ttl": "По `date + lat + lng + timezone`",
                            "icon": "bolt",
                            "desc": "Отдельный JSON-cache для нового почасового метода."
                        }
                    ]
                },
                "technical_requirements": {
                    "title": "Технические требования",
                    "list": [
                        "Формат обмена: JSON",
                        "Кодировка: UTF-8",
                        "Дата: YYYY-MM-DD",
                        "Время: HH:MM или HH:MM:SS",
                        "Все запросы выполняются по HTTPS"
                    ]
                }
            }
        },
        {
            "id": "02_authentication",
            "title": "2. Аутентификация и доступ",
            "description": "Правила api_key, заголовки, лимиты и доступ к sync/async методам.",
            "file_name": "doc_02_auth.json",
            "content": {
                "title": "2. Аутентификация и доступ",
                "description": "Для create_task обязателен api_key в JSON. Для get_result/export_result доступ зависит от ключа, которым создана задача: публичные ключи дают открытый доступ по request_id, приватные требуют тот же API-ключ через X-API-Key или query api_key.",
                "security_card": {
                    "type": "API key",
                    "in": "Тело запроса (JSON), заголовок X-API-Key или query api_key",
                    "name": "api_key",
                    "example": "655351024"
                },
                "headers_table": [
                    {
                        "header": "Content-Type",
                        "value": "application/json",
                        "desc": "Обязателен для POST /api.php?action=create_task"
                    },
                    {
                        "header": "X-Calc-Profile",
                        "value": "A | B",
                        "desc": "Опциональный выбор профиля расчёта. Приоритет: header > query > body > default(A)."
                    },
                    {
                        "header": "X-API-Key",
                        "value": "<your_key>",
                        "desc": "Опционален для публичных задач и обязателен для приватных request_id в get_result/export_result."
                    },
                    {
                        "header": "Accept",
                        "value": "application/json",
                        "desc": "Рекомендуется для API-запросов."
                    }
                ],
                "auth_methods": [
                    {
                        "method": "POST",
                        "endpoint": "/api.php?action=create_task",
                        "badge": "Требуется авторизация",
                        "desc": "Всегда требуется валидный api_key в JSON-теле.",
                        "snippet": "{\n  \"api_key\": \"655351024\",\n  \"user\": { ... }\n}"
                    },
                    {
                        "method": "GET",
                        "endpoint": "/api.php?action=get_result&request_id=...",
                        "badge": "Условно публичный",
                        "desc": "Если задача создана публичным ключом (public_result_access=true), достаточно request_id. Для приватных ключей нужен X-API-Key или query api_key.",
                        "snippet": "GET /api.php?action=get_result&request_id=task_...&view=summary&api_key=<private_key>"
                    },
                    {
                        "method": "GET",
                        "endpoint": "/api.php?action=export_result&request_id=...&format=ndjson",
                        "badge": "Условно публичный",
                        "desc": "Правило такое же, как у get_result: для приватных ключей обязателен тот же ключ доступа.",
                        "snippet": "GET /api.php?action=export_result&request_id=task_...&format=ndjson&api_key=<private_key>"
                    }
                ],
                "ranking_system": {
                    "title": "Система ранжирования API-ключей",
                    "description": "Ранг API-ключа определяет почасовую квоту и доступный профиль нагрузки. Базовые значения хранятся в config/ranks.php. Для публичного тестового ключа 655351024 используется ранг adept.",
                    "rank_table": [
                        {
                            "name": "demiurge",
                            "type": "безлимит",
                            "description": "Флаг is_god=true. limit_per_hour = -1 (без ограничения)."
                        },
                        {
                            "name": "magus",
                            "type": "квота",
                            "description": "limit_per_hour = 1000 условных единиц в час."
                        },
                        {
                            "name": "master",
                            "type": "квота",
                            "description": "limit_per_hour = 500 условных единиц в час."
                        },
                        {
                            "name": "adept",
                            "type": "квота",
                            "description": "limit_per_hour = 100 условных единиц в час. Ранг тестового ключа."
                        }
                    ],
                    "limits_block": [
                        "Стоимость новой задачи учитывается коэффициентом cost_new (по умолчанию 3).",
                        "Стоимость повторного/кэшированного обращения может учитываться коэффициентом cost_cached (по умолчанию 1).",
                        "Дополнительно действует лимит per_minute из реестра ключей (config/api_keys.php)."
                    ]
                },
                "limits_block": {
                    "title": "Ограничения и поведение",
                    "list": [
                        "Глобальный лимит API: 360 запросов за 60 секунд по IP (429 + Retry-After: 60).",
                        "Дополнительный лимит по ключу: per_minute из реестра API-ключей.",
                        "Почасовая квота по рангу/ключу учитывает стоимость новой задачи (cost_new).",
                        "Тестовый ключ 655351024 остаётся публичным и предназначен для интеграционных проверок.",
                        "run_worker защищён: доступ только с localhost или с валидным X-Worker-Token."
                    ]
                },
                "error_table": {
                    "401": "Unauthorized: ключ отсутствует/невалиден или не передан для приватного request_id.",
                    "403": "Forbidden: передан неверный ключ для приватного request_id или запрещён доступ к run_worker.",
                    "405": "Метод не разрешён для выбранного HTTP-метода.",
                    "429": "Превышен лимит запросов (глобальный или ключевой)."
                }
            }
        },
        {
            "id": "03_methods_create",
            "title": "3. Создание задачи (POST /create_task)",
            "description": "Структура запроса, параметры forecast/response, calc_profile.",
            "file_name": "doc_03_create_task.json",
            "content": {
                "title": "3. Создание задачи (POST /create_task)",
                "description": "Метод ставит задачу в очередь и возвращает request_id. Фактический расчёт выполняется worker-процессом асинхронно.",
                "endpoint": {
                    "method": "POST",
                    "url": "/api.php?action=create_task",
                    "content_type": "application/json"
                },
                "request_body_schema": {
                    "root_parameters": [
                        {
                            "name": "api_key",
                            "type": "string | number",
                            "required": true,
                            "description": "Ключ доступа API (публичный тестовый: 655351024)."
                        },
                        {
                            "name": "calc_profile",
                            "type": "enum",
                            "required": false,
                            "values": [
                                "A",
                                "B"
                            ],
                            "default": "A",
                            "description": "Профиль расчёта весов для synthesis. Приоритет источников: X-Calc-Profile > query > body > default."
                        },
                        {
                            "name": "user",
                            "type": "object",
                            "required": true,
                            "description": "Натальные данные пользователя (SubjectContext)."
                        },
                        {
                            "name": "systems",
                            "type": "array[string]",
                            "required": false,
                            "description": "Список модулей: numerology, astrology, bodygraph, transits, forecast, synthesis."
                        },
                        {
                            "name": "current_location",
                            "type": "object",
                            "required": false,
                            "description": "Текущая локация для TemporalContext (прогнозы/транзиты/дневные ветки)."
                        },
                        {
                            "name": "forecast",
                            "type": "object",
                            "required": false,
                            "description": "Параметры периода прогноза и режим качества space_weather."
                        },
                        {
                            "name": "response",
                            "type": "object",
                            "required": false,
                            "description": "Опции проекции ответа (например, omit_portrait_payload)."
                        }
                    ],
                    "user_object": [
                        {
                            "name": "first_name",
                            "type": "string",
                            "required": true,
                            "example": "Евгений"
                        },
                        {
                            "name": "last_name",
                            "type": "string",
                            "required": true,
                            "example": "Ефимченко"
                        },
                        {
                            "name": "middle_name",
                            "type": "string",
                            "required": false,
                            "example": "Владимирович"
                        },
                        {
                            "name": "birth_date",
                            "type": "string (date)",
                            "required": true,
                            "format": "YYYY-MM-DD",
                            "example": "1981-10-27"
                        },
                        {
                            "name": "birth_time",
                            "type": "string (time)",
                            "required": true,
                            "format": "HH:MM или HH:MM:SS",
                            "example": "04:13"
                        },
                        {
                            "name": "birth_city",
                            "type": "string",
                            "required": true,
                            "example": "Норильск"
                        },
                        {
                            "name": "birth_country",
                            "type": "string",
                            "required": false,
                            "example": "Россия"
                        }
                    ],
                    "forecast_object": [
                        {
                            "name": "period_type",
                            "type": "enum",
                            "required": false,
                            "values": [
                                "day",
                                "week",
                                "month"
                            ],
                            "default": "day",
                            "description": "Тип периода прогноза."
                        },
                        {
                            "name": "period_start_date",
                            "type": "string (date)",
                            "required": false,
                            "description": "Дата начала периода (алиас target_date).",
                            "example": "2026-02-14"
                        },
                        {
                            "name": "target_time",
                            "type": "string (time)",
                            "required": false,
                            "description": "Время якоря расчёта для TemporalContext.",
                            "example": "12:00:00"
                        },
                        {
                            "name": "space_weather_mode",
                            "type": "enum",
                            "required": false,
                            "values": [
                                "allow_simulated",
                                "observed_or_estimated",
                                "observed_only"
                            ],
                            "default": "allow_simulated",
                            "description": "Режим качества Kp-данных."
                        }
                    ],
                    "response_object": [
                        {
                            "name": "omit_portrait_payload",
                            "type": "boolean",
                            "required": false,
                            "default": false,
                            "description": "Если true, в итоговом payload скрываются тяжёлые портретные ветки systems.numerology/astrology/bodygraph."
                        }
                    ]
                },
                "feature_guidelines": {
                    "title": "Связка с Synthesis++",
                    "list": [
                        "Чтобы получить канонический слой, добавьте \"synthesis\" в systems.",
                        "Подробный разбор режимов summary/explain/raw вынесен в раздел «5. Работа с Synthesis++ (IPSM v2)».",
                        "Если нужен компактный ответ, передавайте response.omit_portrait_payload=true."
                    ]
                },
                "examples": {
                    "full_request": {
                        "description": "Запрос с synthesis и компактным режимом ответа.",
                        "payload": {
                            "api_key": "655351024",
                            "calc_profile": "B",
                            "user": {
                                "first_name": "Евгений",
                                "middle_name": "Владимирович",
                                "last_name": "Ефимченко",
                                "birth_date": "1981-10-27",
                                "birth_time": "04:13",
                                "birth_city": "Норильск",
                                "birth_country": "Россия"
                            },
                            "systems": [
                                "numerology",
                                "astrology",
                                "bodygraph",
                                "transits",
                                "forecast",
                                "synthesis"
                            ],
                            "current_location": {
                                "city": "Орел",
                                "country": "Россия"
                            },
                            "forecast": {
                                "period_type": "day",
                                "period_start_date": "2026-02-14",
                                "target_time": "12:00:00",
                                "space_weather_mode": "observed_or_estimated"
                            },
                            "response": {
                                "omit_portrait_payload": true
                            }
                        }
                    },
                    "success_response": {
                        "status": 202,
                        "description": "Задача поставлена в очередь.",
                        "payload": {
                            "status": "queued",
                            "message": "Task accepted",
                            "request_id": "task_698cdc670473d"
                        }
                    },
                    "error_response": {
                        "status": 400,
                        "description": "Ошибка валидации обязательных полей user.",
                        "payload": {
                            "status": "error",
                            "errors": [
                                "Field 'last_name' is required"
                            ]
                        }
                    }
                }
            }
        },
        {
            "id": "04_methods_hourly",
            "title": "4. Почасовой лунный прогноз (GET /get_hourly_forecast)",
            "description": "Синхронный geocentric endpoint: почасовые позиции Луны/планет, аспекты Луны, void of course и лунный день.",
            "file_name": "doc_04_hourly_forecast.json",
            "content": {
                "title": "4. Почасовой лунный прогноз (GET /get_hourly_forecast)",
                "description": "Метод возвращает синхронный geocentric-прогноз на локальные сутки. В ответе есть почасовые положения Луны и основных планет, текущие аспекты Луны, окно `void of course`, лунный день и отметка «сатанинского» дня.",
                "endpoint": {
                    "method": "GET",
                    "url": "/api.php?action=get_hourly_forecast",
                    "content_type": "application/json"
                },
                "query_parameters": [
                    {
                        "name": "date",
                        "type": "string (YYYY-MM-DD)",
                        "required": true,
                        "description": "Локальная дата, для которой строится hourly-массив.",
                        "example": "2026-03-18"
                    },
                    {
                        "name": "city",
                        "type": "string",
                        "required": false,
                        "description": "Город для server-side геокодинга. Можно использовать вместо ручных координат.",
                        "example": "Москва"
                    },
                    {
                        "name": "country",
                        "type": "string",
                        "required": false,
                        "description": "Опциональное уточнение для `city`.",
                        "example": "Россия"
                    },
                    {
                        "name": "lat",
                        "type": "float",
                        "required": false,
                        "description": "Широта. Используется вместе с `lng` и `timezone`.",
                        "example": "55.7558"
                    },
                    {
                        "name": "lng",
                        "type": "float",
                        "required": false,
                        "description": "Долгота.",
                        "example": "37.6176"
                    },
                    {
                        "name": "timezone",
                        "type": "string",
                        "required": false,
                        "description": "IANA timezone. Обязательна при ручных координатах без `city`.",
                        "example": "Europe/Moscow"
                    },
                    {
                        "name": "api_key / X-API-Key",
                        "type": "string",
                        "required": true,
                        "description": "API-ключ для авторизации sync-endpoint."
                    }
                ],
                "feature_guidelines": [
                    "Диапазон ответа: от local `00:00` запрошенного дня до local `00:00` следующего дня включительно.",
                    "Астрономическая рамка: `geocentric`.",
                    "Если timezone содержит DST-переход, число точек может отличаться от 25, потому что сохраняются локальные календарные часы.",
                    "Повторный запрос по тем же `date + lat + lng + timezone` возвращается из JSON-cache без нового обращения к NASA JPL Horizons."
                ],
                "response_model": [
                    {
                        "name": "status",
                        "type": "string",
                        "description": "Статус синхронного ответа.",
                        "example": "success"
                    },
                    {
                        "name": "cached",
                        "type": "boolean",
                        "description": "Признак попадания в result-cache."
                    },
                    {
                        "name": "data.meta",
                        "type": "object",
                        "description": "Метаданные диапазона, локации, шага и источника эфемерид."
                    },
                    {
                        "name": "data.hours[]",
                        "type": "array<object>",
                        "description": "Почасовой массив результата."
                    }
                ],
                "hour_fields": [
                    {
                        "name": "hour_index",
                        "type": "integer",
                        "description": "Индекс точки внутри local-day массива."
                    },
                    {
                        "name": "local_datetime / utc_datetime",
                        "type": "ISO-8601 datetime",
                        "description": "Локальная и UTC-временные отметки часа."
                    },
                    {
                        "name": "moon",
                        "type": "object",
                        "description": "Положение Луны: longitude, latitude, sign, sign_degree, speed, is_retro."
                    },
                    {
                        "name": "planets",
                        "type": "object",
                        "description": "Geocentric-положения Солнца, Меркурия, Венеры, Марса, Юпитера, Сатурна, Урана, Нептуна и Плутона."
                    },
                    {
                        "name": "moon_aspects[]",
                        "type": "array<object>",
                        "description": "Текущие мажорные аспекты Луны к планетам: conjunction, sextile, square, trine, opposition."
                    },
                    {
                        "name": "lunar",
                        "type": "object",
                        "description": "Фаза Луны, возраст, лунный день, moonrise-коррекция, флаг `is_satanic`, `void_of_course`."
                    }
                ],
                "void_of_course_fields": [
                    {
                        "name": "is_void_now",
                        "type": "boolean",
                        "description": "Находится ли Луна без курса в текущей точке."
                    },
                    {
                        "name": "starts_at_local / ends_at_local",
                        "type": "ISO-8601 datetime",
                        "description": "Границы текущего или ближайшего окна void of course в локальном времени."
                    },
                    {
                        "name": "next_sign",
                        "type": "string",
                        "description": "Следующий знак Луны после выхода из текущего окна."
                    },
                    {
                        "name": "last_aspect / next_aspect_before_sign_change",
                        "type": "object|null",
                        "description": "Последний и ближайший мажорный аспект до смены знака."
                    }
                ],
                "caching_policy": {
                    "title": "Кэширование",
                    "description": "Метод использует двухуровневый кэш.",
                    "strategies": [
                        {
                            "data_type": "Результат hourly-forecast",
                            "ttl": "До инвалидирования входными параметрами",
                            "icon": "clock",
                            "desc": "JSON-cache по `date + lat + lng + timezone`."
                        },
                        {
                            "data_type": "Geocentric hourly ephemeris",
                            "ttl": "До повторного использования того же диапазона",
                            "icon": "database",
                            "desc": "Пакетный cache рядов NASA для всего диапазона и lookahead-окна."
                        }
                    ]
                },
                "examples": [
                    {
                        "language": "Bash (cURL)",
                        "description": "Запрос по координатам и timezone.",
                        "code": "curl -s \"https://digihash.ru/datacollector/api.php?action=get_hourly_forecast&date=2026-03-18&lat=55.7558&lng=37.6176&timezone=Europe/Moscow&api_key=655351024\""
                    },
                    {
                        "language": "Bash (cURL)",
                        "description": "Запрос по названию города с server-side геокодингом.",
                        "code": "curl -s \"https://digihash.ru/datacollector/api.php?action=get_hourly_forecast&date=2026-03-18&city=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0&country=%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D1%8F&api_key=655351024\""
                    }
                ]
            }
        },
        {
            "id": "04_methods_get",
            "title": "5. Получение результата (GET /get_result)",
            "description": "Модель опроса, статусы, view=summary|explain|raw для synthesis-задач.",
            "file_name": "doc_04_get_result.json",
            "content": {
                "title": "4. Получение результата (GET /get_result)",
                "description": "Метод возвращает статус задачи или финальные данные. Для synthesis-задач поддерживаются режимы view=summary|explain|raw.",
                "endpoint": {
                    "method": "GET",
                    "url": "/api.php?action=get_result",
                    "parameters": [
                        {
                            "name": "request_id",
                            "in": "query",
                            "required": true,
                            "type": "string",
                            "description": "ID задачи, полученный при create_task."
                        },
                        {
                            "name": "view",
                            "in": "query",
                            "required": false,
                            "type": "enum",
                            "values": [
                                "summary",
                                "explain",
                                "raw"
                            ],
                            "default": "summary",
                            "description": "Режим выдачи для synthesis-задач. Для legacy-ответа параметр игнорируется."
                        },
                        {
                            "name": "api_key",
                            "in": "query",
                            "required": false,
                            "type": "string",
                            "description": "Для приватных ключей обязателен (альтернатива: заголовок X-API-Key). Для публичного ключа 655351024 не требуется."
                        }
                    ]
                },
                "synthesis_views": [
                    {
                        "name": "summary",
                        "type": "режим",
                        "description": "Режим по умолчанию. Возвращает стабильный компактный слой: versioning, summary.scales, superpower, quality_score, health."
                    },
                    {
                        "name": "explain",
                        "type": "режим",
                        "description": "Расширенный слой объяснимости: domain_components, breakdown_short, conflicts, reliability_summary, model_health."
                    },
                    {
                        "name": "raw",
                        "type": "режим",
                        "description": "Отладочный режим. Возвращает полный raw_profile synthesis вместе с versioning и health."
                    }
                ],
                "feature_guidelines": {
                    "title": "Практика использования",
                    "list": [
                        "В прод-интеграциях по умолчанию используйте view=summary.",
                        "view=explain запрашивайте по требованию, когда нужно объяснить причины результата.",
                        "view=raw используйте только для диагностики и внутренней разработки.",
                        "Для подробного практического сценария см. раздел «5. Работа с Synthesis++ (IPSM v2)»."
                    ]
                },
                "polling_strategy": {
                    "recommendation": "Опрос каждые 2-3 секунды.",
                    "timeout": "Если задача долго не переходит в success/error, проверьте логи worker и/или создайте новую задачу.",
                    "flow_diagram": "Клиент -> GET get_result -> статус очереди -> success/error"
                },
                "statuses": [
                    {
                        "code": "pending",
                        "meaning": "Задача в очереди, ещё не взята worker-процессом."
                    },
                    {
                        "code": "processing",
                        "meaning": "Задача выполняется worker-процессом."
                    },
                    {
                        "code": "success",
                        "meaning": "Расчёт завершён, доступен финальный payload."
                    },
                    {
                        "code": "error",
                        "meaning": "Расчёт завершился ошибкой; поле error содержит текст или объект ошибки."
                    }
                ],
                "examples": {
                    "processing_response": {
                        "description": "Задача ещё не завершена.",
                        "payload": {
                            "status": "processing",
                            "message": "Calculation in progress..."
                        }
                    },
                    "success_response": {
                        "description": "Пример synthesis-ответа в режиме view=summary.",
                        "payload": {
                            "status": "success",
                            "view": "summary",
                            "schema_version": "export-1.0.0",
                            "calculation_version": "ipsm-2.0.0",
                            "weights_hash": "b7c5...",
                            "conflict_rules_version": "conflict-rules-2.0.0",
                            "normalization_version": "normalization-2.0.0",
                            "calc_profile_id": "A",
                            "request_id": "task_698cdc670473d",
                            "date": "2026-02-14",
                            "summary": {
                                "scales": {
                                    "control": -11.1,
                                    "cognition": 24.5,
                                    "dynamics": 8.3,
                                    "focus": 31.9,
                                    "social": -4.2
                                },
                                "superpower": "focus",
                                "quality_score": 87.4,
                                "conflicts_count": 0
                            },
                            "health": {
                                "analysis_time_ms": 148,
                                "memory_peak_mb": 18.25,
                                "observations_used": 126,
                                "observations_total": 151,
                                "aggregation_drift_detected": false
                            }
                        }
                    },
                    "error_response": {
                        "description": "Ошибка исполнения задачи.",
                        "payload": {
                            "status": "error",
                            "error": "[CRITICAL_EXTERNAL] Ephemeris NASA data unavailable"
                        }
                    }
                }
            }
        },
        {
            "id": "05_synthesis_usage",
            "title": "6. Работа с Synthesis++ (IPSM v2)",
            "description": "Практическая интеграция с каноническим слоем: выбор view, интерпретация шкал, конфликтов и экспорт в BI.",
            "file_name": "doc_05_synthesis_usage.json",
            "content": {
                "title": "5. Работа с Synthesis++ (IPSM v2)",
                "description": "Synthesis++ — канонический интерпретационный слой поверх numerology/astrology/bodygraph/forecast, включая MatrixDestiny22 как отдельный домен MATRIX_DESTINY. Он нужен, чтобы интеграции работали со стабильным контрактом (summary/explain/export), а не парсили сырой профиль модулей.",
                "synthesis_usage": {
                    "title": "Когда и зачем включать Synthesis++",
                    "list": [
                        "Добавляйте \"synthesis\" в systems, если нужен устойчивый слой аналитики для UI, BI и внешних моделей.",
                        "Используйте view=summary как основной прод-контракт: это минимальный, стабильный и дешёвый по объёму ответ.",
                        "Используйте view=explain только там, где нужно объяснение причин результата: доменные вклады, конфликты и топ-факторы.",
                        "Используйте view=raw только для диагностики, аудита и проверки изменений модели.",
                        "Для BI/витрин не парсите raw_profile вручную — используйте export_result с row_type."
                    ]
                },
                "lifecycle_steps": [
                    {
                        "step": 1,
                        "actor": "Клиент",
                        "action": "POST create_task",
                        "description": "Передайте api_key, user и systems с \"synthesis\". При необходимости добавьте forecast/current_location/response."
                    },
                    {
                        "step": 2,
                        "actor": "Клиент",
                        "action": "GET get_result&view=summary",
                        "description": "Получите стабильный результат: scales, superpower, quality_score, conflicts_count и health."
                    },
                    {
                        "step": 3,
                        "actor": "Клиент",
                        "action": "GET get_result&view=explain",
                        "description": "При запросе объяснимости получите domain_components, breakdown_short, conflicts, reliability_summary и model_health."
                    },
                    {
                        "step": 4,
                        "actor": "Клиент",
                        "action": "GET export_result",
                        "description": "Для BI-слоя выгружайте NDJSON/CSV: summary, domain_component и breakdown_item без дополнительного парсинга."
                    }
                ],
                "synthesis_views": [
                    {
                        "name": "summary",
                        "type": "режим",
                        "description": "Режим по умолчанию. Канонический слой: schema/calculation/weights версии, summary.scales, summary.superpower, summary.quality_score, summary.conflicts_count, health."
                    },
                    {
                        "name": "explain",
                        "type": "режим",
                        "description": "Расширенный слой причин: domain_components по шкалам, breakdown_short (top 3+/3-), conflicts с evidence, reliability_summary, model_health."
                    },
                    {
                        "name": "raw",
                        "type": "режим",
                        "description": "Отладочный режим. Возвращает полный raw_profile synthesis для внутренних проверок. Не использовать как внешний стабильный контракт."
                    }
                ],
                "root_parameters": [
                    {
                        "name": "summary.scales",
                        "type": "object",
                        "description": "Пять шкал IPSM v2 в диапазоне около -100..100: dynamics/control/cognition/focus/social."
                    },
                    {
                        "name": "summary.superpower",
                        "type": "string",
                        "description": "Ведущая шкала по формальному правилу max|score|; при конфликте HIGH возможен формат dual_mode_<scale>."
                    },
                    {
                        "name": "summary.quality_score",
                        "type": "number",
                        "description": "Интегральная оценка качества данных 0..100."
                    },
                    {
                        "name": "domain_components",
                        "type": "object",
                        "description": "Нормализованные вклады доменов по шкалам в том же пространстве, что и финальные score. Возможные домены: NUM, MATRIX_DESTINY, ASTRO, HD, TRANSITS, LUNAR, SPACE_WEATHER, RAZIEL."
                    },
                    {
                        "name": "breakdown_short",
                        "type": "object",
                        "description": "Короткое объяснение: топ-положительные и топ-отрицательные факторы по каждой шкале."
                    },
                    {
                        "name": "conflicts",
                        "type": "array",
                        "description": "Доменные конфликты с severity и доказательствами (evidence)."
                    },
                    {
                        "name": "reliability_summary",
                        "type": "object",
                        "description": "Метрики надёжности: simulated/status/missing, канонизация полей, удалённые дубли наблюдений, drift-флаги."
                    },
                    {
                        "name": "model_health",
                        "type": "object",
                        "description": "Диагностика консистентности модели и инвариантов агрегации."
                    }
                ],
                "feature_guidelines": {
                    "title": "Рекомендации по интеграции",
                    "list": [
                        "Всегда храните и проверяйте schema_version, calculation_version и weights_hash: это защита от тихих изменений логики.",
                        "Считайте summary единственным стабильным источником для ранжирования/фильтрации в интерфейсах.",
                        "Показывайте explain по требованию пользователя: это снижает объём трафика и сложность клиента.",
                        "Для матрицы судьбы используйте domain_components.*.MATRIX_DESTINY и breakdown_short с source MATRIX_DESTINY:*; не извлекайте выводы из картинки или порядка узлов.",
                        "Если quality_score низкий, учитывайте reliability_summary перед выводом жёстких рекомендаций.",
                        "Если нужно только темпоральное обновление, используйте response.omit_portrait_payload=true."
                    ]
                },
                "examples": [
                    {
                        "language": "Bash (cURL)",
                        "description": "Полный цикл: create_task с Synthesis++, затем чтение summary и explain.",
                        "code": "# 1) Создание задачи\nTASK=$(curl -s -X POST \"https://digihash.ru/datacollector/api.php?action=create_task\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Calc-Profile: A\" \\\n  -d '{\n    \"api_key\": \"655351024\",\n    \"user\": {\n      \"first_name\": \"Иван\",\n      \"last_name\": \"Иванов\",\n      \"birth_date\": \"1990-01-01\",\n      \"birth_time\": \"12:00\",\n      \"birth_city\": \"Москва\"\n    },\n    \"systems\": [\"forecast\", \"transits\", \"synthesis\"],\n    \"forecast\": {\n      \"period_type\": \"day\",\n      \"period_start_date\": \"2026-02-14\"\n    },\n    \"response\": {\n      \"omit_portrait_payload\": true\n    }\n  }')\n\nREQUEST_ID=$(echo \"$TASK\" | jq -r '.request_id')\n\n# 2) Канонический слой summary\ncurl -s \"https://digihash.ru/datacollector/api.php?action=get_result&request_id=$REQUEST_ID&view=summary\"\n\n# 3) Слой объяснимости explain\ncurl -s \"https://digihash.ru/datacollector/api.php?action=get_result&request_id=$REQUEST_ID&view=explain\""
                    },
                    {
                        "language": "PHP",
                        "description": "Пример опроса до success и безопасного переключения между view=summary и view=explain.",
                        "code": "<?php\n$api = 'https://digihash.ru/datacollector/api.php';\n$requestId = 'task_xxx';\n\nfor ($i = 0; $i < 60; $i++) {\n    sleep(2);\n    $summary = json_decode(file_get_contents($api . '?action=get_result&view=summary&request_id=' . urlencode($requestId)), true);\n\n    if (($summary['status'] ?? '') === 'success') {\n        $scales = $summary['summary']['scales'] ?? [];\n        $superpower = $summary['summary']['superpower'] ?? null;\n\n        // Explain запрашиваем только по требованию\n        $explain = json_decode(file_get_contents($api . '?action=get_result&view=explain&request_id=' . urlencode($requestId)), true);\n        $conflicts = $explain['conflicts'] ?? [];\n\n        print_r(['scales' => $scales, 'superpower' => $superpower, 'conflicts' => count($conflicts)]);\n        exit;\n    }\n\n    if (($summary['status'] ?? '') === 'error') {\n        throw new RuntimeException('Ошибка расчёта: ' . json_encode($summary['error'] ?? null, JSON_UNESCAPED_UNICODE));\n    }\n}\n\nthrow new RuntimeException('Таймаут ожидания результата');\n?>"
                    },
                    {
                        "language": "JavaScript (Fetch)",
                        "description": "Экспорт NDJSON в BI и разбор row_type без привязки к raw_profile.",
                        "code": "async function exportSynthesisNdjson(requestId) {\n  const url = `https://digihash.ru/datacollector/api.php?action=export_result&request_id=${encodeURIComponent(requestId)}&format=ndjson`;\n  const response = await fetch(url);\n  const text = await response.text();\n\n  const rows = text.trim().split('\\n').map(line => JSON.parse(line));\n  const summary = rows.find(r => r.row_type === 'summary');\n  const domainRows = rows.filter(r => r.row_type === 'domain_component');\n  const breakdownRows = rows.filter(r => r.row_type === 'breakdown_item');\n\n  return { summary, domainRows, breakdownRows };\n}"
                    }
                ]
            }
        },
        {
            "id": "05_response_models_1",
            "title": "7. Модели данных: астрология и транзиты",
            "description": "Ключевые структуры astrology/transits и базовые объекты планет/аспектов.",
            "file_name": "doc_05_models_astro.json",
            "content": {
                "title": "6. Модели данных: астрология и транзиты",
                "description": "Раздел описывает ключевые структуры для натальных и транзитных астрологических данных.",
                "common_models": {
                    "title": "Базовые объекты (Models)",
                    "PlanetObject": [
                        {
                            "name": "ecliptic_longitude_deg",
                            "type": "float",
                            "example": "322.6370",
                            "description": "Эклиптическая долгота (0..360)."
                        },
                        {
                            "name": "sign",
                            "type": "string",
                            "example": "aquarius",
                            "description": "Ключ знака зодиака."
                        },
                        {
                            "name": "sign_degree",
                            "type": "integer",
                            "example": "22",
                            "description": "Позиция внутри знака (0..29)."
                        },
                        {
                            "name": "is_retro",
                            "type": "boolean",
                            "example": "false",
                            "description": "Признак ретроградности."
                        },
                        {
                            "name": "hd",
                            "type": "object",
                            "description": "Маппинг Human Design (ворота/линия)."
                        }
                    ]
                },
                "systems_structure": {
                    "title": "Структура модулей astrology/transits",
                    "root": {
                        "schema_version": "string (например 2.2.1)",
                        "description": "Версия схемы верхнего блока systems для legacy-ветки."
                    },
                    "astrology": {
                        "description": "Натальная карта. Источник локации: SubjectContext (данные рождения).",
                        "structure_example": {
                            "status": "ok",
                            "data": {
                                "source": {
                                    "name": "NASA JPL Horizons",
                                    "type": "ephemeris"
                                },
                                "meta": {
                                    "calculated_for": "1981-10-27 04:13:00",
                                    "timezone": "Asia/Krasnoyarsk",
                                    "location_used": {
                                        "context": "subject"
                                    }
                                },
                                "planets": {
                                    "sun": {
                                        "$ref": "PlanetObject"
                                    },
                                    "north_node": {
                                        "$ref": "PlanetObject"
                                    },
                                    "south_node": {
                                        "$ref": "PlanetObject"
                                    }
                                },
                                "aspects": [
                                    {
                                        "p1": "sun",
                                        "p2": "moon",
                                        "aspect": "conjunction",
                                        "actual_angle_deg": 10.66,
                                        "quality_tone": "neutral"
                                    }
                                ]
                            }
                        }
                    },
                    "transits": {
                        "description": "Транзитная карта. Источник локации: TemporalContext (current_location/target_date).",
                        "structure_example": {
                            "status": "ok",
                            "data": {
                                "date": "2026-02-14 09:00:00",
                                "source": {
                                    "name": "NASA JPL Horizons",
                                    "type": "ephemeris"
                                },
                                "planets": {
                                    "sun": {
                                        "$ref": "PlanetObject"
                                    }
                                },
                                "aspects": [
                                    {
                                        "p1": "sun",
                                        "p2": "moon",
                                        "aspect": "sextile"
                                    }
                                ],
                                "meta": {
                                    "location_used": {
                                        "city": "Орел",
                                        "timezone": "Europe/Moscow"
                                    },
                                    "calculated_at_utc": "2026-02-14 09:00:00"
                                }
                            }
                        }
                    }
                },
                "dictionaries": {
                    "title": "Справочники",
                    "planet_keys": [
                        {
                            "key": "sun",
                            "label": "Солнце",
                            "desc": "Сознание, воля, самопрезентация"
                        },
                        {
                            "key": "moon",
                            "label": "Луна",
                            "desc": "Эмоции, реакции, внутренние состояния"
                        },
                        {
                            "key": "north_node",
                            "label": "Северный узел",
                            "desc": "Вектор развития"
                        },
                        {
                            "key": "south_node",
                            "label": "Южный узел",
                            "desc": "Накопленный опыт"
                        }
                    ]
                }
            }
        },
        {
            "id": "06_models_forecast",
            "title": "8. Модели данных: нумерология и прогноз",
            "description": "Структуры numerology/forecast и модель нового hourly-forecast ответа.",
            "file_name": "doc_06_models_forecast.json",
            "content": {
                "title": "7. Модели данных: нумерология и прогноз",
                "description": "Раздел описывает структуры модулей numerology и forecast с учетом разделения портретного и временного контекста.",
                "numerology_model": {
                    "description": "Блок response.systems.numerology.data может содержать портретные и/или временные значения в зависимости от systems и response.omit_portrait_payload.",
                    "fields": [
                        {
                            "name": "life_path",
                            "type": "integer",
                            "example": "2",
                            "desc": "Число жизненного пути (портретное)."
                        },
                        {
                            "name": "destiny",
                            "type": "integer",
                            "example": "7",
                            "desc": "Число судьбы (портретное)."
                        },
                        {
                            "name": "personal_year",
                            "type": "integer",
                            "example": "3",
                            "desc": "Персональный год для target_date."
                        },
                        {
                            "name": "personal_month",
                            "type": "integer",
                            "example": "8",
                            "desc": "Персональный месяц для target_date."
                        },
                        {
                            "name": "personal_day",
                            "type": "integer",
                            "example": "5",
                            "desc": "Персональный день для target_date."
                        },
                        {
                            "name": "chaldean",
                            "type": "object",
                            "desc": "Дневная ветка Халдейской системы (текущая локация + рассвет)."
                        },
                        {
                            "name": "vedic",
                            "type": "object",
                            "desc": "Дневная ветка Ведической системы (текущая локация + рассвет)."
                        },
                        {
                            "name": "matrix_destiny",
                            "type": "object",
                            "desc": "Старый компактный блок матрицы судьбы. Оставлен без изменений для обратной совместимости."
                        },
                        {
                            "name": "matrix_destiny_v2",
                            "type": "object",
                            "desc": "MatrixDestiny22 v2.1.0: basis, canonical, derived_experimental, meta. Корневые дубли core/nodes/lines/sectors/age_cycle/activation удалены; canonical — основной контракт, derived_experimental — explain-слой."
                        }
                    ]
                },
                "matrix_destiny_v2_model": {
                    "description": "matrix_destiny_v2 — портретный API-блок MatrixDestiny22 v2.1.0. Старый matrix_destiny не удаляется. Новый контракт очищен от корневых дублей: используйте canonical для стабильных интеграций и derived_experimental для объяснений/Synthesis++.",
                    "contract": {
                        "system_name": "MatrixDestiny22",
                        "version": "2.1.0",
                        "reduction_rule": "ladini_digit_sum_22",
                        "zero_maps_to": 22
                    },
                    "blocks": [
                        {
                            "name": "basis",
                            "description": "Исходные данные и правило расчета: birth_date, birth_time, calendar, arcana_range, reduction_rule=ladini_digit_sum_22, zero_maps_to=22."
                        },
                        {
                            "name": "canonical",
                            "description": "Официальный стабильный слой v2.1.0. Содержит canonical.core, canonical.age_nodes, canonical.generic_programs, canonical.channels и canonical.health_map. Это основной слой для внешних интеграций."
                        },
                        {
                            "name": "canonical.core",
                            "description": "Базовые якоря матрицы, совместимые со старым matrix_destiny: day_arcana, month_arcana, year_arcana, karma_tail_base, center_comfort, sky_line, earth_line. Каждый элемент содержит source_formula."
                        },
                        {
                            "name": "canonical.age_nodes",
                            "description": "Возрастные внешние узлы. Каждый узел имеет val и source_formula."
                        },
                        {
                            "name": "canonical.generic_programs",
                            "description": "Родовые линии male_line и female_line. Каждая линия содержит values и source_formula."
                        },
                        {
                            "name": "canonical.channels",
                            "description": "Каналы self_search, socialization и spiritual_exam. Каждый канал содержит итоговые значения и source_formula."
                        },
                        {
                            "name": "canonical.health_map",
                            "description": "Карта здоровья по отдельной формуле canonical-health-map-1.0.0. Каждая строка, включая total, содержит source_formula."
                        },
                        {
                            "name": "derived_experimental",
                            "description": "Производный слой для explain и Synthesis++: nodes, lines, sectors, age_cycle, interpretation, activation. Он не является каноном."
                        },
                        {
                            "name": "meta",
                            "description": "Метаданные расчета: canonical_mode, derived_experimental_mode, experimental_blocks, canonical_blocks, root_aliases_removed, source_mapping, health_map_formula_version."
                        }
                    ],
                    "example": {
                        "system_name": "MatrixDestiny22",
                        "version": "2.1.0",
                        "basis": {
                            "birth_date": "1981-10-27",
                            "birth_time": "04:13:00",
                            "calculation_mode": "portrait",
                            "calendar": "gregorian",
                            "arcana_range": "1..22",
                            "reduction_rule": "ladini_digit_sum_22",
                            "zero_maps_to": 22
                        },
                        "canonical": {
                            "core": {
                                "day_arcana": {
                                    "val": 9,
                                    "source_formula": "day(27) => 2+7=9"
                                },
                                "karma_tail_base": {
                                    "val": 11,
                                    "source_formula": "legacy-compatible karma_tail_base"
                                },
                                "center_comfort": {
                                    "val": 13,
                                    "source_formula": "day_arcana + month_arcana + year_arcana + karma_tail_base => 13"
                                },
                                "sky_line": {
                                    "val": 10
                                },
                                "earth_line": {
                                    "val": 21
                                }
                            },
                            "age_nodes": {
                                "upper_left_outer": {
                                    "val": 19,
                                    "source_formula": {
                                        "raw_expression": "day_arcana + month_arcana",
                                        "operands": [
                                            9,
                                            10
                                        ],
                                        "raw_result": 19,
                                        "normalized_result": 19,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                },
                                "upper_right_outer": {
                                    "val": 11,
                                    "source_formula": {
                                        "raw_expression": "month_arcana + year_arcana",
                                        "operands": [
                                            10,
                                            19
                                        ],
                                        "raw_result": 29,
                                        "normalized_result": 11,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                },
                                "lower_right_outer": {
                                    "val": 3,
                                    "source_formula": {
                                        "raw_expression": "year_arcana + karma_tail_base",
                                        "operands": [
                                            19,
                                            11
                                        ],
                                        "raw_result": 30,
                                        "normalized_result": 3,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                },
                                "lower_left_outer": {
                                    "val": 20,
                                    "source_formula": {
                                        "raw_expression": "karma_tail_base + day_arcana",
                                        "operands": [
                                            11,
                                            9
                                        ],
                                        "raw_result": 20,
                                        "normalized_result": 20,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                }
                            },
                            "generic_programs": {
                                "male_line": {
                                    "values": [
                                        19,
                                        3,
                                        22
                                    ],
                                    "source_formula": {
                                        "raw_expression": "upper_left_outer + lower_right_outer",
                                        "operands": [
                                            19,
                                            3
                                        ],
                                        "raw_result": 22,
                                        "normalized_result": 22,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                },
                                "female_line": {
                                    "values": [
                                        11,
                                        20,
                                        4
                                    ],
                                    "source_formula": {
                                        "raw_expression": "upper_right_outer + lower_left_outer",
                                        "operands": [
                                            11,
                                            20
                                        ],
                                        "raw_result": 31,
                                        "normalized_result": 4,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                }
                            },
                            "channels": {
                                "self_search": {
                                    "sky": 21,
                                    "earth": 10,
                                    "result": 4,
                                    "source_formula": {
                                        "raw_expression": "earth_line + sky_line",
                                        "operands": [
                                            21,
                                            10
                                        ],
                                        "raw_result": 31,
                                        "normalized_result": 4,
                                        "rule": "ladini_digit_sum_22"
                                    }
                                },
                                "socialization": {
                                    "male": 22,
                                    "female": 4,
                                    "result": 8
                                },
                                "spiritual_exam": {
                                    "value": 12
                                }
                            },
                            "health_map": {
                                "sahasrara": {
                                    "physics": 9,
                                    "energy": 10,
                                    "emotions": 19
                                },
                                "total": {
                                    "physics": 8,
                                    "energy": 15,
                                    "emotions": 14,
                                    "source_formula": {
                                        "physics": {
                                            "raw_expression": "sum(health_map.*.physics)",
                                            "operands": [
                                                9,
                                                4,
                                                22,
                                                8,
                                                13,
                                                5,
                                                19
                                            ],
                                            "raw_result": 80,
                                            "normalized_result": 8,
                                            "rule": "ladini_digit_sum_22"
                                        },
                                        "energy": {
                                            "raw_expression": "sum(health_map.*.energy)",
                                            "operands": [
                                                10,
                                                15,
                                                5,
                                                18,
                                                13,
                                                6,
                                                11
                                            ],
                                            "raw_result": 78,
                                            "normalized_result": 15,
                                            "rule": "ladini_digit_sum_22"
                                        },
                                        "emotions": {
                                            "raw_expression": "sum(health_map.*.emotions)",
                                            "operands": [
                                                19,
                                                19,
                                                9,
                                                8,
                                                8,
                                                11,
                                                3
                                            ],
                                            "raw_result": 77,
                                            "normalized_result": 14,
                                            "rule": "ladini_digit_sum_22"
                                        }
                                    }
                                }
                            }
                        },
                        "derived_experimental": {
                            "nodes": "...",
                            "lines": "...",
                            "sectors": "...",
                            "interpretation": "...",
                            "activation": "..."
                        },
                        "meta": {
                            "canonical_mode": "matrix_destiny_22_canonical",
                            "compatibility_goal": "common_calculator_consistency",
                            "health_map_formula_version": "canonical-health-map-1.0.0",
                            "root_aliases_removed": true,
                            "derived_experimental_mode": "non_canonical_explain_layer",
                            "experimental_blocks": [
                                "nodes",
                                "lines",
                                "sectors",
                                "age_cycle",
                                "interpretation",
                                "activation"
                            ],
                            "canonical_blocks": [
                                "core",
                                "age_nodes",
                                "generic_programs",
                                "channels",
                                "health_map"
                            ]
                        }
                    }
                },
                "forecast_model": {
                    "description": "Блок response.systems.forecast.data содержит описание периода и массив дней (days[]).",
                    "period_fields": [
                        {
                            "name": "type",
                            "type": "string",
                            "values": [
                                "day",
                                "week",
                                "month"
                            ],
                            "description": "Тип запрошенного периода."
                        },
                        {
                            "name": "start_date",
                            "type": "string",
                            "example": "2026-02-14",
                            "description": "Дата начала периода (локальная дата temporal timezone)."
                        },
                        {
                            "name": "end_date",
                            "type": "string",
                            "example": "2026-02-20",
                            "description": "Дата окончания периода (включительно)."
                        },
                        {
                            "name": "anchor_datetime",
                            "type": "string (ISO-8601)",
                            "example": "2026-02-14T12:00:00+03:00",
                            "description": "Опорный момент расчета в temporal timezone."
                        }
                    ],
                    "day_fields": [
                        {
                            "name": "date",
                            "type": "string (YYYY-MM-DD)",
                            "description": "Дата конкретного дня прогноза."
                        },
                        {
                            "name": "numerology",
                            "type": "object",
                            "description": "Дневная нумерология, персональные числа и matrix_destiny_activation для даты."
                        },
                        {
                            "name": "biorhythms",
                            "type": "object",
                            "description": "Биоритмы дня в диапазоне -100..100."
                        },
                        {
                            "name": "lunar",
                            "type": "object",
                            "description": "Лунные параметры дня."
                        },
                        {
                            "name": "transits",
                            "type": "object",
                            "description": "Транзитные положения/аспекты для дня."
                        },
                        {
                            "name": "space_weather",
                            "type": "object",
                            "description": "Космическая погода (Kp и качество данных)."
                        },
                        {
                            "name": "extensions",
                            "type": "object",
                            "description": "Дополнительные расширения (например, raziel_wisdom)."
                        },
                        {
                            "name": "meta",
                            "type": "object",
                            "description": "Служебная информация о фактически использованной локации и качестве расчетного дня."
                        }
                    ],
                    "day_space_weather_fields": [
                        {
                            "name": "status",
                            "type": "string",
                            "example": "ok",
                            "description": "Статус блока космической погоды (ok|degraded)."
                        },
                        {
                            "name": "data_quality",
                            "type": "string",
                            "example": "observed",
                            "description": "Качество данных: observed | estimated | simulated."
                        },
                        {
                            "name": "kp_index.value",
                            "type": "float",
                            "description": "Текущее значение Kp."
                        },
                        {
                            "name": "meta.is_simulated",
                            "type": "boolean",
                            "description": "Признак fallback-значения. При true данные считаются симулированными."
                        },
                        {
                            "name": "meta.source_mode",
                            "type": "string",
                            "example": "observed_or_estimated",
                            "description": "Режим, запрошенный клиентом: allow_simulated | observed_or_estimated | observed_only."
                        }
                    ],
                    "day_meta_fields": [
                        {
                            "name": "location_used.city",
                            "type": "string",
                            "description": "Фактически использованный город для daily-вычислений."
                        },
                        {
                            "name": "location_used.lat",
                            "type": "float",
                            "description": "Широта фактической локации."
                        },
                        {
                            "name": "location_used.lng",
                            "type": "float",
                            "description": "Долгота фактической локации."
                        },
                        {
                            "name": "location_used.timezone",
                            "type": "string",
                            "description": "Фактическая таймзона вычислений."
                        }
                    ],
                    "structure_example": {
                        "period": {
                            "type": "week",
                            "start_date": "2026-02-14",
                            "end_date": "2026-02-20",
                            "anchor_datetime": "2026-02-14T12:00:00+03:00"
                        },
                        "days": [
                            {
                                "date": "2026-02-14",
                                "numerology": {
                                    "personal_year": 3,
                                    "personal_month": 8,
                                    "personal_day": 5,
                                    "matrix_destiny_activation": {
                                        "date": "2026-02-14",
                                        "active_arcana": [
                                            5,
                                            8,
                                            14
                                        ],
                                        "matched_nodes": [
                                            "center"
                                        ],
                                        "matched_lines": [
                                            "vertical_line"
                                        ],
                                        "matched_sectors": [
                                            "purpose"
                                        ],
                                        "conflict_nodes": [],
                                        "resonance_score": 0.42,
                                        "state": "resonant"
                                    },
                                    "vedic": [],
                                    "chaldean": []
                                },
                                "biorhythms": {
                                    "physical": 17,
                                    "emotional": -24,
                                    "intellectual": 63
                                },
                                "space_weather": {
                                    "status": "ok",
                                    "data_quality": "estimated",
                                    "kp_index": {
                                        "value": 4,
                                        "unit": "Kp"
                                    },
                                    "meta": {
                                        "is_simulated": false,
                                        "source_mode": "observed_or_estimated"
                                    }
                                },
                                "meta": {
                                    "location_used": {
                                        "city": "Орел",
                                        "lat": 52.9686,
                                        "lng": 36.0693,
                                        "timezone": "Europe/Moscow"
                                    }
                                }
                            }
                        ]
                    }
                }
            }
        },
        {
            "id": "07_errors_troubleshooting",
            "title": "9. Ошибки и диагностика",
            "description": "Http status codes, внутренние ошибки worker и практические рекомендации.",
            "file_name": "doc_07_errors.json",
            "content": {
                "title": "8. Коды ошибок и решение проблем",
                "description": "API использует HTTP-коды для синхронных ошибок и статусные поля в JSON для асинхронного жизненного цикла задач.",
                "http_status_codes": [
                    {
                        "code": 200,
                        "meaning": "OK",
                        "desc": "Успешный синхронный ответ (например, get_result/get_spec/get_reference)."
                    },
                    {
                        "code": 202,
                        "meaning": "Accepted",
                        "desc": "create_task: задача поставлена в очередь."
                    },
                    {
                        "code": 400,
                        "meaning": "Bad Request",
                        "desc": "Неверный JSON, отсутствует request_id или ошибка валидации обязательных полей."
                    },
                    {
                        "code": 401,
                        "meaning": "Unauthorized",
                        "desc": "api_key отсутствует/невалиден в create_task или не передан для приватного request_id в get_result/export_result."
                    },
                    {
                        "code": 403,
                        "meaning": "Forbidden",
                        "desc": "Передан неверный ключ для приватного request_id или нет доступа к run_worker (не localhost и нет валидного X-Worker-Token)."
                    },
                    {
                        "code": 404,
                        "meaning": "Not Found",
                        "desc": "Задача по request_id не найдена."
                    },
                    {
                        "code": 405,
                        "meaning": "Метод не разрешен",
                        "desc": "Использован неверный HTTP-метод."
                    },
                    {
                        "code": 409,
                        "meaning": "Conflict",
                        "desc": "export_result: задача еще не готова к экспорту."
                    },
                    {
                        "code": 429,
                        "meaning": "Too Many Requests",
                        "desc": "Сработал rate limiter (есть заголовок Retry-After)."
                    },
                    {
                        "code": 500,
                        "meaning": "Internal Server Error",
                        "desc": "Критическая ошибка API-обработчика."
                    }
                ],
                "task_internal_errors": {
                    "description": "Ошибки, которые worker записывает в результат задачи (status=error).",
                    "common_messages": [
                        {
                            "error": "[CRITICAL_EXTERNAL] Ephemeris NASA data unavailable",
                            "cause": "Внешний источник эфемерид недоступен или вернул невалидные данные.",
                            "solution": "Сервис выполняет до 5 попыток с паузами. Если неуспешно — задача завершается ошибкой без частичного результата."
                        },
                        {
                            "error": "[CRITICAL_EXTERNAL] GeoProvider timezone unavailable",
                            "cause": "Не удалось определить таймзону/координаты через внешние geo-сервисы.",
                            "solution": "Проверьте корректность current_location/birth_city и доступность внешних API."
                        },
                        {
                            "error": "Portrait context is missing",
                            "cause": "Поврежденный или неполный portrait-кеш.",
                            "solution": "Пересоздайте задачу; при повторе проверьте целостность portrait-данных на сервере."
                        }
                    ]
                },
                "troubleshooting_faq": [
                    {
                        "problem": "space_weather показывает simulated данные",
                        "diagnosis": "Использован fallback-режим или нет наблюдаемых данных для окна расчета.",
                        "action": "Проверяйте data_quality/meta.is_simulated. Для строгого режима используйте forecast.space_weather_mode=observed_only."
                    },
                    {
                        "problem": "run_worker возвращает 403",
                        "diagnosis": "Это ожидаемо для внешних клиентов без локального доступа/токена.",
                        "action": "Не используйте run_worker из публичного фронта; запуск worker выполняется инфраструктурой сервера."
                    },
                    {
                        "problem": "get_result/export_result возвращает 401 или 403",
                        "diagnosis": "Задача создана приватным ключом и для чтения не передан ключ, либо передан другой ключ.",
                        "action": "Передайте тот же API-ключ через X-API-Key или query api_key, которым создавалась задача."
                    },
                    {
                        "problem": "Задача долго в processing",
                        "diagnosis": "Ожидание внешних источников или тяжелый расчет большого периода.",
                        "action": "Проверьте app.log/worker.log и попробуйте уменьшить состав systems или период forecast."
                    },
                    {
                        "problem": "Экспорт возвращает 409",
                        "diagnosis": "Расчет еще не завершен статусом success.",
                        "action": "Продолжайте polling get_result до success, затем вызывайте export_result."
                    }
                ]
            }
        },
        {
            "id": "08_integration_examples",
            "title": "10. Примеры интеграции",
            "description": "Практические примеры create/get, hourly-forecast, view-режимов и export_result.",
            "file_name": "doc_08_examples.json",
            "content": {
                "title": "9. Примеры интеграции",
                "description": "Базовые примеры create_task, polling get_result, режимов view для synthesis и экспорта NDJSON/CSV. Подробные правила работы с синергией см. в разделе 5.",
                "examples": [
                    {
                        "language": "Bash (cURL)",
                        "description": "Базовый сценарий: create_task + get_result (view=summary).",
                        "code": "# 1) Создать задачу\nRESPONSE=$(curl -s -X POST \"https://digihash.ru/datacollector/api.php?action=create_task\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Calc-Profile: B\" \\\n  -d '{\n    \"api_key\": \"655351024\",\n    \"user\": {\n      \"first_name\": \"Иван\",\n      \"last_name\": \"Иванов\",\n      \"birth_date\": \"1990-01-01\",\n      \"birth_time\": \"12:00\",\n      \"birth_city\": \"Москва\"\n    },\n    \"systems\": [\"forecast\", \"synthesis\"],\n    \"forecast\": {\n      \"period_type\": \"day\",\n      \"period_start_date\": \"2026-02-14\"\n    }\n  }')\n\necho \"$RESPONSE\"\nTASK_ID=$(echo \"$RESPONSE\" | jq -r '.request_id')\n\n# 2) Опрос результата\nsleep 3\ncurl -s \"https://digihash.ru/datacollector/api.php?action=get_result&request_id=$TASK_ID&view=summary\""
                    },
                    {
                        "language": "Bash (cURL)",
                        "description": "Получение explain-режима и экспорт NDJSON.",
                        "code": "# Explain-слой synthesis\ncurl -s \"https://digihash.ru/datacollector/api.php?action=get_result&request_id=task_123&view=explain\"\n\n# Экспорт NDJSON\ncurl -s \"https://digihash.ru/datacollector/api.php?action=export_result&request_id=task_123&format=ndjson\""
                    },
                    {
                        "language": "Bash (cURL)",
                        "description": "Доступ к приватному request_id через заголовок X-API-Key.",
                        "code": "# Приватный get_result\ncurl -s \"https://digihash.ru/datacollector/api.php?action=get_result&request_id=task_private_123&view=summary\" \\\n  -H \"X-API-Key: your_private_key\"\n\n# Приватный export_result\ncurl -s \"https://digihash.ru/datacollector/api.php?action=export_result&request_id=task_private_123&format=ndjson\" \\\n  -H \"X-API-Key: your_private_key\""
                    },
                    {
                        "language": "PHP",
                        "description": "Пример с опросом результата и переключением view.",
                        "code": "<?php\n$apiUrl = 'https://digihash.ru/datacollector/api.php';\n$requestId = 'task_123';\n\nfor ($i = 0; $i < 30; $i++) {\n    sleep(2);\n    $result = json_decode(file_get_contents($apiUrl . '?action=get_result&request_id=' . urlencode($requestId) . '&view=summary'), true);\n\n    if (($result['status'] ?? '') === 'success') {\n        // Для synthesis-задачи это канонический слой summary\n        print_r($result['summary'] ?? []);\n\n        // При необходимости запрашиваем расширенное объяснение\n        $explain = json_decode(file_get_contents($apiUrl . '?action=get_result&request_id=' . urlencode($requestId) . '&view=explain'), true);\n        print_r($explain['domain_components'] ?? []);\n        exit;\n    }\n\n    if (($result['status'] ?? '') === 'error') {\n        throw new RuntimeException('Ошибка worker: ' . json_encode($result['error'] ?? null, JSON_UNESCAPED_UNICODE));\n    }\n}\n\nthrow new RuntimeException('Превышено время ожидания результата');\n?>"
                    },
                    {
                        "language": "JavaScript (Fetch)",
                        "description": "Фронтенд-опрос с view=summary и последующим экспортом csv.",
                        "code": "async function getSynthesisAndExport(requestId) {\n  const base = 'https://digihash.ru/datacollector/api.php';\n\n  const summaryRes = await fetch(`${base}?action=get_result&request_id=${encodeURIComponent(requestId)}&view=summary`);\n  const summary = await summaryRes.json();\n\n  if (summary.status !== 'success') {\n    throw new Error(`Задача еще не готова: ${summary.status}`);\n  }\n\n  const csvRes = await fetch(`${base}?action=export_result&request_id=${encodeURIComponent(requestId)}&format=csv`);\n  const csvText = await csvRes.text();\n  return { summary, csvText };\n}"
                    }
                ]
            }
        },
        {
            "id": "09_response_map",
            "title": "11. Полная карта ответа",
            "description": "Карта полей для async-задач и ссылка на структуру hourly-forecast ответа.",
            "file_name": "doc_09_response_map.json",
            "content": {
                "title": "10. Полная карта ответа",
                "description": "Карта полей для get_result и export_result. Для synthesis-задач основной рабочий контракт: view=summary, расширение: view=explain, отладка: view=raw.",
                "response_map_tree": {
                    "status": {
                        "type": "Строка",
                        "desc": "Статус задачи: pending | processing | success | error"
                    },
                    "request_id": {
                        "type": "Строка",
                        "desc": "ID задачи."
                    },
                    "message": {
                        "type": "Строка",
                        "desc": "Сообщение прогресса для pending/processing."
                    },
                    "error": {
                        "type": "Строка | Объект",
                        "desc": "Описание ошибки для status=error."
                    },
                    "view": {
                        "type": "Строка",
                        "desc": "Режим synthesis-ответа: summary | explain | raw."
                    },
                    "schema_version": {
                        "type": "Строка",
                        "desc": "Версия экспортного контракта (например export-1.0.0)."
                    },
                    "calculation_version": {
                        "type": "Строка",
                        "desc": "Версия вычислительной логики synthesis."
                    },
                    "weights_hash": {
                        "type": "Строка",
                        "desc": "SHA-256 хеш весов/конфигов расчета."
                    },
                    "conflict_rules_version": {
                        "type": "Строка",
                        "desc": "Версия правил детекции конфликтов."
                    },
                    "normalization_version": {
                        "type": "Строка",
                        "desc": "Версия правил нормализации признаков."
                    },
                    "calc_profile_id": {
                        "type": "Строка",
                        "desc": "Идентификатор calc profile: A или B."
                    },
                    "date": {
                        "type": "Строка (YYYY-MM-DD)",
                        "desc": "Дата расчета/экспорта."
                    },
                    "summary": {
                        "type": "Объект",
                        "desc": "Краткий канонический блок synthesis. Доступен в view=summary и view=explain.",
                        "children": {
                            "scales": {
                                "type": "Объект",
                                "desc": "Пять шкал synthesis (числа в диапазоне примерно -100..100)."
                            },
                            "superpower": {
                                "type": "Строка",
                                "desc": "Формально определенная ведущая шкала (или dual_mode_*)."
                            },
                            "quality_score": {
                                "type": "Число",
                                "desc": "Сводный показатель качества данных 0..100."
                            },
                            "conflicts_count": {
                                "type": "Целое",
                                "desc": "Количество детектированных конфликтов."
                            }
                        }
                    },
                    "health": {
                        "type": "Объект",
                        "desc": "Операционные метрики расчета.",
                        "children": {
                            "analysis_time_ms": {
                                "type": "Целое",
                                "desc": "Время анализа в миллисекундах."
                            },
                            "memory_peak_mb": {
                                "type": "Число",
                                "desc": "Пиковое потребление памяти в MB."
                            },
                            "observations_used": {
                                "type": "Целое",
                                "desc": "Количество наблюдений, реально вошедших в расчеты."
                            },
                            "observations_total": {
                                "type": "Целое",
                                "desc": "Общее число извлеченных наблюдений."
                            },
                            "aggregation_drift_detected": {
                                "type": "Булево",
                                "desc": "Признак дрейфа между финальной шкалой и доменными компонентами."
                            }
                        }
                    },
                    "domain_components": {
                        "type": "Объект",
                        "desc": "Доступно в view=explain: нормализованные доменные компоненты по шкалам."
                    },
                    "breakdown_short": {
                        "type": "Объект",
                        "desc": "Доступно в view=explain: топ-3 положительных и отрицательных факторов по каждой шкале."
                    },
                    "conflicts": {
                        "type": "Массив[Объект]",
                        "desc": "Доступно в view=explain: конфликты с evidence."
                    },
                    "reliability_summary": {
                        "type": "Объект",
                        "desc": "Доступно в view=explain: расширенный отчет по надежности данных."
                    },
                    "model_health": {
                        "type": "Объект",
                        "desc": "Доступно в view=explain: инварианты/согласованность модели."
                    },
                    "raw_profile": {
                        "type": "Объект",
                        "desc": "Доступно в view=raw: полный профиль synthesis (для отладки)."
                    },
                    "systems": {
                        "type": "Объект",
                        "desc": "Ветка для задач без synthesis."
                    },
                    "systems.numerology.data.matrix_destiny_v2": {
                        "type": "Объект",
                        "desc": "MatrixDestiny22 v2.1.0: basis, canonical, derived_experimental, meta. Корневые дубли core/nodes/lines/sectors/age_cycle/activation удалены из контракта."
                    },
                    "systems.forecast.data.days[].numerology.matrix_destiny_activation": {
                        "type": "Объект",
                        "desc": "Дневная активация матрицы судьбы на target_date: active_arcana, matched_nodes, matched_lines, matched_sectors, conflict_nodes, resonance_score, state."
                    },
                    "domain_components.*.MATRIX_DESTINY": {
                        "type": "Число",
                        "desc": "Вклад матрицы судьбы в Synthesis++ explain. Домен добавляется отдельно от NUM."
                    },
                    "warnings": {
                        "type": "Массив[Строка]",
                        "desc": "Глобальные предупреждения worker-а (если есть)."
                    },
                    "systems.numerology.data.matrix_destiny_v2.version": {
                        "type": "Строка",
                        "desc": "Версия MatrixDestiny22. Для нового канонического контракта значение равно 2.1.0."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical": {
                        "type": "Объект",
                        "desc": "Официальный стабильный слой MatrixDestiny22 v2.1.0. Основной источник для внешних интеграций и аудита значений."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.core": {
                        "type": "Объект",
                        "desc": "Базовые якоря, совместимые с legacy matrix_destiny: day_arcana, month_arcana, year_arcana, karma_tail_base, center_comfort, sky_line, earth_line."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.age_nodes": {
                        "type": "Объект",
                        "desc": "Возрастные внешние узлы upper_left_outer, upper_right_outer, lower_right_outer, lower_left_outer."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.generic_programs": {
                        "type": "Объект",
                        "desc": "Родовые линии male_line и female_line с каноническими значениями и source_formula."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.channels": {
                        "type": "Объект",
                        "desc": "Каналы self_search, socialization, spiritual_exam. В self_search sky берется из earth_line, earth берется из sky_line."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.health_map": {
                        "type": "Объект",
                        "desc": "Карта здоровья по независимой формуле canonical-health-map-1.0.0: sahasrara, ajna, vishuddha, anahata, manipura, svadhisthana, muladhara, total."
                    },
                    "systems.numerology.data.matrix_destiny_v2.derived_experimental": {
                        "type": "Объект",
                        "desc": "Производный слой для explain и Synthesis++: nodes, lines, sectors, interpretation, activation. Не является каноническим источником базовых значений."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.canonical_mode": {
                        "type": "Строка",
                        "desc": "Режим канонического расчета. Ожидаемое значение: matrix_destiny_22_canonical."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.health_map_formula_version": {
                        "type": "Строка",
                        "desc": "Версия формулы карты здоровья. Текущее значение: canonical-health-map-1.0.0."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.age_nodes.*.source_formula": {
                        "type": "Объект",
                        "desc": "Формула расчета канонического возрастного узла."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.generic_programs.*.source_formula": {
                        "type": "Объект",
                        "desc": "Формула расчета канонической родовой линии."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.channels.*.source_formula": {
                        "type": "Объект",
                        "desc": "Формула расчета канонического канала."
                    },
                    "systems.numerology.data.matrix_destiny_v2.canonical.health_map.*.source_formula": {
                        "type": "Объект",
                        "desc": "Формула расчета строки карты здоровья. Есть и у total."
                    },
                    "systems.numerology.data.matrix_destiny_v2.derived_experimental.age_cycle": {
                        "type": "Объект",
                        "desc": "Возрастной контур в производном explain-слое."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.derived_experimental_mode": {
                        "type": "Строка",
                        "desc": "Явный признак, что derived_experimental не является каноном. Ожидаемое значение: non_canonical_explain_layer."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.experimental_blocks": {
                        "type": "Массив[Строка]",
                        "desc": "Список блоков derived_experimental."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.canonical_blocks": {
                        "type": "Массив[Строка]",
                        "desc": "Список блоков canonical."
                    },
                    "systems.numerology.data.matrix_destiny_v2.meta.root_aliases_removed": {
                        "type": "Булево",
                        "desc": "true означает, что корневые дубли core/nodes/lines/sectors/age_cycle/activation удалены."
                    }
                },
                "synthesis_usage": {
                    "title": "Как работать с синтезом, а не с сырыми данными",
                    "list": [
                        "Используйте summary как основной интерфейс для UI и автоматических интеграций.",
                        "Используйте explain для объяснения причин результата и анализа конфликтов.",
                        "Не стройте прод-контракт на raw_profile: это внутренний отладочный слой.",
                        "Для BI и отчетности используйте export_result (ndjson/csv) с row_type.",
                        "Пошаговая практика интеграции вынесена в отдельный раздел «5. Работа с Synthesis++ (IPSM v2)»."
                    ]
                },
                "examples": {
                    "export_ndjson_rows": {
                        "description": "Типы строк NDJSON в export_result.",
                        "payload": [
                            {
                                "row_type": "summary",
                                "request_id": "task_abc",
                                "date": "2026-02-14",
                                "calculation_version": "ipsm-2.0.0",
                                "weights_hash": "...",
                                "scales": {
                                    "focus": 31.9
                                },
                                "superpower": "focus",
                                "quality_score": 87.4
                            },
                            {
                                "row_type": "domain_component",
                                "request_id": "task_abc",
                                "date": "2026-02-14",
                                "scale": "social",
                                "domain": "ASTRO",
                                "component": 12.3
                            },
                            {
                                "row_type": "breakdown_item",
                                "request_id": "task_abc",
                                "date": "2026-02-14",
                                "scale": "cognition",
                                "sign": "positive",
                                "rank": 1,
                                "domain": "TRANSITS",
                                "source": "sun_aquarius",
                                "json_path": "systems.forecast.days[0].transits.planets.sun.sign",
                                "contribution": 18.4,
                                "weight": 0.84,
                                "reliability": 1
                            }
                        ]
                    }
                }
            }
        }
    ]
}