С чего начать пилот

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

Цель первого запуска — не промышленная эксплуатация. Цель проще: открыть свой документ внутри своего приложения, изменить его, получить события и убедиться, что сохранённый файл в порядке.

Время	Действие	Ожидаемый результат
0–5 мин	Взять поверхность редактора и любой свой документ; выбрать, в каком окне будете показывать.	Известны три пути: сама программа, исходный документ и отдельный файл для результата.
5–10 мин	Запустить поверхность на свободном локальном порту.	В ответ приходят адрес страницы, разовый пропуск к ней и имя схемы с номером версии — отдельного поля с версией в строке запуска нет, номер стоит в самом имени.
10–15 мин	Создать окно просмотра веб-страниц и открыть в нём этот адрес.	Редактор загружается внутри вашего окна.
15–20 мин	Подключить обработчик сообщений от редактора.	Приходит событие ready — можно показать, что документ открыт.
20–25 мин	Изменить первый абзац и сохранить.	Приходят события dirty и saved, появляется файл с результатом.
25–30 мин	Открыть сохранённый файл заново и остановить поверхность.	Правка на месте; подписки, соединение и процесс закрыты и ничего за собой не оставили.

Чем запускается поверхность

# $CLI — путь к процессору, см. «Установка и проверка»
"$CLI" surface --port 0 \
  --doc /absolute/input.docx \
  --save /absolute/output.docx

Порядок вызовов на стороне хоста

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

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

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

Что дать трём специалистам, чтобы решить — берём или нет

Сначала общая картина и живой пример. Потом устройство изнутри, контракт сеанса и коммерческие условия.

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

1. Раздел A4 — что это и страницы рядом с ним: объекты и связи, разделение Rust и Web, варианты размещения и быстрый старт.

2. Спецификация архитектуры — отдельный документ поставки (см. Состав поставки): протокол, жизненный цикл, безопасность, версионирование, развёртывание и приёмка в промышленной эксплуатации.

3. Evaluation Kit — отдельный артефакт поставки (см. Состав поставки): Surface Host, примеры хоста, три DOCX, схемы и типы, известные ограничения и быстрый старт.

4. Матрица возможностей — что доказано для выбранной платформы и на ваших реальных документах.

5. План пилота — один маршрут «открыть → изменить → событие → сохранить → открыть заново» с условиями, по которым его признают удачным.

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

1. Где должен работать редактор: на рабочих местах под Windows или macOS, в браузере, на телефонах или службой на ваших серверах?

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

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

4. Какие документы и какого размера ходят у вас на самом деле?

5. Что обязательно по единому входу, аудиту, сети, обновлениям, длительной поддержке версии и месту хранения данных?

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

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

Редактор открылся внутри вашего продукта; пользователь изменил настоящий документ; ваше приложение получило события ready, dirty и saved; сохранённый файл открылся заново; права, версии и аудит остались у вас; после закрытия не осталось ни висящих процессов, ни подписок.

Что читать после этой страницы

Спецификация архитектуры встраиваемого редактора A4 — подробный документ для архитекторов и инженеров, к которому переходят, разобрав базовую модель продукта. Он выдаётся вместе с комплектом для оценки; на сайте те же темы разобраны по частям: устройство редактора, жизненный цикл сеанса, контракт сеанса, варианты размещения и безопасность.

Что описано здесь, а что фиксируется отдельно

Здесь описана проверенная архитектурная основа продукта. Публичный набор для разработчика, перечень команд, обязательства по доступности, лицензия и итоговый профиль возможностей фиксируются отдельными приложениями к пилоту и договору.

Предлагаемый следующий шаг

• 60–90 минут: на одном реальном документе согласовать, какие объекты адресуются, какие события приходят и что показывается в контекстном меню.

• Зафиксировать версию контракта взаимодействия и профиль возможностей пилота.

• Собрать один сквозной пример: щелчок правой кнопкой по ячейке таблицы → ваше контекстное меню → типизированная правка → сохранение и открытие заново.

• После приёмки расширять список поддержанных объектов частями, а не обещать весь набор возможностей Word одним заявлением.