From c6e118d762fb57f23566e5c1816bd87d1a17ec78 Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 12:18:00 -0300
Subject: [PATCH 1/7] =?UTF-8?q?feat(core):=20Adiciona=20funcionalidades=20?=
 =?UTF-8?q?e=20documenta=C3=A7=C3=A3o=20de=20valuation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adiciona novos arquivos TypeScript para lidar com cálculo de condição, depreciação, quilometragem e tipos de avaliação de veículos.
Inclui testes unitários abrangentes para as novas utilidades.
Cria extensa documentação sobre especificações do MVP e regras de arquitetura e qualidade.
---
 .windsurf/rules/architecture.md               |  97 ++++++++
 .windsurf/rules/project.md                    |  82 +++++++
 .windsurf/rules/quality.md                    |  73 ++++++
 .windsurf/workflows/core/analyze-product.md   |  33 +++
 .windsurf/workflows/core/create-spec.md       |  67 ++++++
 .windsurf/workflows/core/create-tasks.md      |  59 +++++
 .windsurf/workflows/core/execute-task.md      |  39 ++++
 .windsurf/workflows/core/execute-tasks.md     |  30 +++
 .windsurf/workflows/core/plan-product.md      |  34 +++
 .../workflows/core/post-execution-tasks.md    |  35 +++
 .windsurf/workflows/project/check.md          |  32 +++
 .windsurf/workflows/project/release.md        |  37 ++++
 .windsurf/workflows/project/test.md           |  33 +++
 docs/specs/README.md                          |  27 +++
 docs/specs/ibav-mvp-tasks.md                  | 202 +++++++++++++++++
 docs/specs/ibav-mvp.md                        | 208 ++++++++++++++++++
 shared/types/valuation.ts                     |  19 ++
 shared/utils/condition.ts                     |  16 ++
 shared/utils/depreciation.ts                  |   4 +
 shared/utils/mileage.ts                       |  18 ++
 shared/utils/vehicle.ts                       |   3 +
 test/utils/condition.test.ts                  |  11 +
 test/utils/depreciation.test.ts               |  10 +
 test/utils/mileage.test.ts                    |  19 ++
 test/utils/vehicle.test.ts                    |  17 ++
 25 files changed, 1205 insertions(+)
 create mode 100644 .windsurf/rules/architecture.md
 create mode 100644 .windsurf/rules/project.md
 create mode 100644 .windsurf/rules/quality.md
 create mode 100644 .windsurf/workflows/core/analyze-product.md
 create mode 100644 .windsurf/workflows/core/create-spec.md
 create mode 100644 .windsurf/workflows/core/create-tasks.md
 create mode 100644 .windsurf/workflows/core/execute-task.md
 create mode 100644 .windsurf/workflows/core/execute-tasks.md
 create mode 100644 .windsurf/workflows/core/plan-product.md
 create mode 100644 .windsurf/workflows/core/post-execution-tasks.md
 create mode 100644 .windsurf/workflows/project/check.md
 create mode 100644 .windsurf/workflows/project/release.md
 create mode 100644 .windsurf/workflows/project/test.md
 create mode 100644 docs/specs/README.md
 create mode 100644 docs/specs/ibav-mvp-tasks.md
 create mode 100644 docs/specs/ibav-mvp.md
 create mode 100644 shared/types/valuation.ts
 create mode 100644 shared/utils/condition.ts
 create mode 100644 shared/utils/depreciation.ts
 create mode 100644 shared/utils/mileage.ts
 create mode 100644 shared/utils/vehicle.ts
 create mode 100644 test/utils/condition.test.ts
 create mode 100644 test/utils/depreciation.test.ts
 create mode 100644 test/utils/mileage.test.ts
 create mode 100644 test/utils/vehicle.test.ts

