Criando um sistema administrativo com Rails Admin em 25 minutos!

O que vamos fazer e por que Rails Admin?

Neste tutorial, criaremos um sistema administrativo completo usando Rails Admin em 25 minutos!
A ideia é que depois de fazer o tutorial você seja capaz de criar um sistema administrativo completo (com autenticação) para qualquer tipo de negócio. Como exemplo, vamos criar um sistema para administrar o Aluguel de veículos no qual será possível cadastrar os carros da frota, os clientes, os alugueis e também registrar possíveis “sinistros” que tenham ocorrido durante o aluguel do carro.

O Rails Admin é uma Gem que cria uma interface para que você possa gerenciar seus dados. Para uma explicação mais aprofundada dê uma olhada na página da Gem no GitHub clicando aqui!

Um momento para agradecer

Gostaríamos de agradecer a todos os leitores pela receptividade que o blog está tendo. Cada feedback que recebemos nos dois primeiros posts serviram enormemente de incentivo para continuarmos a produzir conteúdos de valor e melhorarmos ainda mais a qualidade do nosso trabalho.
Simplesmente, obrigado a todos!

Caso você não tenha visto o Post sobre “12 Gems que você precisa conhecer”, clique aqui.
Se você não viu o Post “Como criar um Chatbot usando Ruby On Rails Facilmente”, clique aqui.

Ingredientes do Projeto

Objetivos do Tutorial

  • ● Criar o nosso Projeto Rails 5 com PostgreSQL e instalar a Gem do Rails Admin.
  • ● Criar a estrutura do banco de dados.
  • ● Criar a Autenticação usando Devise.
  • ● Colocar um tema sobre o Rails Admin

Onde encontrar o código completo

Este projeto estará completo no GitHub. Caso queira ver o código, acesse este link! Aproveite e siga-nos no GitHub 🙂

Mãos à Obra!

Primeiro vamos criar o Projeto e instalar as Gems

  1. Para instalar usando Rails 5, rode no terminal:
  2. Verifique se a versão do Rails é realmente a 5 rodando:
  3. Se tudo estiver correto, deverá aparecer uma indicação de que a versão no console é a 5
  4. Rode no terminal para criar o seu projeto
  5. Agora vá até o seu Gemfile e adicione as seguintes gems:

    *Observação: se você estiver usando Rails 4, não precisa adicionar a primeira Gem (remotipart).
  6. Agora Rode o Bundle no console:
  7. Para instalar o Rails Admin rode no console:
  8. Ao rodar o comando, o Rails Admin perguntará em qual rota você gostaria de instalar. Neste tutorial deixaremos em /admin como no default, mas você poderá escolher outra rota ou até mesmo instalar na home.
  9. Você precisa configurar seu arquivo “config/database.yml” com os acessos para o seu postgreSQL.
    Se você não está acostumado com o Rails e não sabe como configurar esse arquivo, veja essa referência!
  10. Depois de configurar o seu arquivo “db/database.yml”, rode no console:
  11. Agora para ver o resultado rode no console:

Pronto, agora já será capaz de ver a seguinte tela acessando no browser http://localhost:3000/admin

 

Rails Admin

 

 

\o/ Estamos Online :), vamos configurar o Rails Admin agora!

Banco de Dados

Apenas relembrando: o exemplo que estamos fazendo aqui hoje é um sistema simples para administrar o aluguel de carros. Criaremos apenas os Models e não será necessária a criação de Controllers ou mesmo rotas para se usar o Rails Admin.

Vamos criar os seguintes Models:

  • Carro: Armazenar os veículos da empresa.
  • Cliente: Pessoas que alugarão os carros.
  • Aluguel: Relaciona um carro e um cliente em evento de Aluguel.
  • Sinistro: Caso ocorra um incidente durante o aluguel de um carro, essa tabela armazenará o que ocorreu. (ex.: a porta foi amassada e o cliente deve pagar R$300).
  • User: A pessoa que usará o sistema de administração. (vamos gerar com o devise)

Vamos Criar

    1. Para criar o Model Carro, rode no console:
    2. Agora para o Model Cliente, rode:
    3. Para o Aluguel, rode:
    4. Vá até a migration gerado para o Aluguel e substitua a linha:

      por:

      Isso é para deixar o campo mais apropriado para guardar valores monetários.
    5. Agora para o Model Sinistro, rode:
    6. Vá até a migration gerada para o Sinistro e substitua a linha:

      por:

      Isso é para deixar o campo mais apropriado para guardar valores monetários.
    7. Agora para gerar as tabelas, rode:
    8. Nós precisamos criar as relações entre nossas tabelas agora:
      • Vá até o model “Aluguel” e inclusa as seguintes linhas:
      • No model “Carro” e também no model “Cliente”, inclua a seguinte linha:
      • Para finalizar, inclua a seguinte linha no model “Sinistro”.

Excelente, agora já temos nossas tabelas e models configurados.

Rode:

 

Acesse no browser http://localhost:3000/admin e veja como está seu site administrativo agora com as novas tabelas.
tutorial rails admin

\o/ Ótimo, agora nós já podemos criar, editar ou apagar dados nas nossas tabelas. Brinque um pouco com seu sistema administrativo e aprenda a usar a interface do Rails Admin, você verá que é bem completo.

Autenticação

