# Planta Fácil

> Editor grátis de planta baixa 2D no navegador: https://futura.place/plantas/editor/
> Este texto é para IAs (Claude, ChatGPT, Gemini e outras): como montar uma planta a pedido do usuário e entregar um link que abre a planta pronta no editor, para ele conferir e ajustar.
> In English: free 2D floor-plan editor. Send the JSON "programa" below to the MCP server or the HTTP API and give the user the returned link; if you have no tools, give the user the JSON to paste into the editor with Ctrl+V.

O Planta Fácil não tem IA dentro. Quem pensa a planta é você, a IA do usuário. O Planta Fácil desenha as paredes, confere tudo e abre no editor. Não custa nada e não precisa de conta.

## Três jeitos de entregar a planta

1. **Com ferramentas (MCP).** Servidor MCP remoto, sem login: `https://futura.place/plantas/mcp`
   - Ferramentas: `descrever_formato` (este texto), `montar_planta` (programa → link), `validar_planta` (confere um `.planta.json` completo), `link_para_editor` (planta ou programa → link) e `listar_moveis` (o catálogo).
   - Use `montar_planta`. Se voltarem erros, corrija o programa e chame de novo, até sair o link.
2. **Com acesso à web (HTTP).** `POST https://futura.place/plantas/api/montar`, com o programa no corpo (JSON). A resposta traz `ok`, `erros`, `avisos`, `comodos` (nome e área útil) e `link`.
3. **Só texto.** Escreva o programa num bloco de código JSON e diga ao usuário:
   - abra https://futura.place/plantas/editor/ e cole com Ctrl+V; ou
   - salve o texto num arquivo `casa.json` e use o botão **Abrir** do editor.

Nos três jeitos, a planta abre como planta nova. A anterior volta com Ctrl+Z.

## O formato: o "programa"

Você não desenha paredes. Você descreve cômodos retangulares, portas, janelas e móveis, e o Planta Fácil monta o resto.

- **Medidas em centímetros**, sempre múltiplos de 5.
- **Coordenadas:** x cresce para a direita e y para baixo. A frente da casa (a rua) fica em y = 0.
- **Cômodos (`comodos`):** `{ "nome", "x", "y", "larg", "prof" }`.
  - `x` e `y` são o canto de cima à esquerda; `larg` é a medida em x e `prof` em y.
  - As medidas são **pelo eixo das paredes**. A área útil sai um pouco menor, porque desconta metade de cada parede.
  - Cômodos vizinhos dividem a mesma linha: se a Sala vai de x = 0 a 460, a Cozinha ao lado começa em x = 460.
  - Cômodos não podem se sobrepor, cada lado precisa ter de 100 a 3000 cm, e os nomes não se repetem.
  - O corredor também é um cômodo.
  - O que fica sem cômodo é área de fora (quintal, recuo).
- **Lados de um cômodo:** `frente` (y menor), `fundos` (y maior), `esquerda` (x menor) e `direita` (x maior).
- **Portas (`portas`):** `{ "de", "para", "tipo", "largura", "lado" }`.
  - `para` é o nome de outro cômodo, que precisa encostar em `de` por um lado.
  - `para` também pode ser `"fora"`, para a entrada ou a saída para o quintal. Nesse caso, diga o `lado`.
  - A folha abre para dentro de `para`, ou de `de` quando `para` é fora.
  - Tipos: `porta` (de abrir, 80 cm), `porta_dupla` (120), `porta_correr` (100) e `vao` (abertura sem porta, como na cozinha americana).
  - A porta fica perto de um canto; o vão fica no meio.
- **Janelas (`janelas`):** `{ "comodo", "lado", "tipo", "largura" }`.
  - Só num lado que dá para fora.
  - Tipos: `janela_correr` (120 cm) e `janela_abrir` (100; para banheiro use 60).
  - A janela fica no meio do pedaço livre da parede.
- **Móveis (`moveis`), opcionais:** `{ "comodo", "item", "lado", "posicao", "larg", "prof" }`.
  - `item` é o id do catálogo (lista abaixo).
  - Com `lado`, as costas do móvel encostam nessa parede (a cabeceira da cama, o encosto do sofá). Sem `lado`, o móvel fica no meio do cômodo.
  - `posicao` diz onde ao longo da parede: `inicio` (a esquerda ou o alto), `meio` (o padrão) ou `fim`.
  - Sem `larg` e `prof`, vale a medida do catálogo.
