# Alinhou — Documentacao Completa

> Agendamento inteligente via WhatsApp para profissionais a domicilio no Brasil

## Sobre o Alinhou

Alinhou e uma plataforma SaaS de agendamento online projetada especificamente para profissionais autonomos que atendem a domicilio no Brasil. O sistema resolve tres problemas criticos: (1) organizar agenda sem depender de caderninho ou WhatsApp, (2) calcular automaticamente a taxa de deslocamento entre atendimentos, e (3) reduzir no-shows com lembretes automaticos via WhatsApp.

O nome "Alinhou" vem da geria brasileira que significa "deu certo", "combinou" — refletindo a simplicidade de agendar um servico.

## Como Funciona

### Para o Profissional
1. Cadastra-se e configura seus servicos, precos e horarios de atendimento
2. Recebe um link exclusivo (ex: alinhou.com.br/vitao-barber)
3. Compartilha o link no WhatsApp, Instagram ou cartao de visita
4. Recebe agendamentos automaticamente no painel
5. Lembretes sao enviados via WhatsApp para o cliente antes do atendimento
6. Taxa de deslocamento e calculada automaticamente com base na distancia

### Para o Cliente
1. Acessa o link do profissional pelo celular
2. Escolhe o servico, data e horario disponivel
3. Informa o endereco (para atendimento a domicilio)
4. Ve o valor total incluindo taxa de deslocamento
5. Confirma o agendamento
6. Recebe lembrete via WhatsApp antes do atendimento

## Funcionalidades Detalhadas

### Agendamento Online
- Link exclusivo personalizavel para cada profissional
- Calendario com slots disponiveis em tempo real
- Suporte a multiplos servicos com duracoes e precos diferentes
- Conflito de horario detectado automaticamente
- Reagendamento e cancelamento pelo painel

### Calculo de Deslocamento
- Integracao com Google Maps Distance Matrix (planos Pro e Business)
- Fallback Haversine com fator de correcao 1.4x para cidades brasileiras
- Taxa calculada automaticamente antes da confirmacao do cliente
- Configuravel: valor por km, taxa minima, raio maximo de atendimento
- Disponivel em todos os planos (basico por Haversine, preciso por Distance Matrix)

### Lembretes via WhatsApp
- Lembretes automaticos configuraaveis (24h, 2h antes do atendimento)
- Integracao com Evolution API (WhatsApp Business)
- Monitoramento de conexao com auto-reconnect
- Templates personalizaveis

### Auto-Confirmacao
- Tres modos: sempre ligado, fora do expediente, ou sempre manual
- Configuravel por faixa horaria
- Agendamentos auto-confirmados sao marcados como tal no painel

### Gestao de Clientes
- Base de clientes com historico de atendimentos
- Busca e filtros por nome, telefone, data
- Informacoes de endereco salvas para proximos agendamentos

### Dashboard e Metricas
- Visao geral: agendamentos do dia, semana, mes
- Metricas financeiras: receita, ticket medio, taxa de no-show
- Filtros por periodo e status
- Graficos de tendencia

### Monetizacao (Stripe)
- Checkout integrado com Stripe
- Pagamento por cartao de credito, PIX e boleto
- Portal do assinante (trocar plano, cancelar, ver faturas)
- Webhook para sincronizacao de status

## Planos e Precos

### Starter — R$39/mes (ou R$374/ano com 20% desconto)
- Ate 100 agendamentos por mes
- Ate 10 servicos
- Ate 300 clientes
- Calculo de deslocamento basico (Haversine)
- Lembretes WhatsApp
- Painel de gestao completo

### Pro — R$79/mes (ou R$758/ano com 20% desconto)
- Ate 400 agendamentos por mes
- Servicos ilimitados
- Clientes ilimitados
- Calculo de deslocamento preciso (Google Maps Distance Matrix)
- Tudo do Starter

### Business — R$159/mes (ou R$1.526/ano com 20% desconto)
- Agendamentos ilimitados
- Tudo do Pro
- Recursos avancados (em desenvolvimento)

### Teste Gratuito
- 7 dias de teste gratuito em qualquer plano
- Sem necessidade de cartao de credito para comecar

## Stack Tecnica

- Frontend: Next.js (React) com Tailwind CSS e shadcn/ui
- Backend: Fastify rodando em AWS Lambda
- Banco de dados: PostgreSQL (Neon serverless)
- WhatsApp: Evolution API
- Pagamentos: Stripe
- Infraestrutura: AWS (Lambda, EventBridge, SQS) via SST v3
- Deploy: Vercel (frontend) + AWS Lambda (backend)

## Perguntas Frequentes

### Preciso baixar algum app?
Nao. Alinhou funciona no navegador, no celular ou computador. Seus clientes tambem agendam sem instalar nada.

### Como meus clientes vao agendar?
Voce recebe um link exclusivo (ex: alinhou.com.br/joao-barbeiro). Compartilha no WhatsApp, Instagram ou imprime num cartao.

### Como funciona a taxa de deslocamento?
Voce define sua area de atendimento e o valor por km. O Alinhou calcula a distancia automaticamente e mostra pro cliente antes de confirmar.

### Posso usar no celular?
Sim. O painel funciona em qualquer celular. Foi feito pensando em quem trabalha na rua.

### Posso mudar de plano depois?
Sim, a qualquer momento. Upgrade ou downgrade com ajuste proporcional.

### E se o cliente cancelar?
Com o plano Business, voce pode exigir deposito antecipado. Se cancelar, voce nao perde.

### Quanto tempo demora para configurar?
Menos de 5 minutos. Cadastro, configura servicos e horarios, e ja pode compartilhar seu link.

### Funciona para saloes com mais de um profissional?
Atualmente o Alinhou e otimizado para profissionais autonomos. Suporte a equipes esta no roadmap.

## Contato

- Site: https://www.alinhou.com.br
- Email: suporte via painel do dashboard
- WhatsApp: integrado no sistema