Strategic standardization

This keynote takes a look at standardization and the effects it may have when applied in a chain of multiple layers. It then connects to how Rails uses conventions and the new Ruby LSP add-on API, which is trying to standardize editor integrations.

Transcript

1. Vinicius Stock Padronização estratégica Direcionando inovação
2. Vinicius Stock X / GitHub: @vinistock Bsky: @vinistock.bsky.social Website: https://vinistock.com Sta ff dev @ Ruby DX team
3. Shopify
4. Ruby LSP Sorbet Tapioca Debug IRB RDoc
5. Vamos começar com dois exemplos de padronização
6. Checkout de clientes em lojas
7. Checkout Maçã fuji
8. Maçã fuji……………………$0.50 Checkout
9. Maçã fuji……………….…….$0.50 Maçã gala……………………$0.60 Checkout
10. Maçã fuji……………….…….$0.50 Maçã gala……………….……$0.60 Banana.………….……………$0.80 Alface (2)…………..….…….$1.50 Checkout
11. Maçã fuji……………….…….$0.50 Maçã gala……………….……$0.60 Banana.………….……………$0.80 Alface (2)…………..….…….$1.50 ——————————————-————- $2.90 Checkout
12. Checkout Maçã fuji……………….…….$0.50 Maçã gala……………….……$0.60 Banana.………….……………$0.80 Alface (2)…………..….…….$1.50 ——————————————-————- $2.90 Arroz…….……………….……$1.30 Feijão.…………….……………$1.50 Cenoura……………..….…….$0.70 ——————————————-————- $3.50 Repolho…….…………………$0.70 Tomate.…………….…………$0.90 Massa………………..….…….$1.20 Suco de laranja.…….…….$1.10 Suco de maçã.……….…….$1.10 ——————————————-————- $3.90 Uva (2).…….…………………$1.50 Leite (3)..………….…………$2.30 Batata………………..….…….$1.50 ——————————————-————- $5.30
13. 🚚 Checkout
14. Entrega 03/04/1952 Maçã gala (50) Maçã fuji (30) Banana (15) Alface (30) Checkout
15. Controle 03/04/1952 Maçã gala (70) Maçã fuji (43) Banana (18) Alface (41) … Chega o momento de auditar a loja Checkout
16. Processo ine fi ciente e com margem para erros
17. Source: https://en.wikipedia.org/wiki/Barcode Código de barras ~1970s
18. Código de barras # db/schema.rb create_table "products" do |t| t.string "bar_code_id" t.integer "price" end
19. Código de barras # db/schema.rb create_table "checkouts" do |t| end create_table "checkout_entries" do |t| t.bigint "product_id" t.bigint "checkout_id" t.integer "quantity" end
20. Análise de dados recentes e históricos Código de barras Cash tracking Alertas de inventário Pedido de estoque (semi-)automatizado Self checkout
21. E fi ciência através de sistemas Código de barras Os sistemas foram criados baseados na padronização do código de barras
22. Código de barras Se cada loja usasse um identi fi cador diferente, parte dos esforços seriam gastos em compatibilidade
23. Carga e descarga em um porto
24. Source: https://en.wikipedia.org/wiki/Breakbulk_cargo Carga solta (breakbulk cargo)
25. Source: https://en.wikipedia.org/wiki/Breakbulk_cargo Itens ainda são empacotados, mas sem padronização
26. Source: https://www.archives.gov/ fi les/research/american-cities/images/american-cities-069.jpg Author: Lewis Hine circa 1912 Public Domain
27. Source: https://en.wikipedia.org/wiki/Breakbulk_cargo Requer equipes grandes A carga ocupa mais espaço A ine fi ciência aumentava o tempo no porto
28. O container A partir de 1967, a carga e descarga passou por transformações signi fi cativas Padronização do container Sources: https://en.wikipedia.org/wiki/Breakbulk_cargo https://en.wikipedia.org/wiki/Containerization
29. Source: http://www.photolib.noaa.gov/coastline/line3174.htm Author: Captain Albert E. Theberge, NOAA Corps (ret.) - June 2004
30. O container Redução de custos entre 80-90% Sources: https://en.wikipedia.org/wiki/Breakbulk_cargo https://en.wikipedia.org/wiki/Containerization Diminuiu o tempo que navios fi cam nos portos Minimizou o tamanho das equipes Otimizou o armazenamento
31. O container A tecnologia necessária pra carga e descarga já existia A padronização das dimensões do container
32. O valor não está no código de barras ou no container (no padrão escolhido) mas sim no ato de padronizar
35. Rails Padronização no Ruby Convention over con fi guration
36. bin src con fi g test log products payments app db_models route_actions jobs models controllers structure.json
37. { "components": { "products": { "models": "src/products/models", "controllers": "src/products/controllers" }, "payments": { "models": "src/payments/db_models", "controllers": "src/payments/db_actions", "jobs": "src/payments/jobs" } } } Padronização no Ruby
38. Padronização no Ruby bin app con fi g db lib test log models controllers jobs
39. Estrutura de diretórios Padronização no Ruby Mapa de entidades
40. class User def name @db_fields[“user_name”] end end Padronização no Ruby
41. Padronização no Ruby # db/schema.rb # . . . create_table "users" do |t| t.string "name" end class User; end user.name user.name = "Vini"
42. Estrutura do banco de dados Padronização no Ruby Estrutura dos modelos
43. class UsersController < ApplicationController before_action :set_user, only: [:show] def index @users = User.where( . . . ) end def show; end private def set_user @user = User.find(params[:id]) end end
44. class SendEmailJob < ApplicationJob retry_on FailedToSendError def perform end end SendEmailJob.perform_now SendEmailJob.perform_later
45. Estrutura dos objetos de controller e job Padronização no Ruby Mapeamento de ações
46. Rails permite que os devs foquem onde importa: Padronização no Ruby na lógica do negócio
47. Quebrando padrões Estamos falando dos lados positivos de padrões
48. Quebrando padrões Padrões podem fi car desatualizados Quebrar padrões existentes também pode trazer inovação
49. Teclado QWERTY Sources: Image: iPhone screenshot https://en.wikipedia.org/wiki/QWERTY Koichi Yasuoka* and Motoko Yasuoka†, “On the Prehistory of QWERTY” - ZINBUN 2009/2010 No.42 *Institute for Research in Humanities, Kyoto University †Faculty of Foreign Studies, Kyoto University of Foreign Studies
50. Teclado DVORAK Sources: https://en.wikipedia.org/wiki/Dvorak_keyboard_layout Image: iPhone screenshot
51. Quebrando padrões Externalidade: máquinas já produzidas, fábricas já especializadas Convenção cultural: pessoas já sabem digitar com o padrão
52. Sources: https://survey.stackover fl ow.co/2024/technology https://survey.stackover fl ow.co/2022/#technology https://survey.stackover fl ow.co/2020#technology 1st JavaScript 2nd HTML/CSS Quebrando padrões
53. Quebrando padrões Externalidade: navegador Convenção cultural: devs já sabem JS/HTML/CSS
54. Quebrando padrões Maior qualidade ou benefícios nem sempre são su fi cientes pra quebrar um padrão existente
55. Padrão existente Padrão novo + externalidades + convenções culturais
56. Ruby LSP Uma tentativa de padronização
58. Ruby LSP Queríamos features especí fi cas pra gems mas colocar tudo na Ruby LSP não daria certo Como permitir que gems adicionem funcionalidade?
59. Ruby LSP add-ons API para outras gems contribuir funcionalidade para a Ruby LSP Projetos também podem ter add-ons privados Carregados automaticamente https://shopify.github.io/ruby-lsp/add-ons.html
60. Ruby LSP add-ons Não é necessário criar um plugin pro editor Não é necessário implementar um language server Não é necessário implementar ferramentas de static analysis https://shopify.github.io/ruby-lsp/add-ons.html
61. Fundação do language server Request/response cycle Incoming and outgoing message queues Worker pool Basic LSP interface Indexing + static analysis tooling Implementação das funcionalidades Integrações API
62. Ruby LSP RuboCop Standard Reek Brakeman Rake Shoulda Fabrication Action Policy Rspec Rails Rubyfmt Tapioca
63. Ruby LSP RuboCop Standard Reek Brakeman Rake Fabrication Action Policy Rspec Rails Rubyfmt Tapioca Shoulda Model context protocol (MCP)
65. Oportunidades para padronização Onde mais há espaço pra padronização?
66. Comandos do terminal # Rake TEST="test/foo_test.rb" bundle exec rake test # Minitest / Test Unit bundle exec ruby -Itest test/foo_test.rb # RSpec bundle exec rspec spec/foo_spec.rb
67. Comandos do terminal # A ação é sempre a mesma. # Não interessa qual é o framework ruby test test/foo_test.rb
68. Comandos do terminal ruby run gem_executable|project_executable ruby format ruby lint ruby test ruby debug
69. Version managers rbenv chruby rvm asdf Mise Shadowenv RubyInstaller Frum Homebrew ruby-install direnv
70. Instalação do Ruby # rbenv ~/.rbenv/versions # asdf ~/.asdf/installs/ruby # ruby-install / chruby ~/.rubies # RubyInstaller C:\Ruby33-x64
71. Instalação de gems # Padrão ~/.gem/ruby/3.3.0 # chruby ~/.gem/ruby/3.3.2 # rvm ~/.rvm/gems/ruby-3.3.2@gemset_name # Bundler BUNDLE_PATH
72. Executáveis de gems # Adiciona ao PATH. Executáveis são # invocados diretamente ~/.gem/ruby/3.3.0/bin # Utiliza shims. As shims são invocadas # pra ativar o ambiente do Ruby e então # invocam os executáveis definidos pelas # gems ~/.rbenv/shims/bin/ruby-lsp
73. Descobrir onde estão instaladas as dependências de um projeto hoje requer: Integração com o version manager do usuário Integração com o Bundler Ou que a ferramenta só seja executada no shell
74. Instalação de Ruby e gems # Ruby ~/.rubies/ruby-3.3.2
75. Instalação de Ruby e gems # Ruby ~/.rubies/ruby-3.3.2 # Gems ~/…/project_path/vendor/bundle
76. Instalação de Ruby e gems # Ruby ~/.rubies/ruby-3.3.2 # Gems ~/…/project_path/vendor/bundle # Executáveis ruby run rubocop = > ~/…/project_path/vendor/bundle/bin/rubocop
77. Padronização não é uniformidade total A existência do código de barras, não diminui a variedade de lojas A existência do container, não diminui a variedade de produtos transportados
78. Padronizar as ferramentas de desenvolvimento não vai nos impedir de criar mais opções Integrações mais robustas Mais funcionalidades
79. Obrigado