# Kelpie OS (VetFlow) — Contexto Estratégico & Alinhamento Completo

> **Proprietária:** Emily Kelda | **Parceiro Técnico:** Daniel  
> **Domínio do Portal & Repositório:** `https://kelpie.dlmidia.com.br`  
> **Painel Operacional (App Docker):** `https://vetflow.dlmidia.com.br`

---

## 1. Identidade & Naming: Kelpie Australiano (`K-E-L-P-I-E`)

Durante o alinhamento entre Daniel e Emily, avaliou-se conectar a marca a uma raça canina reconhecida por inteligência e trabalho:

- **Kelpie Australiano (`K-E-L-P-I-E`) — Escolha Principal:**
  - Cão de pastoreio australiano famoso pelo hiperfoco, energia incansável, agilidade e precisão na condução do rebanho.
  - Cria conexão direta com o sobrenome da fundadora (**Emily Kelda** ↔ **Kelpie**), unindo identidade afetiva do mercado pet com posicionamento tecnológico (`Kelpie OS`, `Kelpie Flow`, `Powered by Kelpie Intelligence`).
- **Border Collie (`Border`):** alternativa considerada pelo ranking de inteligência do Dr. Stanley Coren (`BorderFlow`, `Border Vet`), mantida como referência secundária frente à força identitária de `Kelpie`.

---

## 2. Estratégia Anti-Retrabalho: Add-on de Alto Impacto

**Dor levantada pela Emily:** clínicas já usam ERPs como SimplesVet, Vetwork ou sistemas locais. Se a equipe precisar redigitar agendamentos do WhatsApp para o sistema atual, a adoção trava.

**Decisão de Produto:** o Kelpie / VetFlow não exige troca imediata do ERP da clínica. Ele atua como uma **camada de inteligência acima do sistema existente**, operando por três vias conforme a maturidade técnica do software da clínica:

1. **API Pública / Webhooks Oficiais:** conexão direta quando o ERP moderno fornece REST/GraphQL documentado.
2. **MCP (Model Context Protocol):** interface padronizada onde a IA consulta e executa apenas ferramentas explicitamente permitidas.
3. **RPA em Python (Playwright / Browser Worker) + Extensão de Apoio:**
   - Quando o sistema legado em 2026 ainda não possui API pública nem MCP (cenário comum em sistemas veterinários tradicionais que travam o ecossistema), o robô em Python opera como um funcionário digital invisível usando as mesmas telas que uma recepcionista usaria.
   - Não exige negociação ou abertura de API pelo fornecedor do ERP legado, mas requer mapeamento de seletores/requisições internas XHR e monitoramento contra mudanças de layout.

---

## 3. O Caso Piloto: Clínica & Creche com Plano Petlove

A amiga do Daniel opera uma clínica + creche integrada ao ecossistema **Plano de Saúde Petlove** (que também controla o **SimplesVet**):

- **Por que é estratégico:** validar fluxos reais de consulta de guia, cobertura/coparticipação e agendamento na ponta cria a base do conector aplicável a milhares de clínicas credenciadas.
- **Rotina de Creche & Receita Recorrente:** controle automático de vacinas obrigatórias (V8/V10, Antirrábica, Giárdia, Tosse dos Canis) e vermifugação, com disparos preventivos do **Care Coordination Agent** 15 dias antes do vencimento.

---

## 4. Roadmap de Aplicativos Nativos (Android & iOS)

Para tirar o gestor e o tutor da dependência do navegador e habilitar notificações push + acesso rápido:

- **Stack Recomendada:** React Native + Expo (TypeScript) consumindo endpoints seguros da VPS (`https://vetflow.dlmidia.com.br/api` / `https://kelpie.dlmidia.com.br`).
- **Requisito de Build:**
  - **macOS** é obrigatório para compilar e assinar o binário **iOS** no Xcode / TestFlight / App Store (e também compila Android via Android Studio).
  - **Windows / Linux** compilam Android localmente, dependendo de build remoto na nuvem (ex.: EAS Build) caso queiram gerar iOS.

---

## 5. Segurança & Governança (Resumo Executivo)

- **Não armazenar segredos em páginas públicas ou bundle cliente:** chaves SSH, senhas de PostgreSQL, `WHATSAPP_VERIFY_TOKEN` e chave do cofre AES-256-GCM devem existir apenas em `.env` privados no servidor / cofre local.
- **Painel administrativo sempre autenticado** antes de ir para produção com clientes reais, além de verificação `X-Hub-Signature-256` da Meta no webhook e PostgreSQL Row-Level Security (`RLS`) por `tenant_id`.