Цели, требования и ограничения¶

Цели и нецели¶

Основные цели проекта¶

Сохранить портативные исходные форматы (Markdown / GFM, Mermaid, обычные ассеты) как рабочее представление.
Получать профессиональные deliverable (печатная вёрстка и PDF) из этого исходника без проприетарного формата редактора.
Поддержать diagrams-as-code, чтобы архитектурные и sequence-диаграммы оставались в том же файле, что и текст.
Изолировать сбои рендеринга, чтобы одна сломанная диаграмма не ломала весь документ.
Сохранить client-side-first / локальное поведение для рендеринга, стилей, локальных ассетов и операций с PDF.
Сделать использование ИИ финансово ограниченным через кредиты и контроль стоимости.
Сделать поведение ИИ конфигурируемым и версионируемым независимо от деплоев приложения.
Обеспечить историю трансформаций и административную наблюдаемость серверных AI-задач.
Двигаться к явным Artifact Contract: компиляция успешна, выдала предупреждения или завершилась ошибкой.
Поддержать Git-native выходы, чтобы артефакт мог вернуться в существующий workflow пользователя.

Что не входит в проект¶

Не является универсальным облачным workspace для документов или заменой Notion/Confluence.
Не является WYSIWYG-клоном Word и не делает проприетарный блочный редактор источником истины.
Не является гарантией отсутствия галлюцинаций в AI-выходе. Целевые проверки - детерминированная валидация, привязка к исходнику и ограниченный ремонт - а не недоказуемое утверждение «полностью верифицированный ИИ».
Не привязан навсегда к одному вендору LLM.
Не выдумывает отсутствующие профессиональные факты, если в исходнике нет свидетельств; неразрешённые пункты должны оставаться неразрешёнными.
Не включает формальные значения SLA / RTO / RPO в этом портфолио-пакете. Эти значения - Unknown / TBD, пока они не определены в эксплуатационных артефактах проекта.
Текущая архитектура не предполагает EC2 или постоянно работающие контейнеры, если их нет в продуктовом репозитории.

Требования¶

Бизнес-требования¶

BR-001. Портативный источник истины.
Пользователь должен иметь возможность работать в Markdown (GFM), с Mermaid, иконками архитектуры, YAML front matter и обычными ссылками на изображения, без конвертации в проприетарный формат хранения.
BR-002. Последняя миля профессиональной публикации.
Система должна рендерить профессиональный документ и поддерживать экспорт PDF из локального исходника, включая печатную вёрстку и укрепление пагинации.
BR-003. Local-first по умолчанию.
Рендеринг, стили, локальные ассеты, Mermaid и локальные операции с PDF должны работать в браузере. Содержимое документа не должно покидать браузер, пока пользователь явно не запросит серверную операцию.
BR-004. Ограниченная AI-компиляция.
Серверные AI-трансформации должны тарифицироваться (кредиты), контролироваться по стоимости и быть атрибутируемыми к пользователю и типу трансформации.
BR-005. Конфигурируемое поведение ИИ.
Промпты и связанная runtime-конфигурация должны версионироваться и публиковаться / откатываться без повторного деплоя приложения.
BR-006. Идентичность и администрирование.
Аутентифицированные SaaS-операции должны использовать управляемую идентичность. Должна существовать административная control plane для конфигурации, наблюдаемости и повышенных ролей.
BR-007. Коммерческий контур.
Единица монетизации - интеллект с переменной стоимостью. Качество локального рендеринга не должно искусственно ухудшаться, чтобы вынудить оплату.
BR-008. Направление Artifact Contract.
Продукт должен эволюционировать от «модель что-то сгенерировала» к явному результату компиляции: успех, предупреждения или ошибка относительно контракта Compiler.
BR-009. Направление привязки к свидетельствам.
Важные утверждения в выходе должны становиться трассируемыми к исходным свидетельствам. Отсутствующие свидетельства нельзя молча заполнять.
BR-010. Git-native выходы.
Скомпилированные артефакты должны иметь возможность вернуться в локальные файлы, загрузки и позднее Git / CLI workflow, а не оставаться запертыми в проприетарном хранилище.

В публичной версии приведён сокращённый фрагмент требований. Внутренние суммы биллинга, тексты промптов и неопубликованные контракты Compiler не раскрываются.

Правила и ограничения¶

Business Rules¶

RULE-001. Локальная работа не требует загрузки.
Открытие, редактирование, рендеринг и экспорт документа локально не должны требовать отправки тела документа на бэкенд.
RULE-002. Серверная обработка явна.
Содержимое отправляется на бэкенд только когда пользователь вызывает серверную возможность, например AI-компиляцию.
RULE-003. Кредиты тарифицируют compute, а не качество публикации.
Бесплатные / локальные возможности дают фундамент создания и публикации. Кредиты оплачивают AI / compute-тяжёлые операции.
RULE-004. Не выдумывать отсутствующие факты.
Компиляция не должна представлять неподтверждённые профессиональные факты так, будто они были в исходнике. Неразрешённые решения остаются неразрешёнными.
RULE-005. Инварианты Compiler выше шаблонов.
Пользовательский шаблон выхода может менять структуру артефакта. Он не должен ослаблять гарантии Compiler (привязка к свидетельствам, валидаторы, границы ремонта).
RULE-006. LLM-провайдер сменяем.
Ценность продукта лежит в спецификациях Compiler, контрактах, моделях свидетельств, валидаторах, ремонте и оценке качества - а не в одном промпте или одном вендоре.

Ограничения¶

CON-001. Serverless-архитектура под руководством основателя, чувствительная к стоимости.
Стоимость простоя должна оставаться низкой. Постоянно работающие бэкенды избегаются, пока нагрузка их не оправдывает.
CON-002. Без ненужного постоянного бэкенда документов.
Система не должна требовать проприетарного облачного хранения документов для основного пути публикации.
CON-003. Без обязательной аутентификации для чисто локальных / бесплатных функций.
Идентичность нужна для SaaS / AI / биллинговых операций, а не для локального рендеринга.
CON-004. Приватно-чувствительное профессиональное содержимое.
Черновики могут включать неопубликованную архитектуру, требования и персональные карьерные данные. Обработка по умолчанию остаётся в браузере.
CON-005. Инфраструктура AWS должна воспроизводиться через Terraform.
Продакшен-окружение - не click-ops в консоли.
CON-006. Сначала serverless-оркестрация.
Специализированный compute (например ECS Fargate) вводится только когда границ Lambda недостаточно. EC2 / GPU - только если будущий self-hosted inference или устойчивая нагрузка это оправдают.
CON-007. Формальные операционные SLA - TBD.
Этот портфолио-пакет не выдумывает цели RTO / RPO / доступности.