6172aacfd5
01-slash-commands: 7 slash command examples 02-memory: 3 CLAUDE.md examples Progress: 25/67 files Ref: luongnv89/claude-howto#63
92 lines
4.0 KiB
Markdown
92 lines
4.0 KiB
Markdown
# Конфігурація проєкту
|
||
|
||
## Огляд проєкту
|
||
- **Назва**: Платформа електронної комерції
|
||
- **Технологічний стек**: 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
|