estrutura-paginas

name	estrutura-paginas
description	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 carta, ou template de carta.
allowed-tools	Read, Write, Edit, Glob, Grep

Skill: Estrutura de Páginas de Cartas

Esta skill define a estrutura padrão para páginas individuais de cartas Pokémon TCG graduadas, garantindo consistência e qualidade em todo o portfólio.

Quando Usar

• Ao criar novas páginas de cartas individuais
• Ao revisar estrutura de páginas existentes
• Quando o usuário mencionar "criar página de carta", "layout de perícia"
• Ao refatorar páginas para seguir o padrão
• Ao planejar a estrutura de uma nova carta

Nota: Esta skill é complementar à pericia-template. Use pericia-template para criar novas perícias completas com dados específicos. Use esta skill para entender e aplicar a estrutura padrão.

Estrutura Padrão Completa

1. Navbar (navegação superior)
2. Header Section (cabeçalho com título e certificado)
3. Container Principal
   3.1. Fotos e Identificação (row com 2 colunas)
       - Fotos da Carta (col-lg-6)
       - Identificação (col-lg-6)
   3.2. Graduação (card único)
   3.3. Análise de Condição (card único)
   3.4. Histórico de Proveniência (card único)
   3.5. Observação Importante (alert - opcional)
   3.6. Botão de Voltar
4. Footer (rodapé)
5. Modals (para visualização de fotos)
6. Scripts

Seção 1: Navbar

Padrão obrigatório:

• Navbar dark com bg-dark
• Link "Cartas Graduadas" voltando para ../index.html
• Link "Voltar ao Portfólio" no menu
• Responsiva com toggler para mobile

<!-- Navigation -->
<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
    <div class="container">
        <a class="navbar-brand fw-bold" href="../index.html">Cartas Graduadas</a>
        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
            <span class="navbar-toggler-icon"></span>
        </button>
        <div class="collapse navbar-collapse" id="navbarNav">
            <ul class="navbar-nav ms-auto">
                <li class="nav-item">
                    <a class="nav-link" href="../index.html">Voltar ao Portfólio</a>
                </li>
            </ul>
        </div>
    </div>
</nav>

Seção 2: Header Section

Cores:

• Fundo: bg-dark
• Texto: text-white
• Borda: border-bottom border-secondary

Conteúdo:

• Título: "Laudo de Perícia Técnica"
• Subtítulo: Nome completo da carta com coleção
• Badge: Número do certificado

<!-- Header Section -->
<section class="bg-dark text-white py-4 border-bottom border-secondary">
    <div class="container">
        <div class="row align-items-center">
            <div class="col-md-8">
                <h1 class="h3 mb-2">Laudo de Perícia Técnica</h1>
                <p class="mb-0 text-secondary">[Nome Carta] - [Coleção]</p>
            </div>
            <div class="col-md-4 text-md-end">
                <span class="badge bg-secondary fs-6">Cert: [CERTIFICADO]</span>
            </div>
        </div>
    </div>
</section>

Seção 3.1: Fotos e Identificação

Layout:

• Row com 2 colunas iguais em desktop (col-lg-6)
• Coluna única em mobile

Coluna Esquerda - Fotos da Carta:

<div class="col-lg-6 mb-3 mb-lg-0">
    <div class="card shadow border-secondary h-100">
        <div class="card-header bg-secondary text-white">
            <h5 class="mb-0">Fotos da Carta</h5>
        </div>
        <div class="card-body bg-white p-0">
            <div class="row g-0">
                <div class="col-6">
                    <div class="p-3 border-end">
                        <img src="[URL_FRENTE]"
                             alt="[Nome] - Frente"
                             class="w-100 rounded border"
                             style="height: 400px; object-fit: contain; cursor: pointer;"
                             data-bs-toggle="modal"
                             data-bs-target="#modalFrente">
                    </div>
                </div>
                <div class="col-6">
                    <div class="p-3">
                        <img src="[URL_VERSO]"
                             alt="[Nome] - Verso"
                             class="w-100 rounded border"
                             style="height: 400px; object-fit: contain; cursor: pointer;"
                             data-bs-toggle="modal"
                             data-bs-target="#modalVerso">
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>

Coluna Direita - Identificação:

<div class="col-lg-6">
    <div class="card shadow border-secondary h-100">
        <div class="card-header bg-secondary text-white">
            <h5 class="mb-0">Identificação</h5>
        </div>
        <div class="card-body bg-white">
            <table class="table table-sm table-borderless mb-0">
                <tbody>
                    <tr>
                        <td class="fw-bold text-dark" style="width: 40%;">Nome:</td>
                        <td>[Nome]</td>
                    </tr>
                    <tr>
                        <td class="fw-bold text-dark">Número:</td>
                        <td>[Número]</td>
                    </tr>
                    <!-- Mais campos conforme necessário -->
                </tbody>
            </table>
        </div>
    </div>
</div>

Campos obrigatórios de Identificação:

• Nome
• Número
• Coleção
• Ano
• Raridade (com badge colorido)
• Tipo
• Idioma
• Fabricante
• Ilustrador/Artista

