Skip to main content

​
Inteligência que organiza, atende e faz acontecer

A Orquena é uma plataforma SaaS modular planejada para empresas de serviços. O primeiro produto conecta WhatsApp, atendimento humano, agendamento e inteligência artificial em uma operação única e controlada.

​
Primeiro produto

A experiência inicial atende barbearias, salões, estética e outros negócios que trabalham com horário marcado. O proprietário poderá:
  • Entrar com Google ou email.
  • Configurar a empresa por um onboarding guiado.
  • Conectar o WhatsApp por QR Code.
  • Continuar o setup enquanto contatos e conversas recentes sincronizam.
  • Cadastrar serviços, profissionais e horários.
  • Conectar Google Calendar opcionalmente.
  • Operar a Inbox de forma manual.
  • Receber sugestões de resposta no modo Assistente.
  • Ativar uma secretária automática após testar o simulador.
  • Acompanhar conversas, agenda e status no dashboard.
Toda Inbox começa com IA desligada. A IA automática só atua através de ferramentas autorizadas e não inventa preço, disponibilidade, profissional, desconto ou política.

​
Mapa de leitura

Produto

Jornada inicial, onboarding, Inbox, agenda, IA e dashboard.

Arquitetura

Tenancy, processos, fontes da verdade, eventos e limites.

Capacidades

Domínios, plugins, providers, agentes e conectores.

Operações

Segurança, qualidade, ambientes, observabilidade e contribuição.

Decisões

ADRs aceitos, governança e decisões ainda necessárias.

Roadmap

Sequência de implementação baseada em dependências.

​
Modelo documental

A documentação utiliza duas profundidades principais:
As páginas simples não substituem os documentos específicos. Desenvolvedores e agentes devem chegar até o PRD, ADR, contrato ou README da área antes de implementar.

​
Estado atual

O projeto continua documentation-first. As regras de produto e arquitetura estão sendo fechadas antes do bootstrap executável. Já estão definidos:
  • Produto Orquena e domínio orquena.com.
  • Documentação publicada em docs.orquena.com.
  • Tenant por loja operada separadamente.
  • Onboarding, Inbox, Scheduling, Google Calendar e modos da IA.
  • Better Auth, PostgreSQL, BullMQ/Valkey, Mastra e WAHA como direções iniciais.
  • Contratos de segurança, eventos, jobs, plugins e providers.
Ainda não existem aplicações executáveis, schema operacional, providers implantados ou piloto ativo.

​
Invariantes essenciais

  • Organization é a fronteira de dados do negócio.
  • Account ou group membership não concedem acesso automático ao tenant.
  • PostgreSQL é a fonte da verdade do estado de negócio.
  • WAHA é provider substituível, não domínio.
  • Orquena Inbox é a fonte canônica das conversas normalizadas.
  • Scheduling decide disponibilidade de forma determinística.
  • AI Runtime não acessa tabelas diretamente.
  • COPILOT nunca envia uma sugestão sozinho.
  • Atendimento humano ou pausa bloqueiam respostas automáticas.
  • Falha de provider não apaga nem desfaz estado canônico já confirmado.
Consulte Estado do projeto para a lista completa do que está decidido e do que ainda não foi implementado.