MOffice — основание проекта (библия)

Документ-источник истины для всех остальных документов, макетов и кода. Если что-то здесь противоречит другому документу — прав этот документ, а другой нужно исправить. Версия 0.1 · 2026-10-03 · язык документации — русский; идентификаторы, код, имена файлов — английский. Правообладатель: Орос Алексей Михайлович (ИП Орос А.М.). Весь код и материалы — собственность правообладателя (файл LICENSE).

1. Что мы строим

MOffice (по-русски тоже латиницей; прежнее рабочее название — Meridian Office, решение владельца № 41) — полный офисный пакет для Windows, Linux и macOS, который:

1. Читает всё. Открывает любой распространённый формат документов, таблиц, презентаций, изображений, схем, заметок, почты и баз данных — Microsoft Office (включая устаревшие бинарные), OpenDocument, Apple iWork, Google-экспорт, PDF, растровые и векторные форматы — с точностью отображения не хуже оригинала.
2. Имеет свои форматы. У каждого приложения есть собственный открытый формат семейства MOffice Open Package (MOP) — ZIP-контейнер с XML и ресурсами, по духу близкий к OOXML/ODF, но проще, строже и с встроенной историей изменений.
3. Лучше, а не «тоже». Единое ядро (одна модель текста, одна модель таблиц, один движок рендера и формул во всех приложениях), современный интерфейс одного стиля, локальная работа без облака, совместное редактирование по желанию, скрипты вместо макросов, встроенный ассистент.
4. Один код — три платформы. Это десктопные приложения (решение владельца, 2026-10-03): ядро на Rust, своя оболочка на Rust без Qt (решение № 39); одинаковое поведение и внешний вид на Windows 10/11, macOS 13+ (Intel и Apple Silicon) и Linux (Flatpak/AppImage/deb/rpm, X11 и Wayland). Полноценная работа офлайн, установка на компьютер, нативные диалоги, печать, интеграция с проводником/Finder. Веб-версия и мобильные клиенты — не цель проекта; архитектура их лишь не исключает (ядро компилируется в WebAssembly), и они могут появиться отдельным решением после фазы 7.
5. Коммерческий продукт с первого дня. Система аккаунтов (MOffice ID), лицензионные ключи, активация, редакции и подписки закладываются в структуру проекта с фазы 0 — см. раздел 9.

1.1 Целевые пользователи

1.2 Принципы продукта

• Точность важнее скорости релиза. Открытый документ должен выглядеть так же, как в приложении-источнике.
• Локально по умолчанию. Всё работает без интернета и аккаунта. Облако и ИИ — опциональные модули.
• Одна модель — много представлений. Таблица в Write, диаграмма в Sheets, текст в Slides — это один и тот же код.
• Не ломать привычки. Горячие клавиши, расположение команд и терминология — знакомые пользователям Microsoft Office; но с «компактным режимом» для тех, кто любит минимализм.
• Расширяемость — часть продукта. Скрипты (JavaScript/TypeScript и Python), плагины, темы, шаблоны, магазин.
• Безопасность по умолчанию. Скрипты в песочнице, подписи документов, отсутствие «макро-вирусов» как класса.

2. Состав пакета

2.1 Приложения

2.2 Общие модули (не приложения, а библиотеки ядра)

3. Имена, форматы, расширения

3.1 Семейство форматов MOffice Open Package (MOP)

• Контейнер: ZIP (deflate; большие медиа — stored), первый элемент mimetype без сжатия (как в ODF), чтобы тип определялся по первым байтам.
• Содержимое: XML с пространством имён urn:moffice:<app>:1 (схемы — XSD + RELAX NG), манифест manifest.xml, метаданные meta.xml (Dublin Core + свои), стили styles.xml, настройки settings.xml, медиа в media/, встроенные объекты в objects/, миниатюра thumbnail.png, история изменений history/ (журнал операций CRDT, опционально), скрипты scripts/, подписи signatures/.
• Плоский вариант (один XML-файл без ZIP) для систем контроля версий: суффикс f → .mwxf, .msxf, …
• Шаблоны: последняя буква t вместо x.
• Скрипты внутри документа не меняют расширение (в отличие от .docm): наличие скриптов видно по значку и по манифесту, скрипты не запускаются без явного разрешения, подписанные — по политике.
• Версионирование: manifest.xml/@version, обратная совместимость в пределах мажорной версии; неизвестные элементы сохраняются при пересохранении (round-trip extension elements).

3.2 Таблица расширений

Дополнительные расширения (решения 2026-10-03, см. раздел 10): .mvs — трафарет Draw (пакет библиотеки фигур), .mcht — шаблон диаграммы MOffice Chart, .mfr — пакет ответов Forms, .mnt — шаблон страницы Notes, .meqf — плоская формула Math, .mxt — пакет расширения/скрипта (подписанный ZIP с манифестом), .mkeys — схема горячих клавиш, .mlic/.mreq — лицензия и запрос офлайн-активации (раздел 9).