Campos opcionais:

• Edição
• Versão
• Lançamento
• Registro AAA (para GBA)

Seção 3.2: Graduação

Card header:

• Cor: bg-dark text-white
• Título: "Graduação [Nome Graduadora]"

Conteúdo obrigatório:

1. Nota final (display-4)
2. Descrição da nota
3. Nome da graduadora
4. Certificado
5. Data ou programa
6. Ranking/População
7. Links de referência

<div class="card shadow border-secondary mb-4">
    <div class="card-header bg-dark text-white">
        <h5 class="mb-0">Graduação [Graduadora]</h5>
    </div>
    <div class="card-body bg-white">
        <!-- Nota final centralizada -->
        <div class="text-center mb-3">
            <h2 class="display-4 text-dark mb-0">[Nota]</h2>
            <p class="text-secondary mb-0" style="font-size: 1.1rem;">[Descrição]</p>
        </div>
        <hr>
        <!-- Informações da graduadora -->
        <!-- Ranking -->
        <!-- Links -->
    </div>
</div>

Ranking - 3 Colunas:

1. Mesma Nota
2. Nota Maior
3. Total/População

Seção 3.3: Análise de Condição

Card header:

• Cor: bg-secondary text-white
• Título: "Análise de Condição - [Graduadora]"

Conteúdo obrigatório:

1. Alert com descrição da escala
2. Classificação geral com progress bar
3. Notas por componente (cards pequenos):
   • Centering
   • Corners
   • Edges
   • Surface
4. Observações técnicas detalhadas
5. Observação de autenticidade

<div class="card shadow border-secondary mb-4">
    <div class="card-header bg-secondary text-white">
        <h5 class="mb-0">Análise de Condição - [Graduadora]</h5>
    </div>
    <div class="card-body bg-white">
        <!-- Alert com escala -->
        <div class="alert alert-secondary mb-4">
            <h6 class="alert-heading fw-bold mb-2">Escala [Graduadora]</h6>
            <p class="small mb-0">[Descrição da escala]</p>
        </div>

        <!-- Progress bar -->
        <div class="mb-4">
            <div class="d-flex justify-content-between align-items-center mb-2">
                <span class="fw-bold text-dark">Classificação Geral:</span>
                <span class="badge [cor] fs-6">[Nota] - [Descrição]</span>
            </div>
            <div class="progress" style="height: 25px;">
                <div class="progress-bar [cor]" style="width: [%]%;">
                    <span class="fw-bold">[Nota]/10</span>
                </div>
            </div>
        </div>

        <!-- Componentes -->
        <h6 class="text-dark mb-3">Análise Detalhada por Componente</h6>
        <!-- Cards com notas de cada componente -->

        <!-- Observações técnicas -->
        <h6 class="text-dark mb-3">Observações Técnicas</h6>
        <!-- Alerts com observações -->
    </div>
</div>

Cores de Progress Bar:

• Nota 9-10: bg-success (verde)
• Nota 8-8.9: bg-warning (amarelo)
• Nota < 8: bg-secondary (cinza)

Seção 3.4: Histórico de Proveniência

Card header:

• Cor: bg-dark text-white
• Título: "Histórico de Proveniência" ou "Histórico e Contexto"

Estrutura:

• Accordion flush para eventos históricos
• Alertas ao final para:
  • Informações sobre o artista/ilustrador
  • Notas sobre a graduadora

<div class="card shadow border-secondary">
    <div class="card-header bg-dark text-white">
        <h5 class="mb-0">Histórico de Proveniência</h5>
    </div>
    <div class="card-body bg-white">
        <div class="accordion accordion-flush" id="accordionHistory">
            <!-- Accordion items -->
        </div>

        <!-- Info do artista -->
        <div class="alert alert-dark mt-4 mb-3">
            <h6 class="alert-heading small fw-bold">Sobre o [Artista/Ilustrador]</h6>
            <!-- Conteúdo -->
        </div>

        <!-- Notas da graduadora -->
        <div class="alert alert-secondary mb-0">
            <h6 class="alert-heading small fw-bold">Notas sobre a Graduação [Graduadora]</h6>
            <!-- Conteúdo -->
        </div>
    </div>
</div>

Accordion Items:

• Cada evento em um accordion-item
• IDs únicos (collapse1, collapse2, etc)
• Primeiro item pode iniciar expandido (collapse show)
• Formato de título: Data + Descrição curta
• Corpo: Descrição detalhada em fonte small

Seção 3.5: Observação Importante (Opcional)

Para cartas com nota de perícia que pode mudar:

<div class="alert alert-info mt-4">
    <h6 class="alert-heading fw-bold mb-2">Observação Importante</h6>
    <p class="small mb-0">
        O estado de conservação, as notas de graduação e a população apresentados
        neste laudo refletem a condição da carta na data da [avaliação/certificação]
        realizada pela [Graduadora] em <strong>[Data]</strong>.
        Estes dados podem sofrer alterações ao longo do tempo conforme novas cartas
        são graduadas e adicionadas ao sistema.
    </p>
