Платформа как продукт (ось 3) — B2B API marketplace, Tour Builder, тарифы и динамическая тарификация

Версия: 1.0 Дата: 25.04.2026 Статус: Готов к обсуждению

Назначение документа

Этот документ — раскрытие третьей оси верхнеуровневой архитектуры: платформа как самостоятельный коммерческий продукт. Он отвечает на вопросы: как Vitiana продаётся, какие у платформы тарифные уровни, как работает динамическая тарификация, какой опыт получают разработчики партнёров (developer experience), какие коммерческие промежуточные обещания (SLA, certification, support) платформа даёт, как Tour Builder монетизируется отдельно.

Документ читается после главной архитектурной оси (overview/index.md), манифеста переосмысления (overview/platform-vision-and-manifest.md), архитектурного якоря и бизнес-модели (overview/architectural-anchor-and-business-model.md).

Главный принцип

Vitiana — самостоятельный коммерческий продукт, не «доступ к чужим данным».

Это означает:

• партнёр платит за платформенный труд (нормализация, governance, проверка целостности, поисковая проекция, фиксация коммерческих обещаний, гарантии взаиморасчётов), не за «hotel found»;
• инвентарь поставщиков — это сырьё, обработанное платформой; партнёр получает обработанный продукт;
• цена платформенного access — отражает реальную операционную нагрузку, которую партнёр создаёт;
• платформа — продукт для разработчиков (developer-first product), не «B2B-канал продаж туристического инвентаря».

Семь продуктовых атрибутов платформы

Платформа имеет атрибуты, обязательные для зрелой B2B SaaS-платформы верхнего уровня. Все семь — first-class с самого начала.

Атрибут 1. Тарифные уровни (tenant tiers)

Четыре основных уровня:

Free tier

Назначение: оценка платформы, интеграционное тестирование, обучение разработчиков.

Что включено:

• доступ к sandbox с реалистичными mock-данными (не фейковыми, а похожими на production);
• ограниченный объём search calls для тестирования;
• симулированный booking commit в sandbox;
• базовая документация и code samples;
• community support (форум, чат).

Чего нет:

• production access;
• реальный booking commit;
• доступ к Tour Builder API;
• partner-facing analytics.

Цена: бесплатно. Цель — низкий барьер входа.

Starter tier

Назначение: первая production-интеграция малого партнёра.

Что включено:

• production access с минимальными квотами (примерные envelope: десятки тысяч search calls в месяц, сотни booking commits в месяц);
• базовая Partner API Surface;
• limited supplier coverage (подмножество поставщиков);
• standard webhook delivery;
• email support с reasonable response time.

Чего нет:

• Tour Builder access;
• advanced analytics;
• premium SLA;
• dedicated success engineer.

Модель оплаты: subscription + usage (sub за базовые квоты, usage за overage). Цена — оценочно начинается от десятков долларов в месяц.

Professional tier

Назначение: растущий партнёр с реальным production-объёмом.

Что включено:

• расширенные квоты production;
• полный supplier coverage;
• доступ к Tour Builder API (как часть тарифа или отдельным add-on);
• partner-facing analytics product (usage dashboards, conversion analytics, supplier breakdown);
• webhook subscription management через self-service;
• standard SLA с credits.

Модель оплаты: subscription + usage с большими envelope; bulk-discount.

Enterprise tier

Назначение: крупный B2B-партнёр с регулярным значительным объёмом.

Что включено:

• гарантированная мощность (capacity envelope);
• возможность dedicated infrastructure (фаза 4);
• полный набор возможностей платформы;
• premium SLA с расширенными credits;
• dedicated success engineer;
• custom integration support;
• custom commercial terms (revenue-share, hybrid pricing);
• early access к новым features;
• joint roadmap discussions.

Модель оплаты: custom contract; возможны subscription + usage, revenue-share, fixed price, hybrid.

Атрибут 2. Динамическая тарификация (dynamic pricing)

См. подробное описание в overview/architectural-anchor-and-business-model.md, часть про динамическую тарификацию.

Краткая суть: цена платформенных услуг для партнёра зависит от:

