<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Caio Carrara on Medium]]></title>
        <description><![CDATA[Stories by Caio Carrara on Medium]]></description>
        <link>https://medium.com/@caiowcc?source=rss-afae5bba973a------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*gFXJ5KO73DUG9vNGKBhLwQ.png</url>
            <title>Stories by Caio Carrara on Medium</title>
            <link>https://medium.com/@caiowcc?source=rss-afae5bba973a------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 23:18:24 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@caiowcc/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Usando o Slack ao seu favor]]></title>
            <link>https://medium.com/olist/usando-o-slack-ao-seu-favor-8f4a0c29319d?source=rss-afae5bba973a------2</link>
            <guid isPermaLink="false">https://medium.com/p/8f4a0c29319d</guid>
            <category><![CDATA[produtividade]]></category>
            <category><![CDATA[trabalho-remoto]]></category>
            <category><![CDATA[slack]]></category>
            <dc:creator><![CDATA[Caio Carrara]]></dc:creator>
            <pubDate>Mon, 14 Aug 2017 15:21:44 GMT</pubDate>
            <atom:updated>2017-08-14T15:21:44.463Z</atom:updated>
            <content:encoded><![CDATA[<h4>Eficiência e produtividade na comunicação</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wYc1khh6EhYOAktjO26cWA.png" /><figcaption>Slackbot</figcaption></figure><blockquote>O método mais eficiente e eficaz de transmitir informações para e entre uma equipe de desenvolvimento é através de conversa face a face.</blockquote><p>Aqui no Olist damos extrema importância para a comunicação entre as pessoas dos times. Temos diversos desafios interessantes e complexos para resolvermos e se não estivermos sincronizados no tocante às informações do negócio, às novidades de cada área ou mesmo sobre a cultura que move a empresa, podemos colocar todos os planos em risco.</p><p>Dada a nossa natureza distribuída, temos algumas ferramentas que nos auxiliam na comunicação. Uma delas é o Slack. Todas as pessoas da empresa estão nesse canal e acaba sendo o ponto chave para a troca de informações entre os squads. Entretanto percebemos que se não o utilizarmos bem, o que era para ser um auxiliador pode se tornar o principal vilão na perda de produtividade e fator de distração.</p><p>Estamos constantemente aprendendo como utilizar melhor as funcionalidades do Slack e quais as melhores práticas na utilização da ferramenta para que possamos tirar o melhor proveito dela. Assim sendo, resolvemos compartilhar o que estamos aplicando até o momento pois pode ser útil para outras pessoas.</p><h4>Notificações</h4><p>Ser notificado de toda e qualquer mensagem que é enviada para os canais em que faz parte é inviável. Não ser notificado nunca também não é o mais indicado. Assim, preferimos ajustar para que haja notificações em caso de menções ou na ocorrência de determinadas palavras chave. Essa regra também serve para notificações do tipo &quot;push&quot; nos dispositivos móveis.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/531/1*6IpA2CNNGJdrZoa4yNYaUw.png" /><figcaption>Minha configuração para notificações no Slack</figcaption></figure><p>Em conjunto com uma boa escolha de palavras chaves para notificação é possível manter-se informado das comunicações pertinentes sem ser interrompido constantemente.</p><h4>Interrupções</h4><p>Ser interrompido pelos colegas é algo corriqueiro em diversas empresas. Quando essa interrupção afeta alguém que esteja desempenhando um trabalho criativo que exige alta concentração, como é o desenvolvimento de software, o prejuízo de um momento de desvio de atenção pode ser ainda muito maior. Assim sendo, cabe escolher atentamente quando e como interromper um colega de trabalho.</p><p>Quando alguém está com alguma dúvida que não necessariamente precisa ser respondida por uma pessoa específica, é mais indicado que sejam utilizados os canais. Para isso é importante a organização de todo time em canais significativos para a empresa. No caso do Olist temos um canal para todos da empresa e diversos outros canais para cada squad. Se tenho alguma dúvida referente a publicação de produtos, por exemplo, eu posso utilizar o canal do squad de publicação ao invés de interromper uma pessoa especificamente.</p><p>Um ponto super importante na utilização dos canais, que sempre gera dúvidas, é a utilização mais apropriada do <strong>@here </strong>e do<strong> @channel. </strong>Vale salientar a diferença entre ambos:</p><ul><li><strong>@channel: </strong>notifica todos os membros de um canal independentemente se estejam online ou do dispositivo onde estão conectados.</li><li><strong>@here</strong>: notifica todos os membros de um canal que <strong>estejam online no desktop no momento. </strong>Ou seja, usuários que não estiverem online ou estejam em trânsito online no smartphone, não serão notificados.</li></ul><p>Para mensagens que não demandem urgência ou ação imediata de <strong>todos os membros do canal </strong>a utilização do <strong>@here</strong> é mais indicada por ser menos intrusiva.</p><p>Se a intenção é somente notificar usuários específicos em um canal, vale lembrar que a utilização do <strong><em>@nick</em></strong><em> </em>(onde nick é o nome de um usuário) é o suficiente. Exemplo:</p><blockquote>@fulano @beltrano podem me ajudar com xpto?</blockquote><p>Ainda no que se refere a interrupções, é importante prezar por mandar a mensagem mais completa possível logo no primeiro envio. Isso faz com que a comunicação fique mais otimizada, pois logo que a sua mensagem for vista ela logo poderá ser respondida. Ao invés de mandar uma mensagem &quot;Oi, tudo bom, pode me ajudar?&quot; e esperar para então enviar a pergunta de fato, é melhor já enviar a dúvida (com possíveis referências pertinentes) na primeira mensagem:</p><blockquote>&quot;Oi, tudo bom? Estou precisando de uma ajuda com o código xpto que você mexeu ontem e eu não entendi tal ponto. Pode me esclarecer esse e aquele trecho?&quot;</blockquote><h4>Utilize o status sabiamente</h4><p>Uma funcionalidade relativamente recente do Slack pode ser bastante útil na comunicação com o time sem gerar interrupções. Se trata da definição do status. O próprio Slack sugere alguns status pertinentes:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/246/1*Gtptw5FofmdYgRccAup5GQ.png" /><figcaption>Lista de status sugeridos pelo Slack</figcaption></figure><p>Use a funcionalidade de status para comunicar sua (in)disponibilidade. Deixe explícito quando você estiver focando em algo e não irá poder responder ou acompanhar alguma discussão.</p><h4>Threads</h4><p>Sempre que precisar prolongar uma conversa, ou se sua resposta será diretamente para alguma mensagem posterior, use funcionalidade de threads (passando o mouse sobre uma mensagem o ícone de começar uma thread irá aparecer no canto direito).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/136/1*bLg2sVQ64IvW6prIcWVDOA.png" /><figcaption>Ícone para começar uma nova thread no Slack.</figcaption></figure><p>Quando múltiplas linhas de conversa se desenvolvem em um canal, pode ficar difícil dos participantes seguirem a linha raciocínio e também de outras pessoas acompanharem o fluxo. Múltiplas linhas de discussões também complica a vida de quem precisa se interar do que foi dito após a conversa ter ocorrido.</p><h4>Tenha um canal random</h4><p>Essa é uma prática que pode fazer muito mais sentido para times distribuídos, que é o caso do Olist. Geralmente em canais do tipo &quot;random&quot;, aqueles onde pode-se enviar mensagens de diversos assuntos e propósitos, acabam tendo duas principais vantagens:</p><ol><li>O random serve para aproximar mais humanamente e culturamente os membros do time com piadas, gifs, comentários gerais sobre o dia a dia na empresa entre outros;</li><li>O random também serve para separar o que é assunto pertinente e importante do trabalho dos demais assuntos que também são necessários (como falado no ponto anterior) mas que não são diretamente relacionados ao dia a dia de trabalho.</li></ol><p>É importante lembrar do que a afirmação do manifesto ágil no início do post nos remete: nada substitui a comunicação face a face. Entretanto temos tido bastante sucesso aqui no Olist com uma equipe completamente remota e altamente produtiva. Isso se dá ao fato tanto de a equipe ser composta por pessoas maduras e comprometidas como também de possuirmos o discernimento de quando devemos buscar uma melhor forma de comunicação. O Slack não resolve todas as nossas necessidades e comumentemente utilizamos ferramentas para <em>screen sharing</em> ou conversas via áudio em tempo real.</p><p>Compartilhem com a gente suas práticas na utilização do Slack ou da ferramenta que utiliza.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8f4a0c29319d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/olist/usando-o-slack-ao-seu-favor-8f4a0c29319d">Usando o Slack ao seu favor</a> was originally published in <a href="https://medium.com/olist">olist</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Code reviews no OpenStack]]></title>
            <link>https://medium.com/@caiowcc/code-reviews-no-openstack-5d2e315a42cf?source=rss-afae5bba973a------2</link>
            <guid isPermaLink="false">https://medium.com/p/5d2e315a42cf</guid>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[software-development]]></category>
            <dc:creator><![CDATA[Caio Carrara]]></dc:creator>
            <pubDate>Wed, 24 May 2017 15:52:27 GMT</pubDate>
            <atom:updated>2017-05-25T00:53:56.740Z</atom:updated>
            <content:encoded><![CDATA[<h4>Exercitando revisão de código e colaboração em comunidade</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8dsHUTounYJlsQ8azxV6gg.jpeg" /></figure><p>O ano era 2015 e eu havia acabado de começar a trabalhar na <a href="https://medium.com/u/15bb753e5a63">ThoughtWorks Brasil</a>. Entrei para trabalhar lá muito em função da minha experiência como programador Python. A ThoughtWorks é uma consultoria global de desenvolvimento de software com muitos projetos sendo executados por diversos times. O meu primeiro projeto como um ThoughtWorker foi na área de DevOps.</p><p>O projeto em questão envolvia desenvolvimento relacionado ao <a href="http://openstack.org/">OpenStack</a> (por isso um cara de Python no meio). Na prática eu digo que era relacionado pois não envolvia colaboração com o core do projeto, mas sim em subprojetos do extenso guarda-chuva que é o OpenStack. O objetivo geral do nosso time era assegurar a qualidade e eficiência dos builds da solução para cloud computing de um grande cliente. Essa solução do cliente era uma versão personalizada do OpenStack <em>upstream </em>(versão aberta).</p><p>Como é (ou deveria ser) comum para corporações que utilizam soluções de código aberto, o nosso trabalho não se limitava em codificar somente a solução <em>downstream</em> (do cliente), mas também a versão <em>upstream</em>. Isso não era uma benevolência, mas uma mistura de necessidade (afinal tínhamos que submeter para a comunidade as demandas que faziam sentido pra gente) com responsabilidade de retribuição. Aliás, o confronto de ideias, necessidades, demandas e visões diferentes é um fator fundamental para a qualidade de projetos de código aberto como o OpenStack.</p><p>Eu estava em um universo completamente novo. Nova empresa, novo projeto, novo segmento de software onde tinha atuado muito pouco. Eu poderia fazer (e talvez faça) dezenas de posts falando sobre minhas experiências durante esse período, mas o foco desse são os code reviews.</p><h4>Contribuido para o OpenStack</h4><p>Antes de falarmos das revisões de código em si, precisamos entender um pouco melhor o cenário como um todo. O OpenStack é um projeto de código aberto, logo permite que absolutamente qualquer pessoa possa ter acesso ao código fonte e contribuir com mudanças nesse código. Para que seja possível milhares de pessoas contribuírem com dezenas de projetos sob o arcabouço OpenStack algum processo deve existir para que a qualidade desses projetos não seja degradada. De forma resumida o fluxo de contribuição com código é o seguinte:</p><ol><li>Clona o repositório do projeto que quer contribuir pra sua máquina;</li><li>Prepara seu ambiente e roda os testes locais;</li><li>Cria o patch com suas alterações;</li><li>Submete para revisão da comunidade;</li><li><strong>Obtem pelo menos duas aprovações de core commiters;</strong></li><li>Tem o patch aceito por um core commiter.</li></ol><p>No passo destacado acima a dinâmica é a seguinte: qualquer pessoa pode revisar códigos no OpenStack. Cada revisor pode fazer comentários gerais na submissão ou específicos em um trecho do código proposto. Além dos comentários, os revisores possuem votos, podendo ser +1 (gostei), 0 (zero) ou -1 (não gostei). Core commiters possuem, além desses votos comuns, +2 (aprovado) ou -2 (reprovado). Tanto o voto -1 quanto o -2 não são necessariamente terminativos. Provavelmente junto com eles vem alguma requisição para melhoria ou ajuste. Assim que a submissão tiver pelo menos 2 votos +2 (independente de quantos +1 tiver), um core commiter pode marcar a submissão como aceita para iniciar o processo de merge.</p><h4>Code review</h4><p>A revisão de código é uma prática obrigatória em projetos de código aberto e eu vejo cada vez mais adotada por empresas em projetos internos. Essa etapa no processo de desenvolvimento de software proporciona diversos benefícios. Tanto para a qualidade do código que é produzido quanto para a as pessoas que trabalham juntas.</p><p>De maneira imediata e simplista revisar um código é exatamente aquilo que o conceito remete: parar para olhar o código por outras pessoas e avaliar se aquele código 1) atende ao propósito da alteração 2) é um código de boa qualidade 3) não quebra o projeto. As avaliações 1 e 3, ainda que bastante objetivas, na prática não são triviais. Porém a análise 2, sendo a de maior carga subjetiva dentre as três, é a mais complexa e mais recompensadora para o projeto.</p><p>Um ponto importante de se lembrar é que em projetos reais, mesmo os de código aberto, não há tempo infinito para a análise de submissões de código. O software sendo produzido existe para auxiliar na solução demandas do mundo real. Essas demandas impõem cronogramas, prazos, níveis de qualidade, priorizações, etc. Logo, todo o processo de desenvolvimento, inclusive o de revisão de código, não pode ser executado de tal maneira que as demandas do negócio sejam subvalorizadas.</p><h4>Minha experiência</h4><p>Especificamente nessa oportunidade que tive passando pela ThoughtWorks, a revisão de código era tarefa fundamental para o sucesso do nosso projeto. Isso porque o time estava constantemente submetendo patches para <em>upstream</em> e, como todos sabemos (não é?): a definição de pronto não pode ser qualquer coisa que não envolva código em produção. Assim, para atendermos as demandas do negócio precisávamos ter nossos códigos aceitos. E para ter o código aceito precisávamos dos reviews, desses pelo menos dois positivos de core commiters. Era regra: o tempo para conseguir as aprovações era maior do que para codificar.</p><p>Dado essa característica, o time como um todo se esforçou muito em revisar, tanto quanto produzir código. Não fui diferente. No release do OpenStack em que participei, para o projeto onde atuamos, acabei sendo o membro que mais contribuiu com code reviews do time.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/549/1*lfvyhaO_hgiPUOVge7-27g.png" /><figcaption>Gráfico comparativo considerando revisões de código no projeto do OpenStack que trabalhamos</figcaption></figure><p>Nesse processo pude aprender algumas coisas importantes que trago comigo até hoje e são úteis no meu trabalho atual. Uma delas é que se você precisa que seu código seja revisado, então revise o código dos outros. Essa é uma abordagem que proporciona pelo menos duas vantagens: quanto mais código de outras pessoas você revisar, mais convidativo para as outras pessoas será revisar o seu código e quanto menos submissões (que não a sua) existir, maior a probabilidade de outro revisor pegar a sua para revisar.</p><p>Talvez um dos aspectos mais importantes para a revisão de código ocorrer é o quão convidativa a submissão está. Trabalhando remotamente e tendo todas as interações com as outras pessoas mediadas através do computador esquecer que são outras pessoas “do outro lado” se torna bastante comum. Pessoas que possuem suas rotinas e suas próprias demandas de trabalho.</p><p>Para uma proposta de alteração em um projeto ser convidativa e também levar o menor tempo para ser aceita, há alguns aspectos que precisam ser levados em conta:</p><ol><li><strong>Faça a menor submissão possível que entregue valor.</strong> Submissões que possuem muitas alterações geralmente são deixadas para “depois” pelos revisores. Ainda que a alteração que você precise fazer seja muito grande, quebre-a em submissões menores;</li><li><strong>Disponibilize as informações importantes e relevantes para o revisor.</strong> Essas informações fazem parte da descrição da submissão. Exponha porquê aquela alteração é necessária, qual foi a solução e links externos para possíveis conteúdos relacionados. Ao mesmo tempo não sature demais a submissão, lembre-se que o revisor precisará ler o código também (ninguém disse que seria simples).</li><li><strong>Procure sempre fazer o melhor código possível desde a primeira submissão.</strong> Pode ser tentador a ideia de que a qualidade do código pode ser mediana em alguma submissão, já que haverá uma revisão. Um código mal feito, ou complexo demais, só irá resultar em notas negativas e mais iterações de revisão (review, request, change, submit). Quanto mais iterações uma submissão possuir mais desgastante é o processo para todos os envolvidos.</li></ol><p>Em dado momento, o que mais nos prendia era o fato de ninguém do time ser core commiter no projeto em que estávamos mais atuantes. Ainda que obtivéssemos diversos votos +1 em nossos patches, sempre precisávamos esperar os escassos +2 para aceitação. Esse foi um fator que me ajudou a exercitar e aprender ainda mais com revisões de código e relacionamento em comunidade.</p><h4>O lado humano da colaboração em software</h4><p>Precisamos lembrar que a cada interação com revisão de código não estamos interagindo com o código em si, nem com uma máquina. Estamos sempre falando para outra pessoa. Assim, precisamos nos atentar para o que e como falamos. Seja em uma linha de código, na submissão como um todo ou mesmo nas salas de chat.</p><p>Existem algumas premissas que devemos nos atentar em atender nas interações em comunidades. Seja em projetos de código aberto ou na própria empresa em projetos fechados.</p><ol><li><strong>Seja propositivo em críticas</strong>. Isso significa que ao invés de dizer “seu código está ruim, refaça”, talvez seja melhor dizer “o seu código não cobre cenários <em>a</em> e <em>b</em>, provavelmente precisa ser adaptado <em>nesse</em> e <em>naquele</em> ponto para que não ocorra problemas”.</li><li><strong>Defenda seus argumentos sem esquecer que você pode estar errado.</strong> Em praticamente todos os ambientes com desenvolvedores por onde estive (virtual ou real) o ego é um fator demasiadamente preponderante. Egos gigantes quando se encontram acabam desfocando do objeto da interação. No caso, a solução que o software atende. Assim, para evitar conflitos indesejados e manter o foco no que realmente interessa, é válido escolher bem as palavras em seus argumentos. Na prática, ao invés de dizer “a funcionalidade <em>xpto</em> é irrelevante”, talvez seja melhor dizer “não consegui compreender a razão de estarmos priorizando a entrega dessa funcionalidade nesse momento, pode me explicar?”.</li><li><strong>Comunique-se com uma pessoa, não com a tela do computador.</strong> Isso é bem básico, mas é normal nos esquecermos. Cumprimentar e se despedir podem ser um ótimo começo :)</li></ol><p>A maneira com que você se comporta, junto ao valor que você entrega ao projeto, seja com código ou não, podem trazer diversos benefícios. Pessoalmente, no projeto em que estávamos atuando, acabou me rendendo o status de core commiter (como pode ser visto pelos +2 abaixo)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/251/1*djRExQb2cBcMNc1XdgNC_g.png" /><figcaption>Resumo das minhas contribuições ao OpenStack segundo o <a href="http://stackalytics.com/">Stackalitics</a></figcaption></figure><p>Reparem que o número de commits é bem baixo, mas ainda assim acabei me tornando core commiter no projeto. De acordo com as conversas na época isso se deu justamente pelas minhas contribições em reviews e no IRC do projeto.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5d2e315a42cf" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Entrega do novo cálculo de fretes da Olist]]></title>
            <link>https://medium.com/olist/entrega-do-novo-c%C3%A1lculo-de-fretes-da-olist-6aca314a39f9?source=rss-afae5bba973a------2</link>
            <guid isPermaLink="false">https://medium.com/p/6aca314a39f9</guid>
            <category><![CDATA[olist]]></category>
            <category><![CDATA[agile-development]]></category>
            <category><![CDATA[software]]></category>
            <category><![CDATA[desenvolvimento-software]]></category>
            <dc:creator><![CDATA[Caio Carrara]]></dc:creator>
            <pubDate>Mon, 22 May 2017 18:02:12 GMT</pubDate>
            <atom:updated>2017-05-23T00:49:22.639Z</atom:updated>
            <content:encoded><![CDATA[<h4>Um pouco da nossa frustração, alegria e aprendizados</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TmQ90oNt31S9HybpntM7eA.jpeg" /><figcaption>Um dos momentos mais importantes pra gente é quando a encomenda chega para o consumidor final</figcaption></figure><p>Dentro das áreas de desenvolvimento e produtos na Olist, trabalhamos organizados em “subtimes” (squads) focados em entregar valor para determinada área do negócio. Desde o começo desse ano venho trabalhando junto ao time de Fulfillment. De forma geral o nosso objetivo é garantir que os produtos que são comprados através do Olist sejam efetivamente entregues ao consumidor final. Mais do que isso, temos que garantir que o produto seja postado dentro do prazo pelo vendedor, que seja entregue no prazo ao consumidor final por nossos parceiros logísticos, que os custos dessa operação estejam dentro do planejado e que nenhuma venda seja comprometida devido a falhas em cotações de frete.</p><blockquote>Eu não sei vocês, mas quando estou comprando online, avalio bem o custo do frete e o prazo de entrega. Já deixei de comprar por não haver modalidade expressa de entrega, por exemplo.</blockquote><p>Especificamente referente às cotações de frete, para que sejamos capazes de atender ao nível de qualidade exigido pelos maiores marketplaces do Brasil, precisamos absorver o desenvolvimento internamente. Não podemos contar com os serviços oferecidos pelos Correios para respondermos à milhares de cotações de frete e prazo em um tempo hábil para a operação. Uma requisição por cotação de frete deve ser processada por nosso sistema em menos de 400ms. Se não for assim, corremos o risco de comprometer significativamente o negócio por prejuízo com fretes ou vendas não realizadas. Afinal, se não respondermos aos marketplaces a cotação, ele mostrará que o produto não pode ser entregue na casa do consumidor, quando na verdade poderia.</p><p>Para casos onde o local de origem das encomendas é limitado, essa parece ser uma tarefa um tanto simples. Porém, no caso do Olist, não temos centros de distribuição ou qualquer estrutura parecida. Vendedores de todo o Brasil utilizam a nossa plataforma. Isso faz com que uma rota de frete para nós possa ter origem e destino em qualquer cidade do país (atualmente mais de 5000 municípios).</p><p>Dentro desse contexto, o squad de Fulfillment teve que encarar um ótimo desafio: desenvolver um novo cálculo de fretes devido a mudanças nas regras estabelecidas pelos Correios.</p><h4>Breve histórico</h4><p>Para os que ainda não sabem como está tecnicamente organizada a plataforma Olist, sugiro o post do <a href="https://medium.com/u/e8348ef249f3">osantana</a> sobre <a href="https://engineering.olist.com/como-funciona-a-plataforma-olist-8e2eb8b8181a">como funciona a nossa plataforma</a>. No caso dos fretes a regra é a mesma. Temos um conjunto de serviços que funcionam de modo a tornar possível o cálculo das cotações. O ponto de acesso ao nosso sistema se dá através de uma API.</p><p>Até essa recente entrega que fizemos, a API suportava somente um provedor logísitico. A regra antiga dos Correios era bastante direta: cidades eram classificadas como “interior” ou “capital” e o frete (custo e prazo de entrega) variava de acordo com o tipo de cidades envolvidas no trecho (interior x interior, interior x capital, capital x capital, capital x interior).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/612/1*NlbvjH-uYAswrzQidBXIhw.png" /><figcaption>Estrutura da freights-api single provider</figcaption></figure><p>A imagem acima ilustra brevemente a estrutura da nossa API antes das alterações que estavam por vir. O funcionamento era bem simples e direto (afinal o simples é melhor do que o complexo). Os canais no diagrama são os diversos marketplaces onde publicamos. Cada um deles possui um esquema de comunicação, logo a API expõe endpoints diferentes para cada um desses canais. Os conectores são responsáveis por manipular a entrada dos dados enviados pelos canais e construir uma resposta adequada.</p><p>Uma requisição de um canal chega para a API que irá:</p><ol><li>Verificar qual é o produto que está sendo consultado e qual é o destino (CEP informado pelo consumidor no marketplace);</li><li>Detectar qual é a origem do produto (cadastrado pelo vendedor no Olist);</li><li>Acionar diretamente o <em>provider</em> dos Correios, informando os parâmetros necessários, para o cálculo da cotação de frete (custo, prazo e serviços oferecidos);</li><li>Persistir a cotação retornada pelo <em>provider</em> para posterior análises de conversão de vendas<em>;</em></li><li>Construir a resposta conforme esperado pelo respectivo canal e enviá-la.</li></ol><h4>A notícia da mudança</h4><p>No começo de 2017 ouvimos conversas iniciais sobre uma mudança na regra de cálculo de fretes pelos Correios. Por volta de fevereiro nos foi comunicado que em março somente a nova regra iria valer, portanto teríamos que nos adequar. Assim, planejamos a entrega da nova implementação no primeiro trimestre.</p><p>Vale lembrar que para os Correios não haveria a possibilidade de as duas regras valerem por um curto período de migração ou adaptação. A chave teria que virar da noite para o dia.</p><p>Com os trabalhos inciados fomos comunicados que a migração havia sido adiada por um prazo indeterminado. Isso gerou um pouco de frustração e atrapalhou nossos planos gerais. Porém acabou sendo bastante útil para que pudéssemos já ter iniciado conversas cruciais de entendimento do que precisaria ser feito.</p><p>Então, no começo de abril, o prazo que inicialmente era indeterminado acabou sendo definido. Dia 05 de maio foi estabelecido pelos Correios para entrar com a nova regra. Não tínhamos muito o que pensar. Esse é um tipo de implmentação que, ou fazemos, ou paramos a empresa toda.</p><h4>Uma funcionalidade inesperada</h4><p>Tenho o privilégio de trabalhar com uma equipe bastante experiente quando o assunto é relacionamento corporativo com os Correios. Inocentemente eu poderia pensar em implementar a nova regra sem me importar muito com a regra antiga. Porém, o time achou melhor sermos mais cautelosos e nos prepararmos para eventuais voltas repentinas à antiga regra de cálculo. Surge então a funcionalidade <em>multi providers</em> em nossa API.</p><p>Já havia o planejamento para que implementássemos essa funcionalidade em algum momento, porém a realidade do negócio nos colocou essa necessidade antes que a escolhêssemos. Afinal, considerando a estrutura apresentada acima, para atualizarmos a regra do frete precisaríamos 1) refazer o provider atual dos correios ou 2) criar um novo provider sem se desfazer do atual. Escolhemos a segunda opção por segurança e por ser uma funcionalidade esperada pelo negócio.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*CgBuZLCJb4SgWhSXd84CfQ.png" /><figcaption>Estrutura da freights-api multi providers</figcaption></figure><p>A nova estrutura parece muito semelhante com a primeira, apesar de ter passado por alguns processos de <em>refactoring</em> que a deixaram intrisicamente melhor do que versão inicial. Ainda estamos longe do que esperamos para essa API, mas conseguimos dar um passo importante.</p><p>Nesse novo formato os conectores de cada canal não possuem mais relacionamento direto com os providers. O <em>Quote Manager</em> é a estrutura intermediária responsável pela interação entre os dois extremos do serviço.</p><p>Com essa implementação ganhamos a capacidade de rodar nossa API respeitando a regra nova ou antiga de cálculo de fretes com o esforço de somente mudar um parâmetro. Não precisamos nem mesmo nos preocupar com um novo deploy (embora isso seja muito simples). Outro aspecto importante é que agora também ganhamos a capacidade de adicionar quantos provedores logísticos o negócio exigir.</p><h4>Compartilhe cedo, compartilhe sempre</h4><p>Um dos primeiros ensinamentos que pude tirar de todo esse processo foi o de compartilhar cedo e compartilhar sempre o código que está produzindo. Não somente por uma ocasião, mas em dois momentos notei isso.</p><p>O primeiro desses momentos se refere ao processo de implementar a funcionalidade de <em>multi providers</em> na API. Para essa entrega um <em>refactoring</em> grande e crítico precisou ser feito. Se não me engano passei um ou dois dias de trabalho codificando as alterações em uma branch específica no nosso repositório. Porém, deixei para colher os feedbacks do time somente no Pull Request.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/695/1*N0In5isugBltscbsD5uP8w.png" /><figcaption>Pull requests grandes ou complexos tendem a ser “esquecidos” mais facilmente</figcaption></figure><p>O mesmo problema apareceu na implementação do algoritmo para o novo frete em si. A nova regra nos pegou um tanto quanto de surpresa devido a mudança radical em relação a anterior. Se antes as cidades possuiam somente duas classificações, agora elas teriam várias. Não só isso, a rota envolvendo cada uma dessas cidades possuiríam também algumas dezenas de classificações. O algoritmo de classificação nos tomou certo tempo para compreensão e tempo maior ainda para implementá-lo. Outra vez deixei para colher os feedbacks somente no Pull Request.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/653/1*-eF7w9fxN8BfHL_tajnZuA.png" /></figure><p>Engana-se quem ainda acha que o trabalho de desenvolvimento de software profissional é um trabalho solitário. Os melhores softwares produzidos são aqueles desenvolvidos por <strong>equipes excelentes</strong>. Um dos fatores para essa excelência é a troca de feedbacks diversos, especialmente quanto ao código produzido.</p><p>Entretanto, deixar para colher os feedbacks tardiamente pode ser uma tarefa mais desgastante para todos. Entre outras coisas, a bagagem de conhecimento que o time terá que absorver é muito maior, a probabilidade de mal entendimentos é maior, as discussões serão menos específicas e o processo de aprovação do código irá ser mais demorado.</p><h4>Time</h4><p>Aqui o aprendizado na verdade é uma reafirmação: confie e acredite no seu time. Passamos mais de um mês trabalhando nessa entrega que tinha data marcada para ocorrer. Além disso o time continuou atendendo outras demandas, afinal, como falei lá no começo, o squad de Fulfillment é responsável por todo o processo que envolva a conclusão de uma venda e não somente a cotação de fretes.</p><p>Durante a fase de planejamento e organização do nosso trabalho o <a href="https://medium.com/u/320b38308d8b">Igor Matsuchita</a> e o <a href="https://medium.com/u/5dc57bcfd1e4">Vitor Godoy</a> foram excepcionais. Trouxeram para a equipe de desenvolvimento a nova regra de cálculo “mastigada”. Como falei no meu artigo anterior sobre <a href="https://engineering.olist.com/novo-desenvolvedor-na-olist-16d852466e71">como é ser um novo desenvolvedor aqui na Olist</a>, a equipe de Produto facilita demais o trabalho dos desenvolvedores por aqui. Além disso o Vitor também faz toda a comunicação com os Correios e traz o que é relevante para o time. Esse filtro nos mantém focados no que importa.</p><p>Outro momento chave em que pude pensar “uau!” foi no derradeiro dia 05 de maio de 2017. Na verdade dias 05, 06 e 07 de maio. Devido a uma “notícia de última hora” que os Correios nos deu no dia 05 (sim, no dia de virar a chave), precisamos fazer uma força tarefa além do esperado para que pudessemos concluir a entrega. Foi nessa hora que o <a href="https://medium.com/u/9501f3c14ab5">Adler Medrado</a> e o Rafael Henter se juntaram ao esforço da nova regra do frete, codificando, revisando código, colaborando e fazendo tudo o possível para que entregássemos juntos aquilo que nos comprometemos juntos em entregar.</p><blockquote>Eu esperava passar por uma turbulência muito maior, com muito mais stress. Vocês fizeram essa migração ser uma das mais tranquilas que já passei. — <a href="https://medium.com/u/e8348ef249f3">osantana</a> (CTO Olist)</blockquote><p>Ainda que viéssemos a saber que na semana seguinte da nossa entrega os Correios nos supreenderiam novamente com detalhes que deixaram pra falar de última hora, o fato importante é que na tarde de sábado já estávamos com uma nova API de fretes rodando, com um algoritmo de cálculo de fretes mais complexo e respondendo no mesmo tempo que a implementação anterior.</p><h4>O trabalho sério e o esforço é recompensado com resultado</h4><p>Assim como lembrou o <a href="https://medium.com/u/6b54ab4e87fc">Tiago Dalvi</a>, CEO da Olist, no seu post no Facebook. O trabalho do squad de Fulfillment aqui brevemente relatado, foi responsável direto por um feito super importante para a empresa:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/503/1*tjcfCqpMdsEyHc9zg5nI3g.png" /><figcaption>Olist agora faz entregas em D+1</figcaption></figure><p><strong>Obrigado, time!</strong></p><p>Se ficou um gostinho de fazer parte do time, seja você uma pessoa desenvolvedora ou não, confira a nossa <a href="https://www.99jobs.com/olist">página de oportunidades</a>. Uma dica: nós estamos sempre procurando ótimos talentos ;)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6aca314a39f9" width="1" height="1" alt=""><hr><p><a href="https://medium.com/olist/entrega-do-novo-c%C3%A1lculo-de-fretes-da-olist-6aca314a39f9">Entrega do novo cálculo de fretes da Olist</a> was originally published in <a href="https://medium.com/olist">olist</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Novo desenvolvedor na Olist]]></title>
            <link>https://medium.com/olist/novo-desenvolvedor-na-olist-16d852466e71?source=rss-afae5bba973a------2</link>
            <guid isPermaLink="false">https://medium.com/p/16d852466e71</guid>
            <category><![CDATA[software]]></category>
            <category><![CDATA[programador]]></category>
            <category><![CDATA[tecnologia]]></category>
            <category><![CDATA[desenvolvimento-software]]></category>
            <category><![CDATA[olist]]></category>
            <dc:creator><![CDATA[Caio Carrara]]></dc:creator>
            <pubDate>Wed, 10 May 2017 19:27:05 GMT</pubDate>
            <atom:updated>2017-05-10T20:56:57.389Z</atom:updated>
            <content:encoded><![CDATA[<h4>O que posso dizer até agora</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*XOUhKm9F285fBF078Q4xqA.png" /><figcaption>Sem mimimi, um dos nossos valores</figcaption></figure><p>Faz algum tempo que comecei a trabalhar na <a href="http://olist.com/">Olist</a> e desde as primeiras semanas venho me surpreendendo positivamente. Surpresas não são incomuns quando você começa a trabalhar em um lugar novo. Porém depois de passar por diversas empresas diferentes nos últimos anos, não seria qualquer entusiasmo de emprego novo que me motivaria a parar para escrever.</p><p>Meu histórico profissional remete a uma carreira um tanto quanto comum como desenvolvedor de software. Estagiário, programador junior, pleno e sênior <em>(só cheguei até aqui ainda :P)</em>. Mudanças que ocorreram trabalhando em consultorias tradicionais, outras mais descoladas, instituto de pesquisas ou empresas de produtos. Dez funcionários, cem ou milhares ao redor do mundo. Com certeza em cada uma delas o aprendizado foi enorme e as supresas também, mas nenhuma me surpreendeu como a <a href="http://olist.com/">Olist</a>.</p><p>Para quem ainda não conhece, a <a href="http://olist.com/">Olist</a> é uma empresa que, mais do que auxiliar vendedores a chegar aos maiores marketplaces do Brasil, é a maior comunidade de lojistas exclusivos do país. Além de toda complexidade de negócio que a Olist resolve, há diversos desafios técnicos que precisam ser encarados por aqui. Para saber mais sobre os fundamentos técnicos da Olist já existe um ótimo artigo:</p><p><a href="https://engineering.olist.com/como-funciona-a-plataforma-olist-8e2eb8b8181a">Como funciona a plataforma Olist</a></p><h3>Desenvolvedor desenvolve</h3><p>Pode parecer redundante, mas não é difícil encontrar programadores que estão infelizes em seus empregos por não atuarem com o que são apaixonados por fazer: programar. Ou então que são encorajados a assumirem novas responsabilidades para evoluirem dentro da companhia. Pessoalmente eu acredito que sob um falso mérito de versatilidade, o mercado vem atribuindo tantas funções a um desenvolvedor de software que não raro mais de 80% da rotina de um programador envolve fazer tarefas alheias àquelas relacionadas ao desenvolvimento de software propriamente dito.</p><p>Aqui na <a href="https://olist.com/">Olist</a> eu venho me surpreendendo com a quantidade de tempo em que eu posso de fato ser um programador. E não me entendam mal os desavisados. Ser um programador está longe de passar o dia digitando código em uma tela preta. Podemos dizer que algumas tarefas que compõe um dia de desenvolvedor por aqui vão desde codificar novas funcionalidades de fato em “tela preta”, até revisar criticamente o código produzido pelo time, participar de discussões técnicas, ser ativo e relevante em decisões arquiteturais, fazer constantemente refatorações, implementar testes cada vez melhores, mais robustos e de valor. Ou seja, tenho visto que por aqui um programador pode (e deve) entregar valor ao time fazendo o que mais gosta de fazer.</p><h3>O chefe também programa!</h3><p>O nosso CTO também é um desenvolvedor ativo. Seja em projetos internos ou de <a href="https://github.com/olist/correios/">código aberto para a comunidade</a>, o <a href="https://medium.com/u/e8348ef249f3">osantana</a> está sendo o chefe mais desenvolvedor que eu já tive. E não sabia quanta diferença isso poderia fazer!</p><p>Invariavelmente no mercado, por mais disruptiva ou horizontal que a hierarquia de uma companhia possa ser, o papel da pessoa que gerencia ou coordena equipes de desenvolvimento é ocupado por um Gestor (sim, com G maiúsculo) ou por um programador completamente defasado e inativo.</p><p>Ter um chefe que “é gente como a gente” tráz diversas vantagens. Uma delas é que temos ao nosso lado uma pessoa que compreende profundamente as diversas tarefas que mencionei no tópico anterior. Esse fator faz com que a comunicação seja muito mais fácil, isso quando a gente precisa comunicar. Se estamos passando por um período crítico seja em função de um bug afetando produção, por uma refatoração complexa ou mesmo porque precisamos focar em compreender uma nova tecnologia, nosso chefe sabe que estamos passando por esse momento e o que menos precisamos é alguém gerando impedimentos e distrações burocráticas. Além disso, o <a href="https://medium.com/u/e8348ef249f3">osantana</a> é um cara extremamente experiente e que diariamente está disposto a nos ensinar em cada mensagem no chat ;)</p><h3>Equipe apaixonada pelo que faz</h3><p>Sobre a disposição em colaborar genuinamente não é uma característica que se limita ao CTO. Isso é comum a todas as equipes da <a href="http://olist.com/">Olist</a>, inclusive a de tecnologia. O problema (ou mérito) de um é compartilhado por todos. Essa colaboração genuína é algo que realmente vem me surpreendendo na área de desenvolvimento.</p><p>Uma parte de mim espera que eu esteja contaminado pelas minhas próprias más experiências, mas encontrar programador com o ego maior do que a vontade de contribuir com o time é algo bastante comum. Em pouco tempo de casa eu já pude presenciar atitudes de ajuda genuína e não por promoção própria. De dedicação por paixão em fazer algo bom e novo, e não para bajular uma ou outra pessoa.</p><p>Aqui na Olist não existe nem dono de código nem dono de bug. O código é produzido pelo time. Se um bug surge é de responsabilidade de todo o time. Isso não implica simplismente que todos irão parar para fazer a mesma coisa, mas sim que o time irá se organizar para melhor solucionar o problema. Se um erro foi cometido, ele foi cometido pelo time. Se há uma falha no código, a falha é do time. Se alguém precisou escrever um código de má qualidade, outros precisaram rever o código e aprová-lo. O processo que seguimos por aqui faz com que todos de fato sejam responsáveis pelo que é produzido, seja bom ou seja ruim.</p><h3>Trabalho remoto que funciona</h3><p>Na Olist toda a equipe de desenvolvimento trabalha remotamente. A empresa possui seu escriório em Curitiba com os times de outras áreas por lá, mas exclusivamente os desenvolvedores trabalham remoto. Existem diversas explicações para isso que deverão render um novo artigo em breve. Porém o que é relevante destacar é que se trata de uma equipe remota que funciona. Produz software excelente, gera inovação constante, estabelece uma cultura de desenvolvimento que é passada de pessoa para pessoa e o mais importante: gera valor real para o negócio.</p><h3>Uma equipe de produtos que faz a diferença</h3><p>Quem supostamente trabalha com algum método ágil de desenvolvimento por aí vai entender o que eu vou dizer agora. Existe uma má compreensão generalizada sobre o manifesto ágil que, dentre diversos malefícios, trouxe um que afeta diretamente o trabalho do desenvolvedor: estórias (ou tarefas) extremamente mal especificadas. Eu presumo que esse costume tenha sido derivado da afirmação de que software em funcionamento é mais valorizado do que documentação abrangente ou de que a melhor forma de comunicação seja face a face. Sem querer me prolongar nesse tópico e independente de onde isso tenha surgido, a má prática de se especificar mal ou pouco uma tarefa é bastante comum.</p><p>Quando li a primeira especificação de uma tarefa escrita aqui na Olist eu fiquei um pouco espantado. Estava tudo ali. O que era pra se fazer em um nível de detalhe suficiente, o propósito, o impacto que aquilo geraria para o negócio, os pontos do sistema que precisariam ser alterados ou que seriam afetados e qual era a definição de pronto da tarefa (o que sempre gera debate quando não se define). Posteriormente quando pude participar de uma sprint desde o início pude perceber que os desenvolvedores têm sim papel importante na definição dessas estórias, ajudando em aspectos técnicos ou mesmo dando feedbacks sobre o que não está tão claro. Porém a resposabilidade de liderar a criação, definição, priorização e organização do nosso backlog é exemplarmente feita pela equipe de produtos.</p><p>Se desejar saber mais sobre a criação e evolução da equipe de produtos da Olist, o <a href="https://medium.com/u/28aa2e63b363">Luiz Davi Leitão Martins</a> falou mais sobre isso no artigo abaixo.</p><p><a href="https://engineering.olist.com/evoluindo-time-de-uma-pessoa-para-v%C3%A1rios-squads-independentes-f6f386765c0d">Evoluindo ‘time’ de uma pessoa para vários squads independentes</a></p><h3>Pra encerrar</h3><p>Eu não sei dizer como será o futuro, mas posso dizer que até o momento as coisas vão muito bem, obrigado. Tão bem que o ambiente no qual eu estou inserido hoje me fez sair de um hiato de mais de 2 anos sem escrever nada. A interrupção pode ter acontecido por diversos motivos, mas o fator que me fez sentir confortável e encorajado para escrever novamente, com certeza é composto por como as coisas acontecem por aqui.</p><p>Se ficou um gostinho de fazer parte do time, seja você uma pessoa desenvolvedora ou não, confira a nossa <a href="https://www.99jobs.com/olist">página de oportunidades</a>. Uma dica: nós estamos sempre procurando ótimos talentos ;)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=16d852466e71" width="1" height="1" alt=""><hr><p><a href="https://medium.com/olist/novo-desenvolvedor-na-olist-16d852466e71">Novo desenvolvedor na Olist</a> was originally published in <a href="https://medium.com/olist">olist</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>