diff --git a/.windsurf/rules/architecture.md b/.windsurf/rules/architecture.md
new file mode 100644
index 0000000..a82af48
--- /dev/null
+++ b/.windsurf/rules/architecture.md
@@ -0,0 +1,97 @@
+---
+description: Regras de arquitetura do projeto IBAV
+---
+
+# IBAV - Architecture Rules
+
+## Nuxt
+
+- O projeto utiliza Nuxt 4. Sempre verifique `nuxt.config.ts` antes de modificar configurações.
+- A data de compatibilidade está em `nuxt.config.ts`. Não altere sem necessidade.
+- Não adicione módulos automaticamente. Verifique `package.json` e `nuxt.config.ts` existentes.
+
+## Vue
+
+- Vue 3 Composition API é o padrão do projeto.
+- `<script setup>` é preferido para novos componentes.
+- Não crie componentes Options API sem justificativa técnica.
+
+## TypeScript
+
+- TypeScript é obrigatório para arquivos `.ts` e `<script setup lang="ts">`.
+- Evite `any`. Prefira tipos explícitos.
+- Aproveite a inferência de tipos do Nuxt e Vue quando segura.
+- Mantenha `tsconfig.json` e configurações geradas por Nuxt (`.nuxt/tsconfig.*.json`).
+
+## SSR
+
+- O projeto suporta SSR por padrão.
+- Composables e código executado no servidor devem respeitar as diferenças entre cliente e servidor.
+- Evite acessar APIs do navegador (`window`, `document`) sem `onMounted` ou verificação de `process.client`.
+
+## Client / Server
+
+- APIs server-side vivem em `server/`.
+- Lógica compartilhada pode usar `shared/` quando apropriado.
+- `app/` contém a aplicação Vue/Nuxt.
+- `public/` contém assets estáticos.
+
+## Composables
+
+- Use `composables/` para lógica reutilizável entre componentes.
+- Nomeie com `use*` e exporte como função nomeada.
+- Documente entradas, saídas e efeitos colaterais quando relevante.
+
+## Components
+
+- Componentes Vue em `app/components/` (ou `components/` se configurado).
+- Nome em PascalCase. Não crie componentes de uma única palavra sem necessidade.
+- Reutilize componentes existentes antes de criar novos.
+
+## Pages
+
+- Pages em `app/pages/` (ou `pages/` se configurado).
+- Use `vue-router` (via Nuxt) para navegação.
+- Cada página deve ter responsabilidade única.
+
+## Layouts
+
+- Layouts em `app/layouts/` (se existir).
+- Não crie layout novo se um existente já atender.
+
+## Plugins
+
+- Plugins em `app/plugins/` (se existir).
+- Registre em `nuxt.config.ts` se necessário.
+
+## Server
+
+- Server routes e middlewares em `server/`.
+- Valide entradas nas APIs.
+- Retorne respostas consistentes e com tipos claros.
+
+## Utils
+
+- Funções utilitárias puras em `app/utils/` ou `utils/`.
+- Prefira funções pequenas, testáveis e sem efeitos colaterais.
+
+## Configuração
+
+- `nuxt.config.ts` é a fonte de verdade para configuração do Nuxt.
+- `vitest.config.ts` para configuração de testes.
+- `eslint.config.mjs` para regras de lint.
+- `.prettierrc` para formatação.
+- `tsconfig.json` deve ser respeitado.
+
+## Imports
+
+- Utilize auto-imports do Nuxt quando disponível.
+- Imports explícitos são aceitáveis quando evitam conflitos ou melhoram clareza.
+
+## Reutilização de código
+
+- Antes de criar uma nova abstração:
+  - Procure por algo equivalente.
+  - Entenda a arquitetura atual.
+  - Reutilize o padrão existente quando possível.
+- Não crie arquitetura nova apenas por preferência.
diff --git a/.windsurf/rules/project.md b/.windsurf/rules/project.md
new file mode 100644
index 0000000..eb37702
--- /dev/null
+++ b/.windsurf/rules/project.md
@@ -0,0 +1,82 @@
+---
+description: Regras permanentes do projeto IBAV
+---
+
+# IBAV - Project Rules
+
+## Nome do projeto
+
+IBAV (Instituto Brasileiro de Avaliação Veicular)
+
+## Stack
+
+- Nuxt 4
+- Vue 3
+- Vue Router
+- TypeScript
+- Nuxt UI
+- Nuxt Content
+- Nuxt Image
+- Nuxt SEO Utils
+- Vitest
+- Vue Test Utils
+- Nuxt Test Utils
+- ESLint (@nuxt/eslint-config)
+- Prettier
+- Changelogen
+- pnpm
+
+## Package manager
+
+O projeto utiliza **pnpm**.
+
+- Use `pnpm` para instalar, remover, atualizar ou executar scripts.
+- Nunca use `npm`, `yarn` ou `bun` a menos que o usuário solicite explicitamente.
+
+## Scripts disponíveis
+
+Verifique o `package.json` antes de sugerir qualquer comando. Scripts atuais:
+
+- `pnpm build`
+- `pnpm dev`
+- `pnpm generate`
+- `pnpm preview`
+- `pnpm postinstall`
+- `pnpm lint`
+- `pnpm test`
+- `pnpm test:watch`
+- `pnpm test:debug`
+- `pnpm format`
+- `pnpm format:check`
+
+Não invente scripts como `pnpm typecheck`, `pnpm test:unit`, `pnpm check` ou `pnpm validate`.
+
+## Localização da documentação
+
+- Documentação principal: `docs/docs.md`
+- Especificações técnicas: `docs/specs/`
+- Documentação pública: `docs/content/`
+
+## Fonte de verdade
+
+- `package.json` é a fonte de verdade para:
+  - Nome e versão do projeto
+  - Dependências e devDependencies
+  - Scripts
+  - Stack e versões
+- `docs/docs.md` é a fonte de verdade para a documentação pública do produto.
+
+## Convenções gerais
+
+- Trate `package.json` como fonte de verdade para dependências, scripts e stack.
+- Não hardcode versões de pacotes em Workflows ou Rules.
+- Não invente dependências, scripts ou configurações.
+- Caso um arquivo não exista, ignore-o. Não crie suposições.
+- Sempre consulte `package.json` e `docs/docs.md` antes de propor mudanças.
+
+## Regras de execução
+
+- Uma tarefa por vez.
+- Pare após cada tarefa e aguarde aprovação explícita do usuário.
+- Não continue automaticamente.
+- Não execute a próxima tarefa sem instrução explícita.
diff --git a/.windsurf/rules/quality.md b/.windsurf/rules/quality.md
new file mode 100644
index 0000000..d5ff3d3
--- /dev/null
+++ b/.windsurf/rules/quality.md
@@ -0,0 +1,73 @@
+---
+description: Regras de qualidade do projeto IBAV
+---
+
+# IBAV - Quality Rules
+
+## TypeScript strict
+
+- Utilize tipos explícitos e evite `any`.
+- Prefira interfaces e tipos nomeados.
+- Mantenha consistência com as configurações de `tsconfig.json`.
+
+## Código simples
+
+- Funções pequenas com responsabilidade única.
+- Máxima clareza sobre máxima abstração.
+- Evite lógica desnecessária.
+
+## Responsabilidades claras
+
+- Um componente, composable ou função deve ter um propósito claro.
+- Separe lógica de apresentação quando apropriado.
+
+## Evitar duplicação
+
+- Extraia funções comuns para `utils/` ou `composables/`.
+- Não copie e cole código em vários locais.
+
+## Testes
+
+- Novos comportamentos devem receber testes quando aplicável.
+- Os testes vivem em `test/**/*.{test,spec}.{js,ts}`.
+- Não modifique testes apenas para fazer a implementação passar.
+- Se um teste estiver incorreto, explique o motivo antes de alterá-lo.
+
+## Lint
+
+- O comando `pnpm lint` executa `eslint . --fix`.
+- Como o `--fix` modifica arquivos, verifique `git diff` após a execução.
+- Não execute lint indiscriminadamente em tarefas que possam afetar arquivos fora do escopo.
+
+## Formatação
+
+- Use `pnpm format:check` para validação.
+- Use `pnpm format` somente quando necessário corrigir formatação.
+- Verifique `git diff` após `pnpm format`.
+
+## Build
+
+- Considere `pnpm build` como validação quando alterar:
+  - `nuxt.config.ts`
+  - módulos
+  - plugins
+  - pages
+  - server
+  - configuração de build
+  - runtime
+  - imports
+  - SSR
+  - componentes críticos
+- Não execute build desnecessariamente para alterações puramente documentais.
+
+## Alterações mínimas
+
+- Uma tarefa deve modificar apenas o código necessário para o seu objetivo.
+- Não refatore código não relacionado.
+- Problemas encontrados fora do escopo devem ser reportados, não corrigidos automaticamente.
+
+## Validação
+
+- As validações devem ser baseadas exclusivamente em scripts existentes em `package.json`.
+- Antes de executar qualquer comando, verifique se ele existe no `package.json`.
+- Não crie comandos fictícios como `pnpm typecheck`.
diff --git a/.windsurf/workflows/core/analyze-product.md b/.windsurf/workflows/core/analyze-product.md
new file mode 100644
index 0000000..3c9c3a7
--- /dev/null
+++ b/.windsurf/workflows/core/analyze-product.md
@@ -0,0 +1,33 @@
+---
+description: Analyze the product and existing project context
+---
+
+# /analyze-product
+
+## Purpose
+
+Understand the project, its goals, and existing architecture before proposing any change.
+
+## Steps
+
+1. Read `package.json` to understand the project name, version, stack, dependencies, and scripts.
+2. Read `docs/docs.md` to understand the product goals and domain.
+3. Read `README.md` for the public description.
+4. List `app/`, `server/`, `shared/`, `test/`, `public/`, and `docs/`.
+5. Read `nuxt.config.ts`, `tsconfig.json`, `vitest.config.ts`, `eslint.config.mjs`, and `.prettierrc` if they exist.
+6. Identify the current architecture, patterns, and conventions.
+7. Summarize findings without proposing implementation.
+
+## Output
+
+- Project overview
+- Stack and versions (from `package.json`)
+- Main documentation location
+- Current architecture and conventions
+- Known risks or ambiguities
+
+## Constraints
+
+- Do not invent dependencies or scripts.
+- Do not modify production code.
+- Do not create specifications at this stage unless requested.
diff --git a/.windsurf/workflows/core/create-spec.md b/.windsurf/workflows/core/create-spec.md
new file mode 100644
index 0000000..7f49ff9
--- /dev/null
+++ b/.windsurf/workflows/core/create-spec.md
@@ -0,0 +1,67 @@
+---
+description: Create a detailed specification for a feature
+---
+
+# /create-spec <feature-name>
+
+## Purpose
+
+Create a complete specification for a new feature or change.
+
+## Steps
+
+1. Read `package.json`.
+2. Read `docs/docs.md`.
+3. List and analyze the current project structure.
+4. Read files related to the feature area.
+5. Identify existing patterns and conventions.
+6. Identify risks and ambiguities.
+7. Create the spec file at `docs/specs/<feature-name>.md`.
+
+## Spec template
+
+```markdown
+# <Feature>
+
+## Problem
+
+## Goal
+
+## Scope
+
+## Non-goals
+
+## Current Architecture
+
+## Proposed Solution
+
+## Functional Requirements
+
+## Technical Requirements
+
+## Data Flow
+
+## API / Interfaces
+
+## Error Handling
+
+## Testing Strategy
+
+## Documentation
+
+## Acceptance Criteria
+
+- [ ] ...
+
+## Risks
+
+## Open Questions
+```
+
+## Critical rule
+
+- After creating the spec: **STOP**.
+- Do not create tasks.
+- Do not implement code.
+- Do not modify production files.
+- Wait for explicit user approval before running `/create-tasks`.
diff --git a/.windsurf/workflows/core/create-tasks.md b/.windsurf/workflows/core/create-tasks.md
new file mode 100644
index 0000000..92823aa
--- /dev/null
+++ b/.windsurf/workflows/core/create-tasks.md
@@ -0,0 +1,59 @@
+---
+description: Create implementation tasks from an approved specification
+---
+
+# /create-tasks <feature-name>
+
+## Purpose
+
+Break an approved specification into small, executable tasks.
+
+## Steps
+
+1. Read the spec at `docs/specs/<feature-name>.md`.
+2. Re-analyze the code affected by the spec.
+3. Divide the implementation into small, reviewable tasks.
+4. Respect dependencies between tasks.
+5. For each task define:
+   - Goal
+   - Files involved
+   - Implementation outline
+   - Tests
+   - Validation
+   - Acceptance criteria
+6. Create the task list at `docs/specs/<feature-name>-tasks.md`.
+
+## Task template
+
+```markdown
+# Tasks
+
+## Task 1 — <name>
+
+### Goal
+
+### Files
+
+### Implementation
+
+### Tests
+
+### Validation
+
+### Acceptance Criteria
+
+- [ ] ...
+
+---
+
+## Task 2 — <name>
+
+...
+```
+
+## Critical rule
+
+- This workflow can only run after a spec exists and has been approved.
+- After creating the tasks: **STOP**.
+- Do not execute any task.
+- Wait for explicit user authorization before running `/execute-task N`.
diff --git a/.windsurf/workflows/core/execute-task.md b/.windsurf/workflows/core/execute-task.md
new file mode 100644
index 0000000..f0fa079
--- /dev/null
+++ b/.windsurf/workflows/core/execute-task.md
@@ -0,0 +1,39 @@
+---
+description: Execute a single task from an approved task list
+---
+
+# /execute-task <number>
+
+## Purpose
+
+Execute exactly one task from a task list.
+
+## Steps
+
+1. Read the spec at `docs/specs/<feature-name>.md`.
+2. Read the task list at `docs/specs/<feature-name>-tasks.md`.
+3. Identify the requested task number.
+4. Analyze the files involved.
+5. Implement only that task.
+6. Run relevant validations from `package.json`:
+   - `pnpm lint` (with caution; check `git diff` after)
+   - `pnpm format:check`
+   - `pnpm test`
+   - `pnpm build` when appropriate
+7. Analyze the diff.
+8. Report the result.
+
+## Constraints
+
+- Execute only the requested task number.
+- Do not execute Task N+1, N+2, etc.
+- Do not refactor unrelated code.
+- Do not update dependencies.
+- Do not change versions.
+- Do not create future functionality.
+- Do not fix unrelated problems.
+
+## Hard stop
+
+- On `task_complete`: do not proceed to additional tasks without explicit user request.
+- Mark completed task as `[✅]` and pending/deferred tasks as `[⏳]`.
diff --git a/.windsurf/workflows/core/execute-tasks.md b/.windsurf/workflows/core/execute-tasks.md
new file mode 100644
index 0000000..be817f9
--- /dev/null
+++ b/.windsurf/workflows/core/execute-tasks.md
@@ -0,0 +1,30 @@
+---
+description: Safely execute a requested sequence of tasks one by one
+---
+
+# /execute-tasks <number>[,<number>...]
+
+## Purpose
+
+Execute multiple tasks explicitly requested by the user, one at a time, with confirmation between them.
+
+## Steps
+
+1. Read the spec at `docs/specs/<feature-name>.md`.
+2. Read the task list at `docs/specs/<feature-name>-tasks.md`.
+3. For each requested task number:
+   a. Confirm the next task with the user.
+   b. Run `/execute-task <number>` logic.
+   c. Wait for explicit user approval to continue.
+4. Stop after each task.
+
+## Constraints
+
+- Each task must be explicitly requested or approved.
+- Do not auto-continue after a task finishes.
+- Do not skip the `/execute-task` workflow logic.
+- Validate between tasks.
+
+## Hard stop
+
+- After any task: **STOP**. Wait for explicit user instruction.
diff --git a/.windsurf/workflows/core/plan-product.md b/.windsurf/workflows/core/plan-product.md
new file mode 100644
index 0000000..6225ebb
--- /dev/null
+++ b/.windsurf/workflows/core/plan-product.md
@@ -0,0 +1,34 @@
+---
+description: Plan the product work based on existing analysis
+---
+
+# /plan-product
+
+## Purpose
+
+Define the high-level planning before creating a detailed spec.
+
+## Steps
+
+1. Review the output of `/analyze-product`.
+2. Clarify the problem or opportunity to address.
+3. Define the goal, scope, and non-goals at a high level.
+4. List constraints and dependencies.
+5. Identify risks and open questions.
+6. Output a planning document or summary.
+
+## Output
+
+- Goal
+- Scope
+- Non-goals
+- Constraints
+- Risks
+- Open questions
+- Recommended next step: `/create-spec <feature-name>`
+
+## Constraints
+
+- Do not implement code.
+- Do not create detailed specs unless requested.
+- Stop and wait for approval before proceeding to `/create-spec`.
diff --git a/.windsurf/workflows/core/post-execution-tasks.md b/.windsurf/workflows/core/post-execution-tasks.md
new file mode 100644
index 0000000..b3c85f8
--- /dev/null
+++ b/.windsurf/workflows/core/post-execution-tasks.md
@@ -0,0 +1,35 @@
+---
+description: Post-execution validation and summary
+---
+
+# /post-execution-tasks <feature-name>
+
+## Purpose
+
+Review the implementation after all requested tasks are completed.
+
+## Steps
+
+1. Read the spec and task list.
+2. Verify the diff for all implemented tasks.
+3. Run final validations from `package.json` when applicable:
+   - `pnpm lint` (with caution)
+   - `pnpm format:check`
+   - `pnpm test`
+   - `pnpm build` (if build configuration was affected)
+4. Ensure `docs/docs.md` is updated if the change affects public behavior, API, or configuration.
+5. Summarize what was done, pending items, and any new risks.
+
+## Output
+
+- Summary of completed tasks
+- Pending tasks (`[⏳]`)
+- Validation results
+- Suggested next action
+
+## Constraints
+
+- Do not execute additional tasks.
+- Do not release automatically.
+- Do not modify `package.json` version.
+- Wait for user approval for any next step.
diff --git a/.windsurf/workflows/project/check.md b/.windsurf/workflows/project/check.md
new file mode 100644
index 0000000..cc6c779
--- /dev/null
+++ b/.windsurf/workflows/project/check.md
@@ -0,0 +1,32 @@
+---
+description: Analyze project state without implementing
+---
+
+# /check
+
+## Purpose
+
+Analyze the current project state and produce a report without making changes.
+
+## Steps
+
+1. Run `git status` and `git diff` to see uncommitted changes.
+2. Check `package.json` for scripts and dependencies.
+3. Run `pnpm format:check` if the script exists.
+4. Run `pnpm test` if relevant.
+5. Run `pnpm lint` only if the user explicitly requests it (because `--fix` can modify files).
+6. Consider `pnpm build` only when the project state demands it.
+7. Identify files modified inappropriately.
+
+## Output
+
+- Git status summary
+- Validation results
+- Files changed unexpectedly
+- Recommendations
+
+## Constraints
+
+- Do not fix automatically.
+- Do not modify production code.
+- Report only. Wait for user instruction before fixing.
diff --git a/.windsurf/workflows/project/release.md b/.windsurf/workflows/project/release.md
new file mode 100644
index 0000000..aec8d29
--- /dev/null
+++ b/.windsurf/workflows/project/release.md
@@ -0,0 +1,37 @@
+---
+description: Prepare a new release
+---
+
+# /release
+
+## Purpose
+
+Prepare a new release based on the current state.
+
+## Steps
+
+1. Read `package.json` and confirm the current version.
+2. Read `CHANGELOG.md`.
+3. Check `git status` and `git log`.
+4. Run the necessary validation scripts that exist in `package.json`:
+   - `pnpm lint` (with caution; review `git diff` after)
+   - `pnpm test`
+   - `pnpm format:check`
+   - `pnpm build`
+5. Identify changes since the last release.
+6. Propose the next version using `changelogen` semantics.
+7. Propose a new `CHANGELOG.md` entry.
+
+## Output
+
+- Current version
+- Changes since last release
+- Proposed next version
+- Suggested changelog entry
+
+## Constraints
+
+- Do not bump version automatically.
+- Do not publish or release automatically.
+- Do not modify `package.json` or `CHANGELOG.md` without explicit approval.
+- Wait for explicit user authorization before any release step.
diff --git a/.windsurf/workflows/project/test.md b/.windsurf/workflows/project/test.md
new file mode 100644
index 0000000..ab6776c
--- /dev/null
+++ b/.windsurf/workflows/project/test.md
@@ -0,0 +1,33 @@
+---
+description: Run project tests
+---
+
+# /test
+
+## Purpose
+
+Execute tests and report results without changing code.
+
+## Steps
+
+1. Read `package.json` to confirm test scripts.
+2. Identify tests related to the current change.
+3. Run the appropriate test command:
+   - `pnpm test` for full suite
+   - `pnpm test:watch` if requested for development
+   - `pnpm test:debug` if requested for debugging
+4. Report the results.
+5. Stop on any failure and report without modifying code.
+
+## Output
+
+- Command executed
+- Test results
+- Failed tests (if any)
+- Recommended next action
+
+## Constraints
+
+- Do not modify code to make tests pass.
+- Do not invent test scripts.
+- Wait for user instruction before fixing failures.
diff --git a/docs/specs/README.md b/docs/specs/README.md
new file mode 100644
index 0000000..da30e91
--- /dev/null
+++ b/docs/specs/README.md
@@ -0,0 +1,27 @@
+# Specifications
+
+This directory contains technical specifications for changes to the IBAV project.
+
+Specs are created by the Windsurf `/create-spec` workflow and reviewed before implementation.
+
+## Naming convention
+
+- `docs/specs/<feature-name>.md` - the spec
+- `docs/specs/<feature-name>-tasks.md` - the task list derived from the spec
+
+## Status
+
+- Draft - spec created, not yet approved
+- Approved - spec reviewed and ready for implementation
+- Completed - all tasks executed and validated
+
+## Process
+
+1. `/analyze-product` - understand the project
+2. `/plan-product` - high-level planning
+3. `/create-spec <feature-name>` - detailed spec
+4. Review and approve
+5. `/create-tasks <feature-name>` - task list
+6. Review and approve
+7. `/execute-task N` - one task at a time
+8. Validate and continue only after explicit approval
diff --git a/docs/specs/ibav-mvp-tasks.md b/docs/specs/ibav-mvp-tasks.md
new file mode 100644
index 0000000..2f2e218
--- /dev/null
+++ b/docs/specs/ibav-mvp-tasks.md
@@ -0,0 +1,202 @@
+# Tasks — IBAV MVP
+
+## Task 1 — ✅ Definir tipos e interfaces do domínio
+
+### Goal
+
+Criar os tipos centrais usados em toda a aplicação: entradas do veículo e resultado da avaliação.
+
+### Files
+
+- `shared/types/valuation.ts`
+
+### Implementation
+
+- Declarar `VehicleInputs` com `fipeValue`, `year`, `mileage`, `condition`.
+- Declarar `ValuationResult` com todos os campos de saída.
+- Exportar os tipos.
+
+### Tests
+
+- Nenhum teste unitário necessário; validação por compilação TypeScript.
+
+### Validation
+
+- `pnpm nuxt prepare` ou `npx tsc --noEmit`.
+
+### Acceptance Criteria
+
+- [ ] `shared/types/valuation.ts` criado e compilável.
+- [ ] Tipos refletem o contrato descrito na especificação.
+
+---
+
+## Task 2 — ✅ Implementar utilitários base (idade, quilometragem, conservação)
+
+### Goal
+
+Criar as funções puras de cálculo de idade, desvalorização, ajuste por km e conservação.
+
+### Files
+
+- `shared/utils/vehicle.ts`
+- `shared/utils/depreciation.ts`
+- `shared/utils/mileage.ts`
+- `shared/utils/condition.ts`
+
+### Implementation
+
+- `vehicle.ts`: `calculateAge(year)` retorna `anoAtual - year`.
+- `depreciation.ts`: `calculateAgeDiscount(age)` retorna `age * 0.02`.
+- `mileage.ts`: `calculateMileageAdjustment(age, mileage)` compara com `age * 15000` e aplica `±` percentuais.
+- `condition.ts`: `calculateConditionAdjustment(condition)` mapeia os quatro estados para percentuais.
+
+### Tests
+
+- `test/utils/vehicle.test.ts`
+- `test/utils/depreciation.test.ts`
+- `test/utils/mileage.test.ts`
+- `test/utils/condition.test.ts`
+
+### Validation
+
+- `pnpm test`
+
+### Acceptance Criteria
+
+- [ ] Cada utilitário cobre os cenários de limite (idade 0, km 0, km muito alta).
+- [ ] Percentuais estão corretos conforme `docs/docs.md`.
+
+---
+
+## Task 3 — Implementar VJV e IVB
+
+### Goal
+
+Compor os utilitários base para calcular o Valor Justo do Veículo e o Índice IVB.
+
+### Files
+
+- `shared/utils/vjv.ts`
+- `shared/utils/ivb.ts`
+
+### Implementation
+
+- `vjv.ts`: `calculateVjv(inputs)` — aplica a fórmula usando FIPE como base, desconto idade, ajuste km e conservação.
+- `ivb.ts`: `calculateIvb(inputs)` — calcula pontuação e retorna `label` (Excelente, Muito Bom, Bom, Regular, Atenção).
+
+### Tests
+
+- `test/utils/vjv.test.ts` — verificar exemplo FIPE 80.000, 2022, 90.000 km, Excelente → R$ 74.800.
+- `test/utils/ivb.test.ts` — verificar mesmo exemplo → 842 pontos e classificação "Muito Bom".
+
+### Validation
+
+- `pnpm test`
+
+### Acceptance Criteria
+
+- [ ] Exemplo do `docs/docs.md` passa com arredondamento de centavos esperado.
+- [ ] Todos os estados de conservação e faixas de km são testados.
+
+---
+
+## Task 4 — Criar página com formulário e exibição de resultados
+
+### Goal
+
+Construir a interface do usuário com Nuxt UI, formulário e painel de resultado.
+
+### Files
+
+- `app/pages/index.vue` (ou `app.vue` se preferir single-page)
+- `app/components/` se necessário (ex: `VehicleForm.vue`, `ResultPanel.vue`)
+
+### Implementation
+
+- Formulário com 4 campos usando Nuxt UI.
+- Estados reativos com `ref`/`reactive`.
+- Chamada a `calculateVjv` e `calculateIvb` a cada alteração.
+- Renderização de FIPE, VJV, IVB e classificação.
+- Formatação em `pt-BR` sem i18n.
+
+### Tests
+
+- `test/app.test.ts` — renderiza e interage com campos.
+
+### Validation
+
+- `pnpm dev` e `pnpm test`
+
+### Acceptance Criteria
+
+- [ ] Formulário renderiza os quatro campos.
+- [ ] Alterar os campos atualiza o resultado em tempo real.
+- [ ] Resultado exibe VJV, IVB e classificação.
+
+---
+
+## Task 5 — Sincronizar formulário com query params para compartilhamento
+
+### Goal
+
+Permitir que o usuário copie e compartilhe uma URL que carregue o mesmo cálculo.
+
+### Files
+
+- `app/pages/index.vue`
+
+### Implementation
+
+- Sincronizar `useRoute().query` → estado no `onMounted`.
+- Atualizar `useRouter()` query ao mudar campos.
+- Converter tipos (number) de forma segura.
+
+### Tests
+
+- `test/app.test.ts` ou teste específico para query params.
+
+### Validation
+
+- `pnpm test` e teste manual de navegação.
+
+### Acceptance Criteria
+
+- [ ] URL reflete os valores preenchidos.
+- [ ] Acessar URL com query params preenche o formulário.
+- [ ] Não há hydration mismatch.
+
+---
+
+## Task 6 — Integração final e verificação
+
+### Goal
+
+Garantir que todo o MVP passa em lint, testes e build.
+
+### Files
+
+- Todos afetados pelas tasks anteriores.
+
+### Implementation
+
+- Verificar e ajustar imports, formatação e tipos.
+- Remover arquivos placeholder não utilizados (`hello.ts`, testes genéricos).
+
+### Tests
+
+- `pnpm test`
+
+### Validation
+
+- `pnpm lint`
+- `pnpm format:check`
+- `pnpm test`
+- `pnpm build`
+
+### Acceptance Criteria
+
+- [ ] `pnpm lint` passa.
+- [ ] `pnpm test` passa.
+- [ ] `pnpm build` gera sem erros.
+- [ ] Aplicação funciona em `pnpm dev`.
diff --git a/docs/specs/ibav-mvp.md b/docs/specs/ibav-mvp.md
new file mode 100644
index 0000000..64ef5eb
--- /dev/null
+++ b/docs/specs/ibav-mvp.md
@@ -0,0 +1,208 @@
+# IBAV MVP — Calculadora de Valor Justo e Índice IVB
+
+## Problem
+
+A Tabela FIPE apresenta uma média nacional de preços e não reflete as condições individuais de um veículo (idade, quilometragem, conservação). Não existe uma ferramenta pública, auditável e offline que ajuste a referência FIPE com base nesses fatores de forma transparente.
+
+## Goal
+
+Implementar o **MVP do IBAV**, um cálculo reprodutível de:
+
+- **VJV (Valor Justo do Veículo)**
+- **IVB (Índice de Valor Brasileiro)**
+
+A ferramenta deve funcionar **100% no frontend**, sem APIs externas, e apresentar os resultados de forma clara ao usuário.
+
+## Scope
+
+- Formulário de entrada (FIPE, ano, km, conservação)
+- Cálculo da idade do veículo
+- Cálculo do VJV com base na metodologia do `docs/docs.md`
+- Cálculo do IVB (0-1000 pontos) e classificação
+- Página/área de resultado (Valor FIPE, VJV, IVB, classificação)
+- Compartilhamento básico dos resultados
+- Testes unitários das funções de cálculo
+
+## Non-goals
+
+- Consulta automática à Tabela FIPE
+- Backend real/persistência de dados
+- Histórico de cálculos
+- Comparação entre veículos
+- Integração com bancos, leilões, seguro ou sinistros
+- Autenticação
+- Internacionalização (i18n) — o MVP será exclusivamente em português do Brasil
+
+## Current Architecture
+
+```
+app/
+  app.vue              # entry básico, apenas NuxtWelcome
+server/
+  api/hello.ts         # endpoint placeholder
+shared/
+  utils/capitalize.ts  # único utilitário existente
+test/
+  app.test.ts          # testes do app.vue básico
+  utils.test.ts        # testes genéricos placeholder
+```
+
+Stack:
+
+- Nuxt 4.5.1 + Vue 3.5.40
+- Nuxt UI 4.10.0
+- TypeScript 6.0
+- Vitest 4.1 + jsdom
+- ESLint flat config + Prettier
+
+Não existe ainda nenhuma lógica de domínio implementada.
+
+## Proposed Solution
+
+1. Criar módulos de cálculo em `shared/utils/`:
+   - `vehicle.ts` — cálculo da idade
+   - `depreciation.ts` — desvalorização por idade
+   - `mileage.ts` — ajuste por quilometragem
+   - `condition.ts` — ajuste por conservação
+   - `vjv.ts` — cálculo do Valor Justo
+   - `ivb.ts` — cálculo do IVB e classificação
+2. Criar uma página `app/pages/index.vue` com o formulário e o resultado.
+3. Utilizar Nuxt UI para inputs (`UInput`, `USelect`) e exibição (`UCard`).
+4. Persistir os inputs em query params para permitir compartilhamento por URL.
+5. Testar todas as funções matemáticas com os exemplos contidos em `docs/docs.md`.
+
+## Functional Requirements
+
+- **FR1** O usuário deve informar: valor FIPE (R$), ano do veículo, quilometragem atual e estado de conservação.
+- **FR2** A idade deve ser calculada automaticamente (`anoAtual - anoVeiculo`).
+- **FR3** O desconto por idade deve ser `idade × 2%`.
+- **FR4** O ajuste por quilometragem deve seguir a média de 15.000 km/ano:
+  - acima da média: `-0,5%` a cada 10.000 km
+  - abaixo da média: `+0,3%` a cada 10.000 km
+- **FR5** O ajuste por conservação deve ser:
+  - Excelente: `+3%`
+  - Bom: `0%`
+  - Regular: `-3%`
+  - Ruim: `-8%`
+- **FR6** O VJV deve ser calculado como:
+  `VJV = FIPE + ajusteConservação - descontoIdade ± ajusteQuilometragem`
+- **FR7** O IVB deve ser calculado como pontuação de 0 a 1000:
+  - base: 1000
+  - idade: `-15` pontos/ano
+  - quilometragem acima: `-10` a cada 10.000 km
+  - conservação: `+30/0/-30/-80`
+- **FR8** O resultado deve exibir classificação IVB (Excelente, Muito Bom, Bom, Regular, Atenção).
+- **FR9** O compartilhamento deve permitir copiar a URL com os parâmetros preenchidos.
+- **FR10** O cálculo deve ocorrer em tempo real à medida que o usuário altera os campos.
+
+## Technical Requirements
+
+- **TR1** Todos os cálculos devem ser TypeScript puro em `shared/utils/`.
+- **TR2** Nenhuma chamada de API ou backend será usada para o cálculo.
+- **TR3** A moeda deve ser formatada em `pt-BR` (R$).
+- **TR4** Formulário e resultados devem usar componentes Nuxt UI.
+- **TR5** A página deve ser SSR-safe (sem hydration mismatch).
+- **TR6** Query params devem sincronizar o estado do formulário via `useRoute().query` e `useRouter()`.
+- **TR7** Cobertura de testes unitários acima de 80% para os utilitários matemáticos.
+
+## Data Flow
+
+```
+Usuário preenche formulário
+        ↓
+Validação de campos (números positivos, ano, km)
+        ↓
+Cálculo da idade
+        ↓
+Cálculo de descontos/acréscimos
+        ↓
+Cálculo VJV
+        ↓
+Cálculo IVB
+        ↓
+Renderização do resultado
+        ↓
+Sincronização com query params (compartilhamento)
+```
+
+## API / Interfaces
+
+```ts
+// shared/types/valuation.ts
+export interface VehicleInputs {
+  fipeValue: number;
+  year: number;
+  mileage: number;
+  condition: 'excelente' | 'bom' | 'regular' | 'ruim';
+}
+
+export interface ValuationResult {
+  fipeValue: number;
+  vjv: number;
+  ivbPoints: number;
+  ivbLabel: string;
+  age: number;
+  ageDiscount: number;
+  mileageAdjustment: number;
+  conditionAdjustment: number;
+}
+
+// shared/utils/vjv.ts
+export function calculateVjv(inputs: VehicleInputs): number;
+
+// shared/utils/ivb.ts
+export function calculateIvb(inputs: VehicleInputs): { points: number; label: string };
+```
+
+## Error Handling
+
+- Valor FIPE deve ser maior que zero.
+- Ano deve estar entre 1900 e o ano atual.
+- Quilometragem deve ser maior ou igual a zero.
+- Campos inválidos exibem mensagem sem bloquear digitação.
+- Resultado só é exibido quando todos os campos são válidos.
+
+## Testing Strategy
+
+- **Unitários** em `test/utils/` com os cenários do `docs/docs.md`:
+  - `vjv.test.ts` — exemplo FIPE 80.000, 2022, 90.000 km, Excelente → R$ 74.800
+  - `ivb.test.ts` — mesmo exemplo → 842 pontos
+  - `condition.test.ts` — todos os estados
+  - `mileage.test.ts` — acima e abaixo da média
+- **Componente** `app.test.ts` — renderiza formulário e mostra resultados após input.
+- **Edge cases**: ano futuro, km 0, FIPE 0, string vazia, conservação inválida.
+
+## Documentation
+
+- Manter `docs/docs.md` como a fonte da metodologia de produto.
+- `docs/specs/ibav-mvp-tasks.md` será gerado na próxima etapa (`/create-tasks`).
+- Código deve conter comentários mínimos explicando a fórmula.
+
+## Acceptance Criteria
+
+- [ ] Usuário consegue preencher os quatro campos.
+- [ ] Cálculo do VJV gera exatamente R$ 74.800 para o exemplo do `docs.md`.
+- [ ] Cálculo do IVB gera exatamente 842 pontos para o exemplo do `docs.md`.
+- [ ] Resultado exibe VJV, IVB e classificação.
+- [ ] URL é atualizada com os parâmetros preenchidos.
+- [ ] Testes unitários cobrem todos os estados de conservação e faixas de quilometragem.
+- [ ] Nenhuma requisição externa é feita durante o cálculo.
+- [ ] Aplicação funciona em `pnpm dev` e `pnpm generate` (modo estático).
+
+## Risks
+
+- **R1** Ambiguidade na ordem de aplicação dos percentuais. A fórmula `docs.md` usa `±` sem indicar se os descontos são cumulativos sobre o FIPE ou sobre o total acumulado.
+- **R2** Arredondamento de centavos pode divergir dependendo do ponto de aplicação.
+- **R3** Nuxt UI 4 pode ter diferenças de API de componentes que exigem ajustes.
+- **R4** Query params podem expor valores sensíveis (números brutos) no compartilhamento.
+
+## Open Questions
+
+1. O cálculo percentual deve ser aplicado sempre sobre o valor FIPE original (mais previsível) ou de forma cumulativa?
+2. O arredondamento final do VJV será em centavos (toFixed(2))?
+3. O compartilhamento será apenas por URL/query params ou incluir botão "copiar resultado" em texto?
+4. A página de resultados ficará na mesma página do formulário ou em rota separada?
+
+---
+
+Status: **Draft**
diff --git a/shared/types/valuation.ts b/shared/types/valuation.ts
new file mode 100644
index 0000000..0ef70a9
--- /dev/null
+++ b/shared/types/valuation.ts
@@ -0,0 +1,19 @@
+export type VehicleCondition = 'excelente' | 'bom' | 'regular' | 'ruim';
+
+export interface VehicleInputs {
+  fipeValue: number;
+  year: number;
+  mileage: number;
+  condition: VehicleCondition;
+}
+
+export interface ValuationResult {
+  fipeValue: number;
+  vjv: number;
+  ivbPoints: number;
+  ivbLabel: string;
+  age: number;
+  ageDiscount: number;
+  mileageAdjustment: number;
+  conditionAdjustment: number;
+}
diff --git a/shared/utils/condition.ts b/shared/utils/condition.ts
new file mode 100644
index 0000000..42f0d33
--- /dev/null
+++ b/shared/utils/condition.ts
@@ -0,0 +1,16 @@
+import type { VehicleCondition } from '../types/valuation';
+
+export function calculateConditionAdjustment(condition: VehicleCondition): number {
+  switch (condition) {
+    case 'excelente':
+      return 0.03;
+    case 'bom':
+      return 0;
+    case 'regular':
+      return -0.03;
+    case 'ruim':
+      return -0.08;
+    default:
+      return 0;
+  }
+}
diff --git a/shared/utils/depreciation.ts b/shared/utils/depreciation.ts
new file mode 100644
index 0000000..70f5a49
--- /dev/null
+++ b/shared/utils/depreciation.ts
@@ -0,0 +1,4 @@
+export function calculateAgeDiscount(age: number): number {
+  if (age === 0) return 0;
+  return -(age * 0.02);
+}
diff --git a/shared/utils/mileage.ts b/shared/utils/mileage.ts
new file mode 100644
index 0000000..f7e4f8e
--- /dev/null
+++ b/shared/utils/mileage.ts
@@ -0,0 +1,18 @@
+export function calculateMileageAdjustment(age: number, mileage: number): number {
+  const expected = age * 15000;
+  const diff = mileage - expected;
+
+  if (diff > 0) {
+    return roundPercent(-(Math.floor(diff / 10000) * 0.005));
+  }
+
+  if (diff < 0) {
+    return roundPercent(Math.floor(Math.abs(diff) / 10000) * 0.003);
+  }
+
+  return 0;
+}
+
+function roundPercent(value: number): number {
+  return Math.round(value * 1_000_000) / 1_000_000;
+}
diff --git a/shared/utils/vehicle.ts b/shared/utils/vehicle.ts
new file mode 100644
index 0000000..8040793
--- /dev/null
+++ b/shared/utils/vehicle.ts
@@ -0,0 +1,3 @@
+export function calculateAge(year: number, currentYear = new Date().getFullYear()): number {
+  return Math.max(0, currentYear - year);
+}
diff --git a/test/utils/condition.test.ts b/test/utils/condition.test.ts
new file mode 100644
index 0000000..1120d07
--- /dev/null
+++ b/test/utils/condition.test.ts
@@ -0,0 +1,11 @@
+import { describe, it, expect } from 'vitest';
+import { calculateConditionAdjustment } from '../../shared/utils/condition';
+
+describe('condition', () => {
+  it('returns the correct percentage for each condition', () => {
+    expect(calculateConditionAdjustment('excelente')).toBe(0.03);
+    expect(calculateConditionAdjustment('bom')).toBe(0);
+    expect(calculateConditionAdjustment('regular')).toBe(-0.03);
+    expect(calculateConditionAdjustment('ruim')).toBe(-0.08);
+  });
+});
diff --git a/test/utils/depreciation.test.ts b/test/utils/depreciation.test.ts
new file mode 100644
index 0000000..6ead370
--- /dev/null
+++ b/test/utils/depreciation.test.ts
@@ -0,0 +1,10 @@
+import { describe, it, expect } from 'vitest';
+import { calculateAgeDiscount } from '../../shared/utils/depreciation';
+
+describe('depreciation', () => {
+  it('returns 2% per year as a negative decimal', () => {
+    expect(calculateAgeDiscount(4)).toBe(-0.08);
+    expect(calculateAgeDiscount(1)).toBe(-0.02);
+    expect(calculateAgeDiscount(0)).toBe(0);
+  });
+});
diff --git a/test/utils/mileage.test.ts b/test/utils/mileage.test.ts
new file mode 100644
index 0000000..4e737c4
--- /dev/null
+++ b/test/utils/mileage.test.ts
@@ -0,0 +1,19 @@
+import { describe, it, expect } from 'vitest';
+import { calculateMileageAdjustment } from '../../shared/utils/mileage';
+
+describe('mileage', () => {
+  it('applies a discount of 0.5% per 10.000 km above average', () => {
+    expect(calculateMileageAdjustment(4, 90000)).toBe(-0.015);
+    expect(calculateMileageAdjustment(1, 25000)).toBe(-0.005);
+  });
+
+  it('applies a bonus of 0.3% per 10.000 km below average', () => {
+    expect(calculateMileageAdjustment(4, 30000)).toBe(0.009);
+    expect(calculateMileageAdjustment(1, 5000)).toBe(0.003);
+  });
+
+  it('returns 0 when mileage matches the expected average', () => {
+    expect(calculateMileageAdjustment(4, 60000)).toBe(0);
+    expect(calculateMileageAdjustment(0, 0)).toBe(0);
+  });
+});
diff --git a/test/utils/vehicle.test.ts b/test/utils/vehicle.test.ts
new file mode 100644
index 0000000..b46e00c
--- /dev/null
+++ b/test/utils/vehicle.test.ts
@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest';
+import { calculateAge } from '../../shared/utils/vehicle';
+
+describe('vehicle', () => {
+  it('calculates age with a fixed current year', () => {
+    expect(calculateAge(2022, 2026)).toBe(4);
+    expect(calculateAge(2020, 2026)).toBe(6);
+  });
+
+  it('returns 0 for future years', () => {
+    expect(calculateAge(2030, 2026)).toBe(0);
+  });
+
+  it('returns 0 for the current year', () => {
+    expect(calculateAge(2026, 2026)).toBe(0);
+  });
+});

