# DragonZord Teste 06 — E-commerce Open Source

Repositório de arquitetura e homologação de **10 plataformas de e-commerce open source** para uso
estratégico no Grupo Reis. O objetivo não é clonar os projetos, mas catalogar decisões técnicas,
requisitos de infraestrutura, riscos e recomendações de uso corporativo.

> **Princípios**
> - Nenhuma dependência de plataformas de deploy descontinuadas (zero Netlify).
> - Infraestrutura de referência em AWS EC2 (`3.18.191.22`), RDS, S3, CloudFront e ElastiCache.
> - Nenhum código pesado ou binário é baixado para a máquina local.
> - Cada módulo possui `.env.example` padronizado e documentação própria.

---

## 1. Matriz de plataformas

| # | Plataforma | Stack | Tipo | Banco | Licença | Melhor cenário | Complexidade |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 01 | Medusa.js | TypeScript / Node.js | Headless | PostgreSQL + Redis | MIT | B2C/B2B headless moderno | Média |
| 02 | Bagisto | PHP / Laravel | Monolítico / Multi-vendedor | MySQL / MariaDB | MIT | Multi-vendedor e B2B | Média |
| 03 | Saleor | Python / Django | Headless / GraphQL | PostgreSQL + Redis | BSD-3-Clause | B2C headless com GraphQL | Alta |
| 04 | Spree Commerce | Ruby / Rails | Modular / B2B/B2C | PostgreSQL + Redis | BSD-3-Clause | B2B e catálogos complexos | Alta |
| 05 | WooCommerce | PHP / WordPress | Monolítico / Plugin | MySQL / MariaDB | GPL-3.0 | B2C com ecossistema de plugins | Baixa |
| 06 | EverShop | TypeScript / React / Node.js | Headless / Modular | MySQL / MariaDB | MIT | B2C moderno com React | Média |
| 07 | PrestaShop | PHP | Monolítico / Multi-loja | MySQL / MariaDB | OSL 3.0 | B2C tradicional com módulos | Média |
| 08 | Sylius | PHP / Symfony | Headless / B2B/B2C | PostgreSQL + Redis | MIT | B2B e projetos Symfony | Alta |
| 09 | OpenCart | PHP | Monolítico / Leve | MySQL / MariaDB | GPL-3.0 | Lojas pequenas e médias | Baixa |
| 10 | Vendure | TypeScript / NestJS | Headless / GraphQL | PostgreSQL + Redis | GPL-3.0 | B2C/B2B com TypeScript | Média |

---

## 2. Estrutura do repositório

```
dragonzord-teste-06/
├── 01-typescript-node/
│   └── medusa/
│       ├── README.md
│       └── .env.example
├── 02-php-laravel/
│   └── bagisto/
├── 03-python-django/
│   └── saleor/
├── 04-ruby-rails/
│   └── spree/
├── 05-wordpress/
│   └── woocommerce/
├── 06-typescript-react/
│   └── evershop/
├── 07-php-prestashop/
│   └── prestashop/
├── 08-php-symfony/
│   └── sylius/
├── 09-php-opencart/
│   └── opencart/
├── 10-typescript-nest/
│   └── vendure/
├── docs/
│   └── AWS-EC2.md
└── README.md
```

Cada pasta contém:

- `README.md`: arquitetura, prós, contras, infraestrutura e recomendação.
- `.env.example`: variáveis de ambiente padronizadas para desenvolvimento.

---

## 3. Arquitetura de referência AWS

### 3.1 Componentes

| Camada | Serviço | Uso |
| --- | --- | --- |
| Compute | AWS EC2 | Aplicação, workers e serviços auxiliares |
| Load Balancer | ALB | Distribuição de tráfego e TLS |
| Banco relacional | Amazon RDS | PostgreSQL ou MySQL/MariaDB gerenciado |
| Cache / filas | ElastiCache Redis | Sessões, cache, filas e rate limit |
| Storage | Amazon S3 | Imagens, vídeos, exports e backups |
| CDN | CloudFront | Entrega estática e cache de mídia |
| DNS / TLS | Route 53 + ACM | Domínio e certificados |
| E-mail | Amazon SES | Transacional e marketing |
| Segredos | AWS SSM Parameter Store / Secrets Manager | Credenciais e chaves |
| Observabilidade | CloudWatch | Logs, métricas e alarmes |

