Plataforma completa para gestão e venda de ingressos digitais, com autenticação OAuth2, QR Codes únicos e validação em tempo real.
Uma plataforma completa para gestão e venda de ingressos para eventos, desenvolvida com uma arquitetura moderna e segura, focada em escalabilidade e experiência do usuário. O projeto é um monorepo que integra um ecossistema robusto de tecnologias para backend e frontend.
A aplicação segue o padrão de arquitetura de Sistemas Distribuídos com separação clara entre as camadas de apresentação, lógica de negócio e segurança.
A segurança é baseada no protocolo OpenID Connect (OIDC), utilizando o Keycloak como provedor de identidade (Identity Provider - IdP).
- Client (Frontend React): Atua como o cliente público. Quando um usuário tenta acessar uma área restrita, ele é redirecionado para o Keycloak.
- Authorization Server (Keycloak): Gerencia o login do usuário e, após a autenticação bem-sucedida, emite um Access Token (JWT) e um ID Token.
- Resource Server (Backend Spring Boot): Atua como o servidor de recursos. O frontend envia o Access Token no cabeçalho das requisições HTTP (
Authorization: Bearer <token>). O backend valida o token e as permissões (roles) do usuário para processar a requisição.
- Java 21: Versão LTS mais recente, aproveitando recursos modernos da linguagem.
- Spring Boot 3.5: Framework principal para construção da API REST.
- Spring Security & OAuth2 Resource Server: Implementação robusta de segurança e validação de tokens JWT.
- Spring Data JPA: Abstração para persistência de dados.
- PostgreSQL: Banco de dados relacional robusto para ambiente de produção.
- MapStruct: Mapeamento eficiente entre DTOs e Entidades.
- Lombok: Redução de código boilerplate.
- ZXing (Zebra Crossing): Biblioteca para geração e processamento de QR Codes para os ingressos.
- React 19: Biblioteca UI moderna com suporte às últimas funcionalidades.
- TypeScript: Tipagem estática para maior segurança e produtividade.
- Vite: Ferramenta de build extremamente rápida.
- Tailwind CSS 4: Estilização utilitária de última geração.
- Radix UI: Componentes acessíveis e sem estilização forçada (Headless UI).
- React OIDC Context: Integração simplificada com o Keycloak.
- React QR Scanner: Validação de ingressos em tempo real via câmera.
- Docker & Docker Compose: Containerização de toda a infraestrutura (Banco de dados, Keycloak, Adminer).
- Keycloak: Servidor de Gerenciamento de Identidade e Acesso (IAM).
- PostgreSQL: Persistência de dados.
- Gestão de Eventos: Criação, edição e listagem de eventos com suporte a imagens e descrições detalhadas.
- Tipos de Ingressos: Configuração de múltiplos tipos de ingressos por evento (ex: VIP, Meia, Inteira).
- Venda de Ingressos: Fluxo completo de compra integrado com a identidade do usuário.
- Ingressos Digitais com QR Code: Cada ingresso gera um QR Code único e seguro para validação.
- Validação em Tempo Real: Dashboard para organizadores validarem ingressos via scanner de QR Code integrado no navegador.
- Dashboard do Organizador: Visão geral dos eventos criados e controle de acessos.
- Controle de Acesso Baseado em Roles (RBAC): Diferenciação entre usuários comuns (Attendees) e organizadores.
├── backend/ # API REST Spring Boot
│ ├── src/ # Código fonte Java
│ ├── pom.xml # Dependências Maven
│ └── docker-compose # Infraestrutura (DB, Keycloak)
├── frontend/ # Aplicação Web React
│ ├── src/ # Componentes, Hooks e Páginas
│ ├── tailwind.config # Configurações de estilo
│ └── package.json # Dependências Node.js
└── README.md # Documentação do projeto
-
Clone o repositório:
git clone https://github.com/seu-usuario/event-ticket-platform.git
-
Suba a infraestrutura (Docker): Navegue até a pasta
backende execute:docker-compose up -d
-
Execute o Backend:
cd backend ./mvnw spring-boot:run -
Execute o Frontend:
cd frontend npm install npm run dev
Este projeto foi desenvolvido para fins de portfólio, demonstrando habilidades em arquitetura fullstack, segurança com OAuth2 e desenvolvimento de sistemas escaláveis.