From c941608691f65fff60e51e68fe8821c890f6cd58 Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Tue, 11 Aug 2026 15:19:10 +0000
Subject: [PATCH 2/7] [autofix.ci] apply automated fixes

---
 shared/utils/depreciation.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/shared/utils/depreciation.ts b/shared/utils/depreciation.ts
index 70f5a49..e53c229 100644
--- a/shared/utils/depreciation.ts
+++ b/shared/utils/depreciation.ts
@@ -1,4 +1,4 @@
 export function calculateAgeDiscount(age: number): number {
-  if (age === 0) return 0;
+  if (age === 0) {return 0;}
   return -(age * 0.02);
 }

From 6ee0e19b37ec4c914ef793d9fa49e9c7fea21aa9 Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 12:55:09 -0300
Subject: [PATCH 3/7] =?UTF-8?q?feat(core):=20Adiciona=20c=C3=A1lculo=20de?=
 =?UTF-8?q?=20avalia=C3=A7=C3=A3o=20veicular=20IBAV?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Cria formulário principal para avaliação de veículos.
Implementa lógica para cálculo de pontos e label do IBAV.
Adiciona testes unitários para a funcionalidade de avaliação.
---
 .prettierignore                  |   5 +-
 README.md                        |  14 ++--
 SECURITY.md                      |   8 +--
 app/app.vue                      | 104 ++++++++++++++++++++++++++++-
 docs/docs.md                     |  50 +++++++-------
 docs/specs/ibav-mvp-tasks.md     |   8 +--
 nuxt.config.ts                   |   5 +-
 package.json                     |   1 +
 pnpm-lock.yaml                   | 110 ++++++++++++++++++++++++++++---
 renovate.json                    |   2 +-
 server/api/hello.ts              |   8 +--
 shared/utils/capitalize.ts       |   4 +-
 shared/utils/depreciation.ts     |   4 +-
 shared/utils/ivb.ts              |  59 +++++++++++++++++
 shared/utils/vehicle-query.ts    |  48 ++++++++++++++
 shared/utils/vjv.ts              |  19 ++++++
 test/app.test.ts                 |  72 +++++++++++++++++---
 test/utils/ivb.test.ts           |  27 ++++++++
 test/utils/vehicle-query.test.ts |  44 +++++++++++++
 test/utils/vjv.test.ts           |  26 ++++++++
 vitest.config.ts                 |   6 ++
 21 files changed, 553 insertions(+), 71 deletions(-)
 create mode 100644 shared/utils/ivb.ts
 create mode 100644 shared/utils/vehicle-query.ts
 create mode 100644 shared/utils/vjv.ts
 create mode 100644 test/utils/ivb.test.ts
 create mode 100644 test/utils/vehicle-query.test.ts
 create mode 100644 test/utils/vjv.test.ts

