Skip to content

llucascr/LR-construcao

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏗️ LR Construção - Sistema de Gestão para Construção e Perfuração

Java Spring Boot React Oracle Vite Status

Full Stack Application: Backend robusto em Java + Frontend moderno em React.

📋 Sobre o Projeto

Este projeto é uma API Backend desenvolvida para o gerenciamento de empresas de construção civil e perfuração de solo. O sistema centraliza o cadastro de clientes, controle financeiro de obras (construções) e serviços de perfuração, com foco em integridade de dados e flexibilidade de endereçamento.

🌟 Diferenciais Técnicos

  • Consistência Financeira: Regras de negócio e cálculos monetários executados no Backend para evitar erros de arredondamento ou manipulação no client-side.
  • Modelagem Relacional Complexa: Banco de dados Oracle normalizado para suportar múltiplos endereços, tipos de serviços e relacionamentos entre entidades.
  • DX & Inovação (Google Antigravity): O desenvolvimento do Frontend utilizou a nova IDE baseada em agentes de IA da Google, otimizando a criação de componentes e integração com a API.

🚀 Tecnologias e Arquitetura

Backend (API REST)

  • Linguagem: Java 17
  • Framework: Spring Boot 3 (Web, Data JPA, Validation)
  • Banco de Dados: Oracle Database (Driver JDBC)
  • Documentação: Swagger / OpenAPI
  • Build: Maven

Frontend (SPA)

  • Library: React.js
  • Build Tool: Vite (para alta performance)
  • Estilização: CSS Modules / Styled Components (ajuste conforme seu uso)
  • Consumo de API: Fetch API / Axios

🏗️ Diagrama de Classes e Arquitetura

A estrutura foi planejada para garantir escalabilidade. Abaixo, o diagrama da versão atual:

Diagrama da aplicação V2


⚙️ Funcionalidades Principais

Funcionalidade Descrição Técnica
Gestão de Clientes CRUD completo com validação de CPF/CNPJ e múltiplos endereços.
Controle de Obras Associação de obras a clientes com status de andamento e orçamento.
Serviços de Perfuração Módulo específico para gerenciamento de perfurações de solo.
Cálculos Automáticos O sistema calcula automaticamente totais, impostos e margens no servidor.

🛠️ Como Executar o Projeto

Para rodar a aplicação completa, você precisará clonar o repositório e executar tanto o servidor (Backend) quanto o cliente (Frontend).

1. Configuração do Backend

Pré-requisitos: Java 17+, Maven, Oracle Database.

# Clone o repositório
git clone [https://github.com/llucascr/LR-construcao.git](https://github.com/llucascr/LR-construcao.git)
cd LR-construcao

About

Sistema de gerenciamento para construção e perfuração com foco em consistência financeira e integridade de dados.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors