Add test coverage checklist, report template, and stack matrix for ecommerce project
- Created a test coverage checklist to ensure comprehensive testing of backend and frontend components. - Added a test report template to standardize reporting on test execution results and gaps. - Introduced a test stack matrix to guide the selection of testing tools and frameworks for backend and frontend. - Established a skill for repairing failing tests, including a failure triage checklist and a test repair template. - Documented recommended MCP stack for ecommerce development with FastAPI and React/Next.js. - Developed a detailed README outlining the project structure, agent capabilities, and recommended workflows. - Compiled a comprehensive workflow guide detailing step-by-step commands for project setup, testing, and SEO implementation.
This commit is contained in:
ВяткинАртём
@@ -0,0 +1,100 @@
|
||||
# Рекомендуемый стек MCP
|
||||
|
||||
Этот файл описывает рекомендуемый набор MCP для ecommerce-разработки на FastAPI + React или Next.js.
|
||||
|
||||
## Приоритет 1: добавить в первую очередь
|
||||
|
||||
### 1. Context7 или docs MCP
|
||||
|
||||
- Назначение: получать актуальную документацию и примеры по FastAPI, SQLAlchemy, Pydantic, Next.js, React, Playwright, pytest, Alembic и связанным инструментам.
|
||||
- Почему это важно: снижает риск устаревших решений и помогает агенту ориентироваться на реальные версии библиотек.
|
||||
- Лучше всего подходит для: архитектурных решений, работы с API библиотек, миграций, framework-specific паттернов и отладки незнакомых интеграций.
|
||||
|
||||
### 2. Playwright MCP
|
||||
|
||||
- Назначение: автоматизация браузера, проверка UI, скриншоты, инспекция DOM, диагностика консоли и e2e-валидация.
|
||||
- Почему это важно: один из самых полезных MCP для storefront-флоу, checkout, auth, admin panel, фильтров и regression testing.
|
||||
- Лучше всего подходит для: frontend-разработки, acceptance testing, визуальных проверок и воспроизведения browser-багов.
|
||||
|
||||
### 3. PostgreSQL MCP
|
||||
|
||||
- Назначение: смотреть схему, выполнять запросы, проверять миграции, валидировать данные и разбирать persistence-проблемы.
|
||||
- Почему это важно: критически полезен для FastAPI backend в ecommerce, где есть каталог, заказы, пользователи, права и миграции.
|
||||
- Лучше всего подходит для: backend-разработки, отладки данных, ревью миграций и ручной проверки business rules.
|
||||
|
||||
### 4. Docker или Compose MCP
|
||||
|
||||
- Назначение: управлять сервисами, смотреть логи, поднимать и останавливать стек, валидировать локальную containerized-среду.
|
||||
- Почему это важно: особенно полезен, если backend, frontend, db, redis, search или storage запускаются через Compose.
|
||||
- Лучше всего подходит для: локальной orchestration, просмотра логов сервисов, воспроизводимых сред и integration debugging.
|
||||
|
||||
### 5. GitLab MCP или GitHub MCP
|
||||
|
||||
- Назначение: работать с merge request или pull request, issues, CI pipelines, метаданными репозитория, review и automation context.
|
||||
- Почему это важно: замыкает цикл между кодом, review и CI.
|
||||
- Лучше всего подходит для: командной разработки, review cycle, issue-driven delivery и видимости пайплайнов.
|
||||
- Рекомендация: если проект живет в GitLab, приоритет у GitLab MCP; иначе GitHub MCP.
|
||||
|
||||
## Приоритет 2: очень полезно для ecommerce-проектов
|
||||
|
||||
### 6. Redis MCP
|
||||
|
||||
- Назначение: смотреть cache, sessions, queues, rate limits, pubsub и временное состояние.
|
||||
- Почему это важно: полезен, если корзины, сессии, async jobs, search cache или throttling используют Redis.
|
||||
- Лучше всего подходит для: отладки cache invalidation, auth sessions, task queues и временного commerce-state.
|
||||
|
||||
### 7. S3 или MinIO MCP
|
||||
|
||||
- Назначение: смотреть buckets, uploads, media assets, exports и generated files.
|
||||
- Почему это важно: в ecommerce почти всегда есть product images, баннеры, документы, import и export.
|
||||
- Лучше всего подходит для: asset handling, media debugging и проверки storage workflows.
|
||||
|
||||
### 8. Browser или DevTools MCP
|
||||
|
||||
- Назначение: смотреть network, frontend console, performance, hydration issues, layout bugs и rendering diagnostics.
|
||||
- Почему это важно: хорошо дополняет Playwright, когда нужен более низкоуровневый browser debugging.
|
||||
- Лучше всего подходит для: performance, network failures, client exceptions и сложных rendering-проблем.
|
||||
|
||||
### 9. Sentry MCP
|
||||
|
||||
- Назначение: смотреть production errors, stack traces, release regressions и alert context.
|
||||
- Почему это важно: особенно полезен после деплоя или на проекте, где уже есть реальные пользователи.
|
||||
- Лучше всего подходит для: post-release debugging, bug triage и поиска реальных high-impact проблем.
|
||||
|
||||
## Приоритет 3: добавлять только по необходимости
|
||||
|
||||
### 10. OpenAPI или API testing MCP
|
||||
|
||||
- Назначение: валидировать REST-контракты, гонять API-сценарии, смотреть схемы и проверять integration flows.
|
||||
- Почему это важно: полезен, если в проекте важна API-first валидация или команда опирается на contract testing.
|
||||
- Лучше всего подходит для: backend QA, API verification, smoke tests и integration debugging.
|
||||
|
||||
### 11. Stripe MCP
|
||||
|
||||
- Назначение: смотреть оплаты, checkout sessions, webhooks, customers и billing flows.
|
||||
- Почему это важно: нужен только если проект реально использует Stripe.
|
||||
- Лучше всего подходит для: отладки платежей и проверки webhook flows.
|
||||
|
||||
### 12. Kubernetes MCP
|
||||
|
||||
- Назначение: смотреть workloads, логи, config, namespaces и deploy state.
|
||||
- Почему это важно: полезен только если команда реально деплоит или дебажит через Kubernetes.
|
||||
- Лучше всего подходит для: staging и production operations.
|
||||
|
||||
## Рекомендуемый базовый набор для этого стека
|
||||
|
||||
Если нужен сильный и практичный базовый набор, сначала стоит добавить:
|
||||
|
||||
1. Context7 или docs MCP
|
||||
2. Playwright MCP
|
||||
3. PostgreSQL MCP
|
||||
4. Docker или Compose MCP
|
||||
5. GitLab MCP или GitHub MCP
|
||||
6. Redis MCP, если стек использует cache или queues
|
||||
7. S3 или MinIO MCP, если стек использует media storage
|
||||
|
||||
## Правило выбора
|
||||
|
||||
- Добавляй те MCP, которые закрывают реальные пробелы в разработке, тестировании, отладке, review и эксплуатации.
|
||||
- Не перегружай конфиг узкоспециализированными MCP, которые проекту не нужны.
|
||||
- В приоритете инструменты, которые ускоряют цикл работы сразу по backend, frontend, тестам, CI и production debugging.
|
||||
Reference in New Issue
Block a user