diff --git a/.prettierignore b/.prettierignore
index 90a8c2f..f4dcda7 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -63,4 +63,7 @@ tmp
 .env.*.local
 
 # Playground
-.playground
\ No newline at end of file
+.playground
+
+# Changelog
+CHANGELOG.md
\ No newline at end of file
diff --git a/README.md b/README.md
index d7766a3..54168d2 100644
--- a/README.md
+++ b/README.md
@@ -8,12 +8,12 @@ O objetivo é oferecer uma referência aberta, auditável e evolutiva para compr
 
 ## Principais recursos
 
-* 🚗 Cálculo do Valor Justo do Veículo (VJV)
-* 📊 Índice de Valor Brasileiro (IVB)
-* 📉 Ajustes por idade, quilometragem e conservação
-* 🔍 Metodologia transparente e documentada
-* 🧮 Cálculos reproduzíveis e auditáveis
-* 🌐 Projeto open source
-* ⚡ Sem dependência de APIs na versão inicial
+- 🚗 Cálculo do Valor Justo do Veículo (VJV)
+- 📊 Índice de Valor Brasileiro (IVB)
+- 📉 Ajustes por idade, quilometragem e conservação
+- 🔍 Metodologia transparente e documentada
+- 🧮 Cálculos reproduzíveis e auditáveis
+- 🌐 Projeto open source
+- ⚡ Sem dependência de APIs na versão inicial
 
 O IBAV não substitui a Tabela FIPE, mas a utiliza como referência inicial para gerar uma avaliação mais personalizada e transparente.