- **Nome da planta (`nome`):** aparece no editor e no PDF.

## Exemplo completo

Pedido: "casa térrea num lote de 10 x 25, com 3 quartos (1 suíte) e cozinha americana". A resposta é uma casa de 8 × 14 m, com a frente para a rua:

```json
{
  "nome": "Casa térrea 10 x 25",
  "comodos": [
    { "nome": "Sala", "x": 0, "y": 0, "larg": 460, "prof": 450 },
    { "nome": "Cozinha", "x": 460, "y": 0, "larg": 340, "prof": 450 },
    { "nome": "Área de serviço", "x": 460, "y": 450, "larg": 340, "prof": 170 },
    { "nome": "Corredor", "x": 340, "y": 450, "larg": 120, "prof": 660 },
    { "nome": "Quarto 2", "x": 0, "y": 450, "larg": 340, "prof": 330 },
    { "nome": "Quarto 3", "x": 0, "y": 780, "larg": 340, "prof": 330 },
    { "nome": "Banheiro", "x": 460, "y": 620, "larg": 340, "prof": 240 },
    { "nome": "Suíte", "x": 460, "y": 860, "larg": 340, "prof": 350 },
    { "nome": "Banho da suíte", "x": 460, "y": 1210, "larg": 340, "prof": 190 }
  ],
  "portas": [
    { "de": "Sala", "para": "fora", "lado": "frente", "tipo": "porta", "largura": 90 },
    { "de": "Sala", "para": "Cozinha", "tipo": "vao", "largura": 240 },
    { "de": "Sala", "para": "Corredor", "tipo": "vao", "largura": 80 },
    { "de": "Cozinha", "para": "Área de serviço", "tipo": "porta" },
    { "de": "Área de serviço", "para": "fora", "lado": "direita", "tipo": "porta" },
    { "de": "Corredor", "para": "Quarto 2", "tipo": "porta" },
    { "de": "Corredor", "para": "Quarto 3", "tipo": "porta" },
    { "de": "Corredor", "para": "Banheiro", "tipo": "porta", "largura": 70 },
    { "de": "Corredor", "para": "Suíte", "tipo": "porta" },
    { "de": "Suíte", "para": "Banho da suíte", "tipo": "porta", "largura": 70 }
  ],
  "janelas": [
    { "comodo": "Sala", "lado": "frente", "tipo": "janela_correr", "largura": 200 },
    { "comodo": "Cozinha", "lado": "frente", "tipo": "janela_correr", "largura": 150 },
    { "comodo": "Quarto 2", "lado": "esquerda", "tipo": "janela_correr", "largura": 150 },
    { "comodo": "Quarto 3", "lado": "esquerda", "tipo": "janela_correr", "largura": 150 },
    { "comodo": "Banheiro", "lado": "direita", "tipo": "janela_abrir", "largura": 60 },
    { "comodo": "Suíte", "lado": "direita", "tipo": "janela_correr", "largura": 150 },
    { "comodo": "Banho da suíte", "lado": "fundos", "tipo": "janela_abrir", "largura": 60 }
  ],
  "moveis": [
    { "comodo": "Sala", "item": "sofa3", "lado": "fundos", "posicao": "inicio" },
    { "comodo": "Sala", "item": "mesa4" },
    { "comodo": "Sala", "item": "rack", "lado": "frente", "posicao": "fim" },
    { "comodo": "Cozinha", "item": "bancada_pia", "lado": "frente" },
    { "comodo": "Cozinha", "item": "fogao", "lado": "direita", "posicao": "inicio" },
    { "comodo": "Cozinha", "item": "geladeira", "lado": "direita", "posicao": "fim" },
    { "comodo": "Área de serviço", "item": "tanque", "lado": "fundos" },
    { "comodo": "Área de serviço", "item": "maquina_lavar", "lado": "fundos", "posicao": "inicio" },
    { "comodo": "Quarto 2", "item": "cama_solteiro", "lado": "esquerda", "posicao": "inicio" },
    { "comodo": "Quarto 2", "item": "guarda_roupa", "lado": "fundos", "posicao": "fim" },
    { "comodo": "Quarto 3", "item": "cama_solteiro", "lado": "esquerda", "posicao": "inicio" },
    { "comodo": "Quarto 3", "item": "guarda_roupa", "lado": "fundos", "posicao": "fim" },
    { "comodo": "Banheiro", "item": "lavatorio", "lado": "frente" },
    { "comodo": "Banheiro", "item": "vaso", "lado": "fundos" },
    { "comodo": "Banheiro", "item": "box", "lado": "fundos", "posicao": "fim" },
    { "comodo": "Suíte", "item": "cama_casal", "lado": "direita" },
    { "comodo": "Suíte", "item": "guarda_roupa", "lado": "frente", "posicao": "fim" },
    { "comodo": "Banho da suíte", "item": "lavatorio", "lado": "direita", "posicao": "inicio" },
    { "comodo": "Banho da suíte", "item": "vaso", "lado": "fundos", "posicao": "fim" },
    { "comodo": "Banho da suíte", "item": "box", "lado": "esquerda", "posicao": "fim" }
  ]
}
```

