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.
• Signup: 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/login.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/login.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/login.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.

• Nome: Luan Pereira
• Email: luan23107@gmail.com