BusinessPlatform — документация платформы витрин

Статус: SPEC-FIRST. Этот документ описывает, как мы хотим, чтобы платформа работала — целевую модель. По нему реализуются флоу и API. Где текущая реализация отличается — помечено ⚠️ сейчас:.

Платформа даёт бизнесу витрину (интернет-магазин / запись на услуги) на своём поддомене или домене. Внешний вид витрины задаётся темой; данные, корзину, оплату и запись обслуживает платформа. Темы пишут ИИ и сообщество — поэтому тема песочница (не может выполнять код или трогать деньги).

Оглавление

1. Обзор и архитектура — из чего состоит платформа, рантайм тем, границы доверия.
2. Флоу покупателя — два флоу (Заказ / Запись) на общем хвосте; оси вариаций; кто владеет каждым шагом.
3. Объектная модель (в работе) — какие объекты и поля видит тема (shop, product, cart, service, availability…).
4. API-контракт (в работе) — read/write эндпоинты, авторизация.
5. Как сделать тему (в работе) — структура темы, объекты Liquid, JS-хуки корзины/записи, темизация checkout, ограничения песочницы.

Ключевые принципы (одним взглядом)

• Тема владеет ВИДОМ, платформа — ДАННЫМИ и ДЕНЬГАМИ. Разметку рисует тема почти везде; состояние, подсчёт сумм, остатки, оплата — всегда платформа.
• Один рантайм витрины + песочница-шаблонизатор (Liquid). Тема = бандл шаблонов + CSS + JS, не приложение. Не может выполнить произвольный код.
• Два флоу, один хвост. Заказ и Запись расходятся в середине (что и как получаем), сходятся в конце (контакт → оплата → подтверждение → статус → аккаунт).
• Checkout: логика общая, вид темизируется. Не «одинаковый экран» — тема даёт палитру/шрифты/блоки; поведение оплаты платформенное (безопасность, конверсия).