docs: reorganize and simplify
- Add docs/README.md as index - Consolidate ops in docs/operations.md; mark legacy runbooks as archive - Create docs/desktop/ and docs/admin/ structure and move relevant docs - Update root README to link docs index - Keep historical and planning notes under docs/archive/
This commit is contained in:
parent
0dd0e67458
commit
f5b3abd277
15 changed files with 190 additions and 11 deletions
32
docs/admin/admin-inventory-ui.md
Normal file
32
docs/admin/admin-inventory-ui.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# Admin UI — Inventário por máquina
|
||||
|
||||
A página Admin > Máquinas agora exibe um inventário detalhado e pesquisável do parque, com filtros e exportação.
|
||||
|
||||
## Filtros e busca
|
||||
- Busca livre por hostname, e-mail, MAC e número de série.
|
||||
- Filtro por status: Online, Offline, Sem sinal (stale) e Desconhecido.
|
||||
- Filtro por sistema operacional (OS).
|
||||
- Filtro por empresa (slug).
|
||||
- Marcação “Somente com alertas” para investigar postura.
|
||||
|
||||
## Painel de detalhes
|
||||
- Resumo: hostname, status derivado do heartbeat (badge verde “Online” até 10 minutos; amarelo “Sem sinal” entre 10 minutos e 2 horas; vermelho “Offline” após esse período), e-mail vinculado, empresa (quando houver), perfil de acesso (colaborador/gestor) com dados do usuário associado, SO/arch e sincronização do token (expiração/uso).
|
||||
- Métricas recentes: CPU/Memory/Disco.
|
||||
- Inventário básico: hardware (CPU/mem/serial, GPUs detectadas), rede (IP/MAC), labels.
|
||||
- Discos e partições: nome, mount, FS, capacidade, livre.
|
||||
- Inventário estendido (varia por SO):
|
||||
- Linux: SMART (OK/ALERTA), `lspci`, `lsusb` (texto), `lsblk` (interno para discos).
|
||||
- Windows: informações de SO (edição, versão, build, data de instalação, experiência, ativação), resumo de hardware (CPU/Memória/GPU/Discos físicos com suporte a payloads únicos), serviços, lista completa de softwares com ação “Ver todos”, Defender.
|
||||
- macOS: pacotes (`pkgutil`), serviços (`launchctl`).
|
||||
- Postura/Alertas: CPU alta, serviço parado, SMART em falha com severidade e última avaliação.
|
||||
- Zona perigosa: ação para excluir a máquina (revoga tokens e remove inventário).
|
||||
- Ação administrativa extra: botão “Ajustar acesso” permite trocar colaborador/gestor e e-mail vinculados sem re-provisionar a máquina.
|
||||
|
||||
## Exportação
|
||||
- Exportar CSV de softwares ou serviços diretamente da seção detalhada (quando disponíveis).
|
||||
|
||||
## Notas
|
||||
- Os dados vêm de duas fontes:
|
||||
- Agente desktop (Tauri): envia inventário básico + estendido por SO via `POST /api/machines/heartbeat`.
|
||||
- FleetDM (osquery): opcionalmente, via webhook `POST /api/integrations/fleet/hosts`.
|
||||
- Postura é avaliada no servidor (Convex) a cada heartbeat/upsert. Tickets automáticos podem ser gerados se habilitado.
|
||||
Loading…
Add table
Add a link
Reference in a new issue