Skip to main content

​
Capacidades

A Orquena separa negócio, infraestrutura e integrações para que cada parte tenha uma fonte da verdade clara e possa evoluir sem controlar o restante da plataforma.
Uma capacidade documentada pode estar selecionada ou planejada sem estar implementada. O estado de cada área deve ser confirmado no documento específico e no código existente.

​
Vocabulário de status

​
Capacidades first-party

​
Dependências importantes

Uma capacidade consome contratos públicos de outra. Ela não copia a tabela, identidade ou regra que pertence ao domínio original.

​
Providers selecionados ou planejados

Providers traduzem APIs, tokens, webhooks, rate limits e falhas. Eles não determinam autorização, tenant, estado de conversa, disponibilidade ou regras comerciais.

​
Pacotes de IA

O AI Runtime executa agentes versionados, mas os fatos críticos continuam nos domínios. Pacotes planejados:
  • Receptionist: saudação, triagem e informações gerais aprovadas.
  • Scheduling Assistant: disponibilidade, hold, confirmação, reagendamento e cancelamento.
  • Support Assistant: dúvidas operacionais e handoff.
  • Sales Assistant: contexto comercial futuro, sem inventar desconto ou proposta.
Cada pacote define:
  • Papel e limites.
  • Tools permitidas.
  • Templates e versões.
  • Políticas e aprovações.
  • Avaliações.
  • Fallback e rollback.
Organizações não recebem acesso livre a system prompts, modelos arbitrários ou tools privilegiadas.

​
Integrações externas e referências

Aplicações externas mantêm banco e lifecycle próprios. Qualquer sincronização declara uma direção:
BIDIRECTIONAL nunca é o default. Ele exige versionamento, política de conflito, tombstones, deduplicação, reconciliação e prevenção de loops.

​
Composição do primeiro vertical

O vertical de appointments combina:
O vertical define onboarding, defaults e experiência. Ele não duplica as regras internas de cada domínio.

​
Critérios para adotar uma dependência

Antes de selecionar biblioteca, provider ou aplicação externa, avaliar:
  • Licença e distribuição.
  • Manutenção e releases.
  • Segurança e advisories.
  • API, webhooks e autenticação.
  • Tenancy e data ownership.
  • Rate limits e garantias de entrega.
  • Portabilidade, backup e restore.
  • Upgrade, rollback e custo operacional.
  • Source of truth e reconciliação.
Uma prova de conceito que apenas recebe resposta da API não é suficiente para adoção.

​
Acesso aos detalhes

Plugins

Manifest, lifecycle, capabilities e isolamento.

AI Runtime

Tools, modelos, memória, políticas e avaliações.

WAHA

Sessões, QR Code, webhooks e riscos do provider.

Google Calendar

OAuth, mappings, idempotência e direção inicial.

CRM

Domínio nativo progressivo e conectores avaliados.

Automação

Regras críticas nativas e integração opcional.
Os READMEs em plugins/, packages/, apps/, infra/ e verticals/ continuam documentando limites específicos e não são substituídos por este catálogo resumido.