food-simulation-sdk 0.1.0

A deterministic and explainable SDK for modeling culinary processes.

Food Simulation Platform

Food Simulation Platform — рабочее название независимой платформы для описания и исполнения кулинарных процессов. Её поставляемое разработчикам ядро называется Food Simulation SDK.

Текущий статус

• Этап: A9 — Hardening and Release.
• Состояние: A1–A9 и Gate A завершены; готовится подписанный публичный release SDK 0.1.0.
• Производственный код: готовы immutable domain boundary, embedded schemas и Knowledge Pack, injected facade, deterministic rule selection и pure form/transfer/combine/split/thermal operators, единый session step, canonical CookingProgram executor, log compiler, semantic Result compare и reviewed runtime-neutral golden vector harness для пяти end-to-end scenarios, offline CLI inspection/validation, единые library/CLI operations simulate, replay, compare, black-box clean-install flow wheel/sdist и stateless FastAPI adapter с exact OpenAPI route surface, executable library/CLI/API equivalence, loopback-only food-simulation-api, bounded timeout/concurrency и clean-install Python/curl quickstarts; принят typed React/Vite Simulation Lab с проверенными Causal Workbench и Lab Bench, catalog/program composer, реальным run, полным state/DishState timeline и selectable typed causal trace, Review Corridor через публичный semantic compare и standard golden-vector ZIP с проверяемым import/replay; отдельный versioned Localization Pack, public SDK resolver и полностью двуязычный English/Russian интерфейс не изменяют stable IDs и canonical artifacts; consumer documentation даёт единый clean-install путь, public API reference, tutorials и исполняемые library/data/CLI/API examples с явной границей technical prototype.
• Текущая цель: выпустить подписанный SDK 0.1.0 через GitHub Release и PyPI trusted publishing без запуска Stage B.

Актуальное состояние находится в docs/project/status.md.

Локальная установка

Проект использует CPython 3.14.6 и uv 0.11.30. Единственная поддерживаемая последовательность первой установки и ежедневных команд описана в руководстве по локальной среде. Системный Python и глобальные Python-пакеты не требуются.

После установки полный локальный контур запускается одной командой:

./scripts/check all

Состав продукта

• Food Simulation Platform — платформа целиком.
• Food Simulation SDK — библиотека, схемы и инструменты разработчика.
• Food Simulation Core / Runtime — детерминированное вычислительное ядро.
• Food Knowledge Pack — версионируемые кулинарные данные и правила.
• Simulation Lab — первый референсный клиент SDK.
• Culinary Game — отдельный будущий клиент платформы.

Навигация

• Индекс документации
• Quickstart и документация потребителя SDK
• Генеральный план
• Видение продукта
• Доменная модель
• Контрольные ворота
• Готовность и evidence Gate A
• Правила управления проектом
• Границы этапа A
• Матрица миграции исходных документов
• Стратегия тестирования
• Локальная среда разработки
• Локальные проверки качества
• Базовый контур безопасности
• Релизный threat, dependency, SBOM и license review
• Reproducible release pipeline
• Подписанный public SDK release
• Release notes SDK 0.1.0
• Apache-2.0 license
• Политика безопасности
• Definition of Done
• Архитектурные решения
• Knowledge planning baseline
• Embedded Food Knowledge Pack
• SimulationFacade и runtime ports
• Runtime validation и выбор правил
• Form, transfer и material ledger
• Combine, split и aggregation policy
• Reference thermal/moisture model
• Session и CookingProgram execution
• Пять runtime acceptance scenarios
• Trace completeness invariants
• Canonical SimulationResult
• Semantic Result compare
• Golden vector harness
• CLI contract и diagnostic UX
• CLI inspect и validate
• CLI simulate, replay и compare
• Clean-install CLI quickstart
• Service API и OpenAPI contract
• Тонкий Service API adapter
• Library, CLI и API equivalence
• Локальный Service API quickstart
• UX flow Simulation Lab
• Разработка Simulation Lab
• Catalog и Scenario Composer
• Run и causal trace
• Compare и regression export
• Платформенная локализация

Принцип реализации

Сначала создаётся независимый, проверяемый и расширяемый язык приготовления пищи и среда его исполнения. Затем эта платформа используется клиентами, включая кулинарную игру.

Проект не переходит к следующему этапу по календарю. Переход разрешается только после прохождения соответствующих контрольных ворот и появления проверяемых свидетельств готовности.