diff --git a/SECURITY.md b/SECURITY.md
index 69c3c38..3e5b074 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -3,8 +3,8 @@
 ## Versões Suportadas
 
 | Versão | Suportada |
-|---------|-----------|
-| 0.1.x   | ✅        |
+| ------ | --------- |
+| 0.1.x  | ✅        |
 
 ## Relatando uma Vulnerabilidade
 
@@ -14,7 +14,7 @@ Em vez disso, relate-a privadamente por:
 
 - Abrindo um GitHub Security Advisory
 
-[//]: # (- Ou contatando: security@yourdomain.com)
+[//]: # '- Ou contatando: security@yourdomain.com'
 
 Responderemos dentro de 48 horas.
 
@@ -79,4 +79,4 @@ Seguimos práticas de divulgação responsável:
 2. **Avaliação**: A equipe de segurança avalia o relato dentro de 48 horas
 3. **Remediação**: Correções são desenvolvidas e testadas
 4. **Divulgação coordenada**: A divulgação pública é coordenada com o relator
-5. **Crédito**: Pesquisadores de segurança são creditados por suas contribuições (se desejado)
\ No newline at end of file
+5. **Crédito**: Pesquisadores de segurança são creditados por suas contribuições (se desejado)
diff --git a/app/app.vue b/app/app.vue
index 09f935b..88b60f9 100644
--- a/app/app.vue
+++ b/app/app.vue
@@ -1,6 +1,104 @@
 <template>
-  <div>
-    <NuxtRouteAnnouncer />
-    <NuxtWelcome />
+  <div class="min-h-screen bg-gray-50 p-6">
+    <div class="mx-auto max-w-xl space-y-6">
+      <h1 class="text-2xl font-bold">IBAV - Avaliação Veicular</h1>
+
+      <div class="space-y-4">
+        <div>
+          <label for="fipe" class="block text-sm font-medium">Valor FIPE</label>
+          <UInput id="fipe" v-model.number="form.fipeValue" type="number" min="0" step="1000" />
+        </div>
+
+        <div>
+          <label for="year" class="block text-sm font-medium">Ano</label>
+          <UInput id="year" v-model.number="form.year" type="number" />
+        </div>
+
+        <div>
+          <label for="mileage" class="block text-sm font-medium">Quilometragem</label>
+          <UInput id="mileage" v-model.number="form.mileage" type="number" min="0" />
+        </div>
+
+        <div>
+          <label for="condition" class="block text-sm font-medium">Conservação</label>
+          <USelect id="condition" v-model="form.condition" :options="conditionOptions" />
+        </div>
+      </div>
+
+      <div v-if="result" data-testid="result" class="rounded-lg bg-white p-4 shadow">
+        <p>Valor FIPE: {{ formatMoney(form.fipeValue) }}</p>
+        <p>Valor Justo: {{ formatMoney(result.vjv) }}</p>
+        <p>IVB: {{ result.ivb.points }} pontos ({{ result.ivb.label }})</p>
+      </div>
+    </div>
   </div>
 </template>
+
+<script setup lang="ts">
+import { ref, computed, watch } from 'vue';
+import { useRoute, useRouter } from 'vue-router';
+import type { VehicleCondition, VehicleInputs } from '#shared/types/valuation';
+import { calculateVjv } from '#shared/utils/vjv';
+import { calculateIvb } from '#shared/utils/ivb';
+import { parseVehicleQuery, buildVehicleQuery } from '#shared/utils/vehicle-query';
+
+const currentYear = new Date().getFullYear();
+const route = useRoute();
+const router = useRouter();
+
+const query = parseVehicleQuery(route.query);
+const form = ref<VehicleInputs>({
+  fipeValue: query.fipeValue ?? 0,
+  year: query.year ?? currentYear,
+  mileage: query.mileage ?? 0,
+  condition: query.condition ?? 'bom',
+});
+
+watch(
+  () => form.value,
+  () => {
+    if (typeof window === 'undefined') {
+      return;
+    }
+    if (isValid.value) {
+      router.replace({ query: buildVehicleQuery(form.value) });
+    }
+  },
+  { deep: true }
+);
+
+const conditionOptions = [
+  { label: 'Excelente', value: 'excelente' as VehicleCondition },
+  { label: 'Bom', value: 'bom' as VehicleCondition },
+  { label: 'Regular', value: 'regular' as VehicleCondition },
+  { label: 'Ruim', value: 'ruim' as VehicleCondition },
+];
+
+const isValid = computed(() => {
+  return (
+    form.value.fipeValue > 0 &&
+    form.value.year > 1900 &&
+    form.value.year <= currentYear &&
+    form.value.mileage >= 0
+  );
+});
+
+const result = computed(() => {
+  if (!isValid.value) {
+    return null;
+  }
+  return {
+    vjv: calculateVjv(form.value),
+    ivb: calculateIvb(form.value),
+  };
+});
+
+const currencyFormatter = new Intl.NumberFormat('pt-BR', {
+  style: 'currency',
+  currency: 'BRL',
+});
+
+function formatMoney(value: number): string {
+  return currencyFormatter.format(value);
+}
+</script>
diff --git a/docs/docs.md b/docs/docs.md
index 63a0103..1e40c8d 100644
--- a/docs/docs.md
+++ b/docs/docs.md
@@ -75,12 +75,12 @@ Sistema calcula:
 
 # Campos de Entrada
 
-| Campo | Tipo |
-|--------|------|
-| Valor FIPE | Número |
-| Ano | Número |
+| Campo         | Tipo   |
+| ------------- | ------ |
+| Valor FIPE    | Número |
+| Ano           | Número |
 | Quilometragem | Número |
-| Conservação | Select |
+| Conservação   | Select |
 
 ---
 
@@ -169,12 +169,12 @@ Acréscimo de:
 
 ## 3. Conservação
 
-| Estado | Ajuste |
-|---------|--------:|
-| Excelente | +3% |
-| Bom | 0% |
-| Regular | -3% |
-| Ruim | -8% |
+| Estado    | Ajuste |
+| --------- | -----: |
+| Excelente |    +3% |
+| Bom       |     0% |
+| Regular   |    -3% |
+| Ruim      |    -8% |
 
 ---
 
@@ -312,24 +312,24 @@ a cada 10.000 km acima da média
 
 ## Conservação
 
-| Estado | Pontos |
-|---------|--------:|
-| Excelente | +30 |
-| Bom | 0 |
-| Regular | -30 |
-| Ruim | -80 |
+| Estado    | Pontos |
+| --------- | -----: |
+| Excelente |    +30 |
+| Bom       |      0 |
+| Regular   |    -30 |
+| Ruim      |    -80 |
 
 ---
 
 # Classificação
 
-| Pontos | Classificação |
-|---------|---------------|
-| 900–1000 | Excelente |
-| 800–899 | Muito Bom |
-| 700–799 | Bom |
-| 600–699 | Regular |
-| abaixo de 600 | Atenção |
+| Pontos        | Classificação |
+| ------------- | ------------- |
+| 900–1000      | Excelente     |
+| 800–899       | Muito Bom     |
+| 700–799       | Bom           |
+| 600–699       | Regular       |
+| abaixo de 600 | Atenção       |
 
 ---
 
@@ -420,4 +420,4 @@ O objetivo do IBAV é oferecer uma estimativa transparente do Valor Justo do Ve
 
 # Licença
 
-A metodologia do IBAV deverá ser pública, documentada e versionada para garantir transparência, auditabilidade e evolução contínua.
\ No newline at end of file
+A metodologia do IBAV deverá ser pública, documentada e versionada para garantir transparência, auditabilidade e evolução contínua.
diff --git a/docs/specs/ibav-mvp-tasks.md b/docs/specs/ibav-mvp-tasks.md
index 2f2e218..1a631c4 100644
--- a/docs/specs/ibav-mvp-tasks.md
+++ b/docs/specs/ibav-mvp-tasks.md
@@ -69,7 +69,7 @@ Criar as funções puras de cálculo de idade, desvalorização, ajuste por km e
 
 ---
 
-## Task 3 — Implementar VJV e IVB
+## Task 3 — ✅ Implementar VJV e IVB
 
 ### Goal
 
@@ -101,7 +101,7 @@ Compor os utilitários base para calcular o Valor Justo do Veículo e o Índice
 
 ---
 
-## Task 4 — Criar página com formulário e exibição de resultados
+## Task 4 — ✅ Criar página com formulário e exibição de resultados
 
 ### Goal
 
@@ -136,7 +136,7 @@ Construir a interface do usuário com Nuxt UI, formulário e painel de resultado
 
 ---
 
-## Task 5 — Sincronizar formulário com query params para compartilhamento
+## Task 5 — ✅ Sincronizar formulário com query params para compartilhamento
 
 ### Goal
 
@@ -168,7 +168,7 @@ Permitir que o usuário copie e compartilhe uma URL que carregue o mesmo cálcul
 
 ---
 
-## Task 6 — Integração final e verificação
+## Task 6 — ✅ Integração final e verificação
 
 ### Goal
 
diff --git a/nuxt.config.ts b/nuxt.config.ts
index b6baa24..15685a2 100644
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -1,5 +1,6 @@
 // https://nuxt.com/docs/api/configuration/nuxt-config
 export default defineNuxtConfig({
   compatibilityDate: '2025-07-15',
-  devtools: { enabled: true }
-})
+  devtools: { enabled: true },
+  modules: ['@nuxt/ui'],
+});
diff --git a/package.json b/package.json
index 60b293b..6c927e7 100644
--- a/package.json
+++ b/package.json
@@ -47,6 +47,7 @@
     "@nuxt/eslint-config": "^1.16.0",
     "@nuxt/test-utils": "^4.1.0",
     "@vitejs/plugin-vue": "^6.0.8",
+    "@vitest/coverage-v8": "^4.1.10",
     "@vue/test-utils": "^2.4.11",
     "changelogen": "^0.6.2",
     "eslint": "^10.8.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7742b3e..da0660a 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -44,10 +44,13 @@ importers:
         version: 1.16.0(@typescript-eslint/utils@8.65.0(eslint@10.8.0(jiti@2.7.0)(supports-color@10.2.2))(supports-color@10.2.2)(typescript@6.0.3))(@vue/compiler-sfc@3.5.40)(eslint@10.8.0(jiti@2.7.0)(supports-color@10.2.2))(supports-color@10.2.2)(typescript@6.0.3)
       '@nuxt/test-utils':
         specifier: ^4.1.0
-        version: 4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)))
+        version: 4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10)
       '@vitejs/plugin-vue':
         specifier: ^6.0.8
         version: 6.0.8(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vue@3.5.40(typescript@6.0.3))
+      '@vitest/coverage-v8':
+        specifier: ^4.1.10
+        version: 4.1.10(vitest@4.1.10)
       '@vue/test-utils':
         specifier: ^2.4.11
         version: 2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3))
@@ -68,7 +71,7 @@ importers:
         version: 6.0.3
       vitest:
         specifier: ^4.1.10
