Initial commit

2026-10-09 01:45:17 +00:00
commit 41d230d524
@@ -0,0 +1,63 @@
+# Разработка шаблона Scientia
+
+> Скрытая документация для сопровождающих Typst-библиотеки. Инструкции авторов находятся в публичном каталоге [`docs/`](../../../docs/README.md).
+
+## Текущее устройство
+
+Автор работает с единственным `main.typ`, каталогами `chapters/`, `assets/` и видимой документацией `docs/`. Внутренняя библиотека, профили организаций, тесты и архитектурные решения находятся в `.template/`.
+
+Режим `final`, `draft` или `clean-copy` выбирается переменной внутри `main.typ`. Компилируемые публичные примеры четырёх видов документов и элементов оформления одновременно являются источниками для задачи выбора типа документа.
+
+Обычная сборка использует векторные заглушки. Готовая папка `.private` подключается одним literal-переключателем в `main.typ`; отдельного ZIP installer и отдельной build task нет.
+
+## Команды сопровождающего
+
+```powershell
+# Пользовательский документ
+typst compile --root . main.typ document.pdf
+
+# Полная регрессия
+python .template/development/tests/run-tests.py
+```
+
+## Навигация
+
+| Документ | Назначение |
+|----------|------------|
+| [PLAN.md](PLAN.md) | Завершённые фазы редизайна и проверки |
+| [ARCHITECTURE.md](ARCHITECTURE.md) | Структура, компоненты, data flow и режимы отказа |
+| [ADR-0001](adr/0001-typst-015.md) | Typst 0.15.1 как baseline |
+| [ADR-0002](adr/0002-data-and-assets.md) | Границы данных и ресурсов |
+| [ADR-0003](adr/0003-rendering-model.md) | Детерминированная модель выполнения |
+| [ADR-0004](adr/0004-error-handling.md) | Ошибки и media fallback |
+| [ADR-0005](adr/0005-ddd-boundaries.md) | Направление зависимостей |
+| [ADR-0006](adr/0006-visual-regression.md) | Визуальная регрессия |
+| [ADR-0007, устарел](adr/0007-author-workspace.md) | Историческое решение о трёх entrypoints |
+| [ADR-0008](adr/0008-vscode-onboarding.md) | Версионируемая рабочая область VS Code |
+| [ADR-0009](adr/0009-single-main-and-public-docs.md) | Один `main.typ`, публичные примеры и приватная сборка |
+| [ADR-0010](adr/0010-private-folder-and-employees.md) | Папка `.private`, справочник сотрудников и частичные подписи |
+| [Рабочее пространство автора](../modules/author-workspace.md) | Минимальный корень и один входной файл |
+| [Публичные примеры](../modules/starter-packs.md) | Четыре вида документов и каталог оформления |
+| [Публичная документация](../modules/user-documentation.md) | Видимый `docs/` для авторов |
+| [Рабочая область VS Code](../modules/vscode-workspace.md) | Расширения, задачи и настройки |
+| [Приватные ресурсы](../modules/private-assets.md) | Справочник сотрудников, `.private/settings.typ`, offsets и placeholders |
+| [Публичный фасад](../modules/facade.md) | Стабильный Typst API |
+| [Документ](../modules/domain-document.md) | Профили и режимы выпуска |
+| [Организация](../modules/domain-company.md) | Реквизиты и ресурсы компании |
+| [Стороны](../modules/domain-parties.md) | Адресаты, подписанты и стороны |
+| [Приложения](../modules/domain-attachments.md) | Приложения разных видов документов |
+| [Сборка](../modules/application-render.md) | Application orchestration |
+| [Ресурсы компаний](../modules/infrastructure-assets.md) | Загрузка публичных профилей и overrides |
+| [Основа вёрстки](../modules/presentation-foundation.md) | Tokens и media policy |
+| [Отчёт](../modules/presentation-report.md) | Renderer отчёта |
+| [Письмо](../modules/presentation-letter.md) | Renderer письма |
+| [ТКП](../modules/presentation-commercial-offer.md) | Renderer предложения |
+| [Договор](../modules/presentation-contract.md) | Renderer договора |
+| [Компоненты](../modules/components.md) | Таблицы, формулы и подписи |
+| [Ссылки](../modules/references.md) | Перекрёстные ссылки и библиография |
+| [Нумерация](../modules/numbering.md) | Стратегии нумерации |
+| [Тестирование](../modules/testing.md) | Static, compile, semantic и visual suites |
+
+## Статус
+
+Редизайн принят. Корневой и публичные примеры компилируются на Typst 0.15.1; полная тестовая матрица является release gate.