## Dicas para uma planta boa

São medidas comuns, não regras de prefeitura.

- Sala e cozinha na frente, quartos e banheiros para dentro.
- Quarto com 7 m² ou mais, suíte com 9 m² ou mais, banheiro com 2,5 m² ou mais.
- Corredor com 100 a 120 cm de largura.
- Todo quarto e a sala com janela para fora. O banheiro com janela de 60 cm.
- Portas: entrada de 90 cm, quartos de 80 e banheiros de 70.
- Deixe livre a frente das portas. O Planta Fácil avisa quando um móvel fica no caminho.
- Num terreno de L × F metros, deixe recuos: em geral, a casa fica uns 2 m menor na largura e uns 5 m menor no fundo.

## Quando der erro

A resposta traz `erros` (a planta não sai) e `avisos` (a planta sai, mas vale olhar), em frases curtas. Corrija o programa e mande de novo. Exemplos:

- `"Sala" e "Cozinha" se sobrepõem`: ajuste x, y, larg ou prof para os dois só se encostarem.
- `Porta de "Corredor" para "Suíte": os dois cômodos não encostam um no outro`.
- `Janela de "Corredor" (esquerda): esse lado não dá para fora`.
- `Móvel "cama_box" em "Suíte": esse item não existe no catálogo (parecidos: cama_solteiro, cama_casal, cama_queen, cama_king)`.
- Aviso: `"Quarto 3" ficou sem passagem até a entrada` (falta porta).

## Móveis mais usados (id: largura × profundidade, em cm)

- **Quarto:** cama_solteiro 88×188, cama_casal 138×188, cama_queen 158×198, beliche, berco, guarda_roupa 160×55, criado_mudo 45×40, comoda 100×45.
- **Sala:** sofa2 150×85, sofa3 210×90, sofa_canto, poltrona 75×80, rack 180×40, tv_parede 125×10, mesa_centro, mesa4 120×80, mesa6 180×90, mesa8, cadeira 45×50.
- **Cozinha e serviço:** bancada_pia 120×60, fogao 55×60, cooktop4, geladeira 70×70, microondas, lava_loucas, ilha_cozinha, tanque 55×50, maquina_lavar 60×65, secadora.
- **Banheiro:** vaso 40×65, lavatorio 50×40, box 90×90, banheira, bancada_2_cubas.
- **Escritório:** mesa_trabalho 120×60, mesa_l 150×150, cadeira_escritorio 60×60, mesa_reuniao 200×100, armario 80×45, estante 90×35.
- **Área externa:** vaga_carro, churrasqueira, piscina, arvore.
- **Livre:** objeto (retângulo) e objeto_redondo (círculo), de qualquer tamanho.

São 143 itens no total. Para a lista completa, use a ferramenta `listar_moveis` ou `GET https://futura.place/plantas/api/moveis`.

## Limites

- Até 30 cômodos e 200 móveis por planta.
- Só cômodos retangulares, com paredes em ângulo reto, e um andar. Um cômodo em L se faz com dois retângulos.
- O link leva a planta inteira depois do `#`. Com até uns 8 mil caracteres, cabe em qualquer chat. Se ficar maior, entregue o JSON para o usuário colar ou abrir como arquivo.
- Para quem precisa de tudo: o editor também abre o `.planta.json` completo (nós, paredes, aberturas, rótulos, móveis e anotações). Confira com `validar_planta` antes de entregar.

## Privacidade

- O Planta Fácil não guarda as plantas que passam pelo MCP ou pela API: elas são montadas e devolvidas na hora.
- No link, a planta fica depois do `#`, e o navegador não manda essa parte para o servidor.
- Limite de uso: 60 pedidos por minuto por endereço IP, com no máximo 100 KB por pedido.