-        version: 4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
+        version: 4.1.10(@vitest/coverage-v8@4.1.10)(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
 
 packages:
 
@@ -226,6 +229,10 @@ packages:
     resolution: {integrity: sha512-eY+Yn3dCqTGmyiq2QRU66lA5FL8lqqqvecHt0fF3uHONIa7ToYsaCiWV8lOKqAs0Rb2SjixiKFROngnulPtt2g==}
     engines: {node: ^22.18.0 || >=24.11.0}
 
+  '@bcoe/v8-coverage@1.0.2':
+    resolution: {integrity: sha512-6zABk/ECA/QYSCQ1NGiVwwbQerUCZ+TQbp64Q3AgmfNvurHH0j8TtXa1qbShXA6qqkpAj4V5W8pP6mLe1mcMqA==}
+    engines: {node: '>=18'}
+
   '@bomb.sh/tab@0.0.19':
     resolution: {integrity: sha512-dTRfo9Q9B+lbLG3JCu8a/AGQSfD2XXcFcnakQzVjSOX+VvR/s9zpsH8TlqV3iHqazniRn1Ypwd1hcRlXcu/4BA==}
     hasBin: true
@@ -2664,6 +2671,15 @@ packages:
       vite: ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
       vue: ^3.2.25
 
+  '@vitest/coverage-v8@4.1.10':
+    resolution: {integrity: sha512-IM49HmthevbgAO4anp1hwtoT9wYe59w0LR00gr+eagHE+ZJ5lK4sLPeO0ubgoJcwLk6dehU3R24N+FbEEKDc8g==}
+    peerDependencies:
+      '@vitest/browser': 4.1.10
+      vitest: 4.1.10
+    peerDependenciesMeta:
+      '@vitest/browser':
+        optional: true
+
   '@vitest/expect@4.1.10':
     resolution: {integrity: sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==}
 
@@ -2936,6 +2952,9 @@ packages:
     resolution: {integrity: sha512-m1Q/RaVOnTp9JxPX+F+Zn7IcLYMzM8kZofDImfsKZd8MbR+ikdOzTeztStWqfrqIxZnYWryyI9ePm3NGjnZgGw==}
     engines: {node: '>=20.19.0'}
 
+  ast-v8-to-istanbul@1.0.5:
+    resolution: {integrity: sha512-UPAgKJFSEGMWSDr3LX4tqnAb4f7KGT8O40Tyx8wbYmmZ/yn58lNCm8h3svs3eXgiGd5AXxz8NDOvXWvicq+rJA==}
+
   ast-walker-scope@0.9.0:
     resolution: {integrity: sha512-IJdzo2vLiElBxKzwS36VsCue/62d6IdWjnPB2v3nuPKeWGynp6FF/CYoLa5i/3jXH/z97ZDdsXz6abpgM6w07A==}
     engines: {node: '>=20.19.0'}
@@ -4010,6 +4029,10 @@ packages:
       crossws:
         optional: true
 
+  has-flag@4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+
   has-property-descriptors@1.0.2:
     resolution: {integrity: sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==}
 
@@ -4095,6 +4118,9 @@ packages:
   html-entities@2.6.0:
     resolution: {integrity: sha512-kig+rMn/QOVRvr7c86gQ8lWXq+Hkv6CbAH1hLu+RG338StTpE8Z0b44SDVaqVu7HGKf27frdmUYEs9hTUX/cLQ==}
 
+  html-escaper@2.0.2:
+    resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==}
+
   html-void-elements@3.0.0:
     resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==}
 
@@ -4307,6 +4333,18 @@ packages:
   isomorphic.js@0.2.5:
     resolution: {integrity: sha512-PIeMbHqMt4DnUP3MA/Flc0HElYjMXArsw1qwJZcm9sqR8mq3l8NYizFMty0pWwE/tzIGH3EKK5+jes5mAr85yw==}
 
+  istanbul-lib-coverage@3.2.2:
+    resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==}
+    engines: {node: '>=8'}
+
+  istanbul-lib-report@3.0.1:
+    resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==}
+    engines: {node: '>=10'}
+
+  istanbul-reports@3.2.0:
+    resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==}
+    engines: {node: '>=8'}
+
   jackspeak@3.4.3:
     resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==}
 
@@ -4615,6 +4653,10 @@ packages:
   magicast@0.5.3:
     resolution: {integrity: sha512-pVKE4UdSQ7DvHzivsCIFx2BJn1mHG6KsyrFcaxFx6tONdneEuThrDx0Cj3AMg58KyN4pzYT+LHOotxDQDjNvkw==}
 
+  make-dir@4.0.0:
+    resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==}
+    engines: {node: '>=10'}
+
   markdown-table@3.0.4:
     resolution: {integrity: sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==}
 
@@ -5877,6 +5919,10 @@ packages:
     resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
     engines: {node: '>=18'}
 
+  supports-color@7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+
   supports-preserve-symlinks-flag@1.0.0:
     resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
     engines: {node: '>= 0.4'}
@@ -6922,6 +6968,8 @@ snapshots:
       '@babel/helper-string-parser': 8.0.0
       '@babel/helper-validator-identifier': 8.0.4
 
+  '@bcoe/v8-coverage@1.0.2': {}
+
   '@bomb.sh/tab@0.0.19(cac@7.0.0)(citty@0.2.2)':
     optionalDependencies:
       cac: 7.0.0
@@ -8164,7 +8212,7 @@ snapshots:
       rc9: 3.0.1
       std-env: 4.2.0
 
-  '@nuxt/test-utils@4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)))':
+  '@nuxt/test-utils@4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10)':
     dependencies:
       '@clack/prompts': 1.7.0
       '@nuxt/devtools-kit': 2.7.0(magicast@0.5.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
@@ -8192,12 +8240,12 @@ snapshots:
       tinyexec: 1.2.4
       ufo: 1.6.4
       unplugin: 3.3.0(esbuild@0.28.1)(rolldown@1.2.1)(rollup@4.62.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
-      vitest-environment-nuxt: 2.0.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)))
+      vitest-environment-nuxt: 2.0.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10)
       vue: 3.5.40(typescript@6.0.3)
     optionalDependencies:
       '@vue/test-utils': 2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3))
       jsdom: 26.1.0(supports-color@10.2.2)
-      vitest: 4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
+      vitest: 4.1.10(@vitest/coverage-v8@4.1.10)(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
     transitivePeerDependencies:
       - '@farmfe/core'
       - '@rspack/core'
@@ -9580,6 +9628,20 @@ snapshots:
       vite: 8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)
       vue: 3.5.40(typescript@6.0.3)
 
+  '@vitest/coverage-v8@4.1.10(vitest@4.1.10)':
+    dependencies:
+      '@bcoe/v8-coverage': 1.0.2
+      '@vitest/utils': 4.1.10
+      ast-v8-to-istanbul: 1.0.5
+      istanbul-lib-coverage: 3.2.2
+      istanbul-lib-report: 3.0.1
+      istanbul-reports: 3.2.0
+      magicast: 0.5.3
+      obug: 2.1.4
+      std-env: 4.2.0
+      tinyrainbow: 3.1.1
+      vitest: 4.1.10(@vitest/coverage-v8@4.1.10)(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
+
   '@vitest/expect@4.1.10':
     dependencies:
       '@standard-schema/spec': 1.1.0
@@ -9892,6 +9954,12 @@ snapshots:
       '@babel/parser': 7.29.7
       pathe: 2.0.3
 
+  ast-v8-to-istanbul@1.0.5:
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.31
+      estree-walker: 3.0.3
+      js-tokens: 10.0.0
+
   ast-walker-scope@0.9.0:
     dependencies:
       '@babel/parser': 7.29.7
@@ -11028,6 +11096,8 @@ snapshots:
     optionalDependencies:
       crossws: 0.4.10(srvx@0.11.22)
 
+  has-flag@4.0.0: {}
+
   has-property-descriptors@1.0.2:
     dependencies:
       es-define-property: 1.0.1
@@ -11196,6 +11266,8 @@ snapshots:
 
   html-entities@2.6.0: {}
 
+  html-escaper@2.0.2: {}
+
   html-void-elements@3.0.0: {}
 
   html-whitespace-sensitive-tag-names@3.0.1: {}
@@ -11394,6 +11466,19 @@ snapshots:
 
   isomorphic.js@0.2.5: {}
 
+  istanbul-lib-coverage@3.2.2: {}
+
+  istanbul-lib-report@3.0.1:
+    dependencies:
+      istanbul-lib-coverage: 3.2.2
+      make-dir: 4.0.0
+      supports-color: 7.2.0
+
+  istanbul-reports@3.2.0:
+    dependencies:
+      html-escaper: 2.0.2
+      istanbul-lib-report: 3.0.1
+
   jackspeak@3.4.3:
     dependencies:
       '@isaacs/cliui': 8.0.2
@@ -11688,6 +11773,10 @@ snapshots:
       '@babel/types': 7.29.7
       source-map-js: 1.2.1
 
+  make-dir@4.0.0:
+    dependencies:
+      semver: 7.8.5
+
   markdown-table@3.0.4: {}
 
   marked@17.0.6: {}
@@ -13651,6 +13740,10 @@ snapshots:
 
   supports-color@10.2.2: {}
 
+  supports-color@7.2.0:
+    dependencies:
+      has-flag: 4.0.0
+
   supports-preserve-symlinks-flag@1.0.0: {}
 
   svgo@4.0.2:
@@ -14214,9 +14307,9 @@ snapshots:
       terser: 5.49.0
       yaml: 2.9.0
 
-  vitest-environment-nuxt@2.0.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))):
+  vitest-environment-nuxt@2.0.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10):
     dependencies:
-      '@nuxt/test-utils': 4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)))
+      '@nuxt/test-utils': 4.1.0(@vue/test-utils@2.4.11(@vue/compiler-dom@3.5.40)(@vue/server-renderer@3.5.40)(vue@3.5.40(typescript@6.0.3)))(esbuild@0.28.1)(jsdom@26.1.0(supports-color@10.2.2))(magicast@0.5.3)(rolldown@1.2.1)(rollup@4.62.3)(typescript@6.0.3)(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))(vitest@4.1.10)
     transitivePeerDependencies:
       - '@cucumber/cucumber'
       - '@farmfe/core'
@@ -14241,7 +14334,7 @@ snapshots:
       - vitest
       - webpack
 
-  vitest@4.1.10(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)):
+  vitest@4.1.10(@vitest/coverage-v8@4.1.10)(jsdom@26.1.0(supports-color@10.2.2))(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)):
     dependencies:
       '@vitest/expect': 4.1.10
       '@vitest/mocker': 4.1.10(vite@8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0))
@@ -14264,6 +14357,7 @@ snapshots:
       vite: 8.1.5(esbuild@0.28.1)(jiti@2.7.0)(terser@5.49.0)(yaml@2.9.0)
       why-is-node-running: 2.3.0
     optionalDependencies:
+      '@vitest/coverage-v8': 4.1.10(vitest@4.1.10)
       jsdom: 26.1.0(supports-color@10.2.2)
     transitivePeerDependencies:
       - msw
diff --git a/renovate.json b/renovate.json
index 5da0405..af5563e 100644
--- a/renovate.json
+++ b/renovate.json
@@ -5,4 +5,4 @@
     "enabled": true
   },
   "postUpdateOptions": ["pnpmDedupe"]
-}
\ No newline at end of file
+}
diff --git a/server/api/hello.ts b/server/api/hello.ts
index 843e358..f51cedc 100644
--- a/server/api/hello.ts
+++ b/server/api/hello.ts
@@ -1,5 +1,5 @@
 export default defineEventHandler((event) => {
-    return {
-        hello: 'world',
-    }
-})
\ No newline at end of file
+  return {
+    hello: 'world',
+  };
+});
diff --git a/shared/utils/capitalize.ts b/shared/utils/capitalize.ts
index 11f613d..9d3145d 100644
--- a/shared/utils/capitalize.ts
+++ b/shared/utils/capitalize.ts
@@ -1,3 +1,3 @@
 export const capitalize = (input: string) => {
-    return input[0] ? input[0].toUpperCase() + input.slice(1) : ''
-}
\ No newline at end of file
+  return input[0] ? input[0].toUpperCase() + input.slice(1) : '';
+};
diff --git a/shared/utils/depreciation.ts b/shared/utils/depreciation.ts
index 70f5a49..10dcf7f 100644
--- a/shared/utils/depreciation.ts
+++ b/shared/utils/depreciation.ts
@@ -1,4 +1,6 @@
 export function calculateAgeDiscount(age: number): number {
-  if (age === 0) return 0;
+  if (age === 0) {
+    return 0;
+  }
   return -(age * 0.02);
 }
