Blog.Impact - Home

Ajude a sustentar a Wikipédia e outros projetos sem colocar a mão no bolso, e concorra a um Eee PC!

2008-06-28T06:08:00Z

Ajude a sustentar a Wikipédia e outros projetos, sem colocar a mão no bolso, e concorra a um Eee PC!
…e também a pen drives, card drives, camisetas geeks, livros e mais! O BR-Linux e o Efetividade lançaram uma campanha para ajudar a Wikimedia Foundation e outros mantenedores de projetos que usamos no dia-a-dia on-line. Se você puder doar diretamente, ou contribuir de outra forma, são sempre melhores opções. Mas se não puder, veja as regras da promoção e participe - quanto mais divulgação, maior será a doação do BR-Linux e do Efetividade, e você ainda concorre a diversos brindes!

Fixtures para Polymorphic Associations com o Rails 2

2008-06-08T16:00:00Z

Uma dica rápida de como fazer suas fixtures para associações polimórficas. Digamos que a estrutura abaixo faz parte de sua aplicação:

  class Address < ActiveRecord::Base
    belongs_to :addressable, :polymorphic => true
  end
    
  class Person < ActiveRecord::Base
    has_one :contact, :as => :addressable
  end
  
  class Company < ActiveRecord::Base
    has_one :contact, :as => :addressable
  end

Abaixo as fixtures para esses modelos:

  # Person
  daviscabral:
    username: daviscabral
    password: super_secret
    
  # Company
  impact:
    name = Impact Media
    
  # Address
  daviscabral_address:
    contactable: daviscabral (Person)
    address: Rua Meia Mole, 69 
  
  impact_address:
    addressable: impact (Company)
    address: Av. Brazuca, 999

O grande detalhe, é o (class_name) que é a chave que define o campo type do relacionamento.

Livro de Rails 2.1

O Carlos Brando, do blog Nome do Jogo, publicou o primeiro livro que cobre as novas funcionalidades de Rails 2.1. Junto do Marcos Tapajós, que deu uns tapas no livro revisando e escrevendo o código do fazedor de livros, e do Daniel Lopes, que fez a capa. Bem, códigos do fazedor de livros? Isso mesmo, eles escreveram um projeto em ruby que gera o PDF do livro.

O projeto está no Github e a galera está convidada a ajudar a traduzir para o inglês.

Ótima iniciativa de todos os envolvidos. A comunidade só ganha com atitudes como essa.

Sem perder tempo, fica também a dica do projeto para escrita de livros feito pelo Nando Vieira, do blog Simples idéias. O projeto é muito parecido, mas parece que ambos tiveram a mesma idéia.

Fica a minha sugestão para um merge dos projetos! :-)

Nova fase

Não comentei sobre isso aqui no Blog, mas fazem alguns meses que me desliguei da empresa onde trabalhava. Com a saída de lá, estou podendo me dedicar muito ao Rails e a projetos pessoais.

Com essas mudanças, aderi totalmente as melhores práticas, desde o SCRUM até o BDD. Isso acabou me levando a comprar um MacBook, e a testar o famoso textmate. Realmente o Mac OS é incrível. O textmate não fica atrás, nem as várias coisas novas que ando experimentando com essa nova aquisição.

Na quarta-feira passada, tive a oportunidade de presenciar e participar da primeira palestra sobre SCRUM aqui em Cascavel, PR, que foi realizada na Unioeste. Fiz uma gravação, mas o audio não saiu muito bom. Estou providenciando um microfone bluetooth para ver se a coisa fica melhor.

Demos uma introdução ao SCRUM e também já demos sinais que as próximas palestras e/ou mini-cursos serão sobre testes, mão na massa mesmo. Podem surgir bons artigos a respeito disso.

Polymorphic resources, de uma forma DRY

2008-05-25T18:00:00Z

Modelo polimórfico

Um modelo polimórfico pode pertencer a mais de uma classe modelo pai. Por exemplo, Comments pode pertencer a Articles e Documents.

Para isso teriamos um campo string chamado type em nossa tabela comments. Esse campo é chave no Rails e é preenchido com a classe do modelo pai num relacionamento polimórfico.

Nossos modelos ficariam como abaixo:

class Article < ActiveRecord::Base
  has_many :comments, :as => :commentable
end

class Document < ActiveRecord::Base
  has_many :comments, :as => :commentable
end

class Comment < ActiveRecord::Base
  belongs_to :commentable, :polymorphic => true
end

Dessa maneira, você pode referenciar article.comments e document.comments para seus objetos Article e Document, respectivamente.

Rotas para nosso controlador polimórfico

Agora temos nossos modelos Article e Document possuindo o mesmo modelo Comment. Definindo nossas rotas, veremos que ele será polimórfico também, pois vai estar aninhado aos controladores Articles e Documents .

Abaixo as rotas:

1234	ActionController::Routing::Routes.draw do \|map\| map.resources :articles, :has_many => [ :comments ] map.resources :documents, :has_many => [ :comments ]end

Abaixo exemplo de alguns itens gerados a partir dessas duas rotas:

article_comment_path(@article,@comment) # => /articles/1/comments/22
article_new_comment_path(@article)     # => /articles/1/comments/new

document_comment_path(@document,@comment) # => /documents/1/comments/22
document_new_comment_path(@document)     # => /documents/1/comments/new

Controlador polimórfico

Através das novas rotas, vimos que um comentário poderia ser criado a partir de /articles/1/comments/new ou /documents/1/comments/new. Podemos fazer com que nosso controlador gerencie isso de uma forma simples, como abaixo:

class CommentsController < ApplicationController
  
  def new
    @parent = parent_object
    @comment = Comment.new
  end

  def create

    @parent = parent_object
    @comment = @parent.comments.build(params[:comment])

    if @comment.valid? and @comment.save
      redirect_to parent_url(@parent)
    else
      render :action => 'new'
    end

  end

private

  def parent_object
    case
      when params[:article_id] then Article.find_by_id(params[:article_id])
      when params[:document_id] then Document.find_by_id(params[:document_id])
    end    
  end  

  def parent_url(parent)
    case
      when params[:article_id] then article_url(parent)
      when params[:document_id] then document_url(parent)
    end    
  end
    
end

Faz o que precisa? Faz. Mas isso pode ser mais bonito. Dessa forma, sempre que adicionar-mos um item que pode receber um comentário, ele deverá criar uma nova condição em nossos case. Para isso, vamos passar todo esse código de forma genérica para nosso ApplicationController.

class ApplicationController < ActionController::Base
  
protected

  class << self
  
    attr_reader :parents
  
    def parent_resources(*parents)
      @parents = parents
    end
  
  end

  def parent_id(parent)
    request.path_parameters["#{ parent }_id"]
  end

  def parent_type
    self.class.parents.detect { |parent| parent_id(parent) }
  end
  
  def parent_class
    parent_type && parent_type.to_s.classify.constantize
  end
   
  def parent_object
    parent_class && parent_class.find_by_id(parent_id(parent_type))
  end
  
end

class CommentsController < ApplicationController
  
  parent_resources :article, :document
  
  def new
    @parent = parent_object
    @comment = Comment.new
  end

  def create

    @parent = parent_object
    @comment = @parent.comments.build(params[:comment])

    if @comment.valid? and @comment.save
      redirect_to send("#{ parent_type }_url", @parent)
    else
      render :action => 'new'
    end

  end
    
end

Essa solução foi publicada inicialmente por Val Aleksenko, em seu blog Revolution On Rails. Através dela, criei um plugin chamado parent_resources.

Isso será adicionado ao Edge e já tem um patch sendo desenvolvido. Então esse plugin tem um tempo bem curto de vida. Mas a solução me salvou de várias repetições de código. Fica ae para o caso de alguem precisar.

Trabalho com equipes remotas, posso utilizar SCRUM?

2008-05-23T15:00:00Z

Sim, você pode! Mas o correto seria perguntar como e não se pode!

Em alguns dias de pesquisa sobre ferramentas online para o auxilio e redução de consumo de papel (na busca de uma prática sustentável sem perder a produtividade), encontrei duas ferramentas que me chamaram a atenção e me fizeram publicar esse texto.

Mas a relação custo x benefício dessa prática não me agradou. A produtividade não me parece ser a mesma, quando se utiliza esses scrum-boards virtuais. O impact visual que um quadro branco tem na sua frente, durante seu dia de trabalho, é muito maior que um site onde você entra quando quer para ver as tarefas pendentes, ou faz um trabalho de estimativa.

Mas se é a única alternativa, no caso de equipes remotas, é melhor do que nada.

NOTA: Observei que se for possível, utilizar dois monitores, mantendo o SCRUM board virtual aberto em um dos monitores durante seu dia, essa questão do impacto visual diminui. Mas trocamos os gastos com papel por gastos com energia.

NOTA: Em uma empresa que visitei e está iniciando a aplicação do SCRUM agora, verifiquei a utilização de um scrum-board de vidro, e seus traços feitos com fitas coloridas. O uso de números identificando documentos relacionados as tarefas ao invés de post-its. É uma alternativa também.

Planning poker

Encontrei o site Planning Poker, que proporciona o jogo de cartas para estimativa online. Você, como product owner, acessa o sistema sendo moderador e convida seu time de desenvolvedores para fazer as estimativas através de uma URL. Os membros acessam essa URL e aguardam as histórias e o início das contagens para mostrar o resultado. Ele fornece opções para contar sua estória de forma estruturada, onde você responde algumas questões, ou de forma livre, onde é aceito qualquer coisa.

