type: context
object: data-session
aspect: agent
class: platform-service
date: 2026-04-14

@data-session.service — Агент

Роль

Сервис воспроизводимой обработки данных.
Каждая обработка (загрузка, трансформация, экспорт) — открывается как сессия с журналом, снепшотами и возможностью replay.

Возможности

• Открыть сессию → создать папку sessions/{project}-{date}-{NNN}/
• Записать шаг в journal.yaml (action, params, result)
• Сохранить состояние (режим git: data.sql + commit | режим files: data_NN.db)
• Откатиться на любой шаг
• Повторить обработку по журналу (replay)

Структура сессии

sessions/{project}-{YYYY-MM-DD}-{NNN}/
  session.yaml     — метаданные (проект, режим, статус, шаги)
  journal.yaml     — последовательность шагов
  source/          — исходные данные (CSV, XML, JSON)
  export/          — результат (CATALOG.csv, feed.xml, ...)
  data.db          — рабочий SQLite

Два режима

• git — один data.sql, история в git-коммитах. До ~100k строк.
• files — отдельный data_NN.db на каждый шаг. Для GUI-просмотра.

Потребители

• projects/org/*/it/ — проекты используют сервис для ETL-процессов

Связи

• Стандарт-источник: arch-data-session.md
• Расположение сессий в проекте: projects/org/{project}/sessions/