[EN] | [PT]

🚌 BussPass

📝 Table of Contents

• Description
• Technologies
• Installation
• Usage
• Contributions
• License
• Contact

📖 Description

BussPass is a fullstack application for managing bus reservations for tourism excursions. Designed for travel agencies and tour operators, it provides an intuitive experience for customers and robust administration tools for the business side.

Key features include:

• Trip search by destination and date
• Interactive seat map
• Online reservations
• PIX payments (in progress)
• Booking lookup via reservation code
• Admin portal for trip and fleet management
• REST API with Swagger documentation
• Responsive UI built with modern technologies

🛠 Technologies

Frontend

• Next.js 14 (App Router)
• TypeScript
• TailwindCSS + ShadCN/UI
• Zustand
• React Hook Form + Zod

Backend

• Python 3.11+
• FastAPI
• SQLAlchemy 2.0
• Pydantic v2
• JWT + Bcrypt Auth
• Alembic (migrations)

Database

• PostgreSQL 15+
• SQLite (for development)
• Redis (planned)

DevOps

• Docker + Docker Compose
• Traefik (reverse proxy)
• GitHub Actions (CI/CD - planned)

⚙ Installation

Prerequisites

• Docker and Docker Compose installed

Step-by-step

# Clone the repository
git clone https://github.com/matfurrier/buspass.git
cd buspass

# Run containers
docker-compose up --build

The app will be available at:

• Frontend: http://localhost:3000
• Backend API docs: http://localhost:8000/docs

🎮 Usage

For Customers:

• Search for trips by date and destination
• View available seats on a bus map
• Reserve a seat online
• Confirm via PIX payment (in development)
• Check reservation using code
• Notifications via WhatsApp and email (planned)

For Admins:

• Manage trips (create/edit/delete)
• Manage bus fleet
• Control reservations
• Dashboard with metrics (in development)
• Reports on sales, occupancy and revenue (planned)

🤝 Contributions

Contributions and suggestions are welcome!
Check out the issues page.

📄 License

This project is licensed under the MIT License. See the LICENSE file for more details.

📬 Contact

Mateus Furrier - matfurrier@gmail.com
Project Link: https://www.furrierlabs.com.br/busspass

If this project helped you, consider giving it a ⭐️!

---

🇧🇷 PT - Versão em Português

📝 Índice

• Descrição
• Tecnologias
• Instalação
• Uso
• Contribuições
• Licença
• Contato

📖 Descrição

BussPass é um sistema fullstack de reservas de ônibus voltado para excursões turísticas. Ideal para agências de viagens e operadoras de turismo, ele proporciona uma experiência intuitiva para o cliente e ferramentas completas de gestão para o administrador.

Funcionalidades principais:

• Busca de viagens por destino e data
• Mapa interativo de assentos
• Reservas online
• Pagamento via PIX (em desenvolvimento)
• Consulta de reserva por código
• Portal administrativo para gerenciamento de viagens e frota
• API REST com documentação via Swagger
• Interface responsiva com tecnologias modernas

🛠 Tecnologias

Frontend

• Next.js 14 (App Router)
• TypeScript
• TailwindCSS + ShadCN/UI
• Zustand
• React Hook Form + Zod

Backend

• Python 3.11+
• FastAPI
• SQLAlchemy 2.0
• Pydantic v2
• Autenticação com JWT + Bcrypt
• Migrações com Alembic

Banco de Dados

• PostgreSQL 15+
• SQLite (modo dev)
• Redis (planejado)

DevOps

• Docker + Docker Compose
• Traefik (proxy reverso)
• GitHub Actions (CI/CD planejado)

⚙ Instalação

Pré-requisitos

• Docker e Docker Compose instalados

Passo a passo

# Clonar o repositório
git clone https://github.com/matfurrier/buspass.git
cd buspass

# Subir os containers
docker-compose up --build

A aplicação estará disponível em:

• Frontend: http://localhost:3000
• API Docs: http://localhost:8000/docs

🎮 Uso

Para Clientes:

• Buscar viagens por destino e data
• Visualizar assentos disponíveis em mapa
• Fazer reservas online
• Confirmar via PIX (em desenvolvimento)
• Consultar reserva via código
• Notificações por WhatsApp e e-mail (planejado)

Para Administradores:

• Gerenciar viagens (criar/editar/excluir)
• Gerenciar frota de ônibus
• Controlar reservas
• Dashboard com métricas (em desenvolvimento)
• Relatórios de vendas, ocupação e receita (planejado)

🤝 Contribuições

Sugestões e melhorias são bem-vindas!
Confira as issues.

📄 Licença

Este projeto está sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.

📬 Contato

Mateus Furrier - matfurrier@gmail.com
Link do Projeto: https://www.furrierlabs.com.br/busspass

Se este projeto te ajudou, deixe uma ⭐️!