Após contar sua estória, você inicia a contagem do tempo. Após o resultado, você passa para a próxima estória. Uma mão na roda para quem não tem possibilidade de estar se encontrando frequentemente.

Na primeira reunião do projeto Marca Pelada, foi montado todo o product backlog sem estimativas. O planningpoker.com será utilizado para estimar e após esse resultado, será colocado aqui um update dessa experiência.

Scrum board

O scrum-board virtual realmente é um problema. Encontrei várias opções para uso no desktop, com alguma ajuda de um papél de parede interessante você consegue um bom resultado. Mas o impacto visual realmente fica prejudicado. E vai totalmente contra o DRY você ficar atualizando um scrum-board com as tarefas que os outros da sua equipe fizeram ao final da sua tarefa.

Mas como nem tudo são flores no desenvolvimento remoto, ou você faz isso ou utiliza sistemas online para controle de tarefas compartilhadas. Um simples todo ou até mesmo um aplicativo que gera os burndown chart, como o Acunote.com. Para um único projeto ele é gratuito. Após o cadastro, ele tem alguns dados preenchidos para demonstração.

Incrivelmente foi a única ferramenta que encontrei para esse tipo de controle. Mas unindo controles de versão, sistemas de tickets e um wiki, você consegue muito bem fazer o controle de forma objetiva e bem similar.

O importante é uma forma única e ágil da equipe se comunicar.

Mais recursos

Scrum Alliance – Resources

Planning poker

2008-05-22T01:00:00Z

Um dos métodos de estimativas mais comuns no SCRUM é o uso do planning poker, um jogo de cartas numeradas com uma sequência de Fibonacci. A idéia é pontuar suas estórias, e a primeira estória pontuada serve como referência para pontuar as seguintes.

As cartas são geralmente as seguintes (pelas explicações que li, o modelo abaixo me parece o mais correto):

Ok… Mas qual o porquê dessa série de números?

Simples, os números menores conseguem ser mais precisos e refletem muito bem algo realmente possível de realizar. Os número maiores não são estórias muito claras, difíceis de estimar e que devem ser transformadas em estórias menores. Numa escala coerente, estimativas com números maiores que 13 já levantam questões como: “Isso é mesmo uma estória?”, “Isso não poderia ser quebrado em estórias menores?”, etc.

Cartas especiais

	Feito Essa estória já foi realizada, ou é tão simples, que levará apenas alguns minutos para ser realizada.
	Sem idéia Não se tem a mínima idéia do tempo que essa estória pode levar.
	Hora da pausa Hora de fazer uma pausa para descansar um pouco.

Como funciona

Cada membro da equipe possui um conjunto dessas cartas.

O product owner, junto da equipe, seleciona a estória que mais se aproxima de uma pontuação 2. Essa pontuação no momento, é apenas 2, não significa 2 dias, nem duas horas¹.

A questão aqui é definir uma estória referência. Apartir dessa estória, serão feitas as estimativas para outras estórias seguindo o planning poker.

Todos pensam, selecionam suas cartas e as pões sobre a mesa com o verso para cima. Quem não prestou atenção, acaba não tendo saída e pedir que o product owner explique novamente a estória.

Se houverem muitas divergências de opiniões, o que é comum, o menor valor estimado e o maior, explicam o motivo que os levou a estimar tal valor, questão de um minuto mesmo. É feita a rodada de estimativas novamente. Havendo consenso, a estória fica estimada e se passa para a próxima. Se ainda houverem muitas divergências, outra rodada se torna necessária, se nessa rodada nada for decidido, toma-se a opinião da maioria como a real. É importante que o SCRUM master esteja envolvido para evitar discussões e brincadeiras durante esse momento.

Atenção: Esse artigo foi baseado em uma palestra realizada pelo Juca, do CESAR, através do Treina Tom e na página Planning Poker. Sendo partes do texto apenas transcrições do texto original.

¹ Story points parece ser a forma mais bacana de estimar, mesmo parecendo ser algo muito abstrato inicialmente. Essa abstração se vai, apartir do momento em que o primeiro sprint é executado. No final do sprint, essa pontuação virou referência, e já pode ser considerada num gráfico pontos x tempo.

Como saber quanto tempo eu levo para um projeto?

2008-05-04T15:30:00Z

A resposta é simples: medindo!

Se você nunca medir, nunca saberá o tempo que leva. Todo trabalho de estimativa baseia-se na experiência (registros passados) do tempo que levou. Medir o tempo pode parecer uma coisa simples, mas é importante ser sempre pessimista, problemas podem ocorrer, e todo o tempo que ganhou no projeto, pode ser perdido na última tarefa.

Estimativa é um indicador, e como qualquer outro indicador, você precisa de uma referência. Se você nunca mediu seu tempo, comece agora, sem esses dados suas estimativas serão chutes, e a entrega do projeto na data marcada será uma loteria.

Divida todo seu trabalho em tarefas equivalentes. Reduza seu nível ao mais operacional possível, onde você possua apenas instruções de trabalho. Um exemplo disso é uma tarefa “Programar formulário de cadastro de pessoas”. Reduzindo ao nível mais operacional possível, você evita que a evolução das tarefas possam ser mensuradas (a tarefa A está 78% concluída) e acabem não mostrando sua real evolução dentro do projeto.

Isso não é novo, o SCRUM prega isso, e nele uma tarefa só pode estar pendente, em andamento ou concluída. Estou no início dos meus estudos sobre SCRUM, e pode ter muita coisa que eu entendi errado, mas de qualquer forma, aprendi uma porção de coisas bacanas que podem ajudar mesmo não sendo o padrão correto.

Meu maior problema era definir o que seria uma estória e o que seria uma tarefa. Um exemplo que me ajudou a definir isso esta no livro Scrum and XP from the Trenches e segue abaixo de maneira simplificada:

Quebrando suas estórias em estórias menores

Quebrando estórias em tarefas

Então, defina suas estórias, suas tarefas e então inicie seus trabalhos. Leia sobre SCRUM e XP para ter uma idéia melhor, acredito que isso lhe ajudará muito mesmo, não apenas no seu trabalho, mas para organização de sua vida.

Após o início dos seus trabalhos, acompanhe a evolução do seu trabalho x tempo. Esse indicador é muito importante e será, após a conclusão dos trabalhos, seu indicador base. Vai ser com ele que você saberá o tempo real necessário para concluir um número X de tarefas. É um número aproximado, mas é melhor que número nenhum.

Com isso, você terá uma estimativa real – aproximada, mas real – do potencial de trabalho que tem em mãos. Como ele será possível definir os trabalhos que poderão ser feitos em determinado tempo e até planos para melhoria desse potencial, como treinamentos, aumento do número de pessoas na equipe ou até mesmo troca de membros que possam não estar se adequando a forma de trabalho.

Mais informações podem ser encontradas nos links abaixo:

STI e Polymorphic associations

2008-05-03T17:00:00Z

Essa semana me deparei com um problema: meus modelos que herdavam do modelo User, faziam parte de uma associação polimórfica, onde cada tipo distinto de usuário, poderia ter um vepiculo. Esse problema é documentado no manual, e para utilizar <abbrv title="Single Table Inheritance">STI</abbrv> com associações polimórficas é necessário uma pequena alteração no seu modelo.

O meu problema era, que ao chamar current_user.vehicles.find ele pesquisava por veículos com owner_type igual a User.

Quando utilizo associações polimórficas, eu preciso de dois campos para isso, o campo que armazena o código, id, e o campo que armazena o tipo, type. Como minha associação se chama owner, meu modelo possui dois campos owner_id e owner_type.

Mas na hora do meu cadastro, o tipo armazenado no veículo era Manager, que é um modelo <abbrv title="Single Table Inheritance">STI</abbrv> de User.

Para o uso de associações polimórficas com <abbrv title="Single Table Inheritance">STI</abbrv> eu preciso de um pequeno ajuste no meu modelo Vehicle para que ele armazene a classe base do objeto que estiver sendo fornecido como owner, como está no código abaixo:

class Vechile < ActiveRecord::Base
  belongs_to :owner, :polymorphic => true

  def owner_type=(sType)
     super(sType.to_s.classify.constantize.base_class.to_s)
  end
end

class User < ActiveRecord::Base
  has_many :vehicles, :as => :owner, :dependent => :destroy
end

class Manager < User
end

class Administrator < User
end

Blog.Impact - Home

Ajude a sustentar a Wikipédia e outros projetos sem colocar a mão no bolso, e concorra a um Eee PC!

Fixtures para Polymorphic Associations com o Rails 2

Livro de Rails 2.1

Nova fase

Polymorphic resources, de uma forma DRY

Modelo polimórfico

Rotas para nosso controlador polimórfico

Controlador polimórfico

Trabalho com equipes remotas, posso utilizar SCRUM?

Planning poker

Scrum board

Mais recursos

Planning poker

Ok… Mas qual o porquê dessa série de números?

Cartas especiais

Feito

Sem idéia

Hora da pausa

Como funciona

Como saber quanto tempo eu levo para um projeto?

Quebrando suas estórias em estórias menores

Quebrando estórias em tarefas

STI e Polymorphic associations