Pilot Status

Plataforma SaaS para envio e automação de mensagens (atualmente via WhatsApp).

Stack

TypeScript (Full Stack)
Next.js (App Router — Frontend + API Routes / BFF)
NextAuth (Google, GitHub)
Prisma + PostgreSQL
Redis + BullMQ
Docker (multi-stage)
Tailwind CSS

Estrutura

pilot-status/
├── apps/
│   ├── web/          # Next.js (UI + API routes)
│   └── worker/       # BullMQ worker
├── packages/
│   ├── database/     # Prisma schema + client
│   └── shared/       # Types, DTOs, logger, validation
├── docker-compose.yml
└── README.md

Como rodar

1. Clone e instale dependências por app

cp .env.example .env
# edite .env com suas credenciais

# App fullstack (Next.js + UI + API)
cd apps/fullstack
npm install

# Worker (BullMQ)
cd apps/worker
npm install

2. Subir infraestrutura (PostgreSQL + Redis)

docker compose up -d postgres redis

3. Rodar migrations e seed

Atualmente o schema Prisma fica em packages/database/prisma/schema.prisma.
Para aplicar migrations em desenvolvimento ou produção, use os comandos indicados na sua pipeline ou rode manualmente, por exemplo:

cd packages/database
npx prisma migrate deploy --schema=prisma/schema.prisma

Para popular o banco com dados de exemplo e bastante histórico para os gráficos de analytics, use o seed configurável:

# Perfil padrão de desenvolvimento / TEST (volume moderado)
SEED_PROFILE=TEST npx prisma db seed --schema=prisma/schema.prisma

# Perfil LIVE (muito mais mensagens, ideal para simular produção)
SEED_PROFILE=LIVE npx prisma db seed --schema=prisma/schema.prisma

O seed cria:

Um tenant demo (tenant_demo) com vários projetos de exemplo:
- microsaas-marketing
- sharecontent
- mcp-notify-whatsapp
- content-beauty
- git-social
- entrevistas-dev
Templates TEST e LIVE para cada projeto, com versões aprovadas.
Mensagens (messages) distribuídas nos últimos 3 meses, em ambos os ambientes (TEST e LIVE), em volume proporcional ao SEED_PROFILE, para alimentar os dashboards de analytics.

4. Rodar a aplicação (apps isolados)

Você pode rodar cada app separadamente, entrando na pasta correspondente:

# App fullstack (Next.js + UI + API)
cd apps/fullstack
npm run dev

# Worker (BullMQ)
cd apps/worker
npm run dev

No desenvolvimento local padrão:

App fullstack (Next.js) fica em http://localhost:3000 (UI + API routes no mesmo host)

5. Build para produção

docker compose up --build

Ambiente de teste vs produção

API Keys com prefixo ps_test_ → ambiente de teste
API Keys com prefixo ps_live_ → ambiente de produção
Modo teste limitado a 10 mensagens/dia (plano Gratuito)

Webhooks

Eventos e payloads: webhooks.md

Mensagens agendadas

Agendamento via deliverAt e reconciliação do worker: agendamento-mensagens.md

Produto (visão usuário)

Checklist de funcionalidades: funcionalidades-usuario.md
Telas do painel: telas.md

Planos

| Plano | Mensagens/mês | Limite diário | Preço | |----------|--------------|---------------|-------------| | Gratuito | 300 | 10/dia | Grátis | | Basic | 700 | — | R$ 29,90/mês| | Pro | 3.000 | — | R$ 99,90/mês|