feat(historico): deteccoes com foto, sensor PIR na placa e tela apagando no sono

- historico.py: eventos de PIR (gpiomon no pino 11, gpiochip1 linha 70),
  movimento e som do celular em SQLite; ate 200 eventos e 100 fotos;
  cada sensor e a foto ligam/desligam; intervalo minimo por tipo
- PIR acorda o Carinha quando ele esta dormindo
- APK 0.8.3: o app consulta o pedido de foto e envia uma foto da camera
  frontal (quadro da camera de movimento ou do video ao vivo)
- tela apaga depois de X minutos dormindo (preto total + brilho minimo no
  AMOLED); acende com som, movimento, toque, comando ou PIR
- painel: tela Historico (sensores, fotos, filtros, apagar), atalho em Ao
  vivo e no Ctrl+K, ajustes "Apagar a tela quando dormir"
- testes do historico (servico e rotas HTTP)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

web/src/lib/ajustes.svelte.ts

@@ -55,6 +55,8 @@ export const GRUPOS: { titulo: string; descricao: string; campos: Campo[] }[] =
       { chave: 'economia', rotulo: 'Reduzir brilho em repouso', tipo: 'toggle' },
       { chave: 'brilhoRepouso', rotulo: 'Brilho em repouso', tipo: 'slider', min: 0.01, max: 1, passo: 0.01 },
       { chave: 'repousoTela', rotulo: 'Espera para reduzir brilho', tipo: 'slider', min: 5, max: 300, passo: 5, unidade: ' s' },
+      { chave: 'apagarTela', rotulo: 'Apagar a tela quando dormir', ajuda: 'Tela preta e brilho mínimo; acorda com som, movimento, toque ou PIR', tipo: 'toggle' },
+      { chave: 'apagarTelaMin', rotulo: 'Dormindo há quanto tempo para apagar', tipo: 'slider', min: 1, max: 120, passo: 1, unidade: ' min' },
     ],
   },
   {

web/src/lib/estado.svelte.ts

@@ -139,6 +139,10 @@ const tratadores: Record<string, (d: any) => void> = {
     if (d?.receita?.nome) noFeed('reacao', 'Reação: ' + d.receita.nome);
   },
   treinamento: (d) => (estado.treinamento = d),
+  historico: (d) => {
+    const n = d?.novo;
+    if (n) noFeed('historico', { pir: '🚶 Presença no PIR', movimento: '👀 Movimento na câmera', som: '🔊 Som alto' }[n.tipo as string] ?? 'Detecção');
+  },
 };
 
 let fonte: EventSource | null = null;
