AEX Engineering
ExamplesSample project

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.

1 min de leitura

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 up

Detalhes das variáveis: docs/ENVIRONMENT.md

Testes

npm test

Estrutura

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

Documentação

DocumentoConteúdo
PROJECT_CONTEXT.mdContexto de negócio e do problema.
CLAUDE.mdRegras para a IA no repositório.
docs/PRD.mdRequisitos do produto.
docs/ARCHITECTURE.mdArquitetura e decisões estruturais.
docs/API.mdEndpoints, contratos e exemplos.
docs/DATABASE.mdModelo de dados e relações.
docs/DEPLOY.mdProcesso de publicação.
docs/ENVIRONMENT.mdVariáveis de ambiente.
docs/DECISIONS.mdRegistro de decisões técnicas.
docs/CHANGELOG.mdHistó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

On this page