Огляд проєкту

• Назва: Платформа електронної комерції
• Технологічний стек: Node.js, PostgreSQL, React 18, Docker
• Розмір команди: 5 розробників
• Дедлайн: Q4 2025

Архітектура

@docs/architecture.md @docs/api-standards.md @docs/database-schema.md

Стандарти розробки

Стиль коду

• Використовувати Prettier для форматування
• Використовувати ESLint з конфігурацією airbnb
• Максимальна довжина рядка: 100 символів
• Використовувати відступ 2 пробіли

Конвенції іменування

• Файли: kebab-case (user-controller.js)
• Класи: PascalCase (UserService)
• Функції/Змінні: camelCase (getUserById)
• Константи: UPPER_SNAKE_CASE (API_BASE_URL)
• Таблиці БД: snake_case (user_accounts)

Git-процес

• Назви гілок: feature/description або fix/description
• Повідомлення комітів: дотримуватися conventional commits
• PR обовʼязковий перед злиттям
• Усі CI/CD перевірки мають пройти
• Мінімум 1 затвердження (approval) обовʼязкове

Вимоги до тестування

• Мінімум 80% покриття коду
• Усі критичні шляхи мають мати тести
• Використовувати Jest для юніт-тестів
• Використовувати Cypress для E2E-тестів
• Назви тестових файлів: *.test.ts або *.spec.ts

Стандарти API

• Лише RESTful ендпоінти
• JSON запит/відповідь
• Правильно використовувати HTTP-статус-коди
• Версіонування API-ендпоінтів: /api/v1/
• Документувати всі ендпоінти з прикладами

База даних

• Використовувати міграції для змін схеми
• Ніколи не зашивати облікові дані в код
• Використовувати пул зʼєднань (connection pooling)
• Увімкнути логування запитів у середовищі розробки
• Регулярне резервне копіювання обовʼязкове

Деплой

• Деплой на основі Docker
• Оркестрація Kubernetes
• Стратегія blue-green деплою
• Автоматичний відкат при невдачі
• Міграції БД виконуються перед деплоєм

Типові команди

Контакти команди

• Техлід: Sarah Chen (@sarah.chen)
• Продакт-менеджер: Mike Johnson (@mike.j)
• DevOps: Alex Kim (@alex.k)

Відомі проблеми та обхідні рішення

• Пул зʼєднань PostgreSQL обмежений до 20 у пікові години
• Обхідне рішення: реалізувати чергу запитів
• Проблеми сумісності Safari 14 з async generators
• Обхідне рішення: використовувати транспілятор Babel

Повʼязані проєкти

• Аналітична панель: /projects/analytics
• Мобільний додаток: /projects/mobile
• Адмін-панель: /projects/admin

Останнє оновлення: 9 квітня 2026