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