diff --git a/shared/utils/ivb.ts b/shared/utils/ivb.ts
new file mode 100644
index 0000000..b35dc35
--- /dev/null
+++ b/shared/utils/ivb.ts
@@ -0,0 +1,59 @@
+import { calculateAge } from './vehicle';
+import type { VehicleCondition, VehicleInputs } from '../types/valuation';
+
+export function calculateIvb(
+  inputs: VehicleInputs,
+  currentYear = new Date().getFullYear()
+): { points: number; label: string } {
+  const age = calculateAge(inputs.year, currentYear);
+  const agePoints = age * -15;
+  const mileagePoints = calculateMileagePoints(inputs.mileage, age);
+  const conditionPoints = getConditionPoints(inputs.condition);
+
+  const points = 1000 + agePoints + mileagePoints + conditionPoints;
+  const label = getIvbLabel(points);
+
+  return { points, label };
+}
+
+function calculateMileagePoints(mileage: number, age: number): number {
+  const expected = age * 15000;
+  const diff = mileage - expected;
+
+  if (diff > 0) {
+    return -(Math.floor(diff / 10000) * 10);
+  }
+
+  return 0;
+}
+
+function getConditionPoints(condition: VehicleCondition): number {
+  switch (condition) {
+    case 'excelente':
+      return 30;
+    case 'bom':
+      return 0;
+    case 'regular':
+      return -30;
+    case 'ruim':
+      return -80;
+    default:
+      return 0;
+  }
+}
+
+function getIvbLabel(points: number): string {
+  if (points >= 900) {
+    return 'Excelente';
+  }
+  if (points >= 800) {
+    return 'Muito Bom';
+  }
+  if (points >= 700) {
+    return 'Bom';
+  }
+  if (points >= 600) {
+    return 'Regular';
+  }
+  return 'Atenção';
+}
diff --git a/shared/utils/vehicle-query.ts b/shared/utils/vehicle-query.ts
new file mode 100644
index 0000000..028a946
--- /dev/null
+++ b/shared/utils/vehicle-query.ts
@@ -0,0 +1,48 @@
+import type { VehicleCondition, VehicleInputs } from '#shared/types/valuation';
+
+const VALID_CONDITIONS: VehicleCondition[] = ['excelente', 'bom', 'regular', 'ruim'];
+
+export function parseVehicleQuery(
+  query: Record<string, string | string[]>
+): Partial<VehicleInputs> {
+  const parsed: Partial<VehicleInputs> = {};
+
+  if (typeof query.fipe === 'string') {
+    const value = Number.parseFloat(query.fipe);
+    if (!Number.isNaN(value)) {
+      parsed.fipeValue = value;
+    }
+  }
+
+  if (typeof query.year === 'string') {
+    const value = Number.parseInt(query.year, 10);
+    if (!Number.isNaN(value)) {
+      parsed.year = value;
+    }
+  }
+
+  if (typeof query.km === 'string') {
+    const value = Number.parseInt(query.km, 10);
+    if (!Number.isNaN(value)) {
+      parsed.mileage = value;
+    }
+  }
+
+  if (
+    typeof query.condition === 'string' &&
+    VALID_CONDITIONS.includes(query.condition as VehicleCondition)
+  ) {
+    parsed.condition = query.condition as VehicleCondition;
+  }
+
+  return parsed;
+}
+
+export function buildVehicleQuery(inputs: VehicleInputs): Record<string, string> {
+  return {
+    fipe: String(inputs.fipeValue),
+    year: String(inputs.year),
+    km: String(inputs.mileage),
+    condition: inputs.condition,
+  };
+}
diff --git a/shared/utils/vjv.ts b/shared/utils/vjv.ts
new file mode 100644
index 0000000..8414d60
--- /dev/null
+++ b/shared/utils/vjv.ts
@@ -0,0 +1,19 @@
+import { calculateAge } from './vehicle';
+import { calculateAgeDiscount } from './depreciation';
+import { calculateMileageAdjustment } from './mileage';
+import { calculateConditionAdjustment } from './condition';
+import type { VehicleInputs } from '../types/valuation';
+
+export function calculateVjv(
+  inputs: VehicleInputs,
+  currentYear = new Date().getFullYear()
+): number {
+  const age = calculateAge(inputs.year, currentYear);
+  const ageAdjustment = calculateAgeDiscount(age);
+  const mileageAdjustment = calculateMileageAdjustment(age, inputs.mileage);
+  const conditionAdjustment = calculateConditionAdjustment(inputs.condition);
+
+  const vjv = inputs.fipeValue * (1 + ageAdjustment + mileageAdjustment + conditionAdjustment);
+
+  return Math.round(vjv * 100) / 100;
+}
diff --git a/test/app.test.ts b/test/app.test.ts
index 560b644..8defee7 100644
--- a/test/app.test.ts
+++ b/test/app.test.ts
@@ -1,31 +1,85 @@
-import { describe, it, expect } from 'vitest';
+import { describe, it, expect, vi } from 'vitest';
 import { mount } from '@vue/test-utils';
+import { nextTick } from 'vue';
+import { useRoute, useRouter } from 'vue-router';
 import App from '../app/app.vue';
 