### 3.2 Topologia mínima

```
Route 53 → CloudFront → ALB → EC2 (app + worker)
                              ├── RDS PostgreSQL/MySQL
                              ├── ElastiCache Redis
                              ├── S3 (assets/backups)
                              └── SES (e-mail)
```

### 3.3 EC2 de referência

- Host de homologação: `3.18.191.22`
- Segurança: Security Group mínimo, SSH apenas via SSM Session Manager ou bastion.
- Acesso: IAM role para S3/SSM; sem chaves longas no servidor.
- Backup: snapshots RDS, versionamento S3 e exportação de banco.
- Observabilidade: CloudWatch Agent, logs centralizados e alarmes de CPU/disco/fila.

Detalhes em [`docs/AWS-EC2.md`](docs/AWS-EC2.md).

---

## 4. Recomendação por cenário

| Cenário | Recomendação | Motivo |
| --- | --- | --- |
| B2C rápido com plugins | WooCommerce | Ecossistema maduro e baixo custo inicial |
| B2C moderno headless | Medusa ou Vendure | TypeScript, API-first e deploy em containers |
| B2B / catálogo complexo | Spree ou Sylius | Regras de negócio e customização |
| Multi-vendedor | Bagisto | Marketplace e vendor panel |
| GraphQL / Python | Saleor | API GraphQL e admin dashboard |
| Projeto Symfony | Sylius | Integração com ecossistema Symfony |
| Loja tradicional PHP | PrestaShop ou OpenCart | Maturidade e hospedagem simples |

---

## 5. Padrões de deploy

- **Desenvolvimento:** Docker Compose com app, banco, Redis e MailHog.
- **Staging:** EC2 + RDS + S3, com dados anonimizados.
- **Produção:** ALB + EC2/ECS + RDS Multi-AZ + ElastiCache + S3 + CloudFront.
- **CI/CD:** GitHub Actions para build, testes e deploy; sem Netlify.
- **Migrações:** executadas como job separado antes do deploy da aplicação.
- **Rollback:** imagem/tag anterior + snapshot de banco.

---

## 6. Segurança e governança

- Nunca versionar `.env` real. Apenas `.env.example`.
- Segredos no SSM/Secrets Manager, nunca no repositório.
- Princípio de menor privilégio em IAM e Security Groups.
- WAF no ALB/CloudFront para lojas públicas.
- Backups testados e criptografados.
- Atualização de dependências e imagens base.
- Revisão de licenças antes de uso comercial (GPL, OSL, BSD, MIT).

---

## 7. Status dos módulos

| Módulo | Status | Documentação | `.env.example` |
| --- | --- | --- | --- |
| Medusa.js | Catalogado | OK | OK |
| Bagisto | Catalogado | OK | OK |
| Saleor | Catalogado | OK | OK |
| Spree Commerce | Catalogado | OK | OK |
| WooCommerce | Catalogado | OK | OK |
| EverShop | Catalogado | OK | OK |
| PrestaShop | Catalogado | OK | OK |
| Sylius | Catalogado | OK | OK |
| OpenCart | Catalogado | OK | OK |
| Vendure | Catalogado | OK | OK |

---

## 8. Próximos passos

1. Escolher 2 ou 3 plataformas para prova de conceito.
2. Subir cada uma em staging na AWS EC2 com RDS e S3.
3. Medir performance, custo, complexidade de manutenção e aderência ao B2B/B2C.
4. Registrar resultados em relatórios de homologação.
5. Definir o padrão corporativo do Grupo Reis.

---

## 9. Licença

A documentação deste repositório é MIT. Cada plataforma catalogada mantém sua própria licença; consulte
o `README.md` do módulo e o repositório oficial antes de qualquer uso comercial.