> ## 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.

# Estado do projeto

> O que já foi decidido, pesquisado, documentado e o que ainda não foi implementado.

# Estado do projeto

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

## Nome do produto

* **Nome aceito:** Orquena.
* **Codinome histórico:** Nuvexa.
* **Domínio principal pretendido:** `orquena.com`, ainda a ser registrado.
* **Repositório oficial:** `Fulixts/Orquena`, renomeado em 27 de julho de 2026.

## 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.
* Primeiro vertical voltado a negócios com agendamento.
* Monólito modular antes de microsserviços.
* Next.js como candidato para o frontend.
* NestJS com Fastify como candidato para a API.
* Better Auth para credenciais e sessões.
* 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.
* Docker Compose em VPS como primeira estratégia de implantação.
* Documentação e ADRs obrigatórios para mudanças arquiteturais.

## Decisões após pesquisa open source

| Área           | Decisão atual                                                                  |
| -------------- | ------------------------------------------------------------------------------ |
| Authentication | Better Auth; tenancy e permissions continuam nativos                           |
| CRM            | Domínio nativo progressivo; Twenty como referência; EspoCRM connector opcional |
| Inbox          | Domínio nativo; Chatwoot como referência e connector opcional                  |
| Scheduling     | Domínio nativo e determinístico; Cal.com como referência e connector futuro    |
| Notifications  | Domínio nativo para policy, template e delivery history                        |
| WhatsApp       | WAHA Core inicialmente; Meta Cloud API no futuro                               |
| Automação      | Motor nativo para regras críticas; Activepieces opcional                       |
| Filas          | BullMQ com Valkey                                                              |
| Object storage | Managed S3 ou SeaweedFS em avaliação; MinIO apenas como compatibilidade        |
| IA             | Mastra atrás de contratos próprios da Orquena                                  |
| Observability  | OpenTelemetry, Alloy, Prometheus, Loki, Tempo e Grafana; GlitchTip opcional    |

## Existe no repositório

* Estrutura documental de `apps/`, `packages/`, `plugins/`, `verticals/` e `infra/`.
* Página Mintlify e navegação.
* READMEs detalhados por módulo.
* Política de open source.
* Pesquisa consolidada dos projetos avaliados.
* ADRs iniciais.
* Specification Pack v1.
* PRD do vertical de agendamentos.
* Modelo conceitual de dados.
* Threat model.
* Contratos de plugins, eventos e jobs.
* Decisão formal da marca Orquena.
* Repositório alinhado com o nome Orquena.

## Ainda não implementado

* Workspace pnpm e Nx executável.
* Aplicações Next.js e NestJS.
* Schema PostgreSQL e migrations.
* Better Auth operacional.
* Customer accounts, organizations, memberships e RBAC.
* Row-Level Security.
* Plugin SDK executável.
* Contacts, Scheduling, Inbox, Notifications ou CRM.
* AI Runtime Mastra.
* WAHA provider operacional.
* BullMQ, Valkey e outbox.
* Object storage.
* Observability stack.
* Docker Compose operacional.
* Deployment público do Mintlify.

<Note>
  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.
</Note>

## Próximo marco

Antes do primeiro código, ainda precisamos:

* Registrar ou confirmar a estratégia do domínio Orquena.
* Fazer a triagem de marca no INPI antes do lançamento público.
* Verificar Git remotes, Mintlify, webhooks e integrações após a renomeação do repositório.
* Fechar ADRs de monorepo, banco e plugin lifecycle.
* Validar a navegação Mintlify após o rebranding.
* Iniciar o M1 — bootstrap técnico do monorepo.