CRIANDO UM SISTEMA ADMINISTRATIVO COMPLETO COM RAILS ADMIN – PARTE 3

 

Introdução

Neste Screencast, dividido em 5 partes, nós vamos criar um sistema administrativo completo usando Rails Admin, neste exemplo vamos criar uma plataforma para que uma empresa possa gerenciar as vendas do seus representantes comerciais com dois tipos de usuário: gerente e vendedor. O vendedor poderá entrar com novas vendas, clientes e ver as suas comissões, o gerente poderá criar produtos, descontos e outros usuários.

Também vamos aprender a implementar uma série de features úteis e comuns à maioria dos APPs como autenticação usando Devise, autorização usando CanCanCan, filtro de registros baseado em quem é o dono deles, upload de fotos, customização da aparência e exportação de dados para PDF usando gráficos.

Este é o primeiro tutorial do OneBitCode dividido em vários episódios em vídeos para aumentar o detalhamento e simplificar a explicação, então se você gostar desse formato deixa um feedback ainda em baixo para eu saber e produzir mais conteúdo como este.

Episódios

1. 1. Criando a estrutura do nosso Projeto + Seed (assistir)
   2. Autenticação + Autorização + Filtrando os resultados (assistir)
   3. Incluindo fotos + Atribuição automática de comissão (disponível)
   4. Configurando o Rails Admin + Customizando a aparência (Em breve)
      
   5. Exportando para PDF com gráficos + Testando tudo isto (Em breve)

O que vamos Aprender?

1. 1. Como criar um sistema administrativo
   2. Como implementar a autenticação
   3. Como implementar a autorização
      
   4. Como filtrar para que os vendedores vejam apenas seus próprios clientes, vendas e comissões
      
   5. Adicionando comissão automaticamente (Neste episódio)
   6. Como receber fotos no nosso sistema administrativo (Neste episódio)
   7. Como customizar a aparência do nosso sistema administrativo
   8. Como exportar para PDF e gerar gráficos

Ingredientes

1. 1. Ruby on Rails
   2. Sqlite3 (Mas você pode usar outro Database :))
   3. Gem: Rails Admin
   4. Gem: Rails Admin Rollincode
   5. Gem: Devise
   6. Gem: CanCanCan
   7. Gem: Carrierwave

Lista de comandos utilizados no Screencast parte 3

