> ## Documentation Index > Fetch the complete documentation index at: https://docs.orquena.com/llms.txt > Use this file to discover all available pages before exploring further. # Capacidades > Catálogo resumido de domínios, plugins, providers, agentes e integrações planejados para a Orquena. # 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 | Status | Significado | | ---------------------- | -------------------------------------------------- | | **Selected** | Direção aceita para implementação | | **Planned** | Responsabilidade prevista, ainda sem implementação | | **Future** | Deliberadamente fora do primeiro produto | | **Candidate** | Depende de prova de conceito e decisão explícita | | **Reference** | Fonte de pesquisa e UX, não source of truth | | **Watchlist** | Projeto acompanhado, mas não selecionado | | **Compatibility-only** | Suporte para migração ou instalação existente | | **Rejected** | Opção proibida na decisão atual | ## Capacidades first-party | Capacidade | Estado | Responsabilidade canônica | | --------------- | ---------------- | ----------------------------------------------------------------- | | Contacts | Planned | Identidade tenant-local, canais, preferências e consentimento | | Service Catalog | Planned | Serviços, duração, buffers e preços com vigência | | Professionals | Planned | Recursos agendáveis, elegibilidade e vínculo opcional com usuário | | Scheduling | Selected | Disponibilidade, holds, appointments, estados e políticas | | Inbox | Selected | Conversas, mensagens, atribuição, leitura e handoff | | Notifications | Planned | Intenção transacional, templates, policy e delivery history | | Calendar | Planned | Visões, mappings e interoperabilidade com Scheduling | | CRM | Future after MVP | Pipeline progressivo sem duplicar Contacts ou Inbox | | Knowledge Base | Future | Conteúdo aprovado e retrieval não transacional | | Automations | Planned | Regras e ações tipadas para processos críticos | | Campaigns | Future | Comunicação aprovada, consentida e separada do transacional | ## Dependências importantes ```text theme={null} Contacts ├── Inbox referencia participantes ├── Scheduling referencia clientes ├── CRM referencia identidade └── Notifications resolve destinos Service Catalog + Professionals ↓ Scheduling ↓ Calendar e Notifications Inbox ├── Messaging provider ├── AI Runtime └── Human handoff ``` 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 | Provider | Estado | Limite | | --------------------- | ------------------------------ | --------------------------------------------------------------- | | WAHA | Selected for controlled pilots | Transporte não oficial de WhatsApp atrás de `MessagingProvider` | | Meta Cloud API | Future | Provider oficial para requisitos de produção e escala | | Google Calendar | Selected for MVP integration | Publicação Orquena → Google inicialmente | | Microsoft Calendar | Future | Adapter posterior atrás do mesmo contrato | | AI providers | Planned | Modelos atrás do Model Router da Orquena | | S3-compatible storage | Selected contract | Managed S3 ou adapter self-hosted validado | | SeaweedFS | Candidate | Opção self-hosted sujeita a conformance e restore tests | | MinIO | Compatibility-only | Não é o default para novas instalações | | Payment providers | Future | Billing e pagamentos atrás de contratos próprios | 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 | Projeto | Papel atual | | ------------ | ----------------------------------------------------- | | Chatwoot | Referência de Inbox e possível connector opcional | | Cal.com | Referência de scheduling e possível connector futuro | | Twenty | Referência principal para CRM e possível connector | | EspoCRM | Candidate secundário de CRM | | SuiteCRM | Watchlist | | Activepieces | Candidate para automações não críticas entre sistemas | Aplicações externas mantêm banco e lifecycle próprios. Qualquer sincronização declara uma direção: ```text theme={null} ORQUENA_PRIMARY EXTERNAL_PRIMARY BIDIRECTIONAL IMPORT_ONLY ``` `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: ```text theme={null} Contacts + Service Catalog + Professionals + Scheduling + Inbox + Notifications + WAHA provider + Google Calendar provider opcional + Receptionist e Scheduling Assistant ``` 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 Manifest, lifecycle, capabilities e isolamento. Tools, modelos, memória, políticas e avaliações. Sessões, QR Code, webhooks e riscos do provider. OAuth, mappings, idempotência e direção inicial. Domínio nativo progressivo e conectores avaliados. 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.