Aquabudget
Aplicação web para criação e gestão de orçamentos profissionais. Permite criar um orçamento completo em menos de 5 minutos, com exportação para PDF de aspeto profissional.
Demo: https://GabrielBudoia.github.io/Aquabudget
Funcionalidades
- Criação rápida de orçamentos (< 5 minutos)
- Exportação para PDF profissional
- Gestão de clientes e produtos/serviços
- Histórico de orçamentos
- Interface responsiva
Tech Stack
| Camada | Tecnologia |
|---|---|
| Frontend | React + Vite |
| Backend | Java 17 + Spring Boot |
| Base de dados | PostgreSQL |
| Deploy Frontend | GitHub Pages |
| CI/CD | GitHub Actions |
Setup Local
Pré-requisitos
- Node.js 20+
- Java 17+
- Maven 3.8+ (ou usar o wrapper
./mvnw) - PostgreSQL 15+
1. Clonar o repositório
git clone https://github.com/GabrielBudoia/Aquabudget.git
cd Aquabudget
2. Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com os valores reais
3. Iniciar o backend
cd backend
./mvnw spring-boot:run
# API disponível em http://localhost:8080
4. Iniciar o frontend
cd frontend
npm install
npm run dev
# App disponível em http://localhost:5173
Deploy
O deploy é automático via GitHub Actions:
- Frontend: push para
mainna pastafrontend/→ deploy para GitHub Pages em < 5 min - Backend: push/PR em
backend/→ build + testes automáticos - Release: criar tag
vX.Y.Z→ GitHub Release criada com JAR anexado
Ver docs/deployment.md para detalhes.
Contribuição
Ver CONTRIBUTING.md.