MIME-типы: application/vnd.moffice.<app> (например application/vnd.moffice.write), плоские — application/vnd.moffice.<app>+xml.

3.3 Чужие форматы — сводная матрица (R — чтение, W — запись, R* — чтение с ограничениями)

4. Технологический стек (решение)

Альтернативы, которые рассмотрены и отклонены (подробнее — в 03-architecture.md): Electron/Tauri с веб-UI (тяжелее, хуже IME и доступность на десктопе), Flutter (слабая поддержка сложного текстового ввода и a11y на десктопе), Avalonia/.NET (меньше экосистема рендера), чистый C++ без Rust (риски безопасности в парсерах).

5. Стиль компании и дизайн-система (MOffice Design System, MDS)

5.1 Идея бренда

MOffice — короткое имя пакета (решение владельца № 41, 2026-10-04). Метафора прежнего рабочего названия сохраняется в знаке: меридиан — линия отсчёта, точность, навигация; карта, компас, штурманский стол. Бренд спокойный, инженерный, без «игрушечности»; цвета глубокие, акценты тёплые.

• Логотип пакета — «M»-глобус: окружность (глобус), внутри которой два меридиана, сходящиеся к экватору, и центральная засечка складываются в букву «M»; сверху — короткая засечка, как у компаса. Монохромный вариант — кольцо с «M» из линий. Так знак читается и как буква имени, и как глобус с меридианами.
• Словесный знак: «MOffice» одним словом, «M» и «O» прописные; в русском тексте не переводится.
• Риск смешения: имя близко к «МойОфис/MyOffice» и «MS Office» — до регистрации нужен поиск патентного поверенного по ФИПС и WIPO в классах МКТУ 9 и 42 (docs/legal/trademark-check.md).
• Значки приложений: скруглённый квадрат (радиус 22 % стороны) цвета приложения, белый глиф-символ (не буква, как у MS, а знак сути: Write — перо-строка, Sheets — сетка 2×2, Slides — прямоугольник с треугольником «play», Draw — узел-коннектор, Paint — капля-кисть, Notes — закладка, Mail — конверт, Base — цилиндр, Forms — список с галочкой, PDF — лист с загнутым углом, Math — ∑, Hub — логотип).
• Голос интерфейса: коротко, по делу, во втором лице («Сохраните файл…» → «Сохранить»), без восклицаний.

5.2 Токены (единые для Qt-темы, веб-версии и макетов)

Цвета бренда и приложений (светлая тема; в тёмной — те же оттенки на 1 ступень светлее):

Нейтральные: светлая тема — фон окна #F5F6F8, поверхность #FFFFFF, граница #E1E4E8, текст #1A1D21, вторичный текст #5C636E; тёмная — фон #16181D, поверхность #1F2228, граница #2E3238, текст #E6E8EB, вторичный #9AA1AB. Контраст текста к фону ≥ 7:1 (AAA) для основного, ≥ 4.5:1 для вторичного.

Геометрия: сетка 4 px (компоненты) / 8 px (раскладка); радиусы 6 px (кнопки, поля), 10 px (карточки, панели), 14 px (всплывающие окна); толщина обводки 1 px; фокус — кольцо 2 px цвета приложения с 2 px отступом.

Типографика интерфейса: Inter (резерв: Segoe UI / SF Pro / Cantarell), размеры 11/12/13 (основной)/15/18/24/32 px, моноширинный — JetBrains Mono. Шрифты документов по умолчанию: «Carlito» 11 pt (= Calibri) для совместимости, «PT Serif/Sans» в русских шаблонах, «Liberation Serif» для академических.

Иконки: набор MOffice Glyphs — контурные, 20 px (ribbon — 20 и 32 px), штрих 1,5 px, скругления 2 px; активное состояние — залитая версия. Основа на этапе прототипа — Lucide/Fluent (MIT), затем свой набор.

Движение: 120–200 мс, ease-out; уважение к системному «уменьшить движение».

5.3 Каркас окна (одинаков для всех приложений)

