feat: initial commit - Carinha Control Panel v1.0 com UI glassmorphism, watch-bar, emojis, braco robotico e conversa IA

docs/GEMINI.md

@@ -0,0 +1,21 @@
+# Gemini no Carinha — 2026-10-05
+
+Conversa pelo Gemini configurada no Orange Pi. Modelo atual: gemini-flash-lite-latest. O alias solicitado gemini-flash-latest e os modelos Flash 3.7/3.8 retornaram HTTP 503 com mensagem de alta demanda. Flash Lite respondeu nos testes, por isso é a opção ativa.
+
+## Uso
+
+Atualize /painel. Em Conversar com o Carinha, escolha Gemini ou Qwen local. Não é necessário atualizar o APK: o celular continua recebendo texto e expressão do Orange Pi. Gemini precisa de internet. A chave fica em /etc/carinha-gemini.env, permissão 600, carregada por EnvironmentFile no serviço. Nunca é enviada ao navegador/APK nem devolvida nas rotas de status. Configuração do provedor em /opt/carinha-pc/conversa-config.json. A variável GEMINI_MODEL permite fixar um modelo em vez de usar alias.
+
+## Memória e privacidade
+
+O histórico e as lembranças permanecem no SQLite do Orange Pi. Ao escolher Gemini, até três pares completos de conversa e as lembranças são enviados ao Google junto da mensagem atual. Chamadas que falharam continuam visíveis no painel, mas não entram como perguntas pendentes no contexto. Mensagens antigas do executor local não são enviadas ao Gemini. O horário continua vindo do relógio do servidor.
+
+O plano gratuito tem cotas e condições próprias de uso dos dados: https://ai.google.dev/gemini-api/terms . Integração REST documentada em https://ai.google.dev/gemini-api/docs/structured-output . Erros 429/503 aparecem no painel; não há troca silenciosa para outro provedor ou repetição automática de chamadas.
+
+## Verificação
+
+Respostas reais: “está bravo?” → “Eu? Nunca! Meus circuitos só sabem espalhar alegria por aí.” (1,23 s); música → “Adoro música! Os sons parecem pequenas engrenagens dançando na minha mente metálica.” (0,84 s). Valores são medições pontuais, sem garantia de latência. Respostas limitadas a JSON texto/gesto, validadas antes de renderizar; nenhum comando de motores.
+
+A API retorna a resposta completa e o balão faz escrita animada; transmissão de tokens ainda não implementada. A personalidade automática por sensores continua no Qwen local; Gemini neste incremento controla a conversa por texto.
+
+Rollback: selecione Local no painel. Para remover a credencial, remova o EnvironmentFile e o drop-in gemini.conf e reinicie o serviço após daemon-reload. Não apague memoria.db: ela contém histórico e lembranças.