Skip to main content

​
Estado do projeto

A Orquena está na fase de arquitetura, especificação e preparação do bootstrap técnico.

​
Identidade do produto

  • Nome: Orquena.
  • Domínio principal: orquena.com.
  • Documentação: docs.orquena.com.
  • Repositório oficial: Fulixts/Orquena.
  • Namespace privado planejado: @orquena/*.

​
Produto inicial definido

O primeiro produto completo será uma central de atendimento para empresas de serviços com:
  • Login com Google ou email.
  • Onboarding guiado, retomável e com porcentagem calculada no backend.
  • Conexão antecipada do WhatsApp por QR Code.
  • Sincronização limitada de contatos e conversas recentes em segundo plano.
  • Orquena Inbox para atendimento humano.
  • Serviços, profissionais, horários, disponibilidade e appointments.
  • Google Calendar opcional e separado do login.
  • IA desligada, assistente ou automática.
  • Override por conversa.
  • Handoff com resumo e continuidade no mesmo chat.
  • Simulador antes de ativar a IA automática.
  • Dashboard baseado nas capacidades habilitadas.

​
Já definido

  • Plataforma SaaS modular orientada a plugins.
  • CustomerAccount como relação comercial e billing container.
  • Uma Organization tenant para cada loja operada separadamente.
  • Cliente externo sem conta no painel.
  • Monólito modular antes de microsserviços.
  • Next.js como candidato para o frontend.
  • NestJS com Fastify como candidato para a API.
  • Better Auth com Google Login e email/senha.
  • PostgreSQL como fonte principal de dados.
  • BullMQ sobre Valkey como adapter inicial de jobs.
  • Contrato genérico de storage S3-compatible.
  • Mastra como framework inicial do AI Runtime.
  • OpenTelemetry e Grafana stack para observabilidade.
  • WAHA como primeiro provider não oficial para desenvolvimento e pilotos controlados.
  • Google Calendar como primeira integração externa de agenda.
  • Docker Compose em VPS como primeira estratégia de implantação.
  • Documentação e ADRs obrigatórios para mudanças arquiteturais.

​
Decisões de produto e arquitetura

​
Existe no repositório

  • Estrutura documental de apps/, packages/, plugins/, verticals/ e infra/.
  • Documentação Mintlify publicada em docs.orquena.com.
  • Specification Pack v1.
  • PRD do vertical de agendamentos.
  • PRD de onboarding, Inbox e modos da IA.
  • Contrato de controle humano e IA por conversa.
  • Páginas públicas de onboarding, Inbox, IA e Google Calendar.
  • Modelo conceitual de dados.
  • Threat model.
  • Contratos de plugins, eventos e jobs.
  • Política e pesquisa open source.
  • Roadmap alinhado com o MVP operacional.

​
Ainda não implementado

  • Workspace pnpm e Nx executável.
  • Aplicações Next.js e NestJS.
  • Schema PostgreSQL e migrations.
  • Better Auth operacional e Google OAuth client.
  • Customer accounts, organizations, memberships e RBAC.
  • Onboarding e progresso.
  • Row-Level Security.
  • Contacts, Scheduling e Orquena Inbox.
  • AI Runtime Mastra e simulador.
  • WAHA provider e sincronização inicial.
  • Google Calendar provider.
  • BullMQ, Valkey e outbox.
  • Object storage.
  • Observability stack.
  • Docker Compose operacional.
Uma pasta, README, ADR ou página de documentação descreve intenção aceita. Ela não significa que a funcionalidade já esteja disponível.

​
Próximo marco

  • Fechar ADRs técnicos de monorepo, banco e lifecycle mínimo de capacidades.
  • Iniciar o bootstrap executável.
  • Implementar identidade e tenancy antes do onboarding.
  • Seguir a sequência definida no roadmap até o piloto.
Triagem de marca, domínio defensivo, redes sociais e integrações externas do repositório continuam como atividades paralelas e não bloqueiam o desenvolvimento privado.