Inspecionando fórmulas no ruby

Em 2009, criei um projeto no github com as fórmulas basicas de "gerência de projetos", o qual condecorei com o nome Sopa de Letrinhas para gerência de projetos. O objetivo deste repositório era reunir as fórmulas que me atormentavam ao serem cálculadas manualmente.

Durante o desenvolvimento, encarei muitas dificuldades na inspeção das fórmulas. Como não estava escrevendo testes, então encontrei uma maneira de visualizar o desenvolvimento das fórmulas. O objetivo deste post, é exibir a facilidade de inspecionar um código simples. Os exemplos aqui, são apenas fragmentos do projeto original aonde possui a explicação de cada uma das variáveis.

O exemplo abaixo aborda apenas a especificação dos valores necessários para o uso de cada fórmula.

percentual = 30/100.0
bac = 100_000_000
ac  = 35_000
pv  = 25_000 

A variável percentual, refere-se ao percentual realizado do projeto. Já o bac refere-se ao total orçado para o projeto. O ac refere-se ao custo gasto até o momento, e pv refere-se ao valor planejado.

As fórmulas a seguir, referêm-se aos variáveis acima atribuídas.

formulas = [
  "ev = (bac*percentual)",
  "cv = ev - ac",
  "cpi = ev / ac",
  "spi = ev / pv",
  "sv = ev - pv",
  "eac = bac / cpi",
  "etc = bac - ev"
]

A declaração acima, trata cada fórmula como uma string. O objetivo agora é substituir a string pelas variáveis reais. Para isso é necessário iterar sobre as fórmulas e executá-las através do comando eval, que é capaz de executar um código ruby, apartir de uma string.

Como o objetivo aqui é inspecionar as fórmulas, após a execução da fórmula, será impresso a expressão da fórmula, substituindo a variável pelo seu valor.

for formula in formulas 
  eval formula
  puts "#{formula}: #{formula.gsub(/\w+/){|r|eval(r).to_s}}"
end

Quando as três partes de código acima descritas são executadas, nesta mesma sequência, o seguinte resultado é exibido:

ev = (bac*percentual): 30000000.0 = (100000000*0.3)
cv = ev - ac: 29965000.0 = 30000000.0 - 35000
cpi = ev / ac: 857.142857142857 = 30000000.0 / 35000
spi = ev / pv: 1200.0 = 30000000.0 / 25000
sv = ev - pv: 29975000.0 = 30000000.0 - 25000
eac = bac / cpi: 116666.666666667 = 100000000 / 857.142857142857
etc = bac - ev: 70000000.0 = 100000000 - 30000000.0

Pronto! A parte em que realmente faz a inspeção da fórmula não passa de:

  formula.gsub(/\w+/){|r|eval(r).to_s}

Ou seja, cada variável é capturada da fórmula usando \w+ e resgatado o seu valor através do eval, e substituído na fórmula, mantendo apenas os operadores.

Da mesma forma como o gsub permite usar capturar o valor de cada casamento usando \&, também pode ser tratado como string, quando declarado um bloco de código como segundo parâmetro do gsub.

Abaixo segue o help que gerei pensando em informar o objetivo de cada variável:

help = {
  "PV – Planned Value" => 
     "É o valor estimado do trabalho planejado a realizar até uma data determinada.
      Por exemplo, se um projeto tem um orçamento de R$ 100.000,00
      para realizar em um prazo de 12 meses, então o mês 6 representará o 50% do trabalho do projeto, 
      portanto, o PV para o mês 6 será de R$ 50.000,00",

  "EV - Earned Value" => 
      "É o valor planejado do trabalho realmente completado até uma data determinada.
       Por exemplo, se um projeto tem um orçamento de R$ 100.000,00 
       e o trabalho completado em uma data determinada representa o 25% do projeto completo, 
       o EV será de R$ 25.000",

  "AC - Actual Cost" =>
      "É o gasto real incorrido para o trabalho realmente completado 
       Por exemplo, se um projeto tem um orçamento de R$ 100.000,00 
       e o gasto real até uma determinada data foi de R$ 35.000,00 
       o AC do projeto é de R$ 35.000,00",
        
  "BAC - Budget at Completion" => "Orçamento total do projeto",

  "ETC - Estimate to completion" => "Estimativa para terminar",

  "EAC - Estimate at complete" => "Quanto espero gastar ao final do projeto. 
       Ou seja, baseado na experiência do projeto qual será o custo final. 
       Há várias formulas diferentes para calcular o EAC",

  "SV - Scheduled Variation" => "Variação do Cronograma/Prazos
       SV é a diferença, em termos de custos, entre o Valor Agregado (EV) 
       e a agenda da linha de base (PV). Se SV for positiva, estará adiantado;
       Se SV for negativa, estará atrasado;",

   "SPI - Scheduled Performance Index" => "Índice de Performance do Cronograma/Prazos
    SPI: é a divisão entre o Valor Agregado (EV) e o valor planejado na linha de base (PV).
    Mostra a taxa de conversão do valor previsto em valor agregado. Se SPI for maior que 1,
    o projeto está sendo realizado a uma taxa de conversão maior do que a prevista, ou seja, adiantado; 
    Se SPI for menor que 1, o projeto está sendo realizado a uma taxa de conversão menor do que a prevista, 
    ou seja, atrasado;"
}

ps: Não sou fãn desta método de gerência de projetos, o objetivo aqui é puramente exibir as funcionalidades do eval e gsub em Ruby.


blog comments powered by Disqus
Compartilhar → Twitter Facebook Google+


Olá, sou o Jônatas Davi Paganini e esse é meu blog. Sou programador, tenho alguns projetos no github e escrevo livremente aqui no ideia.me.

Veja minhas talks ou conecte-se via twitter / github / instagram / facebook / linkedin / soundcloud / strava / meetup.