Документація
Опубліковано · перевірено 1 жовтня 2026. Це сайт, який ви читаєте. Публікація сторінки про функцію не створює саму функцію; більшість сторінок тут описують пропозиції.
Сайт документації зберігає те, що команда дослідила, вирішила й специфікувала, прототипи дизайну — і, поки що, лендинг. Це єдина частина Store Deputy з публічною адресою.
Що в ній є
| Розділ | Що в ньому |
|---|---|
| Концепція | Яким пропонується зробити продукт і яку проблему він розв'язує |
| Продукт | Перший продукт, контракт повноважень, план реалізації, протокол мосту та план розвитку |
| Архітектура | Цей розділ: частини й те, як їх побудовано |
| Сценарії користувача | Клікабельні прототипи дизайну модуля, входу та особистого кабінету. Це макети, а не продукт |
| Ринок | Конкуренти, потреби клієнтів, бізнес-модель і реєстр джерел |
| Рішення | Пропозиція продукту, назва й відкриті питання |
Головна сторінка — це лендинг.
Як її влаштовано
- Статичний сайт. Сторінки — це файли Markdown, з яких VitePress збирає звичайний HTML. Немає ні сервера, ні бази даних, і сайт ніколи не звертається до API.
- Три мови. Англійська — вихідна. Українська й російська повторюють кожну сторінку з тими самими заголовками й тими самими цілями посилань, тож під час зміни мови читач лишається на тому самому місці.
- Заздалегідь написані демонстрації. Лендинг, демо магазину й попередній перегляд сценарію акаунта — це компоненти всередині сайту документації. Мережевих запитів вони не роблять.
- Одна візуальна система — спільна для лендингу й документації.
- Хостинг. Статичний сайт на DigitalOcean App Platform, збирається з головної гілки репозиторію. Зміна з'являється там лише після коміту й надсилання.
Чому CleanSlice не застосовується
CleanSlice описує застосунки на NestJS і Nuxt. Сайт документації не є ні тим, ні іншим. У ньому немає слайсів, шарів і шлюзів, бо йому нічого захищати правилами й нізвідки отримувати дані. Його вміст організовано за розділами й за мовами.
Правила, які застосовуються
- Кожне твердження має статус. Перевірено, зроблено, але не перевірено від початку до кінця, прийнятий напрям, пропозиція або історія — і статус має бути видно з першого погляду.
- Нічого не вигадувати. Жодних вимірювань, клієнтів, скриншотів чи успішних запусків, яких не було. Де доказу немає, сторінка каже, що його немає.
- Три мови змінюються разом. Після збірки перевірка порівнює три дерева сторінок, якорі заголовків і кожне внутрішнє посилання.
- Спершу збірка, потім твердження. Сторінку не називають робочою, доки не пройдуть продакшн-збірка й перевірка мов.