@@ -161,7 +165,7 @@ function abrirEventos() {
     if (estado.conexao !== 'token') estado.conexao = 'caiu';
   };
   for (const tipo of ['expressao', 'telemetria', 'app_config', 'aparencia', 'motores', 'estop', 'conversa', 'ia',
-    'reacao', 'treinamento']) {
+    'reacao', 'treinamento', 'historico']) {
     fonte.addEventListener(tipo, (e) => {
       const dados = JSON.parse((e as MessageEvent).data);
       tratadores[tipo]?.(dados);

web/src/lib/historico.svelte.ts

@@ -0,0 +1,84 @@
+/** Histórico de detecções (/historico/*): recarrega ao abrir e quando o servidor avisa por SSE. */
+import { lerToken, pedir, postar } from './api';
+import { avisos } from './avisos.svelte';
+import { ouvir } from './estado.svelte';
+
+export interface EventoHistorico {
+  id: number;
+  horario: number;
+  tipo: 'pir' | 'movimento' | 'som';
+  evento: string;
+  nivel: number | null;
+  foto: boolean;
+}
+
+export interface StatusHistorico {
+  config: { pir: boolean; movimento: boolean; som: boolean; foto: boolean; intervalo: number };
+  pir: { disponivel: boolean; erro: string; linha: string; ultimo: number | null };
+  eventos: EventoHistorico[];
+  total: number;
+  max_eventos: number;
+  max_fotos: number;
+}
+
+export const TIPOS_EVENTO: Record<string, { nome: string; emoji: string; cor: string }> = {
+  pir: { nome: 'Presença (PIR)', emoji: '🚶', cor: '#34c759' },
+  movimento: { nome: 'Movimento na câmera', emoji: '👀', cor: '#0a84ff' },
+  som: { nome: 'Som alto', emoji: '🔊', cor: '#ff9500' },
+};
+
+/** URL da foto com o token na query (a tag <img> não manda cabeçalho). */
+export function urlFoto(id: number) {
+  const t = lerToken();
+  return `/historico/foto/evento-${id}.jpg` + (t ? '?t=' + encodeURIComponent(t) : '');
+}
+
+class Historico {
+  status = $state<StatusHistorico | null>(null);
+  private espera = 0;
+
+  async carregar() {
+    try {
+      this.status = await pedir<StatusHistorico>('/historico/status');
+    } catch (e) {
+      avisos.erro(e);
+    }
+  }
+
+  async configurar(parcial: Partial<StatusHistorico['config']>) {
+    const antes = this.status ? { ...this.status.config } : null;
+    if (this.status) this.status = { ...this.status, config: { ...this.status.config, ...parcial } };
+    try {
+      this.status = await postar<StatusHistorico>('/historico/config', parcial);
+    } catch (e) {
+      if (this.status && antes) this.status = { ...this.status, config: antes };
+      avisos.erro(e);
+    }
+  }
+
+  async apagar(id: number) {
+    try {
+      await postar('/historico/apagar', { id });
+    } catch (e) {
+      avisos.erro(e);
+    }
+  }
+
+  async limpar() {
+    try {
+      await postar('/historico/limpar');
+      avisos.ok('Histórico apagado.');
+    } catch (e) {
+      avisos.erro(e);
+    }
+  }
+
+  /** Vários avisos seguidos (evento + foto) viram uma recarga só. */
+  agendar() {
+    clearTimeout(this.espera);
+    this.espera = window.setTimeout(() => this.carregar(), 300);
+  }
+}
+
+export const historico = new Historico();
+ouvir('historico', () => historico.status && historico.agendar());

web/src/lib/paleta.svelte.ts

@@ -36,6 +36,7 @@ export function itensDaPaleta(): ItemPaleta[] {
 registrarNaPaleta(() => [
   ...ROTAS.map((r) => ({ id: 'ir-' + r.id, grupo: 'Ir para', titulo: r.titulo, fazer: () => nav.ir(r.id) })),
   { id: 'ir-rosto', grupo: 'Ir para', titulo: 'Rosto (estilo, formato e cor)', fazer: () => nav.ir('rosto') },
+  { id: 'ir-historico', grupo: 'Ir para', titulo: 'Histórico de detecções', fazer: () => nav.ir('historico') },
   ...estado.formatos.map((f) => ({ id: 'formato-' + f, grupo: 'Formato dos olhos', titulo: FORMATOS_INFO[f] ?? f, fazer: () => formato(f) })),
   estado.estop.ativo
     ? { id: 'rearmar', grupo: 'Ações', titulo: 'Rearmar motores', fazer: rearmar }

web/src/lib/rotas.svelte.ts

@@ -1,6 +1,6 @@
 /** Rotas por hash (#/conversa): o servidor só precisa entregar index.html em "/". */
 
-export type Rota = 'ao-vivo' | 'conversa' | 'reacoes' | 'movimento' | 'ajustes' | 'rosto';
+export type Rota = 'ao-vivo' | 'conversa' | 'reacoes' | 'movimento' | 'ajustes' | 'rosto' | 'historico';
 
 export const ROTAS: { id: Rota; titulo: string; atalho: string }[] = [
   { id: 'ao-vivo', titulo: 'Ao vivo', atalho: 'g v' },
@@ -11,7 +11,10 @@ export const ROTAS: { id: Rota; titulo: string; atalho: string }[] = [
 ];
 
 /** Páginas abertas a partir de outra tela (não aparecem na navegação). */
-export const SECUNDARIAS: { id: Rota; titulo: string; volta: Rota }[] = [{ id: 'rosto', titulo: 'Rosto', volta: 'ao-vivo' }];
+export const SECUNDARIAS: { id: Rota; titulo: string; volta: Rota }[] = [
+  { id: 'rosto', titulo: 'Rosto', volta: 'ao-vivo' },
+  { id: 'historico', titulo: 'Histórico', volta: 'ao-vivo' },
+];
 
 export const tituloDa = (id: Rota) => [...ROTAS, ...SECUNDARIAS].find((r) => r.id === id)?.titulo ?? '';