• объёма поисковых запросов (search calls), quote, booking, ML-инференса, Tour Builder operations;
• сложности запросов (search complexity, query depth);
• supplier load profile (использование «дорогих» или «дешёвых» поставщиков);
• webhook deliveries volume;
• storage usage;
• settlement/clearing operations volume.

Принципы тарификации:

• прозрачность (партнёр видит фактическую нагрузку и прогноз счёта);
• отсутствие отказа в обслуживании при превышении квоты (только сигнал и опции);
• дифференциация по сложности (дорогие запросы стоят больше);
• bulk-discount при росте;
• self-service upgrade и downgrade;
• транспарентная revenue-share для Enterprise.

Атрибут 3. Опыт разработчика (developer experience, DX)

Платформа — developer-first product. Качество DX — главный фактор adoption партнёрами.

Минимальный набор DX с фазы 2:

• Sandbox с реалистичными mock-данными. Не пустые ответы, а данные, похожие на production: реальные геозоны, реальные пропорции рейтов и описаний, реальные supplier capability profiles. Партнёр в sandbox видит то, что увидит в production.
• Self-service onboarding. Регистрация партнёра, выпуск API ключей, выбор tier, активация sandbox — без переговоров через self-service.
• Версионированная документация. OpenAPI / AsyncAPI specs с changelog; migration guides между версиями; deprecation policy.
• Code samples и SDKs. Минимум для топ-3 языков (например, Python, Go, JavaScript/TypeScript).
• Postman / HTTP collections. Готовые collections для быстрого start.
• Interactive API explorer. Browser-based playground с auto-completion и тестовыми вызовами.
• Searchable knowledge base. Документация, FAQ, best practices, troubleshooting.

Атрибут 4. Сертификация (certification flow)

Переход партнёра из sandbox в production — через формальный процесс:

• Integration testing requirements. Партнёр прогоняет набор обязательных сценариев в sandbox; платформа проверяет результаты.
• KYC (Know Your Customer). Проверка юридического лица партнёра.
• AML (Anti-Money Laundering). Базовая проверка на предмет отмывания денег.
• Business model verification. Партнёр документирует свой канал продаж (B2C-витрина, корпоративный travel, метасёрч и т.д.) — это влияет на риск-профиль.
• Technical readiness check. Webhook endpoint доступен, signature verification работает, обработка retry семантики корректна.
• Compliance attestation. GDPR DPA подписан, sub-processor list согласован.
• Production credentials issuance. После прохождения всех шагов — выпуск production API keys.

Время сертификации — оценочно от часов (для Starter tier) до недель (для Enterprise tier).

Атрибут 5. SLA-контракт

Соглашение об уровне обслуживания (Service Level Agreement, SLA) — формальный коммерческий контракт между платформой и партнёром.

Метрики SLA:

Метрика	Free	Starter	Professional	Enterprise
Uptime API	best effort	99.0%	99.5%	99.9%+
Latency p95 search	best effort	<2s	<1s	<500ms
Latency p95 quote	best effort	<3s	<1.5s	<800ms
Latency p95 booking commit	best effort	<10s	<5s	<3s
Webhook delivery latency p95	best effort	<30s	<10s	<5s
Freshness availability	hours	hours	minutes	minutes
Time to first byte	best effort	<500ms	<300ms	<100ms

Credits при нарушении:

• standard credits для Professional и Enterprise tiers;
• расчёт credits по формуле "% времени downtime × месячная подписка × коэффициент тарифа";
• автоматические credits через self-service (партнёр видит нарушение SLA в dashboard и может потребовать credits через self-service).

Что считается downtime:

• HTTP 5xx errors при штатной нагрузке;
• timeouts;
• значительное превышение latency targets;
• НЕ scheduled maintenance с pre-announcement;
• НЕ partner-induced rate limiting;
• НЕ supplier outages (за это responsibility ограничена).

Атрибут 6. Поддержка (support tiers)

Tier	Channels	Response time
Free	Community forum, knowledge base	best effort, no SLA
Starter	Email + community	1-2 business days
Professional	Email + chat	4 business hours
Enterprise	Dedicated success engineer + email + chat + phone	1 hour for critical issues, 4 business hours for normal

Что покрывает support:

• onboarding assistance;
• технические вопросы по API;
• инцидент-менеджмент со стороны партнёра;
• консультации по best practices;
• escalation для проблем поставщиков.

Атрибут 7. Self-service инструменты

Партнёр должен сам управлять своим присутствием на платформе через self-service tools. Минимальный набор:

• Account dashboard. Текущий tier, использование, прогноз счёта, billing history.
• API key management. Выпуск ключей, ротация, revocation, scope assignment.
• Webhook subscription management. Подписка на event types, конфигурация endpoint, secret management, testing.
• Usage dashboard. Метрики потребления в реальном времени, исторические тренды, breakdown по типу запроса.
• Quota alerts. Уведомления о приближении к лимитам.
• Audit log download. Логи действий за период для compliance.
• Support ticket system. Создание и отслеживание tickets.
• Documentation access. Доступ к актуальной документации, changelog, migration guides.
• Tier upgrade/downgrade. Self-service изменение тарифа.
• Compliance documents. DPA, sub-processor list, certifications — доступны для скачивания.

Tour Builder как отдельный paid tier

Tour Builder — отдельный продуктовый компонент платформы со своей коммерческой моделью.

Что включает Tour Builder

Composition primitives API:

• модуль размещения (accommodation segment);
• модуль переезда (transfer segment) — авто, авиа, ж/д, водный;
• модуль активности (activity);
• модуль услуги (service);
• модуль аренды транспорта (transport rental);
• модуль страхования (insurance);
• пользовательский модуль (custom block);
• информационный модуль (informational block).

Stateful workflow:

• создание Draft;
• добавление и удаление модулей;
• работа с вариантами (Variants) и альтернативами;
• проверка совместимости (compatibility checks);
• расчёт цены тура (tour-level pricing с per-tour markup, package discount);
• генерация Proposal с версионированием;
• создание Artifacts (PDF, share-links, branded exports);
• мониторинг drift (изменений в underlying offers и эффект на тур);
• опциональная конверсия в bookings.

Доступ к Tour Builder

Tour Builder доступен:

• собственным интерфейсам Vitiana (vitrip.store, agency surface);
• партнёрам с тарифом Professional или Enterprise (включён в тариф) или Starter с paid add-on.

Коммерческая модель Tour Builder

Метрики:

• Tour Builder operations (add segment, swap variant, recompose, version, publish);
• Composition complexity (количество сегментов, количество поставщиков);
• Drift handling operations;
• Artifact generations (PDF generation особенно дорогая операция).

Тарификация:

• включена в Professional и Enterprise tiers с envelope;
• доступна как paid add-on для Starter tier;
• overage rate за превышение envelope.

Tour Builder и Package Travel Directive

Тур, состоящий из ≥2 компонентов, может попадать под определение «package travel» в EU 2015/2302. Это создаёт обязательства для package travel organiser:

• insolvency protection (financial guarantee);
• pre-contractual information requirements;
• liability for performance.

Кто package travel organiser — зависит от модели merchant-of-record для конкретного tenant:

• Модель A (платформа MoR): Vitiana — package travel organiser, Vitiana обеспечивает insolvency protection.
• Модель B (партнёр MoR): партнёр — package travel organiser, партнёр обеспечивает insolvency protection.
• Модель C (гибрид): определяется per продукт.

Полное раскрытие — в reference/compliance-and-legal.md фазы 4 и reference/tour-builder-operational-model.md фазы 5.

Аналитика для партнёра как часть продукта

Partner-facing analytics product — часть Professional и Enterprise tiers. Это отдельный продукт, не «свободный доступ к данным».

Что видит партнёр

