Playbook
Playbook

Стандарты

Обязательные правила написания и организации кода.

Стандарты определяют обязательные правила написания и организации кода.

Приоритеты

ПриоритетЗначение
P0Обязательно. Блокирует merge
P1Важно. Должно быть исправлено
P2Желательно. При возможности

Архитектура (P0)

СтандартОписание
Ready-made SolutionsИспользование готовых решений

Структура проекта (P0)

СтандартОписание
Project StructureСтруктура папок и файлов
Auto-importsПравила авто-импортов
Component NamingИменование компонентов
Component DecompositionДекомпозиция компонентов
Package ManagerВыбор пакетного менеджера

Логика (P0)

СтандартОписание
ComposablesНаписание composables
API ClientРабота с API
StoresPinia stores

Backend (P0)

СтандартОписание
Service LayerАбстракция бизнес-логики, тонкие хэндлеры
Error HandlingКлассификация, middleware, формат ошибок
Backend APIREST API и event handlers
Socket.ioReal-time события и namespaces
PrismaSchema conventions и миграции
Type GenerationГенерация типов из Prisma и API

Формы (P0)

СтандартОписание
Forms & ValidationВалидация форм

Типизация (P1)

СтандартОписание
TypeScriptПравила типизации

Стилизация (P0)

СтандартОписание
Tailwind-onlyТолько Tailwind, без <style>
Responsive DesignАдаптивный дизайн (Mobile-First)
Mobile DevelopmentМобильная разработка (Capacitor)

UI/UX (P0)

СтандартОписание
UI/UX QualityВёрстка, темы, загрузка, переходы, ошибки

Качество (P0)

СтандартОписание
TestingТестирование

Политика кэширования REST API

API запросы ($fetch.create)

Используем $fetch.create() для создания преконфигурированного HTTP-клиента.