A4 — что это

A4 — документная часть платформы FastOffice: DOCX-совместимый редактор и процессор документов, который встраивается в приложение партнёра, оставляя документную истину в Rust Core.

Одной фразой

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

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

Что уже умеет система партнёра

Карточка документа, пользователи и роли, маршруты согласования, версии, электронная подпись, архив, аудит, интеграции с TMS/ERP/CRM и правила хранения остаются на стороне партнёра.

Что добавляет A4

• Открыть — получить DOCX от системы партнёра и создать управляемую документную сессию.

• Показать — отрисовать страницы и дать пользователю привычную поверхность редактирования.

• Изменить — принять действия пользователя или агента как ограниченные команды, а не произвольную правку ZIP/XML.

• Сохранить — собрать корректный DOCX и вернуть файл или подтверждённый результат обратно системе партнёра.

• Сообщить — передать события ready, dirty, saved, error и другие согласованные состояния.

Главная граница

A4 не становится владельцем карточки документа или бизнес-процесса. Он отвечает за то, что находится внутри открытого документа и как это содержимое меняется.

Как это выглядит для сотрудника

Сотрудник открывает документ из привычной карточки. Редактор появляется внутри того же окна и под тем же брендом. Пользователь редактирует согласованные элементы, а при сохранении новая версия возвращается в существующий контур хранения и аудита — без ручной выгрузки в отдельный Word и обратной загрузки.

Word-класс внутри продукта партнёра

A4 - документная часть платформы. Её задача: дать партнёру DOCX-совместимый редактор и процессор документов, который встраивается в его приложение, а документная истина остаётся в Rust Core.

Слой	Ответственность	Что это даёт
Partner Host	Окно, бренд, auth, storage, workflow, process lifecycle.	Продукт остаётся продуктом партнёра.
Host Adapter	Process spawn, bootstrap parse, WebView events, shutdown.	Безопасная и управляемая интеграция runtime.
Embedded Web Surface	Canvas/UI, user input, Host API, event emission.	Пользователь работает с документом внутри WebView.
Surface Host	Assets, bootstrap, authenticated WS, one document session.	Runtime может работать локально, loopback-only, без внешнего сервиса.
Document Session	Commands, selection, history, model, layout, save.	Единая сессия документа, команды и события.
Rust Core / OOXML	Package, semantic model, preservation, layout, writeback.	DOCX truth и canonical save/reopen не зависят от HTML serialization.

Что получает пользователь в Word-коридоре

• Открытие согласованных DOCX-документов внутри host-приложения без отдельного окна A4.

• Редактирование, layout, сохранение, повторное открытие и проверка document truth.

• События ready/dirty/saved/error в baseline и расширяемые события selection/content/command state для OEM-профиля.

• White-label: тема, locale, readOnly, CSS variables, собственная оболочка партнёра.

• Headless route для batch processing, services, конвейеров и агентных операций.

Граница честного обещания

• Openability не равна fidelity: capability profile должен отдельно фиксировать чтение, отображение, редактирование, сохранение и preservation по семействам OOXML.

• Полная совместимость с Microsoft Word, Office.js и выполнение VBA-макросов не входят без отдельного соглашения.

• Production-поставка требует acceptance по платформам, save/reopen, lifecycle, security и packaging.

Источник / основание: A4 Architecture Specification: Rust владеет document truth, DOCX round-trip идёт через Rust writeback; Surface Host привязан к 127.0.0.1; production save должен подтверждаться save/reopen; пилот считается успешным только после работы capability profile в реальном приложении партнёра.