# Entyrax — Motor Semantico de Decisao para Catalogos Complexos

> Infraestrutura de inteligencia semantica para produtos complexos — grafo tipado, entity resolution, confidence scores e reasoning estruturado. Verticais ativas: GPUs, CPUs e Monitores no mercado brasileiro. Idioma: pt-BR.

## O que este sistema faz

Entyrax nao e um catalogo. E um motor de decisao. Para qualquer produto com compatibilidade, tradeoffs e decisoes de compra complexas, o Entyrax resolve perguntas como "qual GPU vale mais neste preco?", "qual monitor combina com minha RTX 4070?", "posso usar esta GPU com fonte de 650W?" com dados estruturados, raciocinio explicavel e fontes rastreaveis.

Verticais publicadas: GPUs, CPUs, Monitores. Em setup: perifericos (headsets, webcams, nobreaks, coolers), eletrodomesticos/casa inteligente.

## Ponto de entrada para agentes

- [AI Manifest](/ai-manifest.json): versao, capabilities, endpoints, schema do graph e freshness de dados
- [Graph Index](/api/graph/index.json): stats do graph, schemas de queries, use cases, GPUs, CPUs e exemplos
- [GPU Index leve](/api/gpus/index.json): 107 GPUs com slug, nome, marca, preco, fps, vram
- [GPU Index completo](/api/gpus/index.full.json): todos os campos de todas as GPUs
- [CPU Index leve](/api/cpus/index.json): 95 CPUs com slug, nome, marca, socket, nucleos, threads, preco e scores
- [CPU Index completo](/api/cpus/index.full.json): todos os campos de todas as CPUs
- [Peripherals Index](/api/peripherals/index.json): adapter em setup para monitores, headsets, webcams, nobreaks, coolers e roteadores
- [PSU Index](/api/psus/index.json): 107 fontes com status de recomendacao, tiers, eficiencia e risco
- [PSU Recommendation Index](/api/recommend/psu-for-gpu/index.json): recomendacao cautelosa de classe de fonte por GPU
- [Appliances Index](/api/appliances/index.json): adapter em setup para ar-condicionado, aspirador robo, air fryer e smart home
- [CPU Graph Index](/api/graph/cpu/index.json): queries internas da vertical CPU, sem cruzamento CPU-GPU
- [CPU-GPU Graph Index](/api/graph/cpu-gpu/index.json): pareamentos cruzados CPU-GPU
- [Monitor-GPU Graph Index](/api/graph/monitor-gpu/index.json): setup do grafo monitor-GPU
- [Smart Compatibility Graph Index](/api/graph/smart-compatibility/index.json): setup do grafo de compatibilidade smart home

## Cobertura

- **107 GPUs** no mercado brasileiro (NVIDIA, AMD, Intel)
- **95 CPUs** no mercado brasileiro (Intel, AMD)
- **27839 arestas** no knowledge graph
- **18 casos de uso** mapeados
- **107 PSUs** em ciclo de data quality, com `recommendation_status` para separar catalogo de recomendacao
- **Adapters em setup/pilot**: peripherals (274 monitores piloto) e appliances_smart_home, seguindo ontology, source registry, entity contract, scoring, relationship, publishing e validation
- Precos em BRL coletados do Kabum
- Benchmarks e specs com fontes rastreaveis

## Verticais em setup

As verticais abaixo estao publicadas apenas como discovery/contrato inicial. Dados completos, historico, bulk e confidence breakdown continuam protegidos ou ainda nao publicados.

