# Glossário Hard Court — Definições Canônicas v1

> **Status:** glossário oficial · criado em 15/04/2026
>
> **Propósito:** definir cada termo técnico do Hard Court de forma **única, não-ambígua e acionável**. Todo output do HC (Raio X, Panorama, Radar, Similar Players, emails, cards, posts) deve usar estes termos exatamente como definidos aqui. Drift entre páginas é bug — resolver antes de publicar.
>
> **Regra de uso:** quando um termo é usado num relatório, linkar na primeira ocorrência: `[WTN](/docs/GLOSSARIO_HC.md#wtn)`. Siglas sempre expandidas na primeira ocorrência de cada seção.
>
> **Conflito entre este glossário e qualquer outro arquivo/código:** este documento prevalece. Reportar inconsistência para correção imediata.
>
> **Regra de revisão:** este glossário segue a regra do t0 (ver `PADRAO_RELATORIOS_HC.md §5`). Antes do lançamento oficial, edições são livres. Após t0, cada mudança vira entrada com data no fim do documento.

---

## Índice

1. [Conceitos de atleta](#1-conceitos-de-atleta)
2. [Ratings e métricas individuais](#2-ratings-e-métricas-individuais)
3. [Conceitos de torneio](#3-conceitos-de-torneio)
4. [Conceitos de benchmark e comparação](#4-conceitos-de-benchmark-e-comparação)
5. [Produtos e features HC](#5-produtos-e-features-hc)
6. [Conceitos financeiros (VPL, Gap, Custo)](#6-conceitos-financeiros)
7. [Siglas institucionais](#7-siglas-institucionais)
8. [LGPD, ECA e consentimento](#8-lgpd-eca-e-consentimento)
9. [Padrão editorial HC](#9-padrão-editorial-hc)

---

## 1. Conceitos de atleta

### <a id="atleta-ativo"></a>Atleta ativo
Atleta com pelo menos **1 partida oficial de simples** registrada no banco HC dentro da temporada de referência, com resultado **V (vitória)** ou **D (derrota)**.

**Exclusões obrigatórias:**
- Partidas de duplas (categoria contendo "MD", "Dupla", "Double")
- Resultado "WO" (walkover) quando for ambíguo — tratamento específico por contexto
- Resultado "?" (parsing pendente)
- Entradas órfãs (`id_atleta` sem registro em `atletas`)

**Query canônica:**
```sql
SELECT COUNT(DISTINCT id_atleta) FROM partidas
WHERE data_partida LIKE '%{ANO}%'
  AND resultado IN ('V','D')
  AND categoria NOT LIKE '%Dupla%'
```

**Variantes:** "ativo em 2026", "ativo no RJ 2026", "ativo na categoria 12 Anos 2026" — o escopo temporal/geográfico/categórico deve ser sempre declarado próximo ao número.

---

### <a id="atleta-premium"></a>Atleta Premium
Atleta cadastrado em `atletas_premium` com `plano IN ('premium', 'basico', 'avulso')` e `ativo=1`. Tem relatório Raio X gerado, consentimento LGPD registrado e fluxo de pagamento validado.

**Regra de exibição:** nome nominal só aparece com consentimento parental ativo (ver [Consentimento Parental](#consentimento-parental)).

---

### <a id="atleta-kids"></a>Atleta Kids
Atleta com idade **<11 anos** na temporada de referência. Categorias típicas no TI: "8 Anos", "9 Anos", "10 Anos".

**Tratamento especial:**
- Rankings oficiais de federações **não cobrem** Kids (decisão técnica das federações brasileiras)
- Raio X do Kids esconde seções de College, Universidades-alvo, VPL detalhado (ver `feedback_raio_x_layout.md`)
- LGPD: tratamento ainda mais rigoroso — consentimento parental reforçado

---

### <a id="atleta-juvenil"></a>Atleta Juvenil (IJ)
Atleta com idade **entre 11 e 18 anos** na temporada de referência. Cobertos pelo ranking IJ das federações que publicam (BA, MS, PI, RJ, RO, RS, SC em 2026).

**Sub-categorias CBT:** Sub-12, Sub-14, Sub-16, Sub-18 (classificação por ano de nascimento, não idade exata).

---

### <a id="atleta-college-recruta"></a>Atleta Recrutado (College)
Atleta brasileiro mapeado em `recrutas_brasil` (fonte: TennisRecruiting.net) com `universidade` preenchida. Histórico amplo desde 2003. **N=625** no banco.

**Distinção crítica:** ≠ "brasileiro no college americano" ativo hoje — esse último vem de `ita_brasileiros` (N=741).

---

### <a id="atleta-pro"></a>Atleta no Circuito Pro
Atleta brasileiro com partidas registradas em ATP, WTA, Futures ou Challenger (fonte: `profissionais_hc` — 915 atletas com stats próprios derivados de 46k partidas TI). Substitui a base Sackmann (descontinuada como dependência).

---

## 2. Ratings e métricas individuais

### <a id="wtn"></a>WTN — World Tennis Number
Rating oficial da ITF (International Tennis Federation) numa escala **40 (iniciante) a 1 (elite mundial)**. Coletado via scraping do perfil TI + cruzamento ITF. **Menor = melhor.**

**Cobertura:** ~29.880 atletas brasileiros com WTN no banco HC.

**Variantes no produto HC:**
- **WTN Simples** — singles
- **WTN Duplas** — ignorado por padrão nos Raio X individuais
- **WTN Ativo** — rating atual, atualização mensal
- **WTN Histórico** — série temporal de rating (tabela `wtn_historico`, via API ITF GraphQL)
- **WTN Verificado** — análogo ao "UTR Verified", atletas com torneio oficial recente

**Benchmarks College (reais, 71 recrutas brasileiros):**
- D1: mediana **20,8** (P25 14,5 · P75 30,2 · N=37)
- D2: mediana **24,3** (P25 18,1 · P75 30,2 · N=17)
- D3: mediana **23,6** (P25 19,4 · P75 25,7 · N=8)
- NAIA: mediana **29,3** (P25 28,2 · P75 33,7 · N=8)

---

### <a id="utr"></a>UTR — Universal Tennis Rating
Rating proprietário da UTR Sports numa escala **1 (iniciante) a 16,5 (Djokovic)**. **Maior = melhor.** Oposto ao WTN.

**Cobertura HC:** via conta Power (R$59/mês, `cunhanovaes@gmail.com`), capturamos valor exato com decimais. Sem auth, o site expõe só forma mascarada (ex: "10.xx").

**Produto HC:** referência histórica — na estratégia atual, HC privilegiou WTN (maior cobertura) como métrica canônica. UTR aparece como dado secundário.

---

### <a id="wr"></a>WR — Win Rate
Razão entre vitórias e total de partidas válidas (V+D), excluindo walkovers e duplas. Sempre em **%** com 1 decimal (ex: 60,3%).

**Query canônica:**
```sql
SELECT
  100.0 * SUM(CASE WHEN resultado='V' THEN 1 ELSE 0 END) / SUM(CASE WHEN resultado IN ('V','D') THEN 1 ELSE 0 END) AS wr
FROM partidas
WHERE id_atleta = ?
  AND categoria NOT LIKE '%Dupla%'
```

**Variantes obrigatórias (sempre declarar o recorte):**
- **WR Lifetime** — toda a carreira registrada no banco
- **WR 2026** — ano corrente
- **WR últimos 5 jogos** — últimos 5 cronologicamente (ver [Tendência](#tendencia))
- **WR estadual** — só em torneios do mesmo UF
- **WR nacional** — só em torneios nacionais (G1/G2/COSAT/ITF)

**Ancoragem obrigatória:** nunca citar "WR" sem recorte. "WR 60%" é ambíguo — "WR 2026 60%" é correto.

---

### <a id="score-hc"></a>Score HC
Índice proprietário do Hard Court numa escala **0–100**, calculado em `hc_core.calcular_score()`. Consolida desempenho, trajetória e potencial de evolução.

**Fonte única:** `scripts/hc_core.py:calcular_score()`. **Nunca recalcular inline** em outro arquivo (regra canônica).

**Componentes (detalhes na nota metodológica):** desempenho ponderado por nível, trajetória WTN, consistência, volume, pós-torneio.

---

### <a id="sos"></a>SoS — Strength of Schedule
Média do **WTN dos adversários enfrentados** pelo atleta no período de referência. Métrica de "qualidade da agenda" — atleta com SoS 25 jogou adversários tipicamente mais fracos que atleta com SoS 20.

**Por que importa:** WR não é comparável entre estados sem SoS. Um atleta com 94% WR no CE pode ter jogado adversários com WTN médio 35, enquanto 60% WR no RJ contra adversários WTN 22 é performance superior.

**Query canônica:**
```sql
SELECT AVG(a.wtn_simples) AS sos
FROM partidas p JOIN atletas a ON a.id = p.id_adversario
WHERE p.id_atleta = ?
  AND a.wtn_simples IS NOT NULL
```

---

### <a id="tendencia"></a>Tendência (últimos 5 jogos)
Sequência dos resultados dos **5 últimos jogos cronológicos** (ordenação por data DESC + fase DESC via `_fase_sort_key`).

**Representação visual:** 5 bolinhas horizontais.
- Verde = V
- Vermelha = D
- Cinza tracejada = placeholder (atleta com <5 jogos — regra `feedback_tendencia.md`)

**Regra inviolável:** sempre 5 bolinhas. Nunca 10, nunca variável. WO = verde quando no banco `resultado='V' AND placar LIKE '%WO%'`.

---

### <a id="hit-rate"></a>Hit Rate
% de jogos em que o atleta cumpriu ou superou a expectativa da partida (classificação de resultado baseada em gap WTN dos adversários).

**Classificação canônica** (em `hc_core.classificar_resultado()`):
- **Vitória esperada** / **Vitória surpreendente** (gap >25 p.p. WR)
- **Derrota esperada** / **Derrota surpreendente**
- **Sem histórico** — adversário com <3 partidas

---

### <a id="fase"></a>Fase
Etapa do torneio em que a partida foi disputada. Hierarquia canônica (`_fase_sort_key`):
1. Round Robin
2. 1ª Rodada
3. 2ª Rodada
4. Oitavas
5. Quartas
6. Semi(final)
7. Final

**Inferência quando ausente:** última derrota após 2+ vitórias no torneio = Final (vice). Regra em `feedback_ordem_jogos_torneio.md`.

**Cobertura:** 360 mil partidas do banco HC têm `fase` preenchida (76% do total).

---

### <a id="wo"></a>WO — Walkover
Partida em que um dos atletas não compareceu. Tratamento:
- No **contador de V/D**: WO conta como V se o atleta avançou de fase (regra `feedback_tendencia.md`)
- No **cálculo de WR**: WOs pendentes (`resultado='WO' sem `placar` claro) são EXCLUÍDOS
- Na **Tendência**: bolinha verde

---

## 3. Conceitos de torneio

### <a id="torneio-programado"></a>Torneio programado
Torneio cadastrado no TI com `periodo_inicio` dentro da temporada de referência, **independente de ter ocorrido ou não**. Fonte: tabela `torneios`.

**Query canônica:**
```sql
SELECT COUNT(*) FROM torneios
WHERE periodo_inicio LIKE '%{ANO}%' AND upper(uf) = '{UF}'
```

**Uso canônico em relatórios públicos:** sempre reportar torneios programados como o número "do ano" (ex: "18 torneios programados no RJ em 2026"). NUNCA substituir por "realizados" sem contexto.

---

### <a id="torneio-realizado"></a>Torneio realizado
Torneio programado que teve **ao menos 1 partida registrada** no banco HC até a data de corte. Recorte parcial — útil pra métricas operacionais de ritmo, NÃO pra caracterizar calendário anual.

**Query canônica:**
```sql
SELECT COUNT(DISTINCT t.id) FROM torneios t
JOIN partidas p ON p.id_torneio = t.id
WHERE p.data_partida LIKE '%{ANO}%' AND upper(t.uf) = '{UF}'
```

**Regra editorial:** se for reportar "torneios realizados", dizer explicitamente "realizados até DD/MM/AAAA" + contexto "(de N programados no ano)". Nunca "só X torneios no ano" (enganoso).

---

### <a id="grau"></a>Grau do torneio
Classificação oficial do TI pelo nível competitivo. Hierarquia crescente:
- **Kids / Bola Colorida** — primeiro estágio, sem ranking oficial
- **Regional / Estadual** — circuito da federação estadual
- **G3 / G2 / G1** — nacional, peso crescente
- **COSAT** — Sul-Americano (Confederación Sudamericana de Tenis)
- **ITF** — internacional (Juniors ou adulto)

**Detecção no banco:** regex em `_classificar_nivel_torneio()` em `analise_pos_torneio.py`.

---

### <a id="ranking-escopo"></a>Escopo de ranking
Regra canônica de comparação em rankings:
- **Estadual** — só atletas de torneios do mesmo UF
- **Nacional** — só atletas de torneios nacionais (G1/G2/COSAT/ITF)
- **Nunca "Brasil inteiro"** misturando estaduais de UFs diferentes

Regra em `feedback_ranking_escopo.md`.

---

## 4. Conceitos de benchmark e comparação

### <a id="comparavel"></a>Comparável (benchmark)
Métrica do alvo (atleta, UF, clube) comparada contra a **mesma métrica em uma base válida** (coorte equivalente). Lei Fundamental HC: toda afirmação "de melhoria" precisa trazer valor + média + topo + posição relativa + escopo.

**Regras canônicas:**
- Bases de comparação precisam ter mesmos filtros (mesma temporada, mesma categoria, mesmo tipo de torneio)
- UFs/clubes com amostra pequena (<20 atletas) ficam de fora do cálculo de média (evita distorção)
- Topo sempre reportado junto com média

---

### <a id="benchmark-college"></a>Benchmarks College (D1/D2/D3/NAIA)
Valores de WTN mediana dos **71 recrutas brasileiros reais** (cruzamento `recrutas_brasil` × `atletas`). Ver [WTN](#wtn).

**Queries canônicas** em `hc_core.py`. **Nunca recalcular inline.**

---

### <a id="benchmark-fonseca"></a>Benchmark Fonseca
Série de referência WTN×idade usando dados de **João Fonseca** do TI (idades 9–13) + Sackmann (17–19 anos, ATP/Challenger/Futures). Constante `FONSECA_SACKMANN` em `hc_core.py`.

**Uso:** curva de "elite brasileira" no gráfico "Evolução comparada — Win Rate por idade" do Raio X.

---

### <a id="curva-percentis"></a>Curva P25/P50/P75
Percentis empíricos de WTN por idade, calculados de **160 atletas CBT ranqueados** (`ranking_atletas`). Regra mínima: idades com n≥8 usam percentis diretos; idades com n<8 usam interpolação linear.

**Onde aparece:** gráfico "Trajetória para a Meta" no Raio X.

---

## 5. Produtos e features HC

### <a id="raio-x-atleta"></a>Raio X do Atleta
Produto individual Premium do HC. Relatório interativo completo de um atleta: Score, desempenho, calendário, trajetória, Similar Players, análise pós-torneio (Premium), Radar (Premium).

**Preço:** R$297 avulso · R$109/mês Básico · R$129/mês Premium.

**Arquivos:** template único em `scripts/template_raio_x_master.html` (ver `feedback_template_unico.md`). HTMLs individuais em `site/public/raio-x/{atleta}-2026.html`, acesso gated por HMAC-SHA256.

---

### <a id="raio-x-brasil"></a>Raio X Brasil (macro público)
Relatório público agregado do tênis infanto-juvenil brasileiro. Atrai via SEO/autoridade, funila pra produtos pagos. Página `/raio-x-brasileiro`.

**Não confundir com Raio X do Atleta** — regra crítica de desambiguação (ver `feedback_drift_semantico.md`).

---

### <a id="panorama"></a>Panorama HC
Relatório B2B estadual ou de clube. Formato institucional com ficha técnica, metodologia citável, nota metodológica em `/docs/notas/`.

**Preço:** estadual grátis (case) · clube R$1.500–3.000 · ponte B2B R$300–500/atleta.

**Ativos atuais:** `panorama/rj-2026.html`, `panorama/sp-2026.html`, `panorama/clube-pinheiros-2026.html`. Landing em `panorama/index.html`.

---

### <a id="radar"></a>Radar (antigamente "Vitrine de Talentos")
Diretório de atletas Premium com **consentimento parental ativo**, visível para coaches americanos cadastrados.

**Rebrand:** "Vitrine de Talentos" → "Radar" em todo copy novo (regra `feedback_rebrand_radar.md`). Nomes de páginas internas `/vitrine*` mantidos como marca B2B técnica.

---

### <a id="rede-hc"></a>Rede HC (Programa de Treinadores)
Canal #1 de aquisição declarado na ESTRATEGIA_v3 (14/04/2026). Treinadores indicam atletas → HC faz Raio X grátis → família contrata Premium → treinador recebe 15% sobre primeiro pagamento.

**Perfis individuais:** 156 no ar em `/radar/treinador-{slug}-{uf}.html` (SP/RJ/MG, prioridade ALTA).

---

### <a id="similar-players"></a>Similar Players
Feature do Raio X que mostra **3 atletas com perfil parecido** e o desfecho real deles (college, pro, ativo, parou). Tabela `espelhos_atleta` garante persistência entre regenerações.

**Variantes canônicas:**
- **Similar Players** (snapshot) — incluído em Avulso e Básico
- **Similar Players Live** — com push proativo quando um espelho avança (college sign, primeira V pro, parou). Exclusivo Premium.

**Fonte:** `hc_core.buscar_ou_renovar_espelhos()` — **nunca chamar** `buscar_casos_retroativos()` direto (não-determinístico, quebra continuidade narrativa).

---

### <a id="caso-similar-vivo"></a>Caso Similar Vivo (nome técnico interno)
Nome interno do código para a feature. No copy público, usar **Similar Players / Similar Players Live**. Diário e memórias podem manter "Caso Similar Vivo" como referência técnica.

---

## 6. Conceitos financeiros

### <a id="vpl"></a>VPL — Valor Presente Líquido
Indicador econômico do Raio X que quantifica o **valor financeiro da jornada college** ajustado por custo. Fórmula (metodologia v1.3):

`VPL = VP(Bolsa) + VP(Custo evitado univ BR) − VP(Custos do tênis)`

**Abordagem:** Avoided Cost Approach + fluxos incrementais.

**Taxa de desconto:** **6% a.a. real** (Brealey-Myers-Allen / Damodaran). Referência: documento `metodologia de custos/HC_Metodologia_Custos_Consolidada_v1.3.docx`.

**Valores constantes da data-base** (mar/2026 atualmente). Nunca inflacionar fluxos futuros.

---

### <a id="vpl-sunk-cost"></a>VPL — toggle Sunk Cost
Opção visual do Raio X: pai escolhe incluir ou não o investimento histórico já feito no cálculo. Sunk Cost = custo afundado.

- **Com sunk cost**: VPL reflete o "ROI total da jornada", inclusive investimento passado
- **Sem sunk cost**: VPL reflete a "decisão de hoje pra frente"

---

### <a id="gap-analysis"></a>Gap Analysis / Trajetória para a Meta
Gráfico do Raio X: curva WTN do atleta × curva mediana P50 + Fonseca + alvo D1/D2/D3/NAIA aos 18 anos.

**Produto canônico:** visualização de "quanto falta pra chegar lá" — substitui antigas seções "Gap Analysis NCAA" (descontinuadas).

---

### <a id="custo-torneio"></a>Custo de torneio (Haversine)
Estimativa de custo real de participação: inscrição + hospedagem + deslocamento. Fonte única canônica: `scripts/haversine.py`.

**Parâmetros:** inscrição R$235 (taxa FRJ vigente abr/2026), hospedagem R$200/noite (proxy IBGE), distância via Haversine + geocodificação Nominatim.

**Regra inviolável:** mudanças de custo só em `haversine.py`. Nenhum outro arquivo calcula custo inline. Ver `feedback_fonte_unica_custos.md`.

---

### <a id="ifh"></a>IFH — Índice de Formação do Clube
Índice 0–100 que ranqueia clubes por capacidade de formação de atletas. 5 componentes: Volume (25) · Diversidade (20) · Nível técnico WTN (20) · Conversão college/pro (25) · Performance WR (10).

**Fonte:** `scripts/calcular_ifh.py`. Tabela `ifh_clubes` no banco (267 clubes ranqueados).

**Classificações:** Elite (80–100), Alto (60–79), Competitivo (40–59), Desenvolvimento (20–39), Iniciante (0–19).

---

## 7. Siglas institucionais

### <a id="cbt"></a>CBT — Confederação Brasileira de Tênis
Entidade máxima do tênis brasileiro. Fonte primária de rankings oficiais IJ (Sub-12 a Sub-18). HC cita com respeito — **não se posiciona como substituto**, apenas complementar (regra `conceitos_canonicos.py`).

---

### <a id="fterj"></a>FTERJ — Federação de Tênis do Estado do RJ
Nome canônico a partir de 14/04/2026. **Termos proibidos em copy novo:** "FRJ", "FTR", "FTRJ" (extintas/incorretas). Referência: `scripts/federacoes_canonicas.py`.

---

### <a id="ti"></a>TI — Tenis Integrado (tenisintegrado.com.br)
Plataforma oficial de gestão do tênis brasileiro operada sob convênio com a CBT. Fonte primária da maioria dos dados HC (partidas, rankings, perfis, WTN, inscrições).

---

### <a id="itf"></a>ITF — International Tennis Federation
Entidade internacional que administra o WTN e o circuito ITF Juniors/Pro. API GraphQL pública (`prd-itf-kube.clubspark.pro/tods-gw-api/graphql`) — `wtnPast` permite histórico de WTN desde 2016.

---

### <a id="ita"></a>ITA — Intercollegiate Tennis Association
Entidade dos EUA que administra o circuito universitário. Fonte de `ita_brasileiros` (N=741 brasileiros ativos no college em 2026).

---

### <a id="ncaa"></a>NCAA — National Collegiate Athletic Association
Divisões **D1 / D2 / D3**. Regras de elegibilidade rigorosas: patrocínio formal ou prize money > US$10k/ano elimina elegibilidade permanentemente (Bylaw 12.1.2). Decisão college × pro deve ser tomada **antes dos 14 anos**. Referência: `reference_ncaa_estudo.md`.

---

### <a id="naia"></a>NAIA — National Association of Intercollegiate Athletics
Associação americana alternativa à NCAA, com regras de elegibilidade mais flexíveis.

---

### <a id="juco"></a>JUCO — Junior College
Community colleges americanos, 2 anos de curso, porta de entrada pra D1/D2.

---

## 8. LGPD, ECA e consentimento

### <a id="consentimento-parental"></a>Consentimento parental
Autorização formal do **responsável legal** (pai, mãe ou tutor legal — nunca treinador) para exibição de dados nominais de atleta menor. Registrado em `consentimento_vitrine` (tabela).

**Regra inviolável** (`feedback_lgpd_parental_treinador.md`):
- Treinador NUNCA consente pelo pai
- Consent é granular e revogável a qualquer momento
- Revogação tem efeito imediato (remoção do Radar, mascaramento dos outputs)

---

### <a id="dado-agregado"></a>Dado agregado
Indicador calculado sobre **grupo de atletas** sem identificação individual (ex: "WR médio da cidade"). Único formato permitido em comunicação pra treinador, marca, clube ou federação.

**Usado em:** Panoramas estaduais, Perfis de treinador (Rede HC), Raio X Brasil macro.

---

### <a id="dado-nominal"></a>Dado nominal
Dado que identifica um atleta específico pelo nome. Só aparece em produtos pagos **com consentimento parental ativo por atleta**.

**Usado em:** Raio X do Atleta (só pros Premium ativos), Radar (só com consent), Vitrine B2B (só com consent).

---

### <a id="treinador-invisivel"></a>Treinador invisível (regra LGPD+ECA)
Regra inviolável declarada em 15/04/2026 (`feedback_lgpd_treinador_invisivel.md`):

> O treinador **nunca** pode ser informado de quais atletas específicos dele estão no banco HC. Nenhum produto/email/dashboard cruza `id_treinador` com atletas nomeados. Só agregados geográficos (cidade/UF).

---

## 9. Padrão editorial HC

### <a id="ficha-tecnica"></a>Ficha Técnica
Bloco estruturado ao FINAL de toda publicação pública do HC (padrão institucional IBGE/BACEN/EIA/Itaú). Campos obrigatórios: Edição, Autoria, Data de corte, Próxima atualização, Universo, Comparáveis, Fonte, Metodologia detalhada (link), Escopo, LGPD+ECA, Correções/contato.

**Template em** `docs/PADRAO_RELATORIOS_HC.md §3`.

---

### <a id="nota-metodologica"></a>Nota Metodológica
Documento autônomo citável em `/docs/notas/AAAA-MM-DD-{slug}.md`. Descreve formalmente a metodologia de uma métrica/produto: definição, queries canônicas, universo, limitações, histórico de revisões, formato de citação acadêmica.

**Tem que ser espelhada em `site/public/docs/notas/`** pra ficar acessível via URL pública (descoberta arquitetural 15/04/2026). Todo retrofit/publicação nova copia a nota pra esse path antes do deploy.

---

### <a id="edicao"></a>Edição / Versão
Identificador único da publicação: `HC-{Produto} v{N.M} — {AAAA-MM-DD}`. Ex: `HC-Panorama-RJ v1.0 — 2026-04-15`.

**Regra do t0:** toda página nasce em **v1.0** no lançamento oficial. Iterações pré-lançamento não geram entrada pública de revisão (ver `PADRAO_RELATORIOS_HC.md §5`).

---

### <a id="data-corte"></a>Data de corte
Timestamp da última sincronização de dados antes da publicação. Formato canônico: `DD/MM/AAAA HH:MM BRT`. Sempre declarar fuso (Brasília UTC-3).

---

### <a id="t0"></a>t0 (lançamento oficial)
Momento exato em que um produto/página vai ao ar **para público externo**. Antes disso, HC está em construção — iterações são registradas apenas no `DIARIO_PROJETO.md` e `PENDENCIAS_ATIVAS.md`. A partir do t0, cada alteração vira entrada pública de revisão.

---

### <a id="box-metodologico"></a>Box metodológico
Seção dentro de um relatório com metodologia específica de uma análise (padrão BACEN RPM: "b7" = box 7). Cada box é autônomo e citável. No HC, usamos o formato `/docs/notas/` como box externalizado.

---

## Notação padrão (síntese)

| Tipo | Formato | Exemplo |
|---|---|---|
| Datas (metadados/arquivos) | ISO AAAA-MM-DD | `2026-04-15` |
| Datas (texto corrido) | BR DD/MM/AAAA | `15/04/2026` |
| Timestamps | ISO + fuso | `2026-04-15 12:00 BRT` |
| Números grandes | BR (ponto milhar, vírgula decimal) | `461.003`, `25,6%` |
| Percentuais (>10%) | 1 decimal | `25,6%`, `69,4%` |
| Percentuais (<10%) | 1 ou 2 decimais (consistência interna) | `1,55%`, `0,28%` |
| Variação de % | p.p. (pontos percentuais) | `+3,2 p.p.` |
| Razão de % | % | `+22%` |
| Moeda BR | R$ + espaço | `R$ 235,00` |
| Moeda US | US$ + valor | `US$ 1.5 milhão` |

---

## Histórico de revisões deste glossário

- **2026-04-15 (v1.0):** versão de lançamento. 42 termos canônicos organizados em 9 categorias. Derivado de `PADRAO_RELATORIOS_HC.md`, `TABELAS_CANONICAS.md`, `feedback_lei_fundamental_publicacao.md` e dos memories de feedback existentes. Próxima entrada será registrada quando houver alteração pós-t0.

---

## Como citar

> *Hard Court Brasil. (2026). Glossário Hard Court — Definições Canônicas v1.0. hardcourtbrasil.com/docs/GLOSSARIO_HC.md. Acesso em: DD/MM/AAAA.*