EdileneLopes/accenture-java

🚧 Sistema de Gerenciamento de Alunos 🚀 🚧

Sobre • Documentação • Funcionalidades • Como executar • Tecnologias • Contribuidores • Licença

💻 Sobre o Projeto

☕ Sistema de Gerenciamento - É uma API que permite o Cadastro, Consulta, Inclusão e Exclusão de Alunos..

Projeto desenvolvido durante o Treinamento Java e Node oferecida pela Gama Academy em parceria com a Accenture.

👍 Aprendizados

Conceitos da linguagem Java, orientação a objetos, spring boot. Banco de dados. Solidificamos experiências de cooperação, trabalho em equipe. Também persistência em encontrar soluções.

📃 Documentação Completa

Back-End

⚙️ Funcionalidades

Alunos podem se cadastrar na plataforma enviando:
- Nome, Telefone, Matricula
Manipular na plataforma:
- Acesso ao CRUD onde permite o gerenciamento
  - A Criação de Novos Alunos, Cursos, Disciplinas, Notas
  - Pesquisa e Leitura
  - Ediçao
  - Exclusão

🚀 Como executar o projeto

Este projeto está em uma unica parte:

Backend (cadastro)

💡 O Backend deve estar sendo executado para funcionar.

Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git, Java 8 (Java Runtime Environment JRE), Java 11 (Java SE Development Kit JDK), Node.js, Docker, MySQL. Além disto é bom ter um editor para trabalhar com o código como VSCode, Eclipse. E para testar e consumir os Endpoints use Postman

🎲 Rodando o Backend (servidor)

# Clone este repositório
$ git clone https://github.com/EdileneLopes/accenture-java.git

# Acesse a pasta do projeto no terminal de sua preferencia bash/cmd
$ cd accenture-java.git

# Importe o projeto no Eclipse (Importar como um Exisng Maven Project)

# Selecione a pasta do projeto e selecione o pom.xml e clique em FINISH

# A estrutura do nosso projeto importado para o eclipse fica de acordo com a imagem:

# Um passo antes da execução
$ Abra o arquivo application.properties
$ Troque a senha existente pela sua senha configurada no MySQL

# Execute
$ Basta selecionar CadastroApplication.java, ir com o botão direito do Mouse na seguinte opção
$ Run As > Java Application

# O servidor inciará na porta:8080 - Acesse: http://localhost:8080

Acesse a Documentação com Swagger UI ou http://localhost:8080/swagger-ui.html#/

# Para o consumo de API
Utilize o Postman https://www.postman.com/
$ Exemplos:

/cursos
    {
	"nome": "Java"
    }

/disciplinas
    {
   	"nome": "Lógica de Programação",
  	"curso":
  	 [
  	    {
 	    	"id": 1
  	    }
  	 ]

    }

/alunos
    {
	"nome": "Elson",
	"telefone": "977968299",
	"matricula": "987654321",
	"endereco": "Avenida Paulista",
	"cidade": "São Paulo",
	"uf": "SP",
	"cep": "01310100",
	"curso": 
        {
            "id": 1
        }
    }

/notas
    {
        "notaProva1": 10.0,
        "notaProva2": 10.0,
        "notaTrabalho": 0.0,
        "notaApresentacao": 0.0,
        "disciplina": 
	[
            {
              "id":1  
            }
        ],
        "aluno": 
	{
            "id":1
        }
    }

🛠 Tecnologias

As seguintes ferramentas foram usadas na construção do projeto:

Server (Spring + Java)

Spring initializer: -Maven Project; -Spring Boot Dev Tools; -Spring Web; -Spring Data JPA; -MySQL Driver; -Validation;
Spring Boot
MySQL Workbench(8.0.22)
MySQL Server(8.0.22)

Utilitários

API: Swagger UI
Editor: Visual Studio Code, Eclipse
Markdown: Markdown Emoji
Teste de API: Postman

👨‍💻 Contribuidores

💜 Um super thanks 👏 para essa galera que desenvolveu essa API:)

_{Edilene Lopes}
👪 📚

_{Elson Santos}
☕ 🎵

_{Larissa Botelho}
🌱 💻

_{Rubens Almeida}
👨‍🚀 👽

💪 Como contribuir para o projeto

Faça um fork do projeto.
Crie uma nova branch com as suas alterações: git checkout -b my-feature
Salve as alterações e crie uma mensagem de commit contando o que você fez: git commit -m "feature: My new feature"
Envie as suas alterações: git push origin my-feature

📝 Licença

Este projeto esta sobe a licença MIT.

⬆ Voltar ao topo

EdileneLopes / accenture-java