Пакет для партнёра и первый пилот

Как встроить работающий пример за 30 минут

Цель первого запуска — не production. Цель — открыть свой DOCX внутри host-приложения, изменить его, получить события и проверить сохранённый файл.

Время	Действие	Ожидаемый результат
0–5 мин	Получить Surface Host и тестовый DOCX; выбрать WebView.	Известны binary, input и отдельный output path.
5–10 мин	Запустить surface на свободном loopback-порту.	Host читает bootstrap: URL, token и contract version.
10–15 мин	Создать WebView и открыть bootstrap URL.	Поверхность загружается внутри окна партнёра.
15–20 мин	Подключить обработчик host messages.	Host получает ready и показывает статус.
20–25 мин	Изменить первый абзац и выполнить Save.	Приходят dirty и saved; создаётся output DOCX.
25–30 мин	Переоткрыть output и завершить surface process.	Изменение сохранено; listeners, socket и process освобождены.

Команда запуска текущего Surface Host

fastdoc-cli surface --port 0 \
  --doc /absolute/input.docx \
  --save /absolute/output.docx

Псевдокод host-интеграции

bootstrap = startSurface(input, output)
webview.onMessage(event => handleA4Event(event))
webview.open(bootstrap.url)
waitFor('ready')
// пользователь редактирует документ
waitFor('dirty'); requestSave(); waitFor('saved')
webview.close(); stopSurface()

Что означает «30 минут»

В репозитории уже есть bounded non-Electron WKWebView route и инструкция. Партнёру следует выдавать предварительно собранный evaluation kit; production SDK, SSO, storage adapter и white-label policy — отдельная работа после пилота.

Что дать трём специалистам для go / no-go

Сначала — общая картина и живой пример. Затем — архитектурная глубина, контракт и коммерческие условия.

Рекомендуемый порядок чтения

1. Документ 1 — этот файл. Что такое A4, объекты и связи, Rust/Web, варианты размещения и 30-минутный старт.

2. Документ 2 — Architecture Specification. Protocol, lifecycle, security, versioning, deployment и production acceptance.

3. Evaluation Kit. Surface Host, host-примеры, три DOCX, schemas/types, known limitations и Quick Start.

4. Capability Matrix. Что доказано для выбранной платформы и реальных документов партнёра.

5. Pilot Plan. Один маршрут open → edit → event → save → reopen с критериями успеха.

Пять вопросов для первой встречи

1. Где должен работать редактор: Windows desktop, macOS, browser, Android/iOS или on-prem service?

2. Как host передаёт документ и куда должен получить новую версию?

3. Какие десять пользовательских действий обязательны в первом пилоте?

4. Какие типы DOCX и размеры файлов являются реальными для компании?

5. Какие требования к SSO, аудиту, сети, обновлениям, LTS и data residency обязательны?

Критерий успешного первого пилота

Готово к следующему разговору

Редактор открыт внутри продукта партнёра; пользователь изменил реальный документ; host получил ready/dirty/saved; новый DOCX повторно открылся; права, версии и аудит остались у партнёра; после закрытия не осталось процессов и listeners.

Следующий документ

A4 Embedded Editor Architecture Specification — подробная спецификация для архитекторов и инженеров после того, как команда поняла базовую модель продукта.

Статус утверждений

Документ описывает проверенную архитектурную основу репозитория на август 2026 года. Конкретный публичный SDK, набор команд, SLA, лицензия и production capability profile фиксируются отдельными приложениями к пилоту и договору.