# Конфігурація проєкту

## Огляд проєкту
- **Назва**: Платформа електронної комерції
- **Технологічний стек**: 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 деплою
- Автоматичний відкат при невдачі
- Міграції БД виконуються перед деплоєм

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

| Команда | Призначення |
|---------|-------------|
| `npm run dev` | Запуск сервера розробки |
| `npm test` | Запуск тестового набору |
| `npm run lint` | Перевірка стилю коду |
| `npm run build` | Збірка для продакшну |
| `npm run migrate` | Запуск міграцій БД |

## Контакти команди
- Техлід: 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