Skip to content

Latest commit

 

History

History
166 lines (121 loc) · 5.92 KB

README.md

File metadata and controls

166 lines (121 loc) · 5.92 KB

Consulta de CEP, CNPJ e ISPB Bancos

Este projeto é uma aplicação web que permite consultar informações sobre CEP, CNPJ e códigos bancários (ISPB) etc, usando a API da BrasilAPI. O backend é implementado em Go, e o frontend utiliza HTMX e Tailwind CSS para uma experiência de usuário moderna e responsiva.

Tecnologias Utilizadas

  • Backend: Go
  • Frontend: HTMX, Tailwind CSS
  • API: BrasilAPI (para consulta de CEP, CNPJ, ISPB Bancos, etc.)

Funcionalidades

  • Consulta de CEP: Permite buscar informações detalhadas sobre um CEP.
  • Consulta de CNPJ: Permite buscar informações sobre uma empresa pelo CNPJ.
  • Consulta de ISPB Bancos: Permite buscar informações sobre bancos utilizando o código ISPB.

Descrição dos Componentes

  • main.go: O arquivo principal para iniciar o servidor Go. Configura e executa o servidor HTTP.
  • internal/handlers/: Contém manipuladores para lidar com as solicitações de API:
    • cep_handler.go: Manipulador para consultas de CEP.
    • cnpj_handler.go: Manipulador para consultas de CNPJ.
    • bank_handler.go: Manipulador para consultas de ISPB Bancos.
  • internal/models/: Contém os modelos de dados para a aplicação:
    • cep.go: Modelo para os dados de CEP.
    • cnpj.go: Modelo para os dados de CNPJ.
    • bank.go: Modelo para os dados de ISPB Bancos.
  • internal/services/: Contém os serviços que fazem as chamadas para a API da BrasilAPI e processam os dados:
    • cep_service.go: Serviço para buscar dados de CEP.
    • cnpj_service.go: Serviço para buscar dados de CNPJ.
    • bank_service.go: Serviço para buscar dados de ISPB Bancos.
  • web/templates/index.html: Template HTML para a página inicial da aplicação.
  • go.mod: Arquivo de módulo Go que gerencia as dependências do projeto.

Essa estrutura proporciona uma organização clara e modular do código, facilitando a manutenção e a expansão futura da aplicação.

Documentação dos Handlers de Autenticação

Este projeto implementa funcionalidades de autenticação utilizando JWT (JSON Web Token) para login, registro e logout de usuários. Abaixo estão os detalhes de cada função responsável por processar as requisições HTTP.

Estrutura do Projeto

O código define três handlers principais:

  • Login: Exibe a página de login e processa a autenticação de usuários.
  • #: Exibe a página de registro de novos usuários e processa o cadastro.
  • Logout: Realiza o logout removendo o token JWT armazenado no cookie.

Esses handlers interagem com o banco de dados MySQL para autenticar usuários e armazenar informações de cadastro.

Handlers

1. Login - Exibe a página de login e processa o login de usuários

Este handler lida com a autenticação do usuário. Se as credenciais estiverem corretas, ele gera um token JWT e o envia de volta para o cliente via cookie.

Funcionamento:

  • Método GET: Renderiza a página de login (login.html).
  • Método POST: Processa as credenciais enviadas pelo formulário:
    • Verifica se o email existe no banco de dados.
    • Compara a senha fornecida com a senha armazenada no banco, utilizando bcrypt.
    • Se as credenciais forem válidas, um token JWT é gerado e retornado ao cliente via cookie.
    • Redireciona o usuário para a página /tools.

Código:

func Login(db *sql.DB) http.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) {
		if r.Method == http.MethodGet {
			tmpl := template.Must(template.ParseFiles("web/templates/#.html"))
			tmpl.Execute(w, nil)
			return
		}

		if r.Method == http.MethodPost {
			email := r.FormValue("email")
			password := r.FormValue("password")
			var storedPassword string
			err := db.QueryRow("SELECT password FROM users WHERE email = ?", email).Scan(&storedPassword)
			if err != nil {
				tmpl := template.Must(template.ParseFiles("web/templates/#.html"))
				tmpl.Execute(w, LoginData{ErrorMessage: "Email ou senha inválidos."})
				return
			}

			err = bcrypt.CompareHashAndPassword([]byte(storedPassword), []byte(password))
			if err != nil {
				tmpl := template.Must(template.ParseFiles("web/templates/#.html"))
				tmpl.Execute(w, LoginData{ErrorMessage: "Email ou senha inválidos."})
				return
			}

			token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{
				"email": email,
				"exp":   time.Now().Add(time.Hour * 1).Unix(),
			})

			tokenString, err := token.SignedString([]byte(os.Getenv("JWT_SECRET")))
			if err != nil {
				http.Error(w, "Error generating token", http.StatusInternalServerError)
				return
			}

			http.SetCookie(w, &http.Cookie{
				Name:    "token",
				Value:   tokenString,
				Expires: time.Now().Add(time.Hour * 1),
				Path:    "/",
			})

			http.Redirect(w, r, "/tools", http.StatusSeeOther)
		} else {
			http.Error(w, "Invalid request method", http.StatusMethodNotAllowed)
		}
	}
}

Como Executar o Projeto

  1. Clone o repositório:

    git clone https://github.com/devluanpereira/ToolsDev.git
cd ToolsDev

  2. Instale as dependências do Go:

    go mod tidy

  3. Execute o servidor:

    go run main.go

  4. Acesse a aplicação:

    Abra seu navegador e vá para http://localhost:8000 para ver a aplicação em funcionamento. Mais caso a porta esteja em uso mude para que esteja disponivel em main.go.

Como Contribuir

  1. Faça um fork deste repositório.
  2. Crie uma branch para suas alterações (git checkout -b minha-alteracao).
  3. Faça as alterações e commit (git commit -am 'Adiciona minha alteração').
  4. Envie para o repositório remoto (git push origin minha-alteracao).
  5. Abra um Pull Request.

Licença

Este projeto está licenciado sob a MIT License.

Contato

Se você tiver alguma dúvida, sinta-se à vontade para entrar em contato.