O CurvaDeMana é uma plataforma brasileira para jogadores de Magic: The Gathering. Ela reúne, em português e em um só lugar, três ferramentas que normalmente vivem espalhadas por sites diferentes:

• Busca avançada sobre todas as cartas do jogo, com filtros próprios.
• Deck builder com validação por formato e análise da curva de mana em tempo real.
• Coleção pessoal, integrada ao deck builder para mostrar o que falta para montar cada baralho.

A premissa técnica

Todas as cartas vivem em um banco de dados próprio, alimentado pelo dump público da Scryfall. A busca, os filtros e a ordenação rodam localmente, sem depender de uma API externa a cada consulta. Isso dá controle total sobre como as cartas são organizadas e pesquisadas, e mantém a experiência rápida.

A única consulta em tempo real à Scryfall acontece quando você troca a arte de uma carta, momento em que buscamos as impressões alternativas sob demanda.

Como esta documentação se organiza

A documentação acompanha o produto e é revisada a cada leva de mudanças. Ela está dividida em quatro frentes:

• Começando: o que é a plataforma e como colocá-la para rodar.
• Guia de uso: o passo a passo de cada recurso, escrito para quem joga.
• Referência técnica: arquitetura, modelo de dados, API e os motores internos, para quem desenvolve.
• Design e usabilidade: os princípios visuais, a identidade e as decisões de acessibilidade.

Princípio editorial

Em todo conteúdo do projeto, evitamos o hífen e o travessão como recurso de pontuação, reservando o hífen apenas para palavras que o exigem. É uma escolha de estilo que vale para a interface, os textos, os commits e esta documentação.