Estrutura do Projeto

mercodocs/
├── scraper/              ← Projeto Scrapy (spiders, settings, utils)
│   ├── spiders/          ← Spiders de coleta (base + 4 spiders)
│   ├── constants.py      ← Timeouts e constantes compartilhadas
│   ├── items.py          ← Schema dos itens produzidos
│   └── html/             ← Fixtures HTML para testes offline
├── tests/                ← Testes automatizados (pytest)
├── website/              ← Site de documentação (Astro/Starlight)
├── docs/                 ← Documentação técnica (ARCHITECTURE.md)
├── scripts/              ← Scripts utilitários
└── .github/              ← CI/CD (GitHub Actions) e templates de PR