# Medusa.js

**Categoria:** Headless TypeScript/Node.js · **Licença:** MIT · **Banco:** PostgreSQL + Redis

## Visão geral

Medusa é uma plataforma de comércio headless construída em Node.js e TypeScript. A arquitetura é modular,
com APIs de admin e storefront, plugins e workflows. É indicada para times que querem um backend de
e-commerce moderno, API-first e fácil de integrar com frontends React/Next.js.

## Prós

- TypeScript nativo e arquitetura modular.
- API-first, headless e independente de frontend.
- Ecossistema de plugins e workflows.
- Boa integração com PostgreSQL, Redis e S3.
- Comunidade ativa e documentação moderna.

## Contras

- Ecossistema menor que WooCommerce/Shopify.
- Exige conhecimento de Node.js/TypeScript.
- Admin dashboard precisa ser avaliado ou customizado.
- Curva de aprendizado para regras de inventário e regiões.

## Infraestrutura mínima

- EC2: 2 vCPU / 4 GB (staging), 4 vCPU / 8 GB (produção).
- RDS PostgreSQL.
- ElastiCache Redis para cache e filas.
- S3 para mídia e backups.
- CloudFront para assets.

## Deploy

- Docker Compose para desenvolvimento.
- Imagem Docker versionada em ECR.
- Migrações via job separado.
- Nginx/ALB na frente da aplicação.

## Variáveis

Veja [`.env.example`](.env.example).

## Recomendação Grupo Reis

Boa opção para B2C/B2B headless moderno, especialmente se o time já domina TypeScript. Validar custo de
manutenção e maturidade dos plugins antes de produção.