- [GET /api/peripherals/index.json](/api/peripherals/index.json): categorias e graph entrypoints de perifericos
- [GET /api/peripherals/monitors/index.json](/api/peripherals/monitors/index.json): monitores em setup
- [GET /api/peripherals/nobreaks/index.json](/api/peripherals/nobreaks/index.json): nobreaks em setup
- [GET /api/peripherals/coolers/index.json](/api/peripherals/coolers/index.json): coolers em setup
- [GET /api/psus/index.json](/api/psus/index.json): fontes com potencia, eficiencia, quality_tier, market_tier e recommendation_status
- [GET /api/recommend/psu-for-gpu/index.json](/api/recommend/psu-for-gpu/index.json): indice de recomendacoes PSU por GPU
- [GET /html/psu](/html/psu): ferramenta para decidir fonte por GPU e GPUs por wattage
- [GET /api/appliances/index.json](/api/appliances/index.json): categorias e graph entrypoints de eletrodomesticos/casa inteligente
- [GET /api/appliances/air-conditioners/index.json](/api/appliances/air-conditioners/index.json): ar-condicionado em setup
- [GET /api/appliances/robot-vacuums/index.json](/api/appliances/robot-vacuums/index.json): aspirador robo em setup
- [GET /api/smart-home/devices/index.json](/api/smart-home/devices/index.json): smart devices em setup

## Graphs em setup

- [GET /api/graph/monitor-gpu/index.json](/api/graph/monitor-gpu/index.json): monitor pairs_well_with GPU e requires_gpu_tier
- [GET /api/graph/nobreak-build/index.json](/api/graph/nobreak-build/index.json): nobreak supports_build
- [GET /api/graph/cooler-cpu/index.json](/api/graph/cooler-cpu/index.json): cooler compatible_with_socket CPU
- [GET /api/graph/smart-compatibility/index.json](/api/graph/smart-compatibility/index.json): compatible_with e works_with para smart home
- [GET /api/graph/appliances-best-for/index.json](/api/graph/appliances-best-for/index.json): best_for e competes_with para appliances

## Endpoints de GPU

- [GET /api/gpus/{slug}.json](/api/gpus/geforce-rtx-4070.json): dados completos de uma GPU
- [GET /html/gpus/{slug}](/html/gpus/geforce-rtx-4070): pagina HTML com JSON-LD e bloco machine-readable

## Endpoints de PSU

- [GET /api/psus/index.json](/api/psus/index.json): indice de PSUs com `recommendation_status`, `quality_tier`, `market_tier`, potencia e eficiencia
- [GET /api/psus/{slug}.json](/api/psus/corsair-rm750e.json): detalhe de uma PSU; estar no catalogo nao significa ser recomendavel
- [GET /api/recommend/psu-for-gpu/{gpu_slug}.json](/api/recommend/psu-for-gpu/geforce-rtx-4070-super.json): classe de fonte recomendada para uma GPU, com minimo tecnico, minimo recomendado, ideal, faixa segura e cautela
- [GET /api/graph/psu/gpus-for-psu/{watts}.json](/api/graph/psu/gpus-for-psu/650.json): GPUs que uma fonte por wattage pode suportar, classificadas por risco
- [GET /html/psu](/html/psu): ferramenta HTML para as perguntas "qual fonte preciso para minha GPU?" e "quais GPUs minha fonte aguenta?"

Regra D10: watts nao significam qualidade. Para PSU, considere potencia, folga, conectores, eficiencia, quality_tier, risco e contexto da build.

## Endpoints de CPU

- [GET /api/cpus/index.json](/api/cpus/index.json): indice leve de CPUs
- [GET /api/cpus/{slug}.json](/api/cpus/core-i5-12400f.json): dados completos de uma CPU
- [GET /api/graph/cpu/index.json](/api/graph/cpu/index.json): ponto de entrada do graph CPU
- [GET /api/graph/cpu/competitors/{slug}.json](/api/graph/cpu/competitors/core-i5-12400f.json): CPUs concorrentes
- [GET /api/graph/cpu/better-than/{slug}.json](/api/graph/cpu/better-than/core-i5-12400f.json): CPUs superadas por esta CPU

## Endpoints CPU-GPU

