Pular para o conteúdo principal

Local-first

Toposync é local-first por padrão. O caminho principal do produto roda backend, UI, extensões, settings, arquivos e estado de pipelines no próprio ambiente do usuário.

Local-first não significa isolado de todo o resto. O Toposync pode integrar com Home Assistant, câmeras, processing servers e serviços externos opcionais. Significa que o sistema local deve continuar sendo o centro de propriedade e operação.

O que fica local​

Em uma instalação normal, o Toposync armazena e opera localmente:

  • configuração e settings;
  • usuários, sessões e concessões de acesso;
  • composições, paredes, áreas e elementos;
  • registro de câmeras e dados de mapeamento;
  • arquivos enviados, imagens, modelos e artifacts gerados;
  • definições de pipelines, telemetria, snapshots e armazenamento;
  • dados de extensões criados pelas extensões instaladas.

O diretório de dados ativo depende do caminho de instalação. Veja Locais de arquivos para caminhos específicos por plataforma.

Diretório de dados​

O Toposync tem um diretório de dados principal. Ele pode ser definido por --data-dir, TOPOSYNC_DATA_DIR, volumes Docker ou armazenamento do add-on.

Use um diretório de dados explícito para instalações previsíveis:

toposync serve --data-dir ./toposync-data

Não edite config.json enquanto o servidor está rodando. Prefira a UI ou API. Se precisar de recuperação manual, pare o Toposync antes e mantenha um backup.

Integração com Home Assistant​

A integração com Home Assistant é opcional. O Toposync pode rodar de forma independente, ou pode usar Home Assistant para entidades, estados, automações, notificações, entidades de câmera e operação como add-on.

Quando roda como add-on do Home Assistant OS, o Toposync ainda usa armazenamento local do add-on e o Home Assistant Supervisor gerencia o ciclo de vida do add-on.

Processing servers​

Processing servers continuam dentro do modelo local-first quando rodam em máquinas que você controla.

Use processing servers quando:

  • o servidor origin deve continuar leve;
  • Home Assistant OS roda em hardware limitado;
  • múltiplas câmeras precisam de processamento;
  • cargas OpenCV ou ONNX são pesadas demais para o origin;
  • um host Windows, Linux, macOS, Docker ou GPU deve fazer o trabalho pesado.

O origin continua responsável por configuração e orquestração. O processing server recebe o trabalho que precisa executar e reporta status ou eventos de volta ao origin.

Serviços externos​

O Toposync não deve exigir um serviço externo para iniciar, carregar a UI, gerenciar uma casa, carregar extensões, rodar pipelines locais ou integrar com Home Assistant na mesma rede.

Se serviços opcionais forem adicionados depois, eles devem ser aditivos. Eles não devem mudar a base local-first.

Regras práticas​

  • Faça backup do diretório de dados antes de upgrades.
  • Use redes contidas e entidades não críticas ao testar builds alpha.
  • Prefira processamento local para mídia privada de câmeras.
  • Sanitize logs antes de compartilhar issues.
  • Trate achados de segurança como reports privados, não issues públicas.

Próximo: Conceitos espaciais.