EE DataCollector API — асинхронный сервис эзотерической аналитики. Система разделяет SubjectContext (натальный портрет) и TemporalContext (прогнозный момент), что исключает смешивание контекстов и коллизии кэша.

# 1. Введение

2.2.0

2026-02-14

# Ключевые изменения

Разделены домены данных: портретные константы и темпоральные расчёты.

Добавлен канонический слой Synthesis++ с режимами view=summary|explain|raw.

Добавлен export_result (ndjson/csv) для BI и мониторинга.

Добавлен versioning-слой: schema_version, calculation_version, weights_hash, conflict_rules_version, normalization_version.

Добавлен calc_profile (A/B) через header/query/body.

Для приватных ключей get_result/export_result требуют API-ключ; для публичного тестового ключа доступ по request_id остаётся открытым.

# Сводная информация

https://digihash.ru/datacollector/api.php

2.2.0

HTTPS / JSON

# Возможности системы

  • Асинхронная очередь задач: create_task возвращает request_id, расчёт выполняет worker.
  • Контекстная изоляция SubjectContext/TemporalContext во всех вычислениях.
  • Поддержка прогнозных периодов day/week/month.
  • Канонический слой Synthesis++ для интерпретации и explainability.
  • Режим критического отказа для внешних ошибок: при CRITICAL_EXTERNAL сервис не отдаёт частичный успех.

# Архитектура решения

Этапы жизненного цикла

1

Клиент POST create_task

Передаёт user, systems и при необходимости forecast/current_location/response/calc_profile.

2

API Постановка в очередь

Создаётся queued-задача и возвращается request_id.

3

Worker Расчёт модулей

Выполняет расчёты, сохраняет итог и устанавливает success/error.

4

Клиент GET get_result

Опрос каждые 2-3 секунды до финального результата.

# Режим Synthesis++

List

  • summary — основной стабильный контракт для UI/сервисов.
  • explain — расширенный слой причин и качества данных.
  • raw — только для отладки и внутренних проверок.
  • export_result — канонический экспортный слой для BI.

Политика кеширования

# Модель хранения и кэширования

Кэш и результаты разделены по доменам данных. В публичном API файловые пути кэша не раскрываются.

Портретные данные
Постоянно

Натальные неизменяемые данные пользователя (SubjectContext).

Прогнозные данные
Постоянно

Временные прогнозы для target_date/target_time/current_location (TemporalContext).

Глобальные транзиты
Постоянно

Геоцентрическая база транзитов общего назначения как инфраструктурный слой.

# Технические требования

List

  • Формат обмена: JSON
  • Кодировка: UTF-8
  • Дата: YYYY-MM-DD
  • Время: HH:MM или HH:MM:SS
  • Все запросы выполняются по HTTPS