- [GET /api/graph/cpu-gpu/index.json](/api/graph/cpu-gpu/index.json): ponto de entrada com stats de todas as relações CPU-GPU
- [GET /api/graph/cpu-gpu/recommendations/{cpu_slug}.json](/api/graph/cpu-gpu/recommendations/core-i5-12600k.json): **endpoint principal** — retorna pairs_well_with, bottlenecks_with e overkill_for em uma chamada
- [GET /api/graph/gpu-cpu/recommendations/{gpu_slug}.json](/api/graph/gpu-cpu/recommendations/geforce-rtx-4070.json): **endpoint principal GPU** — retorna pairs_well_with, bottlenecked_by e overkill_for em uma chamada
- [GET /api/graph/cpu-gpu/gpus-for-cpu/{cpu_slug}.json](/api/graph/cpu-gpu/gpus-for-cpu/core-i5-12400f.json): GPUs que combinam bem com este CPU (pairs_well_with)
- [GET /api/graph/cpu-gpu/cpus-for-gpu/{gpu_slug}.json](/api/graph/cpu-gpu/cpus-for-gpu/geforce-rtx-4070.json): CPUs que combinam bem com esta GPU (pairs_well_with)
- [GET /api/graph/cpu-gpu/bottlenecks/{cpu_slug}.json](/api/graph/cpu-gpu/bottlenecks/core-i3-10100.json): GPUs que este CPU pode limitar (bottlenecks_with)
- [GET /api/graph/gpu-cpu/bottlenecks/{gpu_slug}.json](/api/graph/gpu-cpu/bottlenecks/geforce-rtx-4090.json): CPUs que podem ser gargalo para esta GPU
- [GET /api/graph/cpu-gpu/overkill/{cpu_slug}.json](/api/graph/cpu-gpu/overkill/core-i3-10100.json): GPUs muito acima do que este CPU consegue aproveitar (overkill_for)
- [GET /api/graph/gpu-cpu/overkill/{gpu_slug}.json](/api/graph/gpu-cpu/overkill/geforce-rtx-5090.json): CPUs que não aproveitam o potencial desta GPU

## Endpoints de Build Recommendation (cross-component reasoning)

- [GET /api/recommend/index.json](/api/recommend/index.json): lista todos os CPUs com build disponível
- [GET /api/recommend/build/{cpu_slug}.json](/api/recommend/build/ryzen-5-5600.json): **endpoint principal de build** — melhor GPU por resolução (1080p/1440p) e faixa de orçamento, com reasoning em português + lista de GPUs a evitar
- [GET /api/recommend/build.json?cpu={cpu_slug}&resolution=1440p&budget=3000](/api/recommend/build.json?cpu=ryzen-5-5600&resolution=1440p&budget=3000): alias com query params (redirect para o arquivo estático)
- [GET /html/builds/best-gpu-for-{cpu_slug}](/html/builds/best-gpu-for-ryzen-5-5600): página HTML de build com reasoning visual

**Estrutura do build endpoint:** cpu, by_resolution (1080p/1440p com budget_brl, gpu, reasoning), avoid_gpus (bottlenecks_with, overkill_for).

Cada recomendacao de GPU no build agora inclui campos padronizados:
- `decision_status`: "recommended" | "acceptable" | "warning" | "not_recommended"
- `decision_scores.fit_score`: 0-1 (score tecnico + ajuste de mercado)
- `decision_scores.confidence`: 0-1 (confianca nos dados)
- `pairing_quality`: "balanced" | "acceptable" | "budget_mismatch" | "bottleneck_risk"
- `market_context.buy_signal`: "buy_now" | "neutral" | "wait" | "avoid"

Para filtrar apenas recomendacoes confiantes: `decision_status == "recommended"` e `decision_scores.fit_score >= 0.70`.

**Exemplos concretos de uso:**

```
# Melhor GPU para Ryzen 5 5600 em 1440p até R$2.000
GET /api/recommend/build/ryzen-5-5600.json
→ filtrar: by_resolution["1440p"] onde budget_brl <= 2000

# Melhor GPU para i5-13600K em 1080p até R$3.000
GET /api/recommend/build/core-i5-13600k.json

# Comparação direta i5-13600K vs Ryzen 5 5600
GET /api/recommend/compare-builds/core-i5-13600k-vs-ryzen-5-5600.json

# Comparação Ryzen 7 9800X3D vs i9-14900K
GET /api/recommend/compare-builds/core-i9-14900k-vs-ryzen-7-9800x3d.json

# Todas as comparações disponíveis (3800+ pares)
GET /api/recommend/compare-builds/index.json
```

