replay-parser-2

Русский · English

Rust-парсер OCAP-реплеев для Solid Stats — статистики игр сообщества Solid Games (ArmA 3). Превращает OCAP JSON-реплеи в компактные, детерминированные, версионируемые артефакты, которые server-2 хранит, аудирует на уровне вклада в статистику и использует для публичных показателей. Замена legacy-парсера на Rust.

Главный принцип v1 — артефакт по умолчанию сокращает данные реплея: OCAP-файл на 10–15 МБ не должен превращаться в ещё один JSON на 10–15 МБ на обычном пути загрузки.

Часть многорепной платформы: поиск сырых реплеев — в replays-fetcher, хранение бизнес-состояния, API и оркестрация задач — в server-2, веб-интерфейс — в web, рантайм и операции — в infrastructure. replay-parser-2 владеет только разбором и контрактом выходного артефакта; каноническая идентичность игроков остаётся за server-2.

Solid Stats от и до строят AI-агенты по процессу GSD. Разработка вне GSD — вне процесса.

Статус

Веха v1.0 завершена и заархивирована: контракт артефакта 3.0.0, режим CLI и воркер RabbitMQ/S3 поставлены, строгие гейты качества на месте. Текущий фокус — ожидание определения следующей вехи.

Быстрый старт

Сборка и разбор одного реплея в минимальный JSON:

cargo build --release
replay-parser-2 parse path/to/replay.json --output path/to/artifact.json

Запуск воркера (читает задачи RabbitMQ, сырые объекты S3, пишет артефакты и публикует parse.completed / parse.failed):

replay-parser-2 worker

Гейт качества воркспейса:

cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Полный список команд, опций воркера, деплоя и гейтов покрытия — в docs/parser-reference.md.

Документация

• docs/parser-reference.md — контракт артефакта, CLI и воркер, деплой, гейты качества, данные валидации, история приёмки v1.0.
• .planning/ — продуктовый контекст, требования, роадмап и состояние (GSD).
• gsd-briefs/ — брифы проектов replays-fetcher, replay-parser-2, server-2, web.

Стек

Rust 2024 (1.95) · Cargo workspace · serde / serde_json · schemars · tokio · lapin (RabbitMQ) · aws-sdk-s3 · tracing

Лицензия — MIT