Agendou
Agendamento online simples para pequenos prestadores de serviço. O profissional cria seus serviços, compartilha um link e recebe agendamentos sem precisar de telefone ou planilha.
Agendamento online simples para pequenos prestadores de serviço. O profissional cria seus serviços, compartilha um link e recebe agendamentos sem precisar de telefone ou planilha.
Exemplo da AEX Engineering. Este é um projeto fictício que demonstra os padrões da AEX aplicados na prática (estrutura, documentação e stack). Não é uma aplicação real.
Sobre
Agendou é um MVP para validar se prestadores autônomos (barbearias, clínicas, estúdios) adotam um link de agendamento self-service.
Contexto de negócio: PROJECT_CONTEXT.md
Stack
- Framework: Next.js (frontend + API routes)
- Banco de dados: Supabase (PostgreSQL + Auth)
- Infraestrutura: Docker + Coolify
Pré-requisitos
- Docker e Docker Compose
- Node 20+
- Conta e projeto no Supabase
Como rodar localmente
git clone https://github.com/aexhub/agendou.git
cd agendou
cp .env.example .env
# preencha os valores em .env
docker compose upDetalhes das variáveis: docs/ENVIRONMENT.md
Testes
npm testEstrutura
agendou/
├── src/ # Código-fonte (Next.js)
├── docs/ # Documentação técnica
├── .github/ # CI/CD
├── docker/ # Dockerfile e compose
├── README.md
├── PROJECT_CONTEXT.md
├── CLAUDE.md
└── .env.exampleDocumentação
| Documento | Conteúdo |
|---|---|
PROJECT_CONTEXT.md | Contexto de negócio e do problema. |
CLAUDE.md | Regras para a IA no repositório. |
docs/PRD.md | Requisitos do produto. |
docs/ARCHITECTURE.md | Arquitetura e decisões estruturais. |
docs/API.md | Endpoints, contratos e exemplos. |
docs/DATABASE.md | Modelo de dados e relações. |
docs/DEPLOY.md | Processo de publicação. |
docs/ENVIRONMENT.md | Variáveis de ambiente. |
docs/DECISIONS.md | Registro de decisões técnicas. |
docs/CHANGELOG.md | Histórico de mudanças por versão. |
Deploy
Deploy automático via pipeline no merge em main (GitHub → CI/CD → Docker → Coolify). Processo completo: docs/DEPLOY.md
PROJECTCONTEXT — Agendou
Pequenos prestadores de serviço agendam clientes por WhatsApp e papel. Isso gera dupla marcação, esquecimento e tempo perdido confirmando horários manualmente.
API — Agendou
Endpoints do painel exigem um token do Supabase Auth no header. Endpoints públicos (agendamento pelo link) não exigem autenticação.