Criando um sistema Administrativo Completo com Rails Admin – Parte 1

 

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 (Disponível)
   2. Autenticação + Autorização + Filtrando os resultados (Em breve)
   3. Incluindo fotos + Atribuição automática de comissão (Em breve)
   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. Como receber fotos no nosso sistema administrativo
   6. Como customizar a aparência do nosso sistema administrativo
   7. 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 1

1. 1. Criando os Models do sistema:
      
      Ruby

      rails g model User name:string document:string kind:integer status:integer notes:text

      1	rails g model User name:string document:string kind:integer status:integer notes:text

      
      
      Ruby

      rails g model Client name:string company_name:string document:string email:string phone:string user:references notes:text status:integer

      1	rails g model Client name:string company_name:string document:string email:string phone:string user:references notes:text status:integer

      
      
      Ruby

      rails g model Address country:string city:string state:string neighborhood:string street:string number:string client:references user_id:integer

      1	rails g model Address country:string city:string state:string neighborhood:string street:string number:string client:references user_id:integer

      
      
      Ruby

      rails g model Product name:string description:text status:integer

      1	rails g model Product name:string description:text status:integer

      
      
      Ruby

      rails g model Discount name:string description:text value:integer kind:integer status:integer

      1	rails g model Discount name:string description:text value:integer kind:integer status:integer

      
      
      Ruby

      rails g model ProductQuantity product:references quantity:integer user:references

      1	rails g model ProductQuantity product:references quantity:integer user:references

      
      
      Ruby

      rails g model Sale client:references sale_date:date user:references discount:references notes:text

      1	rails g model Sale client:references sale_date:date user:references discount:references notes:text

      
      
      Ruby

      rails g model Comission sale:references value:decimal user:references status:integer note:text

      1	rails g model Comission sale:references value:decimal user:references status:integer note:text

      
      
      Ruby

      rails db:migrate

      1	rails db:migrate

   2. Incluindo nossos Enuns e relacionamentos:
      
      Ruby

      class User < ApplicationRecord enum kind: [:salesman, :manager] enum status: [:active, :inactive] has_many :comissions has_many :addresses has_many :clients has_many :product_quantities has_many :sales end

      1 2 3 4 5 6 7 8 9

      class User < ApplicationRecord   enum kind: [:salesman, :manager]   enum status: [:active, :inactive]   has_many :comissions   has_many :addresses   has_many :clients   has_many :product_quantities   has_many :sales end

      
      
      Ruby

      class Client < ApplicationRecord belongs_to :user enum status: [:active, :inactive] has_one :address end

      1 2 3 4 5

      class Client < ApplicationRecord   belongs_to :user   enum status: [:active, :inactive]   has_one :address end

      
      
      Ruby

      class Address < ApplicationRecord belongs_to :client end

      1 2 3

      class Address < ApplicationRecord   belongs_to :client end

      
      
      Ruby

      class Product < ApplicationRecord enum status: [:active, :inactive] has_many :product_quantities end

      1 2 3 4

      class Product < ApplicationRecord   enum status: [:active, :inactive]   has_many :product_quantities end

      
      
      Ruby

      class Discount < ApplicationRecord enum status: [:active, :inactive] end

      1 2 3

      class Discount < ApplicationRecord   enum status: [:active, :inactive] end

      
      
      Ruby

      class ProductQuantity < ApplicationRecord belongs_to :product belongs_to :sale, optional: true end

      1 2 3 4

      class ProductQuantity < ApplicationRecord   belongs_to :product   belongs_to :sale, optional: true end

      
      
      Ruby

      class Sale < ApplicationRecord belongs_to :client belongs_to :user belongs_to :discount has_many :product_quantities end

      1 2 3 4 5 6

      class Sale < ApplicationRecord   belongs_to :client   belongs_to :user   belongs_to :discount   has_many :product_quantities end

      
      
      Ruby

      class Comission < ApplicationRecord belongs_to :sale belongs_to :user end

      1 2 3 4

      class Comission < ApplicationRecord   belongs_to :sale   belongs_to :user end

   3. Instalando o Projeto:
      
      Ruby

      gem 'rails_admin'

      1	gem 'rails_admin'

      
      
      Ruby

      rails g rails_admin:install

      1	rails g rails_admin:install

   4. Seed:
      
      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 User.create name: 'Marcos', status: :active, kind: :manager # Criando alguns produtos de exemplo Product.create name: 'Smartphone', description:'Um smartphone novo ...', status: :active Product.create name: 'Tablet', description:'Um tablet novo ...', status: :active # Criando um desconto de exemplo Discount.create name: 'Desconto carnaval', description: 'Aplique esse desconto no carnaval', value: '10', kind: :porcent, status: :active

      1 2 3 4 5 6 7 8 9 10

      # 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 User.create name: 'Marcos', status: :active, kind: :manager   # Criando alguns produtos de exemplo Product.create name: 'Smartphone', description:'Um smartphone novo ...', status: :active Product.create name: 'Tablet', description:'Um tablet novo ...', status: :active   # Criando um desconto de exemplo Discount.create name: 'Desconto carnaval', description: 'Aplique esse desconto no carnaval', value: '10', kind: :porcent, status: :active

      
      
      Ruby

      rake db:seed

      1	rake db:seed

Conclusão – Parte 1

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
🙂 • https://facebook.com/onebitcode
 📱  • https://instagram.com/one_bit_code
🐦 • https://twitter.com/onebitcode

 

Nossos cursos:

🥇 • Programador Full Stack Javascript em 8 Semanas
💎 • https://onebitcode.com/dating-agencies-preston-lancashire/
 ⚙  • https://onebitcode.com/dating-sites-for-fat-people/
🐞 • best dating app los angeles

 

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/