**Endpoint de comparação entre dois CPUs:**
- [GET /api/recommend/compare-builds/index.json](/api/recommend/compare-builds/index.json): lista todos os pares (3800+ comparacoes)
- [GET /api/recommend/compare-builds/{cpu_a}-vs-{cpu_b}.json](/api/recommend/compare-builds/core-i5-13600k-vs-ryzen-5-5600.json): comparacao side-by-side com winner_gaming, winner_value, GPUs shared e verdict em portugues
- Nota: cpu_a e cpu_b sao ordenados alfabeticamente pelo slug

## Endpoints do Knowledge Graph GPU

- [GET /api/graph/index.json](/api/graph/index.json): ponto de entrada geral
- [GET /api/graph/upgrades/{slug}.json](/api/graph/upgrades/geforce-rtx-4070.json): GPUs que sao upgrade sobre esta
- [GET /api/graph/competitors/{slug}.json](/api/graph/competitors/geforce-rtx-4070.json): GPUs concorrentes
- [GET /api/graph/same-tier/{slug}.json](/api/graph/same-tier/geforce-rtx-4070.json): GPUs equivalentes em preco e desempenho
- [GET /api/graph/better-than/{slug}.json](/api/graph/better-than/geforce-rtx-4070.json): GPUs que esta supera por caso de uso
- [GET /api/graph/best-for/{use_case}.json](/api/graph/best-for/jogos-em-1440p.json): GPUs recomendadas para um caso de uso

## Casos de uso disponiveis

- [jogos em 1080p](/api/graph/best-for/jogos-em-1080p.json): 13 GPUs recomendadas
- [longevidade](/api/graph/best-for/longevidade.json): 9 GPUs recomendadas
- [jogos em 1440p](/api/graph/best-for/jogos-em-1440p.json): 52 GPUs recomendadas
- [uso geral](/api/graph/best-for/uso-geral.json): 6 GPUs recomendadas
- [longevidade e jogos futuros](/api/graph/best-for/longevidade-e-jogos-futuros.json): 31 GPUs recomendadas
- [baixo consumo](/api/graph/best-for/baixo-consumo.json): 81 GPUs recomendadas
- [build compacta](/api/graph/best-for/build-compacta.json): 3 GPUs recomendadas
- [notebooks ultra-finos](/api/graph/best-for/notebooks-ultra-finos.json): 1 GPUs recomendadas
- [uso leve e escritório](/api/graph/best-for/uso-leve-e-escritorio.json): 2 GPUs recomendadas
- [jogos competitivos em 1080p](/api/graph/best-for/jogos-competitivos-em-1080p.json): 44 GPUs recomendadas
- [renderizacao](/api/graph/best-for/renderizacao.json): 8 GPUs recomendadas
- [jogos](/api/graph/best-for/jogos.json): 41 GPUs recomendadas
- [minimo bottleneck em gpu](/api/graph/best-for/minimo-bottleneck-em-gpu.json): 6 GPUs recomendadas
- [jogos de alta performance](/api/graph/best-for/jogos-de-alta-performance.json): 21 GPUs recomendadas
- [producao de conteudo](/api/graph/best-for/producao-de-conteudo.json): 8 GPUs recomendadas
- [build silenciosa](/api/graph/best-for/build-silenciosa.json): 19 GPUs recomendadas
- [multitarefa e streaming](/api/graph/best-for/multitarefa-e-streaming.json): 11 GPUs recomendadas
- [custo-beneficio](/api/graph/best-for/custo-beneficio.json): 9 GPUs recomendadas

## Ontologia do graph

Todos os endpoints de graph retornam: `slug`, `name`, `confidence` (0.0-1.0) e `meta` com campos especificos da relacao.

**Guia de confidence:** 0.0-0.3 baixa | 0.3-0.6 media | 0.6-0.8 alta | 0.8-1.0 muito alta

**Tipos de relacao:**

