# Marca — Nexus

**Nexus** — *Casa Inteligente*. Slogan: *Sua casa, inteligente*.

> O projeto já se chamou **Asgard** e depois **sgci.io**. Virou **Nexus** quando deixou
> de ser "cérebro do condomínio" para ser o **cérebro de uma única residência** (um
> apartamento). Este guia é a referência da marca.

---

## Fonte única (não escreva o nome na mão)

O nome vive em **um lugar só**: `api/config/app.php`.

```php
'brand'      => 'Nexus',
'brand_full' => 'Nexus — Casa Inteligente',
'brand_tag'  => 'Sua casa, inteligente',
```

Nas views, **sempre** use os helpers — nunca digite `Nexus` direto:

| Helper | Devolve |
|---|---|
| `H::brand()` | `Nexus` |
| `H::brandFull()` | `Nexus — Casa Inteligente` |
| `H::brandTag()` | `Sua casa, inteligente` |
| `H::brandMark(56)` | só o símbolo (SVG inline, herda a cor do tema) |
| `H::brandLogo(26)` | símbolo + wordmark (se o nome tiver um ponto, o sufixo — ex.: `.io` — sai em cor de acento; `Nexus` não tem ponto, então sai só o wordmark) |

Trocar a marca de novo = **uma linha** no `app.php`.

---

## O símbolo

Um **nó central ligado a quatro nós** — um *hub* de conexões. É a ideia de **nexus**
(elo, ponto de encontro) e também a metáfora do **cérebro da casa** ligando os
dispositivos.

- Geometria contida (raio 14 num tile 64), alinhada ao restyle *enterprise*.
- Sobrevive a **16 px** (favicon) e funciona em **mono** e em fundo escuro.
- Cor do tile: **`#3b6ef5`** — é a `--primary` do design system, então a marca
  nunca destoa da interface.

Arquivos:

```
public/assets/img/brand/nexus-mark.svg        (vetor, fonte da verdade)
public/assets/img/brand/nexus-mark-mono.png   (mono, p/ documento/impressão)
public/icon-192.png                          (PWA)
public/icon-512.png                          (PWA)
public/icon-maskable-512.png                 (PWA — safe zone p/ recorte circular)
public/apple-touch-icon.png                  (iOS)
public/favicon.ico                           (16/32/48)
```

Os PNG são **gerados** do vetor (script Pillow, com supersampling 4× p/ antialias).
Se mudar o SVG, regere os ícones.

---

## Renomeação total: tudo virou Nexus

Diferente de renomeações anteriores, aqui **tudo** virou Nexus — a marca **e** os
identificadores técnicos internos. Isso foi possível porque a instalação nova ainda
não tinha sido feita, então **não havia integração em produção a preservar**.

| O que | Agora é |
|---|---|
| Tópico MQTT | `nexus/...` (padrão `MQTT_BASE_TOPIC=nexus`) |
| Pasta do Agendador de Tarefas | `Nexus\` (`set "PREFIX=Nexus"` nos `.bat`; `WatchdogService::PREFIX = 'Nexus'`) |
| Plugin Homebridge | `deploy/homebridge-nexus/` |
| Servidor MCP | `deploy/nexus-mcp/` (env `NEXUS_URL` / `NEXUS_API_KEY`) |

> ⚠️ Se algum dia mexer no **prefixo do Agendador**, mude os **três** juntos:
> `WatchdogService::PREFIX`, o `install_workers.bat` e o `uninstall_workers.bat` —
> senão o watchdog não acha as tarefas.

---

## ⚠️ A ÚNICA exceção — o banco `asgard`

Existe **um** identificador que continua `asgard`: o **banco de dados do sistema de
automação ANTIGO**. O Nexus só **lê** dele **uma vez**, para importar o inventário de
automação legado. Esse banco é **externo** (não é nosso) — renomear a referência
apontaria o import para um banco que não existe.

Ele permanece `asgard` **apenas** nestes três arquivos:

```
api/scripts/import_automacao.php     (--db=asgard, leitura)
api/database/schema_migracao.sql     (INSERT ... SELECT FROM asgard.*)
api/database/migration_automacao.sql (comentário)
```

**Em qualquer outro lugar do código, encontrar `asgard` é bug** — deveria ser `nexus`.