</div>

Seção 3.6: Botão de Voltar

<div class="text-center mt-4">
    <a href="../index.html" class="btn btn-dark btn-lg">Voltar ao Portfólio</a>
</div>

Seção 4: Footer

Padrão obrigatório:

<!-- Footer -->
<footer class="bg-dark text-white py-4 mt-5 border-top border-secondary">
    <div class="container">
        <div class="row">
            <div class="col-md-6">
                <p class="mb-0 text-secondary">&copy; 2025 Cartas Pokémon TCG Graduadas</p>
            </div>
            <div class="col-md-6 text-md-end">
                <p class="mb-0 text-secondary">[Texto variável - data ou certificado]</p>
            </div>
        </div>
    </div>
</footer>

Opções de texto variável:

• "Laudo gerado em: DD/MM/YYYY"
• "Laudo gerado para: [CERTIFICADO]"

Seção 5: Modals

Dois modals obrigatórios:

1. modalFrente - Foto da frente
2. modalVerso - Foto do verso

<!-- Modal Frente -->
<div class="modal fade" id="modalFrente" tabindex="-1" aria-labelledby="modalFrenteLabel" aria-hidden="true">
    <div class="modal-dialog modal-dialog-centered modal-lg">
        <div class="modal-content bg-dark">
            <div class="modal-header border-secondary">
                <h5 class="modal-title text-white" id="modalFrenteLabel">[Nome] - Frente</h5>
                <button type="button" class="btn-close btn-close-white" data-bs-dismiss="modal" aria-label="Fechar"></button>
            </div>
            <div class="modal-body text-center p-0">
                <img src="[URL_FRENTE]" alt="[Nome] - Frente" class="img-fluid">
            </div>
        </div>
    </div>
</div>

<!-- Modal Verso -->
<!-- Estrutura idêntica com IDs e conteúdo do verso -->

Responsividade

Mobile (< 768px):

• Layout em coluna única
• Navbar com toggler
• Cards em largura total
• Fotos em grid 2 colunas

Tablet (≥ 768px):

• Layout ainda em coluna única
• Melhor espaçamento

Desktop (≥ 992px):

• Grid 2 colunas para Fotos e Identificação
• Cards em largura total
• Layout otimizado

Use classes responsivas:

• col-12 col-lg-6 para 2 colunas em desktop
• mb-3 mb-lg-0 para espaçamento responsivo
• text-md-end para alinhamento responsivo

Cores e Estilos

Paleta padrão:

• Background principal: bg-light
• Cards: bg-white
• Headers primários: bg-dark text-white
• Headers secundários: bg-secondary text-white
• Bordas: border-secondary
• Sombras: shadow

Badges de Raridade:

• Promocional: bg-dark
• Shiny Rare: bg-dark
• Hyper Rare: bg-warning text-dark
• Secret Rare: bg-danger

Badges de Notas:

• 9.5-10: bg-success
• 9-9.25: bg-success
• 8-8.5: bg-warning text-dark
• 6-7.5: bg-secondary
• < 6: bg-secondary

Checklist de Qualidade

Antes de considerar uma página completa:

Estrutura:

• ✅ Navbar funcional
• ✅ Header com título e certificado
• ✅ Fotos da carta (frente e verso)
• ✅ Tabela de identificação completa
• ✅ Card de graduação com ranking
• ✅ Análise de condição detalhada
• ✅ Histórico com accordion
• ✅ Info do artista
• ✅ Notas da graduadora
• ✅ Botão de voltar
• ✅ Footer
• ✅ Modals para fotos

Conteúdo:

• ✅ Todas as informações básicas preenchidas
• ✅ Notas detalhadas (Centering, Corners, Edges, Surface)
• ✅ Observações técnicas escritas
• ✅ Pelo menos 2-3 eventos históricos
• ✅ Informações sobre o artista
• ✅ Links de referência funcionando

Qualidade:

• ✅ Responsivo em mobile
• ✅ Imagens carregando corretamente
• ✅ Modals funcionando
• ✅ Accordion funcionando
• ✅ Apenas classes Bootstrap
• ✅ HTML válido e semântico
• ✅ Acessibilidade (ARIA, alt text)

Diferenças por Graduadora

Manafix

• Campo: "Data da Certificação"
• Ranking label: "Total"
• Pode usar "Artista" em vez de "Ilustrador"
• Campos extras: Edição, Versão

GBA

• Campo: "Data da Avaliação" ou "Programa"
• Ranking label: "População"
• Campo: "Registro AAA"
• Ilustrador (não Artista)
• Campo extra: Lançamento

Integração com Outras Skills

Esta skill trabalha em conjunto com:

• pericia-template: Para criação automatizada de páginas
• bootstrap-guidelines: Para classes e componentes
• codigo-html: Para estrutura HTML limpa
• acessibilidade: Para HTML acessível

Use esta skill como referência para entender a estrutura. Use pericia-template para criar páginas completas.