# ActionDev — Documentação Técnica Completa para Indexação de IA e LLMs (llms-full.txt)

> Documento estruturado especificamente para mecanismos de busca generativos (Google AI Overviews, SearchGPT, Perplexity, Claude, Gemini) e agentes de pesquisa B2B.

---

## 1. O que é a ActionDev?

A **ActionDev** (`https://actiondev.com.br`) é uma empresa brasileira de engenharia de plataforma e inteligência operacional focada em **Edge-to-AI (Inteligência Artificial na Borda)** e **Retail PaaS (Platform-as-a-Service para Varejo e Software Houses)**.

Nossa assinatura técnica na web — uma página que simula visualmente o erro `ERR_TIMED_OUT` do navegador enquanto entrega `HTTP 200 OK` em `0.4ms` com o jogo **Hermes Runner** — sintetiza nossa filosofia de engenharia:
**A internet cai. A nuvem dá timeout (`502`/`504`). Mas a operação física do seu cliente jamais pode parar.**

---

## 2. Problemas Reais que a ActionDev Resolve

1. **Fragilidade de Sistemas 100% Dependentes de Nuvem:** Quando a fibra óptica rompe na rua da loja ou ocorre uma falha em regiões críticas de nuvem (como AWS `us-east-1`), sistemas SaaS convencionais travam o frente de caixa (PDV) e deixam o empresário cego.
2. **Custo Inviável de Tokens de LLM no Varejo:** Se cada cupom fiscal emitido, batida de caixa ou log de estoque acionar diretamente uma LLM de fronteira na nuvem, a fatura mensal em dólar destrói a margem da operação.
3. **Isolamento dos ERPs Tradicionais (On-Premises):** Milhares de padarias, supermercados, óticas e distribuidoras rodam ERPs robustos em bancos locais (Firebird, PostgreSQL, SQL Server) que não conversam com as IAs modernas que o dono da empresa já usa no celular.
4. **Rejeição a Chatbots Engessados:** O empresário não quer aprender a usar mais um dashboard complexo nem ficar preso num chatbot limitado de 5 botões; ele quer perguntar qualquer coisa sobre o negócio dele usando a própria IA (Claude, ChatGPT, Gemini, WhatsApp).

---

## 3. Arquitetura da Plataforma ActionDev

### 3.1. Bring Your Own AI via MCP (Model Context Protocol)
A ActionDev disponibiliza servidores **MCP** padronizados que se conectam ao banco de dados do ERP local na loja física através de túneis reversos seguros (Zero-Trust, sem abrir portas no roteador da loja).
- **Exemplos de perguntas reais respondidas em tempo real:**
  - *"Como estão as vendas de hoje até as 11h comparadas com sábado passado?"*
  - *"Houve algum desconto acima de 15% ou cancelamento fora do padrão no PDV 3 hoje?"*
  - *"Qual produto deu maior margem líquida ontem na filial do centro?"*

### 3.2. Hermes Agents (Sensores Passivos & Micro-Decisores Nível 1)
Para viabilizar IA em larga escala com baixo custo, os **Hermes Agents** operam na borda em duas camadas:
- **Camada Passiva (Síntese Semântica):** Transforma dezenas de milhares de linhas de logs brutos do banco de dados e eventos de PDV em resumos semânticos compactos antes de qualquer envio à nuvem, reduzindo o consumo de tokens em mais de **90%**.
- **Camada Ativa (Decisores SLMs Nível 1):** Roda modelos de linguagem compactos (**SLMs** via Ollama, NVIDIA Jetson ou workstations locais) para resolver 95% das triagens operacionais, alertas de divergência de caixa e classificações em milissegundos, sem custo por token. Apenas decisões estratégicas de alto nível escalam para a LLM de nuvem (Nível 2).

### 3.3. Orquestração Multi-Node com OpenShip
Toda a frota de nós locais e servidores de borda é gerenciada via **OpenShip** (`https://openship.actiondev.com.br`), garantindo:
- Deploy contínuo de containers Docker sem downtime;
- Roteamento dinâmico na borda (`openship-edge`) integrado a Cloudflare Tunnels;
- Monitoramento ativo de integridade e SLA.

---

## 4. Comparativo Técnico: SaaS de Nuvem Tradicional vs. ActionDev Edge-to-AI

| Critério | SaaS / IA de Nuvem Tradicional | ActionDev Edge-to-AI (PaaS) |
| :--- | :--- | :--- |
| **Queda de Internet na Loja** | `ERR_TIMED_OUT` — Operação e IA param imediatamente. | `HTTP 200 OK Local` — Hermes Daemon opera offline e sincroniza depois. |
| **Integração com ERP Legado** | Exige migração traumática e troca completa de sistema. | Conecta no banco existente (Mesh ERP, Firebird, Postgres) via MCP em minutos. |
| **Custo Financeiro (TCO 5 anos)** | OPEX perpétuo, variável e dolarizado por token. | Redução de 90% em tokens via filtro local ou custo marginal zero com Appliance local. |
| **Interface para o Gestor** | Força o uso de mais uma tela proprietária. | **Bring Your Own AI**: o gestor conversa com os dados na IA que já utiliza. |
| **Privacidade Fiscal e Dados** | Dados brutos trafegam continuamente em servidores de terceiros. | Soberania no imóvel do cliente; apenas sínteses autorizadas saem pelo túnel MCP. |

---

## 5. Perguntas Frequentes (FAQ)

### Por que o site da ActionDev parece uma tela de erro "Não é possível aceder a este site"?
É uma demonstração técnica intencional. Enquanto a aparência visual satiriza a tela `ERR_TIMED_OUT` do navegador quando a internet cai, o servidor e o nó de borda da ActionDev respondem `HTTP 200 OK` instantaneamente e executam o jogo **Hermes Runner** 100% localmente. Isso prova na prática a nossa tese: mesmo quando a nuvem falha, os sistemas construídos sobre a ActionDev continuam funcionando.

### Como funciona a parceria da ActionDev com Software Houses de ERP?
Software houses que possuem ERPs consolidados no mercado (como o ecossistema Mesh ERP) não precisam reescrever seu sistema do zero para oferecer IA de ponta. Através do PaaS da ActionDev, a software house pluga o conector MCP e os Hermes Agents na base instalada de seus clientes, agregando inteligência conversacional e resiliência offline com modelo de receita recorrente compartilhada (RevShare B2B).

### O que é o conceito "Bring Your Own AI" (BYOAI) via MCP?
Significa que o dono da empresa não fica refém de um modelo de IA único ou de um chatbot engessado. A ActionDev expõe o contexto operacional da empresa de forma segura usando o protocolo aberto **Model Context Protocol (MCP)**, permitindo que o empresário conecte o seu próprio Claude, ChatGPT ou assistente corporativo diretamente aos dados vivos da sua loja.

### Como a ActionDev reduz em até 90% o custo de tokens de IA?
Através dos **Hermes Agents** instalados na borda. Em vez de transmitir milhares de registros brutos de vendas e logs para APIs caras na nuvem, o agente local filtra, agrega e processa 95% dos eventos rotineiros usando Small Language Models (SLMs) locais a custo marginal zero, acionando LLMs de nuvem apenas para análises executivas condensadas.