• Usage analytics. Search/quote/booking volume, breakdown по типу запроса, по поставщикам, по географии.
• Performance analytics. Latency p50/p95/p99 по эндпоинтам, error rate, cache hit rate.
• Conversion analytics. Search-to-quote, quote-to-book, abandonment rate.
• Supplier breakdown. Какие поставщики используются, их операционное здоровье, freshness, latency.
• Commercial analytics. Revenue, margin (где доступно по контракту), payouts.
• Cohort analytics. Поведение конечных клиентов партнёра во времени.
• Comparative benchmarks. Сравнение с медианой по своему сегменту (anonymized, aggregated).

Что НЕ видит партнёр

• Данные других партнёров;
• raw supplier payloads;
• внутренние governance details;
• внутренние margin/clearing details платформы.

Углубление

Полное описание — в reference/analytics-and-bi.md фазы 4.

Маркетплейс возможностей (capability marketplace) — расширение для фазы 4

Концепция, фиксируемая на верхнем уровне для будущей реализации:

Партнёры с Enterprise tier могут получить доступ к дополнительным capabilities через add-on модель:

• доступ к premium-поставщикам (которые требуют отдельной коммерческой договорённости);
• доступ к extended ML capabilities (custom ranking models, custom recommendation models);
• доступ к специальной географии или сегменту inventory;
• доступ к premium support (24/7 phone support);
• доступ к compliance services (DPO consultation, audit support).

Add-on модель — это дополнительный revenue stream, появляющийся в фазе 4 при зрелой Enterprise-базе.

Опыт собственного канала vitrip.store как продукт

vitrip.store — собственный B2C-канал, но также demonstration of platform capabilities.

Принципы demonstration

• vitrip.store — обычный tenant на собственном API. Никаких архитектурных привилегий.
• Партнёры, рассматривающие интеграцию, могут увидеть vitrip.store как живой пример того, что можно построить на платформе.
• Performance, conversion, UX vitrip.store — витрина возможностей Vitiana.

Двойная функция vitrip.store

1. Собственный канал продаж — реальный revenue от B2C, прямая маржа платформы.
2. Demonstration — публичный пример для партнёров.

При конфликте между функциями приоритет: архитектура. Если что-то нельзя сделать на собственном API без специальных привилегий — это нельзя для vitrip.store. Это сохраняет честность demonstration.

Path-to-monetize: путь к монетизации платформы

Этот раздел описывает порядок появления revenue streams во времени.

Фаза 1 (Bootstrap, 0-12 мес)

Revenue source: vitrip.store (собственный канал).

Состояние Partner API marketplace: концепция в документации, прототип контракта; ещё нет paying партнёров.

Состояние Tour Builder: концепция и прототип композиционных primitives.

Состояние Agency platform: концепция; реальных агентств ещё нет.

Цель фазы: stabilize core, доказать viability ingestion и каноничной модели на 2 поставщиках.

Фаза 2 (Service isolation, 12-24 мес)

Revenue source:

• vitrip.store (продолжение);
• первые Free tier и Starter tier Partner API подписчики (тестовый revenue);
• первые agency tenants на платных подписках.

Состояние Partner API marketplace: Partner API Surface stabilized; sandbox доступен; первые self-service onboarding партнёров.

Состояние Tour Builder: доступен в beta для собственных каналов; ограниченный доступ для отдельных партнёров.

Фаза 3 (Workload-specific, 24-36 мес)

Revenue source:

• vitrip.store (зрелый канал);
• Professional tier Partner API — основной revenue;
• Enterprise tier — первые контракты;
• Agency platform — зрелый revenue;
• Tour Builder paid access — растущий revenue.

Состояние: платформа на пути к зрелой B2B SaaS с реальными partners.

Фаза 4 (Multi-region, 36+ мес)

Revenue source:

• Все tier и каналы зрелые;
• Enterprise — крупная доля revenue с custom commercial terms;
• Capability marketplace add-ons — дополнительный revenue.

Состояние: платформа верхнего уровня с глобальным присутствием.

Связь с другими осями архитектуры

Связь с осью 1 (каноничная доменная)

• Tenant, Partner, Agency, ApiClient, ApiCredential — главные сущности продуктовой оси.
• TourDraft, TourProposal — сущности отдельного Tour Builder paid tier.
• UsageEvent, BillingEntry — сущности тарификации.

Связь с осью 2 (поверхности взаимодействия)