Como qualquer sistema fechado, nosso sistema precisa ter um método de autenticação. Nós poderíamos usar uma autenticação básica, mas porque não usar o devise que além de simples é completo? Vamos lá:

  1. Para criar o Model do nosso Administrador do sistema, rode:
  2. Vamos instalar o Devise. Rode:
  3. Agora para criar os campos do devise e adicionar as opções ao Model User, rode:
  4. No console, rode:
  5. Agora vá até o arquivo “config/initializers/rails_admin.rb”, lá você poderá futuramente editar o seu sistema de administração, mas por hora procure o seguinte trecho de código comentado e o “descomente”:
  6. Excelente! Agora no browser, vá até http://localhost:3000/admin e você será redirecionado para a tela de Login.
    captura-de-tela-de-2016-09-16-18-30-40
  7. Maravilha! Já temos a nossa página de login (você pode personalizá-la, nos documentos do Devise você pode aprender como clicando aqui). Como você ainda não tem uma conta, poderá clicar em “Sign Up” e criá-la para
  8. logar. (Você pode aprovar ou não novos cadastros na plataforma, veja como).

 

\o/ Ótimo, conseguimos criar um método de autenticação usando Devise. Agora você já é capaz de gerenciar as pessoas que acessam sua plataforma e bloquear acessos indevidos.

 

Para fechar com chave de ouro esse tutorial, vamos agora colocar um tema no nosso Rails Admin para deixá-lo mais apresentável.

Mas antes, uma tarefa simples para você se aprofundar

Você deve ter percebido que onde nós colocamos relações entre os models (has_one) nós acabamos ficando com dois campos visíveis. Por exemplo, nessa imagem abaixo da criação do Aluguel, nós temos duas vezes o campo “carro” e duas vezes o campo “cliente”. Você pode fazer com que apareça apenas uma vez adicionando no arquivo “config/initializers/rails_admin.rb” quais campos do model você gostaria que aparecessem. Para saber como fazer isso clique aqui.

captura-de-tela-de-2016-09-16-19-07-56

 

Instalando o Template

Já estamos com nosso site pronto e funcional, mas é claro que adicionar novas funcionalidades nele está nas suas mãos (se precisar de dicas, mande-nos uma mensagem pelo Facebook). Com base no que aprendemos até aqui, já é possível criar um sistema administrativo rapidamente e impressionar aquele seu chefe que vive te apressando ou finalmente criar um admin de qualidade pra sua Startup. 🙂

Vamos Instalar!

  1. Primeiro, adicione a seguinte linha em “config/application.rb” após Bundler.required
  2. Agora, rode os seguintes comandos:

    * Se o tema não funcionar, rode esse comando antes:
  3. Finalmente o último passo! Crie o seguinte arquivo (“app/assets/javascripts/rails_admin/custom/ui.js”) e cole o código abaixo nele:

  4. Agora é só rodar o Rails s e ver como seu admin ficou bonito 🙂


12 formas de vencer o bloqueio criativo e escrever textos memoráveis (e 6 dicas extras)

Não perca nenhum conteúdo

Receba nosso resumo semanal com os novos posts, cursos, talks e vagas \o/



Conclusão e indicações

Obrigado por seguir esse tutorial até aqui \o/, esperamos que ele tenha o ajudado a criar sistemas administrativos de maneira simples usando Ruby On Rails + Rails Admin.

O Rails Admin é bem útil e existem mais opções dentro dele que podem ser exploradas. Para saber mais, dê uma olhada no Wiki dele nesse link.

Caso queira acessar o código completo do que fizemos aqui para referência, acesse pelo GitHub clicando aqui.

Estamos trabalhando bastante para criar conteúdos de qualidade e em Português então, se você gostou desse e dos outros tutoriais, compartilhe-os com seus amigos :), nos ajuda bastante (tem alguns botões de share aí em baixo).

Se você ficou com alguma dúvida, escreva nos comentários ou fale conosco no Facebook. Ficaremos muito felizes em poder ajudá-lo(a).

Se você ainda não se inscreveu, inscreva-se na nossa Newsletter. Toda Sexta-Feira enviamos um resumo com o melhor do que foi produzido na semana para você.

Novamente, muito obrigado pela atenção e pela receptividade que esses conteúdos têm tido na comunidade!

Um grande abraço,

Equipe OneBitCode.


Você é novo por aqui?

Primeira vez no OneBitCode? Curtiu esse conteúdo? O OneBitCode tem muito mais para você!

O OneBitCode traz conteúdos de qualidade e em português sobre programação com foco em Ruby on Rails e outras tecnologias como Angular, Ionic, React, desenvolvimento de Chatbots e etc.

Se você deseja aprender mais, de uma forma natural e dentro de uma comunidade ativa, visite nosso Facebook e nosso Twitter, veja os screencasts e talks no Youtube, alguns acontecimentos no Instagram, ouça os Podcasts e faça parte de nossa Newsletter.

Além disso, também estamos com alguns e-Books muito interessantes para quem deseja se aprimorar como programador e também como freelancer (os e-Books são gratuitos!):

Espero que curta nossos conteúdos e sempre que precisar de ajuda com os tutoriais, fala com a gente! Seja por Facebook ou e-mail, estamos aqui para você 🙂

Bem-vindo à família OneBitCode \o/

julho 19, 2018
Feito com s2 por OneBitCode
%d blogueiros gostam disto: