Descrição • Reprograme-se • Pré-requisitos • Tecnologias Utilizadas • Instalação e Uso • Implantação • Licença • Agradecimentos
Este projeto faz parte das atividades práticas do módulo 2024-F2M4: Node.js, do programa Reprograme-se. A proposta consiste em desenvolver um sistema de cadastro de livros e funcionários, dividido em duas partes:
-
Aplicação Front-end: Responsável pela interface do usuário, esta parte permite que os usuários visualizem, adicionem, editem e excluam informações sobre livros e funcionários de forma intuitiva e amigável. Repositório no Github
-
Aplicação Back-end: Esta parte gerencia os dados dos livros e funcionários, possibilitando a realização de operações de CRUD (Create, Read, Update, Delete) por meio de uma API, garantindo assim a integridade e segurança dos dados. Repositório no Github
Note
Este repositório refere-se ao item 1 (Aplicação Front-end) e a aplicação permite o gerenciamento de funcionários e livros em um sistema de livraria. Inclui funcionalidades como cadastro, listagem, atualização e exclusão de funcionários e livros.
O Reprograme-se é um programa oferecido pelo IFES - Instituto Federal do Espírito Santo, com o objetivo de qualificar jovens e adultos para o mercado de trabalho na área de Tecnologia da Informação (TI). Para mais informações, visite o site oficial do Reprograme-se.
Este projeto foi desenvolvido utilizando um conjunto de tecnologias modernas e poderosas que contribuem para a construção de uma aplicação web robusta e eficiente:
- JavaScript: Uma linguagem de programação amplamente utilizada, tanto no front-end quanto no back-end, que oferece flexibilidade e desempenho.
- Node.js: Um ambiente de execução JavaScript que permite a criação de aplicativos escaláveis do lado do servidor.
- Express.js: Um framework web minimalista para Node.js que simplifica o desenvolvimento de APIs e aplicativos web, fornecendo uma série de recursos úteis e uma estrutura organizada.
- Bootstrap: Um framework front-end que facilita o desenvolvimento de interfaces responsivas e atraentes, fornecendo componentes de interface de usuário prontos para uso e estilos baseados em CSS e JavaScript.
Antes de iniciar, você precisará ter as seguintes ferramentas instaladas em sua máquina:
- Node.js: Faça o download e siga as instruções de instalação para o seu sistema operacional.
- Git: Utilizado para clonar o repositório e trabalhar com controle de versão.
- API: Fornece os recursos necessários para a aplicação front-end, incluindo operações CRUD. É fundamental para o funcionamento da aplicação.
Além disso, você precisará de um editor de código de sua preferência, como Visual Studio Code.
- Clonagem do repositório: Clone este repositório para o seu ambiente local usando o comando:
git clone https://github.com/prpires66/bookstore-front.git
- Instalação de dependências: Navegue até o diretório do projeto e instale as dependências usando o comando:
npm install
- Configuração do ambiente: Antes de executar a aplicação, certifique-se de configurar as seguintes variáveis de ambiente:
URL_API
: URL do endpoint da API (Back-end).PORT
: Porta em que o servidor da aplicação será executado. Por padrão, é 3000, mas você pode definir uma porta diferente se necessário.
Tip
Você pode definir essas variáveis de ambiente em um arquivo .env
na raiz do projeto ou configurá-las diretamente no ambiente de execução, dependendo das suas preferências e ambiente de desenvolvimento. Abaixo um exemplo de arquivo .env
:
URL_API="http://localhost:4000/"
PORT=3000
- Execução da Aplicação: Inicie o servidor usando o comando:
npm start
- Utilização da Aplicação: A Aplicação estará disponível em
http://localhost:3000
por padrão, ou na porta especificada pela variável de ambientePORT
. Você pode acessar a página web da aplicação utilizando o navegador da sua preferência.
Important
Esta aplicação requer uma conexão ativa com uma API externa para funcionar. Certifique-se de que a aplicação back-end esteja sendo executada e disponível.
Para implantar esta aplicação, você pode considerar duas abordagens populares:
-
Implantação em Servidor de Nuvem:
- Esta abordagem envolve hospedar a sua aplicação em um provedor de serviços de nuvem, como Vercel, Heroku ou Netlify.
- Você pode fazer o upload do código fonte da sua aplicação para a plataforma de hospedagem e seguir as instruções fornecidas pela plataforma para implantar a aplicação.
- Essas plataformas geralmente oferecem integração contínua, escalabilidade automática e gerenciamento simplificado de infraestrutura, o que facilita o processo de implantação e gerenciamento da aplicação.
-
Implantação em Container Docker:
- Nesta abordagem, você empacota sua aplicação e suas dependências em um contêiner Docker, que pode ser implantado em qualquer ambiente compatível com Docker.
- É necessário criar um arquivo de configuração Dockerfile para a aplicação e construir a imagem do contêiner.
- Depois de construir a imagem, você pode implantar o contêiner em qualquer host que execute o Docker Engine, como servidores físicos, máquinas virtuais ou clusters de contêineres gerenciados.
- O uso de contêineres Docker oferece portabilidade, consistência de ambiente e isolamento de recursos, o que pode ser vantajoso para ambientes de desenvolvimento, teste e produção.
Note
Cada abordagem tem suas próprias vantagens e desvantagens, e a escolha entre elas dependerá das necessidades específicas do seu projeto, dos requisitos de escalabilidade, do orçamento e da preferência pessoal. Certifique-se de avaliar cuidadosamente cada opção antes de decidir qual é a melhor para sua aplicação.
Copyright © 2024 Paulo Pires.
Este projeto está sob a licença MIT. Consulte o arquivo LICENSE para obter mais detalhes.
- Agradeço ao IFES - Instituto Federal do Espírito Santo pelo apoio através do projeto Reprograme-se, assim como professores e colegas.
- Contribuições e sugestões são sempre bem-vindas.
- Muito obrigado! 💙