+vi.mock('vue-router');
+
+const useRouteMock = vi.mocked(useRoute);
+const useRouterMock = vi.mocked(useRouter);
+
 describe('App.vue', () => {
   it('renders the component', () => {
+    useRouteMock.mockReturnValue({ query: {} } as any);
+    useRouterMock.mockReturnValue({ replace: vi.fn() } as any);
+
     const wrapper = mount(App, {
       global: {
         stubs: {
-          NuxtRouteAnnouncer: true,
-          NuxtWelcome: true,
+          UInput: true,
+          USelect: true,
         },
       },
     });
-    
+
     expect(wrapper.exists()).toBe(true);
   });
 
-  it('contains a div element', () => {
+  it('shows the result after valid input', async () => {
+    useRouteMock.mockReturnValue({ query: {} } as any);
+    useRouterMock.mockReturnValue({ replace: vi.fn() } as any);
+
+    const wrapper = mount(App, {
+      global: {
+        stubs: {
+          UInput: true,
+          USelect: true,
+        },
+      },
+    });
+
+    wrapper.vm.form = {
+      fipeValue: 80000,
+      year: 2022,
+      mileage: 90000,
+      condition: 'excelente',
+    };
+
+    await nextTick();
+
+    const text = wrapper.text().replace(/\s+/g, ' ');
+
+    expect(text).toContain('R$ 74.800,00');
+    expect(text).toContain('940 pontos');
+    expect(text).toContain('Excelente');
+  });
+
+  it('loads state from query params', async () => {
+    useRouteMock.mockReturnValue({
+      query: {
+        fipe: '80000',
+        year: '2022',
+        km: '90000',
+        condition: 'excelente',
+      },
+    } as any);
+    useRouterMock.mockReturnValue({ replace: vi.fn() } as any);
+
     const wrapper = mount(App, {
       global: {
         stubs: {
-          NuxtRouteAnnouncer: true,
-          NuxtWelcome: true,
+          UInput: true,
+          USelect: true,
         },
       },
     });
-    
-    expect(wrapper.find('div').exists()).toBe(true);
+
+    await nextTick();
+
+    const text = wrapper.text().replace(/\s+/g, ' ');
+
+    expect(text).toContain('R$ 74.800,00');
+    expect(text).toContain('940 pontos');
   });
 });
diff --git a/test/utils/ivb.test.ts b/test/utils/ivb.test.ts
new file mode 100644
index 0000000..0b402ff
--- /dev/null
+++ b/test/utils/ivb.test.ts
@@ -0,0 +1,27 @@
+import { describe, it, expect } from 'vitest';
+import { calculateIvb } from '../../shared/utils/ivb';
+
+describe('ivb', () => {
+  it('returns the correct IVB for the docs example', () => {
+    const inputs = {
+      fipeValue: 80000,
+      year: 2022,
+      mileage: 90000,
+      condition: 'excelente' as const,
+    };
+
+    const result = calculateIvb(inputs, 2026);
+
+    expect(result.points).toBe(940);
+    expect(result.label).toBe('Excelente');
+  });
+
+  it('classifies each condition correctly', () => {
+    const base = { fipeValue: 80000, year: 2022, mileage: 90000 };
+
+    expect(calculateIvb({ ...base, condition: 'bom' }, 2026).points).toBe(910);
+    expect(calculateIvb({ ...base, condition: 'regular' }, 2026).points).toBe(880);
+    expect(calculateIvb({ ...base, condition: 'ruim' }, 2026).points).toBe(830);
+    expect(calculateIvb({ ...base, condition: 'ruim' }, 2026).label).toBe('Muito Bom');
+  });
+});
diff --git a/test/utils/vehicle-query.test.ts b/test/utils/vehicle-query.test.ts
new file mode 100644
index 0000000..4378e1c
--- /dev/null
+++ b/test/utils/vehicle-query.test.ts
@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { parseVehicleQuery, buildVehicleQuery } from '../../shared/utils/vehicle-query';
+
+describe('vehicle-query', () => {
+  it('parses query strings into VehicleInputs', () => {
+    expect(
+      parseVehicleQuery({
+        fipe: '80000',
+        year: '2022',
+        km: '90000',
+        condition: 'excelente',
+      })
+    ).toEqual({
+      fipeValue: 80000,
+      year: 2022,
+      mileage: 90000,
+      condition: 'excelente',
+    });
+  });
+
+  it('ignores unknown condition values', () => {
+    expect(parseVehicleQuery({ condition: 'invalid' }).condition).toBeUndefined();
+  });
+
+  it('ignores invalid numbers', () => {
+    expect(parseVehicleQuery({ fipe: 'abc' }).fipeValue).toBeUndefined();
+  });
+
+  it('builds query from inputs', () => {
+    expect(
+      buildVehicleQuery({
+        fipeValue: 80000,
+        year: 2022,
+        mileage: 90000,
+        condition: 'excelente',
+      })
+    ).toEqual({
+      fipe: '80000',
+      year: '2022',
+      km: '90000',
+      condition: 'excelente',
+    });
+  });
+});
diff --git a/test/utils/vjv.test.ts b/test/utils/vjv.test.ts
new file mode 100644
index 0000000..f53c884
--- /dev/null
+++ b/test/utils/vjv.test.ts
@@ -0,0 +1,26 @@
+import { describe, it, expect } from 'vitest';
+import { calculateVjv } from '../../shared/utils/vjv';
+
+describe('vjv', () => {
+  it('returns the correct VJV for the docs example', () => {
+    const inputs = {
+      fipeValue: 80000,
+      year: 2022,
+      mileage: 90000,
+      condition: 'excelente' as const,
+    };
+
+    expect(calculateVjv(inputs, 2026)).toBe(74800);
+  });
+
+  it('returns the FIPE value when there are no adjustments', () => {
+    const inputs = {
+      fipeValue: 50000,
+      year: 2026,
+      mileage: 0,
+      condition: 'bom' as const,
+    };
+
+    expect(calculateVjv(inputs, 2026)).toBe(50000);
+  });
+});
diff --git a/vitest.config.ts b/vitest.config.ts
index 575f762..414e7a2 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -1,8 +1,14 @@
+import { fileURLToPath } from 'node:url';
 import { defineConfig } from 'vitest/config';
 import vue from '@vitejs/plugin-vue';
 
 export default defineConfig({
   plugins: [vue()],
+  resolve: {
+    alias: {
+      '#shared': fileURLToPath(new URL('./shared', import.meta.url)),
+    },
+  },
   test: {
     environment: 'jsdom',
     include: ['test/**/*.{test,spec}.{js,ts}'],

From bbe4f6df1894c8788bb41ecfb609d25fc3e300b9 Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 12:56:57 -0300
Subject: [PATCH 4/7] feat(core): Adiciona .github ao .prettierignore

---
 .prettierignore | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.prettierignore b/.prettierignore
index f4dcda7..262c724 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -66,4 +66,7 @@ tmp
 .playground
 
 # Changelog
-CHANGELOG.md
\ No newline at end of file
+CHANGELOG.md
+
+# GitHub
+.github

From 11d1b6e4ca9e8e8030a119c63c52688ba275c513 Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 12:57:32 -0300
Subject: [PATCH 5/7] =?UTF-8?q?docs(core):=20Formata=20documentos=20de=20g?=
 =?UTF-8?q?overnan=C3=A7a=20e=20contribui=C3=A7=C3=A3o?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CONTRIBUTING.md | 17 ++++++++++-------
 GOVERNANCE.md   |  9 ++++++++-
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 66fc1ee..a3fa2bd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -68,11 +68,13 @@ Clone o repositório:
 git clone https://github.com/4sllan/ibav.git
 cd ibav
 ```
+
 Instale as dependências:
 
 ```bash
 pnpm install
 ```
+
 Execute o ambiente de desenvolvimento:
 
 ```bash
@@ -93,16 +95,17 @@ Exemplo:
 git checkout -b feat/minha-funcionalidade
 ```
 
-| Tipo     | Exemplo                          |
-| -------- | -------------------------------- |
-| Feature  | `feat/add-ivb-calculation`       |
-| Fix      | `fix/mileage-adjustment`         |
-| Docs     | `docs/update-methodology`        |
-| Refactor | `refactor/vjh-formula`           |
+| Tipo     | Exemplo                    |
+| -------- | -------------------------- |
+| Feature  | `feat/add-ivb-calculation` |
+| Fix      | `fix/mileage-adjustment`   |
+| Docs     | `docs/update-methodology`  |
+| Refactor | `refactor/vjh-formula`     |
 
 ## ✍️ Diretrizes de Commit
 
 Seguimos Conventional Commits:
+
 ```text
 tipo(escopo): descrição
 ```
@@ -163,4 +166,4 @@ Obrigado por ajudar a melhorar o IBAV!
 
 - [Documentação do Projeto](docs/docs.md) - Metodologia completa e especificações
 - [Roadmap](docs/docs.md#roadmap) - Funcionalidades planejadas e versões futuras
-- [Metodologia](docs/docs.md#metodologia) - Fórmulas de cálculo VJV e IVB
\ No newline at end of file
+- [Metodologia](docs/docs.md#metodologia) - Fórmulas de cálculo VJV e IVB
diff --git a/GOVERNANCE.md b/GOVERNANCE.md
index f400816..5e58fb2 100644
--- a/GOVERNANCE.md
+++ b/GOVERNANCE.md
@@ -25,6 +25,7 @@ O IBAV é um projeto open source que visa calcular o **Valor Justo do Veículo (
 ### Transparência
 
 A metodologia do IBAV é pública, documentada e versionada para garantir:
+
 - Auditabilidade dos cálculos
 - Evolução contínua e colaborativa
 - Confiança dos usuários
@@ -56,6 +57,7 @@ O sistema considera quatro fatores principais:
 ### Índice de Valor Brasileiro (IVB)
 
 Pontuação de 0 a 1000 pontos que classifica o veículo:
+
 - 900–1000: Excelente
 - 800–899: Muito Bom
 - 700–799: Bom
@@ -69,6 +71,7 @@ Pontuação de 0 a 1000 pontos que classifica o veículo:
 ### Versionamento
 
 A metodologia do IBAV é versionada para garantir:
+
 - Rastreabilidade de mudanças
 - Estabilidade para usuários
 - Possibilidade de rollback se necessário
@@ -76,6 +79,7 @@ A metodologia do IBAV é versionada para garantir:
 ### Atualizações
 
 Mudanças na metodologia devem:
+
 - Ser documentadas no CHANGELOG.md
 - Manter compatibilidade quando possível
 - Ser comunicadas claramente aos usuários
@@ -115,6 +119,7 @@ Mudanças na metodologia devem:
 ## Licenciamento
 
 O projeto IBAV é open source para garantir:
+
 - Acesso livre à metodologia
 - Contribuição da comunidade
 - Melhoria contínua através de colaboração
@@ -125,6 +130,7 @@ O projeto IBAV é open source para garantir:
 ## Contribuição
 
 Contribuições são bem-vindas e devem seguir:
+
 - O código de conduta do projeto (CODE_OF_CONDUCT.md)
 - As diretrizes de contribuição (CONTRIBUTING.md)
 - O processo de issues e pull requests do GitHub
@@ -134,6 +140,7 @@ Contribuições são bem-vindas e devem seguir:
 ## Contato e Suporte
 
 Para dúvidas, sugestões ou reportar problemas:
+
 - Abra uma issue no GitHub
 - Consulte a documentação em docs/docs.md
-- Revise o CHANGELOG.md para atualizações recentes
\ No newline at end of file
+- Revise o CHANGELOG.md para atualizações recentes

From a046a50c339eef7a506f990f30f7a5940a97556d Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 13:30:40 -0300
Subject: [PATCH 6/7] =?UTF-8?q?refactor(docs):=20Atualiza=20regras=20de=20?=
 =?UTF-8?q?organiza=C3=A7=C3=A3o=20de=20c=C3=B3digo?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/app.vue                   | 73 +++++++++++++++++------------------
 docs/specs/ibav-mvp.md        | 58 ++++++++++++++++++++++++++++
 shared/utils/vehicle-query.ts |  2 +-
 3 files changed, 95 insertions(+), 38 deletions(-)

diff --git a/app/app.vue b/app/app.vue
index 88b60f9..e859196 100644
--- a/app/app.vue
+++ b/app/app.vue
@@ -1,42 +1,5 @@
-<template>
-  <div class="min-h-screen bg-gray-50 p-6">
-    <div class="mx-auto max-w-xl space-y-6">
-      <h1 class="text-2xl font-bold">IBAV - Avaliação Veicular</h1>
-
-      <div class="space-y-4">
-        <div>
-          <label for="fipe" class="block text-sm font-medium">Valor FIPE</label>
-          <UInput id="fipe" v-model.number="form.fipeValue" type="number" min="0" step="1000" />
-        </div>
-
-        <div>
-          <label for="year" class="block text-sm font-medium">Ano</label>
-          <UInput id="year" v-model.number="form.year" type="number" />
-        </div>
-
-        <div>
-          <label for="mileage" class="block text-sm font-medium">Quilometragem</label>
-          <UInput id="mileage" v-model.number="form.mileage" type="number" min="0" />
-        </div>
-
-        <div>
-          <label for="condition" class="block text-sm font-medium">Conservação</label>
-          <USelect id="condition" v-model="form.condition" :options="conditionOptions" />
-        </div>
-      </div>
-
-      <div v-if="result" data-testid="result" class="rounded-lg bg-white p-4 shadow">
-        <p>Valor FIPE: {{ formatMoney(form.fipeValue) }}</p>
-        <p>Valor Justo: {{ formatMoney(result.vjv) }}</p>
-        <p>IVB: {{ result.ivb.points }} pontos ({{ result.ivb.label }})</p>
-      </div>
-    </div>
-  </div>
-</template>
-
 <script setup lang="ts">
 import { ref, computed, watch } from 'vue';
-import { useRoute, useRouter } from 'vue-router';
 import type { VehicleCondition, VehicleInputs } from '#shared/types/valuation';
 import { calculateVjv } from '#shared/utils/vjv';
 import { calculateIvb } from '#shared/utils/ivb';
@@ -102,3 +65,39 @@ function formatMoney(value: number): string {
   return currencyFormatter.format(value);
 }
 </script>
+
+<template>
+  <div class="min-h-screen bg-gray-50 p-6">
+    <div class="mx-auto max-w-xl space-y-6">
+      <h1 class="text-2xl font-bold">IBAV - Avaliação Veicular</h1>
+
+      <div class="space-y-4">
+        <div>
+          <label for="fipe" class="block text-sm font-medium">Valor FIPE</label>
+          <UInput id="fipe" v-model.number="form.fipeValue" type="number" min="0" step="1000" />
+        </div>
+
+        <div>
+          <label for="year" class="block text-sm font-medium">Ano</label>
+          <UInput id="year" v-model.number="form.year" type="number" />
+        </div>
+
+        <div>
+          <label for="mileage" class="block text-sm font-medium">Quilometragem</label>
+          <UInput id="mileage" v-model.number="form.mileage" type="number" min="0" />
+        </div>
+
+        <div>
+          <label for="condition" class="block text-sm font-medium">Conservação</label>
+          <USelect id="condition" v-model="form.condition" :options="conditionOptions" />
+        </div>
+      </div>
+
+      <div v-if="result" data-testid="result" class="rounded-lg bg-white p-4 shadow">
+        <p>Valor FIPE: {{ formatMoney(form.fipeValue) }}</p>
+        <p>Valor Justo: {{ formatMoney(result.vjv) }}</p>
+        <p>IVB: {{ result.ivb.points }} pontos ({{ result.ivb.label }})</p>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/docs/specs/ibav-mvp.md b/docs/specs/ibav-mvp.md
index 64ef5eb..d31f6bd 100644
--- a/docs/specs/ibav-mvp.md
+++ b/docs/specs/ibav-mvp.md
@@ -104,6 +104,64 @@ Não existe ainda nenhuma lógica de domínio implementada.
 - **TR5** A página deve ser SSR-safe (sem hydration mismatch).
 - **TR6** Query params devem sincronizar o estado do formulário via `useRoute().query` e `useRouter()`.
 - **TR7** Cobertura de testes unitários acima de 80% para os utilitários matemáticos.
+- **TR8** Em todos os arquivos `.vue` (SFC), o bloco `<script setup>` deve ser declarado **antes** do bloco `<template>`.
+
+## Code Organization Rules (Nuxt 4)
+
+O projeto utiliza **Nuxt 4** e suas convenções devem ser respeitadas para organização de imports, utilitários e compartilhamento de código.
+
+### Verificar antes de implementar
+
+Antes de modificar qualquer arquivo relacionado a imports, organização de código ou compartilhamento de utilitários:
+
+- Inspecionar a estrutura atual do projeto.
+- Verificar onde componentes, composables, tipos e utilitários estão localizados.
+- Identificar como os imports estão sendo utilizados.
+- Verificar dependências ou referências entre `shared/` e `app/`.
+
+Só então implementar as alterações necessárias. Nunca assumir a estrutura do projeto sem verificar primeiro.
+
+### Imports de `shared/`
+
+Projetos Vue/Nuxt **não precisam importar diretamente arquivos de `shared/`** quando o código puder ser utilizado por mecanismos nativos do Nuxt 4 ou quando existir uma alternativa apropriada dentro de `app/`.
+
+- Evitar imports relativos do tipo `import { foo } from '../../shared/utils'` em páginas, componentes ou composables.
+- Antes de criar ou manter um import de `shared/`, verificar se ele é realmente necessário.
+
+### Utilitários específicos da aplicação
+
+Funções utilitárias específicas da aplicação Vue/Nuxt devem preferencialmente ficar em `app/utils/` e ser utilizadas pelo mecanismo de auto-import do Nuxt, quando aplicável.
+
+```
+app/
+├── components/
+├── composables/
+├── pages/
+├── utils/
+└── ...
+```
+
+Evitar importar manualmente utilitários que o Nuxt possa disponibilizar por auto-import.
+
+### Sem duplicação
+
+Antes de criar uma nova função utilitária:
+
+- Procurar se ela já existe em `app/utils/`.
+- Procurar implementações equivalentes no projeto.
+- Verificar se existe implementação compartilhada que realmente precise ser reutilizada.
+- Não criar cópias da mesma função em diretórios diferentes sem necessidade.
+
+### Fluxo obrigatório
+
+Para qualquer alteração relacionada a essa regra:
+
+1. **Verificar** a estrutura existente.
+2. **Analisar** a melhor localização e opções nativas do Nuxt 4.
+3. **Identificar** a solução menos acoplada.
+4. **Validar** impactos e dependências.
+5. **Implementar** a alteração.
+6. **Validar** o resultado (lint, testes, build).
 
 ## Data Flow
 
diff --git a/shared/utils/vehicle-query.ts b/shared/utils/vehicle-query.ts
index 028a946..d784aad 100644
--- a/shared/utils/vehicle-query.ts
+++ b/shared/utils/vehicle-query.ts
@@ -3,7 +3,7 @@ import type { VehicleCondition, VehicleInputs } from '#shared/types/valuation';
 const VALID_CONDITIONS: VehicleCondition[] = ['excelente', 'bom', 'regular', 'ruim'];
 
 export function parseVehicleQuery(
-  query: Record<string, string | string[]>
+  query: Record<string, unknown>
 ): Partial<VehicleInputs> {
   const parsed: Partial<VehicleInputs> = {};
 

From d26f1e7b51877827f741f3694fd606ca390df1e3 Mon Sep 17 00:00:00 2001
From: "aslan.gama" <aslan.gama@sixchains.com.br>
Date: Tue, 11 Aug 2026 17:11:22 -0300
Subject: [PATCH 7/7] =?UTF-8?q?fix(app):=20Atualiza=20c=C3=A1lculo=20de=20?=
 =?UTF-8?q?ano=20atual=20na=20app.vue?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/app.vue | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/app/app.vue b/app/app.vue
index e859196..710a81f 100644
--- a/app/app.vue
+++ b/app/app.vue
@@ -5,14 +5,14 @@ import { calculateVjv } from '#shared/utils/vjv';
 import { calculateIvb } from '#shared/utils/ivb';
 import { parseVehicleQuery, buildVehicleQuery } from '#shared/utils/vehicle-query';
 
-const currentYear = new Date().getFullYear();
+const currentYear = useState<number>('currentYear', () => new Date().getFullYear());
 const route = useRoute();
 const router = useRouter();
 
 const query = parseVehicleQuery(route.query);
 const form = ref<VehicleInputs>({
   fipeValue: query.fipeValue ?? 0,
-  year: query.year ?? currentYear,
+  year: query.year ?? currentYear.value,
   mileage: query.mileage ?? 0,
   condition: query.condition ?? 'bom',
 });
@@ -41,7 +41,7 @@ const isValid = computed(() => {
   return (
     form.value.fipeValue > 0 &&
     form.value.year > 1900 &&
-    form.value.year <= currentYear &&
+    form.value.year <= currentYear.value &&
     form.value.mileage >= 0
   );
 });
@@ -51,8 +51,8 @@ const result = computed(() => {
     return null;
   }
   return {
-    vjv: calculateVjv(form.value),
-    ivb: calculateIvb(form.value),
+    vjv: calculateVjv(form.value, currentYear.value),
+    ivb: calculateIvb(form.value, currentYear.value),
   };
 });