1. 1. Comissão automática e customização dos campos e tabelas:Adicionar no arquivo: /app/models/sale.rb
      
      Ruby

      has_one :comission

      1	has_one :comission

      
      Adicionar no arquivo: /app/models/discount.rb
      
      Ruby

      has_many :sales

      1	has_many :sales

      
      Alterar a linha “has_one: address” em “/app/models/client.rb” por:
      
      
      Ruby

      has_many :address

      1	has_many :address

      
      Rodar no Console
      
      Ruby

      rails g migration add_sale_id_to_product_quantity sale_id:integer

      1	rails g migration add_sale_id_to_product_quantity sale_id:integer

      
      
      Ruby

      rails g migration add_price_to_product price:decimal

      1	rails g migration add_price_to_product price:decimal

      
      
      Ruby

      rake db:migrate

      1	rake db:migrate

      
      Adicionar no arquivo: /app/models/comission.rb
      
      Ruby

      enum status: [:pending, :payd]

      1	enum status: [:pending, :payd]

      
      Substituir o conteúdo do arquivo: /db/seeds.rb
      
      Ruby

      # Criando nossos Users --- OBS: Depois que adicionarmos o devise precisamos incluir o email e senha dos users User.create name: 'José', status: :active, kind: :salesman, email: 'salesman@teste.com', password: 123456 User.create name: 'Manuel', status: :active, kind: :salesman, email: 'salesman2@teste.com', password: 123456 User.create name: 'Marcos', status: :active, kind: :manager, email: 'manager@teste.com', password: 123456 # Criando alguns produtos de exemplo Product.create name: 'Smartphone', description:'Um smartphone novo ...', status: :active, price: 10 Product.create name: 'Tablet', description:'Um tablet novo ...', status: :active, price: 20 # Criando um desconto de exemplo Discount.create name: 'Desconto carnaval', description: 'Aplique esse desconto no carnaval', value: '10', kind: :porcent, status: :active Discount.create name: 'Desconto carnaval dinheiro', description: 'Aplique esse desconto quando possível', value: '10', kind: :money, status: :active # Crindo client Client.create name: 'Paulo', company_name: 'Google', document: '1234', email: 'paulo@google.com', user: User.first Client.create name: 'Julia', company_name: 'Google', document: 'abcd', email: 'julia@google.com', user: User.first

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

      # Criando nossos Users --- OBS: Depois que adicionarmos o devise precisamos incluir o email e senha dos users User.create name: 'José', status: :active, kind: :salesman, email: 'salesman@teste.com', password: 123456 User.create name: 'Manuel', status: :active, kind: :salesman, email: 'salesman2@teste.com', password: 123456 User.create name: 'Marcos', status: :active, kind: :manager, email: 'manager@teste.com', password: 123456   # Criando alguns produtos de exemplo Product.create name: 'Smartphone', description:'Um smartphone novo ...', status: :active, price: 10 Product.create name: 'Tablet', description:'Um tablet novo ...', status: :active, price: 20   # Criando um desconto de exemplo Discount.create name: 'Desconto carnaval', description: 'Aplique esse desconto no carnaval', value: '10', kind: :porcent, status: :active Discount.create name: 'Desconto carnaval dinheiro', description: 'Aplique esse desconto quando possível', value: '10', kind: :money, status: :active   # Crindo client Client.create name: 'Paulo', company_name: 'Google', document: '1234', email: 'paulo@google.com', user: User.first Client.create name: 'Julia', company_name: 'Google', document: 'abcd', email: 'julia@google.com', user: User.first

      
      Rodar no console:
      
      Ruby

      rake db:drop db:create db:migrate db:seed

      1	rake db:drop db:create db:migrate db:seed

      
      Adicionar no arquivo: /app/models/sale.rb
      
      Ruby

      after_save do     calc = 0     # Soma o preço dos produtos vezes a quantidade deles     self.product_quantities.each {|p| calc += p.product.price * p.quantity}     # Verifica se existe um desconto e aplica caso exista     if self.discount       if self.discount.kind == "porcent"         calc -= calc / self.discount.value       elsif self.discount.kind == "money"         calc -= self.discount.value       end     end     # Verifica se já existe uma comissão, caso sim atualiza, caso não cria uma nova.     if self.comission.present?       self.comission.update(value: (calc * 0.1), status: :pending)     else       Comission.create(value: (calc * 0.1), user: self.user, sale: self, status: :pending)     end   end

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

      after_save do     calc = 0     # Soma o preço dos produtos vezes a quantidade deles     self.product_quantities.each {|p| calc += p.product.price * p.quantity}     # Verifica se existe um desconto e aplica caso exista     if self.discount       if self.discount.kind == "porcent"         calc -= calc / self.discount.value       elsif self.discount.kind == "money"         calc -= self.discount.value       end     end       # Verifica se já existe uma comissão, caso sim atualiza, caso não cria uma nova.     if self.comission.present?       self.comission.update(value: (calc * 0.1), status: :pending)     else       Comission.create(value: (calc * 0.1), user: self.user, sale: self, status: :pending)     end   end

      
      Adicionar no arquivo: /config/initializers/rails_admin.rb
      
      Ruby

      config.model Sale do   create do     field  :client     field  :sale_date     field  :discount     field  :notes     field  :product_quantities     field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end   edit do     field  :client     field  :sale_date     field  :discount     field  :notes     field  :product_quantities     field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end end config.model Client do   create do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address     field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end   edit do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address     field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end   list do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address   end end config.model ProductQuantity do   visible false end config.model Address do   visible false end config.model ProductQuantity do   edit do     field :product     field :quantity     field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end end

      1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100

      config.model Sale do   create do     field  :client     field  :sale_date     field  :discount     field  :notes     field  :product_quantities       field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end     edit do     field  :client     field  :sale_date     field  :discount     field  :notes     field  :product_quantities       field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end end   config.model Client do   create do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address       field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end     edit do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address         field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end     list do     field  :name     field  :company_name     field  :document     field  :email     field  :phone     field  :notes     field  :status     field  :address     end end   config.model ProductQuantity do   visible false end   config.model Address do   visible false end     config.model ProductQuantity do   edit do     field :product     field :quantity       field :user_id, :hidden do       default_value do         bindings[:view]._current_user.id       end     end   end end

   2. Incluindo fotos no nosso Admin:Adicionar ao arquivo: Gemfile
      
      Ruby

      gem 'carrierwave'

      1	gem 'carrierwave'

      
      Rodar no console:
      
      Ruby

      bundle

      1

      bundle

      
      Rodar no console:
      
      
      Ruby

      rails generate uploader Photo

      1	rails generate uploader Photo

      
      Rodar no console:
      
      
      Ruby

      rails g migration add_photo_to_product photo:string

      1	rails g migration add_photo_to_product photo:string

      
      Rodar no console:
      
      
      Ruby

      rake db:migrate

      1	rake db:migrate

      
      Adicionar ao arquivo: /app/models/product.rb
      
      
      Ruby

      mount_uploader :photo, PhotoUploader

      1	mount_uploader :photo, PhotoUploader

 

Conclusão – Parte 3

Muito Obrigado por acompanhar este Blog!
Sua presença aqui é uma honra para mim,

Abraço,
Leonardo Scorza.

 

---

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 também JavaScript.
Além disso, aqui sempre levamos à você conteúdos valiosos sobre a carreira de programação, dicas sobre currículos, portfólios, perfil profissional, soft skills, enfim, tudo o que você precisa saber para continuar evoluindo como Programador(a)!

Fique por dentro de todos os conteúdos o/

 

Nossas redes sociais:

📹 • https://youtube.com/Onebitcode [Live todas as terças-feiras às 19h)
💻 • https://linkedin.com/company/onebitcode
🙂 • free dating web site los angeles
 📱  • dating profiles for men
🐦 • https://onebitcode.com/dating-site-free-online/

 

Nossos cursos:

🥇 • free 100 dating site in usa
💎 • Curso Completo de Ruby
 ⚙  • Minicurso: API Rails 5 Completo
🐞 • Minicurso de Testes para Ruby on Rails com RSpec

 

Espero que curta nossos conteúdos e sempre que precisar de ajuda, fala com a gente!
Estamos aqui para você 🙂

Bem-vindo à família OneBitCode o/