Документация
Опубликована · проверено 1 октября 2026. Это сайт, который вы читаете. Публикация страницы о функции не создаёт саму функцию; большинство страниц здесь описывают предложения.
Сайт документации хранит то, что команда исследовала, решила и специфицировала, прототипы дизайна — и, пока что, лендинг. Это единственная часть Store Deputy с публичным адресом.
Что в ней есть
| Раздел | Что в нём |
|---|---|
| Концепция | Каким предлагается сделать продукт и какую проблему он решает |
| Продукт | Первый продукт, контракт полномочий, план реализации, протокол моста и план развития |
| Архитектура | Этот раздел: части и то, как они построены |
| Сценарии пользователя | Кликабельные прототипы дизайна модуля, входа и личного кабинета. Это макеты, а не продукт |
| Рынок | Конкуренты, потребности клиентов, бизнес-модель и реестр источников |
| Решения | Предложение продукта, название и открытые вопросы |
Главная страница — это лендинг.
Как она устроена
- Статический сайт. Страницы — это файлы Markdown, из которых VitePress собирает обычный HTML. Нет ни сервера, ни базы данных, и сайт никогда не обращается к API.
- Три языка. Английский — исходный. Украинский и русский повторяют каждую страницу с теми же заголовками и теми же целями ссылок, поэтому при смене языка читатель остаётся на том же месте.
- Заранее написанные демонстрации. Лендинг, демо магазина и предпросмотр сценария аккаунта — это компоненты внутри сайта документации. Сетевых запросов они не делают.
- Одна визуальная система — общая для лендинга и документации.
- Хостинг. Статический сайт на DigitalOcean App Platform, собирается из главной ветки репозитория. Изменение появляется там только после коммита и отправки.
Почему CleanSlice не применяется
CleanSlice описывает приложения на NestJS и Nuxt. Сайт документации не является ни тем, ни другим. В нём нет слайсов, слоёв и шлюзов, потому что ему нечего защищать правилами и неоткуда получать данные. Его содержимое организовано по разделам и по языкам.
Правила, которые применяются
- У каждого утверждения есть статус. Проверено, сделано, но не проверено от начала до конца, принятое направление, предложение или история — и статус должен быть виден с первого взгляда.
- Ничего не выдумывать. Никаких измерений, клиентов, скриншотов или успешных запусков, которых не было. Где доказательства нет, страница говорит, что его нет.
- Три языка меняются вместе. После сборки проверка сравнивает три дерева страниц, якоря заголовков и каждую внутреннюю ссылку.
- Сначала сборка, потом утверждение. Страницу не называют рабочей, пока не пройдут продакшн-сборка и проверка языков.