# Grafana e Planta Baixa

Este guia cobre o uso do Grafana com o `V-Fire Monitor` para dashboards baseados em planta baixa.

## Arquivos de apoio

- [floorplan/floorplan-map.example.json](/mnt/c/Users/Syllas/Documents/V-Fire-Monitor/floorplan/floorplan-map.example.json)
- [tools/build_floorplan_bundle.py](/mnt/c/Users/Syllas/Documents/V-Fire-Monitor/tools/build_floorplan_bundle.py)

## O que o instalador ja deixa pronto

Na instalacao Debian 13:

- plugin Zabbix do Grafana instalado
- datasource `Zabbix` provisionado
- dashboard inicial `V-Fire Floorplan Starter`
- icones SVG servidos pelo proprio `V-Fire Monitor`

## URLs dos icones

Substitua `SEU_HOST` pelo host do V-Fire Monitor.

- `http://SEU_HOST:8088/static/grafana-icons/detector-smoke.svg`
- `http://SEU_HOST:8088/static/grafana-icons/detector-heat.svg`
- `http://SEU_HOST:8088/static/grafana-icons/module-input.svg`
- `http://SEU_HOST:8088/static/grafana-icons/siren.svg`
- `http://SEU_HOST:8088/static/grafana-icons/panel-nfs320.svg`

## Dashboard inicial

O instalador provisiona a pasta `V-Fire` no Grafana e um dashboard chamado:

- `V-Fire Floorplan Starter`

Esse dashboard serve como ponto de partida e lembra as URLs dos icones.

## Formato versionavel da planta

Para nao depender apenas de arrastar elementos manualmente no Grafana, o repositorio agora inclui um formato JSON de mapa de planta.

Campos principais:

- `title`
- `grafana_dashboard_uid`
- `background_image_url`
- `vfire_base_url`
- `zabbix_host`
- `items`

Cada item descreve:

- `id`
- `label`
- `item_key`
- `icon`
- `x`
- `y`
- `width`
- `height`
- `rotation`

## Gerar bundle normalizado

Exemplo:

```bash
python3 tools/build_floorplan_bundle.py floorplan/floorplan-map.example.json
```

Isso gera um arquivo `.bundle.json` com:

- URLs completas dos icones
- referencia do host do Zabbix
- referencias dos `item_key`
- coordenadas prontas para uso em futuras automacoes

## Montando a planta baixa

Abordagem recomendada:

1. Abra o dashboard `V-Fire Floorplan Starter`
2. Crie ou edite um painel do tipo `Canvas`
3. Defina a imagem de fundo com a planta baixa do local
4. Adicione elementos visuais ou imagens representando cada ponto
5. Use os SVGs do `V-Fire Monitor` como base visual
6. Associe cada elemento ao item correspondente no datasource `Zabbix`

## Como mapear itens

Os itens que o app envia ao Zabbix seguem chaves como:

- `notifier.status[NomeDoPonto]`
- `notifier.comm[NomeDoPonto]`
- `node.status[NomeDaCentral]`

Os nomes dos pontos sao descobertos automaticamente a partir do monitoramento.

## Estrategia recomendada de planta baixa

- use a planta como imagem base
- posicione um icone por detector, modulo ou sirene
- use cor dinamica para refletir estado
- crie uma legenda simples com:
  - normal
  - incidente
  - ack
  - removido
  - offline

## Observacao pratica

O instalador nao conhece a planta baixa real do cliente.

Por isso, ele consegue deixar:

- Grafana integrado
- datasource pronto
- dashboard inicial provisionado
- icones prontos
- formato versionavel da planta baixa
- bundle normalizado para futuras importacoes

Mas o posicionamento exato dos elementos na planta baixa ainda precisa ser feito conforme o layout real da instalacao.