┌───────────────────────────────────────────────────────────────────────┐
│ Заголовок: [значок] Имя документа — MOffice Write  [поиск ⌘⇧P] [☁][👤] │  ← на macOS нативный, на Win/Linux свой (CSD); вкладки документов в одном окне (P0)
├───────────────────────────────────────────────────────────────────────┤
│ Файл  Главная  Вставка  Дизайн  Макет  Ссылки  Рецензирование  Вид  Скрипты │  ← вкладки ribbon (+ контекстные)
│ [группа команд] [группа] [группа] ...                     [⌄ свернуть] │  ← лента 92 px; компактный режим 40 px
├────────┬──────────────────────────────────────────────┬───────────────┤
│ Навиг. │                                              │ Боковая панель│
│ панель │           Холст документа                    │ (свойства,    │
│ (опц.) │                                              │ стили, исправ-│
│        │                                              │ ления, …)     │
├────────┴──────────────────────────────────────────────┴───────────────┤
│ Стр. 3 из 12 · 1 254 слова · Русский · [режимы] [масштаб ───●─── 100%] │  ← строка состояния 24 px
└───────────────────────────────────────────────────────────────────────┘

• Вкладка Файл открывает «backstage» на весь экран (Создать/Открыть/Сохранить/Экспорт/Печать/Поделиться/Сведения/Параметры).
• Командная палитра Ctrl+Shift+P / ⌘⇧P (псевдоним Alt+Q, как «Что вы хотите сделать» в Office) — поиск любой команды, стиля, файла, функции. Ctrl+K / ⌘K остаётся за гиперссылкой, как в Microsoft Office (решение 2026-10-03).
• Контекстная мини-панель при выделении (как в Office) + контекстные вкладки ribbon (Таблица, Рисунок, Диаграмма).
• Три режима плотности: «Лента», «Компактная панель» (одна строка), «Фокус» (только холст).
• Горячие клавиши — как в Microsoft Office; схема LibreOffice и своя — в настройках.

6. Архитектура — верхний уровень

┌──────────────── MOffice Shell (Rust: meridian-ui, решение № 39) ─┐
│ Hub │ Write │ Sheets │ Slides │ Draw │ Paint │ PDF │ Notes │ Mail │ Base │ Forms │
├──────────────── FFI (C ABI meridian-ffi, stable) ─────────────────┤
│                      MOffice Kernel (Rust)                        │
│  text-model · text-layout · grid-model · calc-engine · scene       │
│  raster · chart · math · undo/crdt · styles · fields · search      │
├─────────────── MOffice Codecs (Rust) ────────────────────────────┤
│  ooxml · odf · msbinary(doc/xls/ppt) · rtf · pdf(read/write) ·     │
│  html/md · images · svg · vsdx · pst/eml · accdb · iwork · …       │
├─────────────── Platform (Rust + C++) ─────────────────────────────┤
│  render(Skia) · fonts · print · ime · a11y · fs/cloud · script(QuickJS) · sync(Yrs) │
└───────────────────────────────────────────────────────────────────┘

Процессная модель: один процесс на документ-окно (как у браузеров) + общий «брокер» (Hub) для буфера, недавних, облака и обновлений; парсеры чужих форматов — в отдельном песочном процессе (crash ≠ потеря документа). Автосохранение — журнал операций каждые 2 с, восстановление после сбоя.

7. Фазы (сводно; подробно — 08-roadmap.md)

Фазы перекрываются: команды Sheets и Slides стартуют, когда ядро стабилизировано (конец фазы 0 / середина фазы 1).

8. Соглашения для документов этого репозитория

• Язык документов — русский; термины интерфейса даём по-русски с английским в скобках при первом упоминании.
• Имена приложений пишем латиницей: MOffice Write, MOffice Sheets (не «Врайт»). Ядро — MOffice Kernel.
• Каждый документ приложения (docs/apps/<app>.md) имеет разделы: Назначение и аналоги → Функции (по группам, с приоритетами P0/P1/P2) → Экраны (список всех окон/панелей/диалогов с описанием) → Модель данных → Алгоритмы и скрипты (псевдокод/Rust/TypeScript) → Форматы (чтение/запись, особенности) → Горячие клавиши → Критерии готовности → Риски.
• Приоритеты: P0 — без этого нельзя выпустить 1.0; P1 — в 1.x; P2 — позже.
• Макеты (mockups/*.html) используют mockups/assets/mds.css, одна страница на приложение, каждый экран — блок <section class="screen"> с подписью; не изобретать свои цвета — только токены.
• Код в примерах: Rust для ядра, TypeScript для MOffice Script и веб, C++/QML для оболочки. Комментарии в коде — двуязычные: // Пересчёт зависимостей / Recalculate dependencies.

9. Лицензирование, аккаунты и редакции (закладывается с фазы 0)

Требование владельца (2026-10-03): система аккаунтов и лицензионных ключей — часть структуры проекта с самого начала, а не надстройка «потом». Подробно — docs/10-licensing-accounts.md; здесь — решения верхнего уровня.

9.1 Редакции

9.2 MOffice ID (аккаунты)

• Вход: e-mail + пароль (Argon2id), ссылка-вход по почте, OAuth (Google, Apple, Microsoft, Яндекс ID, VK ID), корпоративный SSO (OIDC/SAML 2.0), 2FA (TOTP, passkeys/WebAuthn), восстановление доступа.
• Сущности: пользователь → устройства (ограничение по редакции) → организации (владелец/админ/участник/гость) → группы → политики. SCIM-провиженинг для Business/Enterprise, журнал аудита, регионы хранения данных (РФ / ЕС), удаление аккаунта и экспорт данных (152-ФЗ, GDPR).
• Аккаунт не обязателен для Free/Home-офлайн; обязателен для подписок, облака, совместной работы, Assist.
• Токены: короткоживущий access (15 мин) + refresh (90 дней, ротация); хранение — Keychain (macOS), DPAPI/Credential Manager (Windows), Secret Service (Linux). Никаких токенов в файлах настроек.

9.3 Лицензионные ключи и активация

• Формат ключа: MOFC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX (25 символов Crockford Base32 без неоднозначных букв; внутри — редакция, тип (вечная/подписка/объёмная), число мест, серия, дата выпуска, контрольная часть). Ключ сам по себе ничего не «разблокирует»: он обменивается на лицензию.
• Лицензия — подписанный (Ed25519) файл license.mlic (CBOR): владелец, редакция, функции (features), устройства/отпечаток (хэш: ОС, ID машины, серийник диска/платы, без персональных данных), сроки, льготный период, канал обновлений, ограничения. Проверяется офлайн при каждом запуске; ключ подписи зашит в приложение, резервный — для ротации.
• Способы активации: онлайн (ключ → сервер → лицензия), через аккаунт (покупка привязывается к MOffice ID, устройства активируются входом), офлайн (файл запроса .mreq → портал/администратор → .mlic), плавающая (on-prem сервер лицензий выдаёт аренду на 1 ч, продлевается в фоне, 24 ч офлайн-резерв), объёмная (Enterprise: один ключ на N мест + политика автоактивации через MDM/GPO).
• Подписка: онлайн-проверка раз в 7 дней, льготный период 30 дней без сети, затем режим «только чтение и печать» (документы никогда не блокируются). Вечная лицензия: обновления в пределах мажорной версии.
• Деактивация и перенос устройств — из портала и из приложения; отзыв ключа — списком отзыва при проверке.
• Защита — разумная: подписи, проверки в нескольких местах ядра, целостность сборки; никакого DRM, который мешает честным пользователям; взлом не предотвратить полностью — цель «честным удобно, пиратам неудобно».

9.4 Серверная часть (Rust/axum + PostgreSQL, Docker-образы, on-prem вариант для Enterprise)

Домены (план): id.meridian-office.<tld>, license.…, account.… (портал), update.…, cloud.…. Enterprise получает тот же набор как docker compose для своей сети.

9.5 Как это живёт в структуре кода

kernel/crates/meridian-license/   ← проверка лицензий, отпечаток, аренда, флаги функций (Rust, без сети)
kernel/crates/meridian-id/        ← клиент аккаунтов: OAuth-поток, токены, хранилище ОС (Rust)
shell/src/account/                ← диалоги входа/активации, менеджер лицензий, значки состояния (QML/C++)
services/id-service/ services/license-service/ services/billing-service/ services/portal/ services/update-service/
tools/keygen/                     ← выпуск ключей и подпись лицензий (только у владельца, HSM/YubiKey)

Все функции, зависящие от редакции, в коде включаются через один механизм Features::has(Feature::X), а не разбросанными проверками; интерфейс показывает «замок» и предложение перейти на редакцию выше.

10. Решения по вопросам из документов (журнал, 2026-10-03)

Каждый документ заканчивается разделом «Вопросы к библии». Здесь — принятые решения; документы приводятся в соответствие постепенно, при расхождении действует этот раздел.

11. Повторное использование открытого кода (решения 2026-10-04)

С 2026-10-04 действует решение № 40 «весь код свой»: перечисленные ниже проекты — образцы алгоритмов и временные зависимости до замены своим кодом (порядок — docs/research/own-code-plan.md для ядра, docs/research/own-shell.md §8 для оболочки). Данные (шрифты, словари, шаблоны переносов, таблицы Unicode) — отдельные решения владельца.

Требование владельца: весь продукт — под собственной лицензией MOffice. Правила — docs/12-license-policy.md (классы 0–1 — без обязательств или только атрибуция; класс 2 — только по решению владельца; класс 3 — запрет). Полный отчёт и карта «что куда» — docs/11-open-source-reuse.md, реестр 669 проверенных компонентов — docs/research/oss-verified.tsv. Основные принятые решения:

11.1 Решения по спайкам A8 (перенесено из журнала A, с поправкой на решение № 40)

12. Решения владельца от 2026-10-04