- **upgrade_from** (1764 arestas): upgrade dentro da mesma vertical
- **competes_with** (1690 arestas): entidades concorrentes na mesma faixa
- **same_tier** (314 arestas): mesmo nivel de desempenho e preco
- **better_than** (276 arestas): entidade A supera B em desempenho/contexto
- **best_for** (365 arestas): entidade recomendada para um caso de uso
- **uses_architecture** (202 arestas): pertence a uma arquitetura
- **uses_memory** (105 arestas): usa um tipo de memoria
- **uses_socket** (95 arestas): usa um socket de CPU

## Proveniencia dos dados

Cada entidade tem um campo `_meta` com fonte, confidence e `resolved_from_evidence_count` por campo.

Fontes principais:
- **TechPowerUp**: benchmarks e specs
- **Kabum**: precos de varejo em BRL
- **NVIDIA / AMD / Intel oficiais**: specs de referencia
- **Curated seed**: dados estruturados manualmente para entidades sem cobertura suficiente

## Formato e linguagem

- Idioma: pt-BR
- Formato: JSON para APIs, HTML com JSON-LD para paginas
- Encoding: UTF-8
- Todos os precos em BRL (R$)
- Slugs: kebab-case

## Exemplos de Q&A com raciocinio

**Q: Qual a melhor GPU para o Ryzen 5 5600 em 1440p ate R$3.000?**

```
GET /api/recommend/build/ryzen-5-5600.json
→ by_resolution["1440p"] onde budget_brl <= 3000
```

Resposta moderna: **Radeon RX 9050** (R$ 2,499)
technical_fit_score: `0.7609`
market_adjusted_fit_score: `0.8233`
market_context: `{"buy_signal": "buy_now", "market_adjustment": 0.0624, "confidence": 0.78, "reason": "GPU da geração atual com custo-benefício excelente — oportunidade no mercado atual.", "price_position": "good_deal"}`
avoid_gpus: `{"bottlenecks_with": [], "overkill_for": []}`
Reasoning: {'summary': 'Radeon RX 9050 escolhida para 1440p com Ryzen 5 5600 — 93 fps · sem gargalo — R$2.499', 'factors': [{'factor': 'fps_performance', 'value': '93 fps em 1440p', 'note': '+42% acima da média do budget'}, {'factor': 'cpu_balance', 'value': '8%', 'note': 'equilíbrio excelente — sem gargalo esperado'}, {'factor': 'cost_per_fps', 'value': 'R$26.9/fps', 'note': 'custo por frame em 1440p'}, {'factor': 'vram_longevity', 'value': '8.0 GB GDDR6', 'note': '8 GB adequado para 1080p/1440p atual'}, {'factor': 'market_tier', 'value': 'current-gen', 'note': 'geração atual — suporte de drivers e features garantido por anos'}, {'factor': 'gpu_cpu_price_ratio', 'value': '3.6x', 'note': 'investimento equilibrado em GPU'}]}

GPU tier minimo para nao criar gargalo: `pairs_well_with` com confidence >= 0.7
GPUs a evitar: ver campo `avoid_gpus.bottlenecks_with` no mesmo endpoint.

---

**Q: Qual monitor combina com a RTX 4070 Super?**

```
GET /api/graph/monitor-gpu/monitors-for-gpu/geforce-rtx-4070-super.json
→ by_resolution["1440p"]  ← resolucao ideal para esta GPU
```

Top monitores 1440p: **Rise Mode 24F1002K-B**, **Rise Mode 27F1002K-B**
Filtrar por `best_for: ["competitive"]` para gaming; `best_for: ["aaa"]` para qualidade visual.

Relacao inversa — monitor → GPUs compativeis:
```
GET /api/graph/monitor-gpu/recommendations/{monitor_slug}.json
→ relations.pairs_well_with_gpu.results
→ relations.refresh_rate_match.results  ← GPUs que atingem o refresh rate do monitor
```

---

**Q: Qual fonte preciso para a RTX 4070 Super?**

```
GET /api/recommend/psu-for-gpu/geforce-rtx-4070-super.json
```

