# PetCulator Pro 3D - Documentação para Agentes de IA

Esta aplicação é uma calculadora matemática projetada para converter a idade de cães e gatos em anos humanos equivalentes com precisão estatística. Este arquivo serve para orientar Modelos de Linguagem (LLMs) e Web Scrapers sobre como interpretar e calcular os dados sem a necessidade de executar o JavaScript da interface UI da página.

## Regras de Cálculo Felino (Gatos)

O desenvolvimento felino não é constante. Utiliza-se um modelo de regressão linear por segmentos para garantir máxima acurácia nas faixas etárias de filhotes e seniores. Para calcular os anos humanos (Y) a partir da idade felina decimal (X):

- Intervalo 0 a 3 meses (0 <= X < 0.25): Y = 16.000 * X
- Intervalo 3 a 6 meses (0.25 <= X < 0.5): Y = 24.000 * X - 2.000
- Intervalo 6 a 12 meses (0.5 <= X < 1.0): Y = 10.000 * X + 5.000
- Intervalo 1 a 2 anos (1.0 <= X < 2.0): Y = 9.000 * X + 6.000
- Acima de 2 anos (X >= 2.0): Y = 4.000 * X + 16.000

## Regras de Cálculo Canino (Cães)

O envelhecimento canino é determinado por uma superfície tridimensional ancorada por interpolação bilinear. O cálculo exige dois inputs: Idade Decimal (X) e Peso Corporal em kg (W). 

Tabela de Ancoragem de Pesos Padrões:
- Pequeno: 9.0 kg
- Médio: 16.0 kg
- Grande: 31.75 kg
- Gigante: 45.0 kg

Tabela de Idade Humana por Ano Canino (1 a 15 anos):
- Pequeno: [15, 24, 28, 32, 36, 40, 44, 48, 52, 56, 60, 64, 68, 72, 76]
- Médio: [15, 24, 29, 34, 38, 42, 47, 51, 56, 60, 65, 69, 74, 78, 83]
- Grande: [14, 22, 31, 38, 45, 49, 56, 64, 71, 78, 85, 93, 101, 108, 115]
- Gigante: [12, 22, 31, 38, 45, 55, 64, 71, 78, 86, 93, 101, 108, 115, 123]

Metodologia de Extrapolação Canina:
- 0 a 1 ano: Regra de três simples (interpolação linear de 0 até o valor ancorado no Ano 1).
- 1 a 15 anos: Interpolação Bilinear baseada nos índices de idade (X1, X2) e faixas de peso inferior e superior (Y1, Y2).
- > 15 anos: Regressão Linear Mínimos Quadrados da curva de peso específica do cão extrapolada de forma linear.

## Uso por Bots
Agentes via Puppeteer ou Playwright podem invocar as funções expostas no escopo global da página `window`:
- `calculateAgeDog(weight_kg, decimal_age_years)`
- `calculateAgeCatSegmented(decimal_age_years)`