Mantendo a sua aplicação Rails organizada

Quando criamos uma nova app com Rails, o framework já nos traz uma série de convenções de nomenclatura e estrutura que nos auxilia a mantê-la organizada. Entretanto, conforme ela cresce e vai se tornando mais complexa, torna-se cada vez mais difícil manter o codebase organizado e de fácil compreensão.Nessa palestra serão apresentadas algumas ferramentas e práticas para auxiliar nesse desafio e manter o código da sua app Rails mais legível e manutenível.

* Slides adaptados de https://speakerdeck.com/fnando/criando-aplicacoes-mais-faceis-de-manter-com-ruby-on-rails

Transcript

1. Mantendo a sua aplicação Rails @mateusg organizada
2. Mateus Gomes github.com/mateusg twitter.com/mateusg mateusg.18@gmail.com
4. Estamos contratando! #remote helabs.com/jobs
7. Você cria a sua aplicação Tudo se inicia com um rails new myapp.
8. Desenvolve funcionalidades rails generate scaffold vid4l0k4
9. Desenvolve funcionalidades
10. As views se tornam complexas Começa a se acumular lógica de formatação, de geração de classes CSS e muitas condicionais.
11. Os controllers se tornam complexos Modificar o comportamento de uma action envolve muito esforço. Testar e fazer manutenção nos testes existentes, mais ainda.
12. Os models se tornam complexos Classes cada vez maiores, acumulando muita lógica de negócio, mais responsabilidade do que deveriam ter.
13. Será que o problema está no Rails? Ou será que é preciso mudar a forma como o código é escrito, assim como a arquitetura da aplicação?
15. RAILS WAY
16. O que fazer para manter o código bem escrito?
17. O que caracteriza um código bem escrito?
18. https://speakerdeck.com/fnando/criando-aplicacoes-mais-faceis-de-manter-com-ruby-on-rails
19. Nomenclatura deve ser levada a sério Você pode achar que o nome de uma classe está perfeito, mas ainda assim ele pode ser interpretado da forma errada.
20. –Uncle Bob Martin, Clean Code “Fazer o seu código legível é tão importante quanto fazê-lo executável.”
21. ConfirmPaymentPaypal
22. Confirm Payment Paypal
23. Confirm Payment Paypal Confirma Pagamento Paypal
24. Confirm Payment Paypal Confirma Pagamento Paypal Sidekiq Job/Worker app jobs confirm_payment_paypal.rb
25. Explícito > Implícito Só o diretório em que a classe se encontra não é suficiente para indicar o que ela é ou a qual contexto ela pertence.
26. Confirm Payment Paypal Job
27. Watch your grammar!
28. Confirm Payment Paypal Job Pagamento do Paypal
29. Confirm Paypal Payment Job
30. Confirm Paypal Payment Job Nome de classe => Substantivo (coisa) Nome de método => Verbo (ação)
31. Paypal Payment Confirmation Job
32. Paypal::PaymentConfirmationJob !
33. Clareza > Brevidade Evite abreviações em nomes de métodos, classes e constantes.
34. –DHH “Se você se esforçar para ser claro na nomenclatura, raramente precisará escrever comentários explicativos.” https://signalvnoise.com/posts/3250-clarity-over-brevity-in-variable-and-method- names
35. def  turn_into_an_outside_subscriber_if_accesses_revoked      update_attribute(:outside_subscriber,  true)  if  accesses_revoked?   end   def  shift_records_upward_starting_at_position(position)      positioned_records.update_all  "position  =  position  -­‐  1",          ["position  >=  ?",  position]   end   def  accesses_revoked?      accesses.blank?   end  
36. validates  :name,  inclusion:  {  in:  -­‐>  (e)  {  e.available_names  }  }   Aqui pode!
37. Testes automatizados são essenciais Além de facilitarem a compreensão do código, dão mais segurança para evoluí-lo e fazer manutenção.
38. Separe os testes unitários por método Estruturar os testes hierarquicamente em classe => método => contextos torna a leitura e a compreensão mais rápida.
39. #  app/models/webhook.rb   class  Webhook  <  ActiveRecord::Base      def  enable!          update_column  :enabled,  true      end      def  disable!          update_column  :enabled,  false      end   end  
40. describe  Webhook  do      subject(:webhook)  {  create  :webhook,  enabled:  false  }      describe  'enabling  webhook'  do          it  'updates  enabled  to  true'  do              webhook.enable!                            expect(webhook.reload.enabled).to  be  true          end      end      describe  'disabling  webhook'  do          #...      end      describe  'deleting  webhook'  do          #  ...      end   end  
41. describe  Webhook  do      subject(:webhook)  {  create  :webhook,  enabled:  false  }      describe  'enabling  webhook'  do          it  'updates  enabled  to  true'  do              webhook.enable!                            expect(webhook.reload.enabled).to  be  true          end      end      describe  'disabling  webhook'  do          #...      end      describe  'deleting  webhook'  do          #  ...      end   end  
42. #  spec/models/webhook_spec.rb   describe  Webhook  do      describe  '#enable!'  do          subject(:webhook)  {  create  :webhook,  enabled:  false  }          it  'updates  enabled  to  true'  do              webhook.enable!                            expect(webhook.reload.enabled).to  be  true          end      end      describe  '#disable!'  do          subject(:webhook)  {  create  :webhook,  enabled:  false  }          it  'updates  enabled  to  false'  do              webhook.disable!                            expect(webhook.reload.enabled).to  be  false          end      end   end  
43. #  spec/models/webhook_spec.rb   describe  Webhook  do      describe  '#enable!'  do          subject(:webhook)  {  create  :webhook,  enabled:  false  }          it  'updates  enabled  to  true'  do              webhook.enable!                            expect(webhook.reload.enabled).to  be  true          end      end      describe  '#disable!'  do          subject(:webhook)  {  create  :webhook,  enabled:  false  }          it  'updates  enabled  to  false'  do              webhook.disable!                            expect(webhook.reload.enabled).to  be  false          end      end   end  
44. –Kent Beck “Sou pago para escrever código que funciona, não testes, então minha filosofia é testar o suficiente para atingir um certo nível de confiança.”
45. Dê preferência aos testes unitários Testes unitários são mais rápidos e simples, portanto são mais fáceis de serem mantidos.
46. Testes não devem ser DRY A legibilidade de um teste não pode ser prejudicada para deixá- lo DRY. Testes devem ser de fácil entendimento, já que também têm papel de documentação do comportamento do código.
47. [:phone_number,  :cellphone_number].each  do  |attr|      it  {  is_expected.to  validate_presence_of(attr)  }      it  {  is_expected.to  validate_format_of(attr)  }   end   http://betterspecs.org
48. [:phone_number,  :cellphone_number].each  do  |attr|      it  {  is_expected.to  validate_presence_of(attr)  }      it  {  is_expected.to  validate_format_of(attr)  }   end   Gerando testes dinamicamente http://betterspecs.org
49. [:phone_number,  :cellphone_number].each  do  |attr|      it  {  is_expected.to  validate_presence_of(attr)  }      it  {  is_expected.to  validate_format_of(attr)  }   end   Gerando testes dinamicamente http://betterspecs.org
50. [:phone_number,  :cellphone_number].each  do  |attr|      it  {  is_expected.to  validate_presence_of(attr)  }      it  {  is_expected.to  validate_format_of(attr)  }   end   Gerando testes dinamicamente it  {  is_expected.to  validate_presence_of(:phone_number)  }   it  {  is_expected.to  validate_presence_of(:cellphone_number)  }   it  {  is_expected.to  validate_format_of(:phone_number)  }   it  {  is_expected.to  validate_format_of(:cellphone_number)  }   ! http://betterspecs.org
51. describe  'List'  do      describe  '#clear'  do          before  {  queue.clear  }          it  'removes  all  items'  do              expect(queue.items).to  be_empty          end      end   end  
52. describe  'List'  do      describe  '#clear'  do          before  {  queue.clear  }          it  'removes  all  items'  do              expect(queue.items).to  be_empty          end      end   end   DRY!
53.        end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  'removes  all  items'  do              expect(queue.items).to  be_empty          end      end   end  
54.        end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  'removes  all  items'  do              expect(queue.items).to  be_empty          end      end   end   O que está sendo testado?
55.        end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  'removes  all  items'  do              expect(queue.items).to  be_empty          end      end   end   O que está sendo testado?
56.        it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  'removes  all  items'  do              list.clear              expect(list.items).to  be_empty          end      end   end  
57.        it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  '...'  do          end          it  'removes  all  items'  do              list.clear              expect(list.items).to  be_empty          end      end   end   !
58. Refatore, refatore, refatore Busque deixar os componentes da sua aplicação mais enxutos e livres de responsabilidades que não os pertencem.
59. O Rails Way tem se mostrado insuficiente para aplicações complexas Fuja das convenções sempre que for conveniente, mas avalie com cuidado as suas decisões.
60. Abstrações de mais ou de menos? O excesso de abstrações pode ser tão prejudicial quanto a falta de abstrações.
61. Extraia lógica das views Views não devem ter nada além de loops, forms enxutos e lógicas simples de exibição.
62. Usando Helpers
63. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.paid?  ?  'paid'  :  ''}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  link_to  invoice_path(payment.invoice)  if   payment.invoice.present?  &&  current_user.has_role?  :manager          %td              =  t("payments.methods.#{payment.method}")          %td              =  payment.automatic?  ?  'Sim'  :  'Não'  
64. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.paid?  ?  'paid'  :  ''}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  link_to  invoice_path(payment.invoice)  if   payment.invoice.present?  &&  current_user.has_role?  :manager          %td              =  t("payments.methods.#{payment.method}")          %td              =  payment.automatic?  ?  'Sim'  :  'Não'  
65. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment_status_class(payment)}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  invoice_link  payment,  current_user          %td              =  t("payments.methods.#{payment.method}")          %td              =  automatic_label(payment)  
66. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment_status_class(payment)}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  invoice_link  payment,  current_user          %td              =  t("payments.methods.#{payment.method}")          %td              =  automatic_label(payment)   Injeção de dependência :(
67. Usando Decorators
68. #  app/controllers/payments_controller.rb   def  index      @payments  =  Payment.page(params[:page]).decorate   end   #  Gemfile   gem  'draper'   https://github.com/drapergem/draper
69. #  app/controllers/payments_controller.rb   def  index      @payments  =  Payment.page(params[:page]).decorate   end   #  Gemfile   gem  'draper'   https://github.com/drapergem/draper
70. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.paid?  ?  'paid'  :  ''}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  link_to  invoice_path(payment.invoice)  if   payment.invoice.present?  &&  current_user.has_role?  :manager          %td              =  t("payments.methods.#{payment.method}")          %td              =  payment.automatic?  ?  'Sim'  :  'Não'  
71. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.paid?  ?  'paid'  :  ''}          %td              =  l  payment.paid_at,  format:  :short          %td              =  number_to_currency  payment.value          %td              =  number_to_percentage  payment.discount          %td              =  number_to_currency  payment.recharge_value          %td              =  number_to_currency  payment.total          %td              =  link_to  invoice_path(payment.invoice)  if   payment.invoice.present?  &&  current_user.has_role?  :manager          %td              =  t("payments.methods.#{payment.method}")          %td              =  payment.automatic?  ?  'Sim'  :  'Não'  
72. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.status_class}          %td              =  payment.paid_at          %td              =  payment.formatted_value          %td              =  payment.formatted_discount          %td              =  payment.formatted_recharge_value          %td              =  payment.formatted_total          %td              =  payment.invoice_link          %td              =  payment.method_label          %td              =  payment.automatic_label  
73. / app/views/payments/index.html.haml -­‐  @payments.each  do  |payment|      %tr{class:  payment.status_class}          %td              =  payment.paid_at          %td              =  payment.formatted_value          %td              =  payment.formatted_discount          %td              =  payment.formatted_recharge_value          %td              =  payment.formatted_total          %td              =  payment.invoice_link          %td              =  payment.method_label          %td              =  payment.automatic_label  
74. #  app/decorators/payment_decorator.rb   class  PaymentDecorator  <  Draper::Decorator      def  paid_at          l  object.paid_at,  format:  :short      end      def  status_class          object.paid?  ?  'paid'  :  nil      end      def  formatted_value          number_to_currency  object.value      end      def  formatted_discount          number_to_percentage  object.discount      end      def  formatted_recharge_value          number_to_currency  object.recharge_value      end      def  formatted_total          number_to_currency  object.total      end      def  invoice_link          if  object.invoice.present?  &&  current_user.has_role?  :manager              link_to  invoice_path  object.invoice          end      end      def  method_label          t  object.method,  scope:  'payments.methods'      end      def  automatic_label          t  object.automatic?,  scope:  'yes_or_no'      end   end  
75. #  app/decorators/payment_decorator.rb   class  PaymentDecorator  <  Draper::Decorator      def  paid_at          l  object.paid_at,  format:  :short      end      def  status_class          object.paid?  ?  'paid'  :  nil      end      def  formatted_value          number_to_currency  object.value      end      def  formatted_discount          number_to_percentage  object.discount      end      def  formatted_recharge_value          number_to_currency  object.recharge_value      end      def  formatted_total          number_to_currency  object.total      end      def  invoice_link          if  object.invoice.present?  &&  current_user.has_role?  :manager              link_to  invoice_path  object.invoice          end      end      def  method_label          t  object.method,  scope:  'payments.methods'      end      def  automatic_label          t  object.automatic?,  scope:  'yes_or_no'      end   end  
76. #  app/decorators/payment_decorator.rb   class  PaymentDecorator  <  Draper::Decorator      def  paid_at          l  object.paid_at,  format:  :short      end      def  status_class          object.paid?  ?  'paid'  :  nil      end      def  formatted_value          number_to_currency  object.value      end      def  formatted_discount          number_to_percentage  object.discount      end      def  formatted_recharge_value          number_to_currency  object.recharge_value      end      def  formatted_total          number_to_currency  object.total      end      def  invoice_link          if  object.invoice.present?  &&  current_user.has_role?  :manager              link_to  invoice_path  object.invoice          end      end      def  method_label          t  object.method,  scope:  'payments.methods'      end      def  automatic_label          t  object.automatic?,  scope:  'yes_or_no'      end   end  
77. Extraia lógica dos controllers O controller deve ser somente uma camada de input e output.
78. Usando Form Objects
79. class  SignupsController  <  ApplicationController      def  create          @signup  =  Signup.new(params[:signup])          if  @signup.save              redirect_to  dashboard_path          else              render  "new"          end      end   end  
80. class  SignupsController  <  ApplicationController      def  create          @signup  =  Signup.new(params[:signup])          if  @signup.save              redirect_to  dashboard_path          else              render  "new"          end      end   end  
81. class  SignupsController  <  ApplicationController      def  create          @signup  =  Signup.new(params[:signup])          if  @signup.save              redirect_to  dashboard_path          else              render  "new"          end      end   end   Delega para o form object
82. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
83. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
84. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
85. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
86. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
87. class  Signup      include  Virtus      extend  ActiveModel::Naming      include  ActiveModel::Conversion      include  ActiveModel::Validations      attr_reader  :user,  :company      attribute  :name,  String      attribute  :company_name,  String      attribute  :email,  String      validates  :email,  presence:  true      #  ...      def  save          if  valid?              persist!;  true          else              false          end      end            private      def  persist!          @company  =  Company.find_or_create_by!(name:  company_name)          @user  =  @company.users.create!(name:  name,  email:  email)      end   end   https://github.com/solnic/virtus
88. =  form_for  @signup,  url:  signup_path  do  |f|      =  f.label  :company_name      =  f.text_field  :company_name      =  f.label  :name      =  f.text_field  :name      =  f.label  :email      =  f.text_field  :email  
89. =  form_for  @signup,  url:  signup_path  do  |f|      =  f.label  :company_name      =  f.text_field  :company_name      =  f.label  :name      =  f.text_field  :name      =  f.label  :email      =  f.text_field  :email  
90. Extraia lógica dos models Skinny Controllers, Fat Models é conversa pra boi dormir. Models não são o lugar responsável por fazer TUDO sobre o seu domínio.
91. Usando Concerns
92. Usando Concerns
93. Usando Concerns Não use.
94. Usando Concerns Não use. Ou ao menos evite usar.
95. –Bryan Helmkamp, Code Climate “Any application with an app/ concerns directory is concerning.” http://blog.codeclimate.com/blog/2012/10/17/7-ways-to-decompose-fat- activerecord-models/
96. module  UserAssociations      extend  ActiveSupport::Concern      included  do          has_many  :contacts,  dependent:  :destroy          has_one  :configuration,  dependent:  :destroy          #  has_many            #  has_many            #  has_many            #  belongs_to          #  has_many            #  has_one            #  has_many            #  has_one            #  has_many            #  has_one        end   end   class  User  <  ActiveRecord::Base      include  UserAssociations      validates  :contacts,  presence:  true      validates  :email,  :name,  presence:  true   end  
97. Apesar de parecer que o código está organizado por cima, o model continua poluído É como dizer que um quarto foi arrumado depois pegar todas as roupas espalhadas, jogar de qualquer jeito em 6 gavetas e fechá-las.
98. Usando Service Objects
99. #  app/models/user.rb   class  User      has_many  :contacts      after_save  :import_contacts,  if:  :csv_file      def  import_contacts          Users::ContactsCSVImporter.import  csv_file,  user_id:  id      end   end   #  app/services/users/contacts_csv_importer.rb   module  Users      class  ContactsCSVImporter          def  self.import(csv_file,  options  =  {})              CSV.foreach(csv_file,  col_sep:  ';')  do  |row|                  #  ...                  Contact.create!(name:  name,  email:  email,  phone:  phone,   user_id:  options[:user_id])              end          end      end   end  
100. #  app/models/user.rb   class  User      has_many  :contacts      after_save  :import_contacts,  if:  :csv_file      def  import_contacts          Users::ContactsCSVImporter.import  csv_file,  user_id:  id      end   end   #  app/services/users/contacts_csv_importer.rb   module  Users      class  ContactsCSVImporter          def  self.import(csv_file,  options  =  {})              CSV.foreach(csv_file,  col_sep:  ';')  do  |row|                  #  ...                  Contact.create!(name:  name,  email:  email,  phone:  phone,   user_id:  options[:user_id])              end          end      end   end  
101. #  app/models/user.rb   class  User      has_many  :contacts      after_save  :import_contacts,  if:  :csv_file      def  import_contacts          Users::ContactsCSVImporter.import  csv_file,  user_id:  id      end   end   #  app/services/users/contacts_csv_importer.rb   module  Users      class  ContactsCSVImporter          def  self.import(csv_file,  options  =  {})              CSV.foreach(csv_file,  col_sep:  ';')  do  |row|                  #  ...                  Contact.create!(name:  name,  email:  email,  phone:  phone,   user_id:  options[:user_id])              end          end      end   end  
102. #  app/models/user.rb   class  User      has_many  :contacts      after_save  :import_contacts,  if:  :csv_file      def  import_contacts          Users::ContactsCSVFile.import  csv_file,  user_id:  id      end   end   #  app/services/users/contacts_csv_importer.rb   module  Users      class  ContactsCSVFile          def  self.import(csv_file,  options  =  {})              CSV.foreach(csv_file,  col_sep:  ';')  do  |row|                  #  ...                  Contact.create!(name:  name,  email:  email,  phone:  phone,   user_id:  options[:user_id])              end          end      end   end  
103. #  app/models/user.rb   class  User      has_many  :contacts      after_save  :import_contacts,  if:  :csv_file      def  import_contacts          Users::ContactsCSVFile.import  csv_file,  user_id:  id      end   end   #  app/services/users/contacts_csv_importer.rb   module  Users      class  ContactsCSVFile          def  self.import(csv_file,  options  =  {})              CSV.foreach(csv_file,  col_sep:  ';')  do  |row|                  #  ...                  Contact.create!(name:  name,  email:  email,  phone:  phone,   user_id:  options[:user_id])              end          end      end   end   Importer.import => CSVFile.import !
104. Refactoring é sempre melhor do que rewrite Melhorar a qualidade do seu projeto incrementalmente é a melhor saída.
105. Adapte a estrutura de diretórios A estrutura de diretórios deve seguir as suas necessidades, não fique preso ao esquema default do Rails.
106. app assets controllers helpers jobs mailers models views Estrutura do Rails
107. app … decorators forms middlewares policies serializers services Crie outros diretórios, conforme a sua necessidade
108. app features signup checkout order_listing webhooks Agrupe por contexto de negócio
109. WebhookUserSerializer WebhookCallDecorator Use Namespaces
110. Webhooks::UserSerializer Webhooks::CallDecorator Use Namespaces
111. Mantenha as dependências atualizadas Uma aplicação que não tem as dependências atualizadas é uma aplicação aberta à todos os tipos de problemas.
112. Sempre use a última versão estável do Rails Atualizar o framework não deve ser algo tão complicado, a comunidade sempre publica guias passo-a-passo quando sai novas versões.
113. Atualize também para a última versão estável do Ruby Bug fixes, falhas de seguranças corrigidas e novas funcionalidades.
114. Procure diminuir a quantidade de dependências Por que adicionar uma dependência complexa quando você pode implementar a mesma funcionalidade em poucas linhas de código?
115. Recapitulando tl;dw
116. Avalie cuidadosamente os prós e contras de cada decisão Não siga nada sem saber quais as implicações de tal arquitetura ou pattern. 1.
117. Não comece com uma arquitetura complexa Não siga nada sem saber quais as implicações de tal arquitetura ou pattern. 2.
118. Sua experiência é mais importante Não é porque funcionou para outras pessoas que vai funcionar com você. Experimente! 3.
119. Pensar fora da caixa é essencial O Rails se estabeleceu por sugerir padrões, mas os tempos mudam, não fique preso a este pensamento. 4.
120. Bom design é melhor que qualquer arquitetura Não adianta redefinir a arquitetura se no fim o código continuar ruim. 5.
121. Obrigado! @mateusg mateusg.18@gmail.com