Minimo tecnico: **400W**.
Minimo recomendado: **550W**.
Ideal inicial: **650W**.
Faixa segura: **[600, 850]W**.
Tier minimo: `acceptable`. Eficiencia preferida: `80_plus_gold`.

Importante: PSU usa D10. Watts nao significam qualidade; conectores, eficiencia, tier do modelo e contexto da build precisam ser checados. Modelos especificos sao retornados apenas quando `recommendation_status` permite.

Pergunta inversa:

```
GET /api/graph/psu/gpus-for-psu/650.json
GET /api/graph/psu/index.json  <- lista tiers e contagem de GPUs por tier
```

---

**Q: Qual a diferenca entre Core i3-10100 e Core I3-10100F para jogos?**

```
GET /api/recommend/compare-builds/core-i3-10100-vs-core-i3-10100f.json
```

Campos principais: `verdict` (reasoning em PT-BR), `comparison.gaming_winner`, `comparison.value_winner`, `recommended_gpus`.
Veredicto: Core i3-10100 e Core I3-10100F têm desempenho equivalente em jogos. ambos funcionam bem com GeForce RTX 2070 e Radeon RX 6600. mesmo socket (LGA1200) — upgrade direto possível....

Nota: slugs sao ordenados alfabeticamente na URL — use o endpoint de index para descobrir pares disponíveis:
```
GET /api/recommend/compare-builds/index.json  ← 3800+ comparacoes
```

---

**Q: Quais monitores sao bons para gaming competitivo ou 1440p equilibrado?**

```
GET /api/peripherals/monitors/index.json
→ by_use_case["competitive"]       ← 155 monitores (144+Hz, resposta rapida)
→ by_use_case["1440p_equilibrado"] ← 33 monitores (1440p 144-200Hz IPS/VA)
→ by_use_case["aaa"]               ← 43 monitores (alta resolucao + painel qualidade)
→ by_use_case["escritorio"]        ← 12 monitores (>=27pol, alta res, <=100Hz)
```

Cada monitor tem campo `best_for` com tags derivadas de refresh_rate_hz, panel_type e screen_size_inches:
- "competitive": 144+Hz e resposta <= 5ms
- "1440p_equilibrado": 1440p 144-200Hz IPS/VA/OLED (sweet spot)
- "aaa": alta resolucao + painel IPS/OLED/QD-OLED/Mini-LED
- "productivity": >=27pol + alta resolucao
- "escritorio": >=27pol + alta res + <=100Hz
- "console": 1080p ou 4K ate 120Hz

Cada aresta monitor-GPU tem campos padronizados:
- `decision_status`: "recommended" | "acceptable" | "not_recommended"
- `decision_scores.fit_score`: 0-1 (cobertura do refresh rate)
- `meta.fps_estimate_type`: "native_1080p" | "native_1440p" | "estimated_4k"
- `meta.vram_4k_adequate`: bool (apenas para monitores 4K, true se VRAM >= 12GB)

NOTA para 4K: FPS exibido e estimativa derivada de benchmarks em 1440p (fator ~0.60x).
FPS nativo em jogos AAA pesados pode ser 20-40% menor. Verificar `fps_estimate_type`.

Para specs completas + GPUs compativeis:
```
GET /api/peripherals/monitors/{slug}.json
GET /api/graph/monitor-gpu/recommendations/{slug}.json
```

Tipos de relacao monitor-GPU: `pairs_well_with_gpu` (geral), `resolution_match` (VRAM focus), `refresh_rate_match` (sweet spot 0.9-1.5x coverage).

## Platform Constraint Layer v0

Campos adicionados nas entidades CPU e GPU para diferenciar "funciona" de "e recomendavel".

### CPU: cooling_requirement

Cada CPU tem `cooling_requirement.tier`: `basic` | `moderate` | `strong`

- `basic`: cooler stock adequado (ex: Core i3, Ryzen 3, CPUs de baixo TDP)
- `moderate`: upgrade de cooler melhora estabilidade (ex: Ryzen 5 5600, i5 K)
- `strong`: resfriamento robusto necessario para boost sustentado (ex: X3D, i9, Ryzen 9)

