Руководства по разработке

Сайт использует Next.js с App Router, React, TypeScript и Bootstrap 5, дополненный собственной таблицей стилей BI3LYX. Редакционные страницы генерируются из типизированных данных в репозитории.

app/

Маршруты, макеты, метаданные, карта сайта, RSS-лента и маршрут статуса.

components/

Переиспользуемые компоненты интерфейса, включая навигацию, карточки и обозреватель.

lib/

Типизированные редакционные данные, конфигурация сайта и модели будущего API.

tests/

Тесты контента, навигации, компонентов и рендеринга страниц.

• npm install — установить зависимости.
• npm run dev — запустить сервер разработки.
• npm run typecheck — проверить TypeScript без генерации файлов.
• npm run lint — проанализировать код с помощью ESLint.
• npm test — запустить набор тестов.
• npm run build — собрать production-сборку.
• npm start — запустить сборку Next.js.

Страницы документации и новости описываются типизированными блоками. Каждая новая публикация должна содержать уникальный slug, заголовок, описание, дату и текст, написанный без неподтверждённых данных.

• Проверять внутренние ссылки и метаданные.
• Чётко указывать информацию, находящуюся в подготовке.
• Никогда не публиковать вымышленные статистики или смоделированные скриншоты.
• Давать на вычитку технические утверждения перед публикацией.

• Сохранять серверный слой доступа отдельно от компонентов отображения.
• Настраивать URL API только через переменную окружения.
• Предусмотреть тайм-аут и явное состояние ошибки.
• Проверять схемы ответов перед отображением.
• Никогда не раскрывать URL RPC, секрет или данные кошелька.

• Никаких прямых изменений производственной инфраструктуры из репозитория сайта.
• Любое изменение должно проходить типизацию, lint, тесты и сборку.
• Коммиты и развёртывания требуют разрешения руководителя проекта.
• Бинарные файлы никогда не публикуются с сайта без проверки и подписи.