estrutura-paginas
Define a estrutura padrão para páginas individuais de cartas Pokémon TCG. Use quando criar novas páginas de carta, organizar layout de perícia, ou o usuário mencionar estrutura de página, layout de ca
estrutura
paginas
SKILL.md.claude/skills/estrutura-paginas
GitHubEstrutura visual dinâmica
O projeto usa FastAPI, MongoDB e Jinja2. Todas as cartas compartilham os mesmos templates; não existem páginas HTML individuais por carta.
Limite desta skill
- Para adicionar uma carta, use
pericia-template, que encaminha para a skill canônica.agents/skills/adicionar-carta/SKILL.md. - Para alterar a galeria, edite
backend/templates/index.html. - Para alterar o laudo individual, edite
backend/templates/laudo.html. - Para alterar o cadastro administrativo, edite
backend/templates/admin.htmle confirme o contrato embackend/models.py.
Uma alteração visual deve funcionar para todos os documentos válidos, inclusive campos opcionais ausentes e registros antigos.
Estrutura atual
Galeria (index.html)
- Navegação e acesso ao painel administrativo
- Hero com total de cartas e graduadoras
- Busca, filtro por graduadora, ordenação por nota e filtro de troca
- Grid de cards com imagem frontal, identificação, raridade, nota e graduadora
- Toggle de disponibilidade para usuários autenticados
- Footer
Laudo (laudo.html)
- Navegação e cabeçalho com nome completo e certificado
- Fotos de frente e verso com ampliação em modal
- Identificação da carta
- Dados de aquisição exibidos somente ao usuário autenticado
- Graduação, certificado e link oficial condicional
- Links externos condicionais
- Nota final e subgrades condicionais
- Observações técnicas e histórico condicionais
- Acesso de edição somente ao usuário autenticado
Regras
- Preserve a sintaxe Jinja2 e acesse somente campos existentes em
backend/models.pyou documentos legados tratados explicitamente. - Proteja campos opcionais com condicionais; não renderize botões vazios, imagens quebradas ou blocos sem conteúdo.
- Não exponha
acquisition_price, controles administrativos ou ações de escrita a visitantes anônimos. - Mantenha links externos com
target="_blank"erel="noopener noreferrer". - Mantenha textos alternativos significativos, navegação por teclado e rótulos acessíveis.
- Reuse os tokens e componentes de
backend/static/css/styles.css; não recoloque o visual estático antigo. - Mudanças no schema exigem atualização coordenada do modelo, formulário, payload JavaScript, templates, testes e da referência da skill de cadastro.
Verificação
Ao concluir uma mudança visual:
- Execute os testes do backend.
- Renderize uma carta completa e uma carta com campos opcionais ausentes.
- Verifique galeria e laudo em viewport móvel e desktop.
- Confirme que a inclusão de cartas continua sendo feita somente no MongoDB.