# Manual de uso — Gestor Mãe  
**Casa das Impressoras · McZa Informática · 62 3954-3636**

Este manual é para **quem usa o site** no dia a dia: baixar o Servidor de Impressão, criar conta, ver o painel e acompanhar as estações.

| Acesso | Endereço |
|--------|----------|
| **Manual (esta página)** | https://gestor.casaimp.com.br/manual |
| **Arquivo Markdown** | https://gestor.casaimp.com.br/manual.md |
| **API técnica (programadores)** | https://gestor.casaimp.com.br/docs |
| **Baixar o Servidor de Impressão** | https://gestor.casaimp.com.br/baixar |
| **Painel** | https://gestor.casaimp.com.br/app/ |

---

# 1. O que é o Gestor Mãe?

O **Gestor Mãe** é a nuvem da Casa das Impressoras. Ele:

- Organiza **contas** e **servidores** (estações Windows com impressora)
- Oferece **URL pública** estável para imprimir pela internet
- Distribui e atualiza o **Servidor de Impressão** (agente gratuito)
- Guarda a **biblioteca técnica** (drivers, telemetria, comandos) — o agente só executa na LAN

O **Servidor de Impressão** (filho) fica no PC da impressora. É **gratuito**. O Gestor é o serviço em nuvem (planos mensais).

```text
Seu sistema / navegador
        │
        ▼
  Gestor Mãe (gestor.casaimp.com.br)
        ▲
        │  heartbeat / jobs / update
        │
 Servidor de Impressão (Windows do cliente)
        │
        ▼
   Impressora
```

---

# 2. Baixar e instalar o Servidor de Impressão

1. Abra **[Baixar](https://gestor.casaimp.com.br/baixar)** (ou o botão **Baixe o Servidor de Impressão** na home).
2. Clique em **Baixe o Servidor de Impressão**.
3. No Windows: botão direito no arquivo → **Executar como administrador**.
4. O instalador **instala** se ainda não existir ou **atualiza** preservando os dados.
5. Abra a gestão local: **http://127.0.0.1:9108/**

Para remover tudo: na mesma página `/baixar`, use o link de exclusão completa (também como administrador).

Atualizações futuras chegam automaticamente pelo Gestor quando a estação está online.

---

# 3. Conta no Gestor

Endereço: **https://gestor.casaimp.com.br/conta/**

## Entrar / cadastrar

- Aba **Entrar**: e-mail + senha → painel `/app/`
- Aba **Cadastrar**: nome, e-mail, senha e **celular** (obrigatório)
- Também: **Google**, **Microsoft**, **Facebook** e **WhatsApp** (código)

Um cadastro por pessoa (e-mail e celular únicos).

## Depois do login

Você cai no **painel** (`/app/`). Vincule o Servidor de Impressão instalado à sua conta (caixa “Conta no Gestor” no agente local, ou registro autenticado).

---

# 4. Painel (`/app/`)

Layout em **três colunas** (servidores · fila/impressoras · ações/detalhe).

O que você pode fazer:

| Área | Uso |
|------|-----|
| **Servidores** | Ver estações online/offline, versão do agente, URL pública |
| **Filas / impressoras** | Acompanhar trabalhos, enviar arquivo ou texto para imprimir |
| **Comandos remotos** | Pedir ações no PC (ex.: atualizar agente, abrir preferências) |
| **Telemetria** | Leituras técnicas quando a biblioteca da mãe e o agente permitem |
| **Marketplace** | Manuais, insumos e serviços de parceiros (conforme oferta) |

Só quem é **dono** ou **delegado** da estação enxerga e comanda aquele servidor.

---

# 5. Planos (Gestor)

Valores em USD / mês (sujeitos ao site):

| Plano | Ideia |
|-------|--------|
| **Starter** | Até 10 servidores |
| **Pro** | Até 50 servidores |
| **Scale** | Extras além de 50 |

Há **1 servidor em avaliação gratuita**. O Servidor de Impressão local continua gratuito.

---

# 6. Impressão pela internet (visão usuário)

Cada estação ganha uma **URL pública** do tipo:

`https://gestor.casaimp.com.br/v1/p/cdi_…`

Sistemas (ERP, portal) usam essa URL. O PC da loja **não precisa** de IP fixo na internet — ele se conecta de dentro para fora ao Gestor.

Detalhes para programadores: **[/docs](https://gestor.casaimp.com.br/docs)** e o arquivo `docs/API.md`.

---

# 7. Problemas comuns

| Sintoma | O que fazer |
|---------|-------------|
| Não consigo entrar | Confira e-mail/senha; tente OAuth ou WhatsApp; limpe cache se a tela antiga ficar presa |
| Agente não aparece no painel | Instale/atualize pelo `/baixar`; vincule a conta no agente; confira se está online |
| Sem URL pública | Estação precisa estar registrada e com heartbeat OK |
| Instalador não sobe | Execute **como administrador**; antivírus pode bloquear — libere a pasta |
| Dúvidas | **62 3954-3636** |

---

# 8. Onde achar mais informação

| Documento | Conteúdo |
|-----------|----------|
| Este manual | Uso do site e do fluxo conta → agente → painel |
| `/docs` | API técnica do Gestor |
| Manual do filho | http://127.0.0.1:9108/manual (no PC instalado) |
| `docs/biblioteca-firmware-hub.md` | Biblioteca técnica / hub (equipe) |

---

*Última atualização: 2026-08-11 · Casa das Impressoras*