```
GET /api/cpus/ryzen-7-5800x3d.json
→ cooling_requirement.tier = "strong"
→ cooling_requirement.stock_cooler_adequate = false
```

### CPU: platform_warnings

Array de avisos de chipset e VRM por CPU. Campos: `type`, `severity`, `chipsets_affected`, `message`.

- `chipset_caution`: CPU funciona mas plataforma nao e ideal (ex: 5800X3D em A320)
- `vrm_caution`: alto consumo pode sobrecarregar VRMs de placas de entrada

```
GET /api/cpus/core-i9-14900k.json
→ platform_warnings[0].type = "chipset_caution"
→ platform_warnings[0].chipsets_affected = ["H610", "B660", "H670"]
→ platform_warnings[1].severity = "high"
```

### GPU: pcie_context

Contexto de interface PCIe por GPU. Campos: `interface`, `native_pcie_gen`, `sensitive_to_pcie_gen`,
`gaming_impact_on_pcie3`, `data_workload_impact_on_pcie3`.

- GPUs antigas (Pascal, Turing): `native_pcie_gen = "3.0"` — sem impacto de geracao
- GPUs modernas (Ampere, Ada, RDNA 2/3): `native_pcie_gen = "4.0"`
- GPUs high-end (RTX 4090, 5090, RX 9070 XT+): `sensitive_to_pcie_gen = true` — impacto em dados/IA

```
GET /api/gpus/geforce-rtx-4090.json
→ pcie_context.sensitive_to_pcie_gen = true
→ pcie_context.gaming_impact_on_pcie3 = "low"
→ pcie_context.data_workload_impact_on_pcie3 = "medium_to_high"
```

Estas restricoes aparecem nas paginas /html/questions/best-gpu-for-{cpu} como bloco "Atencao de plataforma".

## Paginas de Perguntas Naturais (/html/questions/)

Paginas estaticas que respondem perguntas em linguagem natural usando dados reais do grafo.
Cada pagina tem: resposta curta, recomendacao principal com razao, opcoes por faixa de preco,
quando evitar, e links diretos para API e entidades.

Tipos disponiveis:

- [/html/questions/best-gpu-for-{cpu_slug}](/html/questions/best-gpu-for-ryzen-5-5600): melhor GPU por CPU — equilibrio, eficiencia e custo-beneficio
- [/html/questions/psu-for-{gpu_slug}](/html/questions/psu-for-geforce-rtx-4070-super): fonte recomendada para uma GPU — wattagem minima, ideal e modelos
- [/html/questions/best-monitor-for-{gpu_slug}](/html/questions/best-monitor-for-geforce-rtx-4070-super): melhor monitor por GPU — agrupado por resolucao com tier_match e fps_coverage
- [/html/questions/](/html/questions/): indice de todas as perguntas disponiveis

**Exemplos de jornada para agentes:**

```
# Pergunta: qual GPU comprar para um Ryzen 5 5600?
GET /html/questions/best-gpu-for-ryzen-5-5600
→ contem: GPU recomendada, razao do grafo, link para /api/graph/cpu-gpu/gpus-for-cpu/ryzen-5-5600.json

# Pergunta: qual fonte usar com RTX 4070 SUPER?
GET /html/questions/psu-for-geforce-rtx-4070-super
→ contem: wattagem recomendada, modelos com preco, link para /api/recommend/psu-for-gpu/geforce-rtx-4070-super.json

# Pergunta: qual monitor combina com RTX 4070 SUPER?
GET /html/questions/best-monitor-for-geforce-rtx-4070-super
→ contem: monitores por resolucao (1080p/1440p/4K), tier_match, fps_coverage, link para /api/graph/monitor-gpu/monitors-for-gpu/geforce-rtx-4070-super.json
```

Jornada ideal de descoberta para agentes:
```
/llms.txt → /html/questions/best-gpu-for-{cpu} → /api/graph/cpu-gpu/gpus-for-cpu/{cpu}.json → /html/for-agents
```

## Contato

hello@entyrax.com

---
Versao publica: 0.6.0
Gerado em: 2026-06-02