• Partner API Surface — главная коммерческая поверхность.
• Tour Builder Closed Surface — отдельный premium продукт.
• B2C Storefront Surface — собственный канал и demonstration.
• Agency Working Surface — другая коммерческая модель.

Связь с осью 4 (данные и интеллект)

• Usage metering — базовый источник для динамической тарификации.
• Partner-facing analytics — часть Professional и Enterprise tiers.
• ML — динамическое ценообразование на основе реальных метрик; ranking, recommendation как premium возможности.

Связь с осью 5 (операционная)

• SLA — операционное обещание тенанту, прямо зависит от tier.
• Capacity envelopes — операционная гарантия для Enterprise.
• Disaster Recovery — обязательство уровня Enterprise.
• On-call rotation для critical issues Enterprise tier.

Связь с осью 6 (реализация)

Текущий home-to-go-api:

• Имеет работающий Stuba-эндпоинт https://api.vitrip.store/stuba — это adapter ingestion, не Partner API Surface.
• Имеет admin-панель vitrip.store с Preact + HTM, PHP backend — это прототип Internal Operational Surface.
• НЕ имеет Partner API Surface, sandbox, billing console, certification flow, partner-facing analytics, Tour Builder API — всё это к разработке в фазах 2-3.

Углубление в документах нижних слоёв

Эта ось верхнего уровня раскрывается детально в документах, которые будут созданы в фазе 4:

Тема	Документ
API as product (sandbox, DX, certification, billing)	reference/api-as-product.md
Экономическая модель (cost-per-search, unit economics)	reference/economic-model.md
Динамическое ценообразование детально	reference/api-metering-and-usage-governance.md (углубление) + reference/api-as-product.md
Multi-tenant isolation strength	reference/multi-tenant-isolation-strength.md (фаза 5)
Tour Builder operational model	reference/tour-builder-operational-model.md (фаза 5)
Compliance & Legal	reference/compliance-and-legal.md
Payment domain	reference/payment-domain.md
Notification & Communication (webhooks)	reference/notification-and-communication.md
Analytics & BI как продукт	reference/analytics-and-bi.md

Открытые развилки

Развилка 1. Точные envelope каждого tier

Сколько именно search calls в Free / Starter / Professional? Конкретные цены? Эскалируется при создании reference/api-as-product.md фазы 4.

Развилка 2. Pricing model: subscription + usage vs revenue-share для Enterprise

Custom contract для Enterprise — какая базовая модель? Эскалируется в фазе 3 при первых Enterprise-партнёрах.

Развилка 3. Tour Builder как отдельный subscription или add-on?

Включён ли Tour Builder в Professional базово, или отдельный add-on? Эскалируется при создании reference/api-as-product.md.

Развилка 4. Capability marketplace — полная модель

Для фазы 4 — какие именно capabilities идут как add-ons, как выпускаются? Эскалируется при достижении фазы 4.

Связанная документация

• Главная архитектурная ось (overview/index.md)
• Манифест переосмысления (overview/platform-vision-and-manifest.md)
• Архитектурный якорь и бизнес-модель (overview/architectural-anchor-and-business-model.md)
• Поверхности взаимодействия (overview/layers.md)
• Каноничная доменная ось (overview/canonical-domain-spine.md)
• Ось данных и интеллекта (overview/data-and-intelligence-spine.md)
• Операционная ось (overview/operational-spine.md)
• Связь с реализацией (overview/relation-to-implementation-baseline.md)
• Граф пересечений архитектурных осей (overview/architectural-axes-and-cross-links.md)
• Дорожная карта инфраструктурного масштабирования (operations/scaling-and-packaging-roadmap.md)
• Коммерческая модель (reference/commercial-model.md)
• Партнёрские взаиморасчёты (reference/partner-finance-and-clearing.md)
• Тенантная настройка (reference/tenant-configuration-and-enablement.md)
• Учёт потребления и квоты (reference/api-metering-and-usage-governance.md)
• Контракты API (reference/api-contracts.md)
• Tour Builder Domain (reference/tour-builder-domain.md)