Skip to main content
Glama
Pergunte à Reforma

Pergunte à Reforma

README.md
# Pergunte à Reforma

> Pergunte em português, receba o valor do imposto, a explicação e o artigo da **LC 214/2025**.
> A conta é sempre feita pelo **motor oficial da Receita Federal**, nunca pela IA.

**Status:** 🟢 Semana 1 quase concluída: motor oficial buildando e testado no CI, ETL e busca de NCM/NBS prontos (Bloco 2 · Projeto 1). Plano completo em [`docs/PLANO.md`](docs/PLANO.md) e tarefas nas [Issues](../../issues) e [Milestones](../../milestones).

---

## A ideia em 30 segundos

```
Você:  "Quanto de imposto tem num pacote de arroz de R$ 25 e numa cerveja de R$ 8?"

Agente: busca "arroz" → NCM 1006.30.21 → cesta básica (redução de 100%)
        busca "cerveja" → NCM 2203.00.00 → alíquota cheia + Imposto Seletivo
        chama o MOTOR OFICIAL → recebe os valores
        responde com os números do motor, o artigo da lei e um gráfico
```

O resultado não vem só em texto: aparece um **painel visual** com a memória de cálculo (base → redução → CBS → IBS → IS), a comparação entre os itens e o caminho da classificação ("por que deu isso").

## Use com a IA que você já tem

Em vez de cobrar uma API de IA do projeto, **você usa o seu próprio Claude, ChatGPT ou Gemini**:

| Modo | Como funciona | Quem paga o modelo |
|---|---|---|
| **1. Conector (principal)** | Cole a URL do servidor MCP em *Conectores* do Claude, *Apps* do ChatGPT ou *Connected Apps* do Gemini. As ferramentas e os painéis visuais aparecem dentro do chat que você já usa. | A sua assinatura |
| **2. Site com sua chave** | No site, escolha Claude, GPT ou Gemini e cole sua chave de API. Ela fica só no seu navegador. | A sua chave |
| **3. Demonstração grátis** | Algumas perguntas por dia com um modelo leve, para quem só quer testar. | O projeto (com limite) |

> **Por que não "entrar com a conta do Claude/ChatGPT/Gemini" dentro do site?** Os termos de uso da Anthropic e do Google proíbem que apps de terceiros usem o login da assinatura do usuário (e contas já foram bloqueadas por isso). O conector MCP inverte a lógica: **o projeto entra na sua conta**, não o contrário. Detalhes em [ADR-001](docs/adr/ADR-001-modelo-do-usuario-via-mcp.md).

## Arquitetura

```mermaid
flowchart LR
    subgraph Usuario["Onde a pessoa pergunta"]
        C[Claude] & G[ChatGPT] & Ge[Gemini]
        W[Site Next.js<br/>BYOK ou demo]
    end
    subgraph Projeto["Pergunte à Reforma"]
        MCP[Servidor MCP<br/>ferramentas + painéis]
        CORE[core<br/>guardrails e cenários]
        S[(Busca híbrida<br/>NCM · NBS · anexos)]
    end
    E[[Motor oficial RTC<br/>Java · Cloud Run]]

    C & G & Ge -- MCP --> MCP
    W --> CORE
    MCP --> CORE
    CORE --> S
    CORE -- cálculo e dados abertos --> E
```

Mais detalhes em [`docs/ARQUITETURA.md`](docs/ARQUITETURA.md).

## Princípios inegociáveis

1. **A IA não faz conta.** Todo número exibido vem da resposta do motor oficial ([ADR-002](docs/adr/ADR-002-ia-nao-faz-conta.md)).
2. **Toda resposta cita a lei**: artigo da LC 214/2025 e a classificação usada (CST/cClassTrib).
3. **Na dúvida, pergunta.** Se o produto cabe em duas classificações, o agente pergunta em vez de chutar.
4. **Simulação, não consultoria.** O aviso aparece em toda resposta. A partir de 2027 as alíquotas são cenários configuráveis e isso fica explícito.
5. **Medido, não prometido.** A taxa de acerto é medida contra os casos de teste oficiais do repositório da Receita ([`docs/AVALIACAO.md`](docs/AVALIACAO.md)).

## Rodando localmente

```bash
pnpm install --ignore-scripts
pnpm --filter @reforma/search etl        # clona a calculadora oficial (1.6.1), gera o banco e exporta data/*.json
pnpm --filter @reforma/search avaliar     # mede a busca no gabarito (top-1/3/5)
docker run -p 8080:8080 ghcr.io/nicolasdev-web/rtc-engine:1.6.1   # motor oficial
engine/smoke.sh                           # confere o exemplo oficial da Receita
```

## Estrutura do repositório

```
engine/          Dockerfile do motor oficial (Java 21 + SQLite gerado no build)
packages/core/   cliente do motor, ferramentas, cenários, guardrails (TypeScript)
packages/search/ ETL dos dados abertos + índice de busca NCM/NBS/anexos
apps/mcp/        servidor MCP remoto + painéis visuais (MCP Apps)
apps/web/        site Next.js: chat BYOK/demo + painéis
eval/            gabarito a partir dos testes oficiais + runner de avaliação
docs/            plano, arquitetura, ideias, ADRs, posts
```

## Créditos e aviso

- Motor de cálculo: [ReceitaFederal/calculadora-rtc-regime-regular](https://github.com/ReceitaFederal/calculadora-rtc-regime-regular) (licença MIT), usado sem modificações.
- Projeto independente, sem vínculo com a Receita Federal ou o SERPRO. **É uma simulação e não substitui orientação de um contador.**

Feito por [Nicolas Santos](https://www.linkedin.com/in/nicolassantos-986861304) · Licença MIT