<?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 Guilherme Almeida on Medium]]></title>
        <description><![CDATA[Stories by Guilherme Almeida on Medium]]></description>
        <link>https://medium.com/@guicalmeida?source=rss-bfcccca1eda6------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*Vqo_IvpwsCElqXjeG6HQsw.jpeg</url>
            <title>Stories by Guilherme Almeida on Medium</title>
            <link>https://medium.com/@guicalmeida?source=rss-bfcccca1eda6------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 15:11:46 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@guicalmeida/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[Nossa despedida]]></title>
            <link>https://medium.com/collact-tech/nossa-despedida-a99bb44257eb?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/a99bb44257eb</guid>
            <category><![CDATA[back-end-development]]></category>
            <category><![CDATA[business-intelligence]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[product-management]]></category>
            <category><![CDATA[stone]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Thu, 17 Nov 2022 18:15:24 GMT</pubDate>
            <atom:updated>2022-11-17T18:19:23.100Z</atom:updated>
            <content:encoded><![CDATA[<p>Este será um texto diferente. O foco ainda será a tecnologia, mas é na verdade uma despedida, não só do blog quanto da Collact. E, apesar desse texto ter uma perspectiva pessoal, quem está indo embora não sou eu e sim toda a empresa.</p><p>Não se assuste, a Collact não está fechando as portas; inclusive, muito pelo contrário: ela acaba de ser oficialmente absorvida pela Stone. É um capítulo sensacional que se dá no décimo aniversário de uma empresa que nasceu nas mãos de três universitários sem nenhuma experiência em startup e apenas alguns meses de experiência no mercado de trabalho.</p><p>Em termos de engenharia, ainda há muito o que ser decidido — e é por isso mesmo que opto por olhar o passado. O que tornou a Collact um produto tão cativante de se trabalhar? Como foi o caminho até chegar aqui?</p><h3>As primeiras tentativas</h3><p>A ideia era simples: varejos de todos os portes utilizam cartões fidelidade como ação de marketing, garantindo a recorrência de seus clientes; logo, vamos digitalizar este conceito.</p><p>Estamos em 2012, celulares não são tão comuns e as tecnologias e sistemas operacionais não são tão sofisticadas, mas uma coisa já funcionava e se tornou a primeira forma de identificar o cliente: QR Code. Ele entra no estabelecimento, escaneia o código como uma espécie de check-in e pronto, faz progresso naquele programa de fidelidade.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/829/0*l728VhIZsfGGPys0" /></figure><p>E sim, conforme você está imaginando, era bastante propenso a fraude esse sistema, o que levou à iteração seguinte, um beacon bluetooth capaz de identificar o usuário. E o fato de você provavelmente não conhecer essa tecnologia mesmo 10 anos depois, mostra porque a Collact chegou a sua próxima fase: o famoso tablet</p><h3>O tablet</h3><p>O tablet foi a primeira grande tentativa da Collact de um produto escalável. O lojista deixava sempre ligado sobre o balcão e se o cliente atingia o mínimo necessário para ganhar um “carimbo”, bastava colocar o CPF e acumular pontos ou mesmo pegar seu prêmio.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/745/0*YyyhscY4g6XICdwt.jpg" /></figure><p>O app funcionava muito bem e tiveram casos de sucesso, mas o custo de entrada no programa de fidelidade por parte do lojista era alto, pois envolvia adquirir um tablet para si.</p><p>Isso prejudicava bastante a escalabilidade do produto, não só pelo custo mas também por uma questão logística: expandir para fora de São Paulo envolvia enviar e oferecer manutenção física longe da sede da Collact — e isso exigiu pensar em uma outra forma de oferecer um programa de fidelidade; foi então que as trajetórias da Collact e da Stone se cruzaram.</p><h3>O sistema embarcado</h3><p>A Stone buscava ativamente formas de aumentar sua proposta de valor para lojistas e já não queria ser só “a maquininha verde” e nem brigar por alguns decimais de margem com concorrentes. Havia — e há — uma visão de ser um verdadeiro ecossistema para seus clientes, cujo POS (nome correto para maquininha) deixaria de ser apenas uma forma de aceitar cartão para se tornar um poderoso auxiliar no varejo.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ijNBakkUTsXQYm7-.png" /></figure><p>A Collact encaixa perfeitamente nessa estratégia, tornando o POS uma forma de fidelizar clientes, oferecer recompensas personalizadas, premiar clientes frequentes e até mesmo tentar recuperar clientes perdidos.</p><p>Para a Collact também foi o casamento perfeito: ao colocar a inteligência em fidelidade embarcada no POS, eliminava-se ainda mais o atrito de incluir o consumidor no programa, deixando de exigir seu CPF e, para usuários já participantes, passou a ser possível identificá-los a partir dos números finais de seu cartão de pagamento, eliminando totalmente a necessidade de qualquer interação do cliente final.</p><h3>Um novo capítulo na Collact</h3><p>É claro que isso não resolveu todos problemas de escalabilidade da Collact da noite para o dia, mas tornou sim a aquisição de novos clientes mais fácil, uma vez que o produto diminuiu consideravelmente seu preço, liberou espaço no balcão e diminuiu potenciais filas em que cada cliente colocando o CPF em um tablet com baixo processamento causava.</p><p>Com essa dor de cabeça a menos, a equipe de produto e engenharia pôde focar em rechear o painel do lojista com recursos que aumentavam a proposta de valor da Collact, como uma maior inteligência de dados, <a href="https://tech.collact.com.br/checklist-de-lan%C3%A7amento-de-um-produto-digital-o-caso-de-comunica%C3%A7%C3%B5es-69c90275ef72">ferramentas de envio de comunicação</a>, promoções ainda mais personalizadas e direcionais e melhorias gerais porém significativas na experiência de uso.</p><p>As melhorias, é claro, não se limitam ao front-end e design: em pouco mais de um ano o back-end da Collact colocou de pé no painel do lojista um <a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">data lake capaz de entregar em tempo real estatísticas</a> que exigem cruzamento de dados de dezenas de tabelas, criou um algoritmo capaz de gerar em segundos grupos de clientes separados por hábito de consumo e a própria ferramenta de comunicação, que exigiu um uso sofisticado de message queues para garantir a operabilidade.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Kjd5qfwhrxYeg-lt_-w1EQ.png" /></figure><p>Isso tudo sem contar de iniciativas como o<a href="https://tech.collact.com.br/implementando-um-controle-de-permiss%C3%B5es-no-front-end-com-angular-fdebd1a18c3"> produto de autosserviço</a>, cujo alpha foi colocado de pé em menos de um mês; do projeto de<a href="https://tech.collact.com.br/como-transformar-uma-api-de-uso-interno-em-p%C3%BAblica-25688ac3e3af"> tornar a API de Collact pública</a>; do desenvolvimento do produto para lojistas, clientes finais, POS Android e POS em javascript feito por uma equipe enxuta; da integração nativa de Collact com o software de pagamento da Stone, deixando de ser um app e passando a fazer parte do fluxo nativo; enfim, a velocidade da inovação e desenvolvimento na Collact impressiona e até intimidadora para devs entrantes, não importa o nível de senioridade.</p><p>O tempo passa mais devagar quando se trabalha no time de produto e engenharia da Collact. Não por ser chato, é muito pelo contrário: não dá tempo de ficar entediado, se entrega e se aprende tanta coisa que poucos meses aqui te dão intimidade com o código (e com as pessoas!) que parece de anos.</p><p>Tudo isso para dizer que todas essas iniciativas da Collact chamam a atenção. A Stone acompanhou boa parte dessa jornada e enxergou enorme valor no que construímos, decidindo integrar a Collact ao seu produto <em>core</em>. Inclusive, a Collact não é mais Collact, é <strong>Stone Fidelidade</strong>.</p><p>E agora, nós do time de Produto e Engenharia da Stone, no produto de fidelidade, temos o grande desafio de aproveitar ao máximo as portas que se abrem com uma integração desse nível, fazendo parte inclusive da plataforma do lojista da própria Stone, que conta com mais de um milhão de negócios.</p><blockquote>A Collact não é mais Collact, é <strong>Stone Fidelidade</strong>.</blockquote><p>Isso também significa que o blog de tecnologia da Collact chegou ao seu fim. Cumpriu seu propósito. Escrever sobre boa parte das iniciativas recentes aqui listadas foi uma honra e um prazer — e se ajudou, inspirou ou interessou uma pessoa sequer, cumpriu seu papel. Como autor desse blog, deixo aqui minha despedida e dois convites: conheça o <a href="https://medium.com/stonetech">blog de tecnologia da Stone</a> e também me mande uma mensagem lá no<a href="https://www.linkedin.com/in/guilhermecalmeida"> LinkedIn</a>!</p><p>Um abraço para você que acompanhou este blog, para todos da Collact que contribuíram nos textos e outro especial para o <a href="https://www.linkedin.com/in/heitor-neves-3962199b/">Heitor Neves</a>, que concebeu a ideia de um blog sobre nossas iniciativas e me confiou sua escrita. Até mais!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a99bb44257eb" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/nossa-despedida-a99bb44257eb">Nossa despedida</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Implementando um controle de permissões no front-end com Angular]]></title>
            <link>https://medium.com/collact-tech/implementando-um-controle-de-permiss%C3%B5es-no-front-end-com-angular-fdebd1a18c3?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/fdebd1a18c3</guid>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[object-oriented]]></category>
            <category><![CDATA[permission]]></category>
            <category><![CDATA[rxjs]]></category>
            <category><![CDATA[angular]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Fri, 16 Sep 2022 22:52:17 GMT</pubDate>
            <atom:updated>2022-09-16T22:52:17.185Z</atom:updated>
            <content:encoded><![CDATA[<p>Se fosse para resumir a proposta de valor da Collact em uma única frase, eu diria que é <strong><em>um sofisticado programa de fidelidade digital voltado a pequenos e médios negócios de varejo, especialmente do ramo alimentício. </em></strong>Então, no auge da pandemia de covid-19, quando exatamente essa categoria se viu sem clientes do dia para a noite, a Collact se viu obrigada a se reinventar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RaTIS0Kk6eoH567JdWDwjg.jpeg" /></figure><p>Foi então que surgiu o Compre Local, uma iniciativa da Stone junto à Collact para fortalecer esses pequenos negócios e pensar juntos uma forma de aliviar os impactos econômicos da necessária quarentena. Em duas semanas, a equipe de produto e engenharia criou um novo e complicado produto para operar praticamente no lugar da fidelidade que ocupava a plataforma.</p><p>No entanto, com a vacinação no horizonte e as sanções mais rigorosas levantadas, a Collact voltou à sua proposta original e voltou a atender essa categoria, com um produto que ganhava tração e sofisticação a cada dia; mas já era tarde: o código do Compre Local já estava profundamente emaranhado no código original da plataforma.</p><p>Quando no segundo semestre de 2022 surge então a ideia de um novo produto — uma versão reduzida em recursos e em valor da plataforma — os traumas do Compre Local e da necessidade de uma enorme refatoração no código fez com que a equipe de front-end pensasse com bastante carinho na implementação disso.</p><p>Para fazer isso direito, era necessário cumprir com alguns pré-requisitos:</p><ul><li><strong>Escalabilidade</strong>: se novos produtos surgirem no futuro, a implementação deve ter pouco ou nenhum atrito;</li><li><strong>Centralização</strong>: toda lógica de permissão deveria ser concentrada em um único lugar;</li><li><strong>Reversibilidade</strong>: se um dia o produto deixar de existir, sua remoção do código deve ser simples.</li></ul><p>E foi com esses princípios que se concluiu que a melhor forma de executar isso seria criar um módulo responsável pelo controle de acesso via lista de permissões — ou, em inglês, uma <strong>Access Control List.</strong></p><h3>Implementação</h3><p>A Collact tem hoje dois produtos: uma versão completa e outra reduzida, chamadas provisoriamente na empresa de Pro e Light, respectivamente. Para realizar o controle de permissionamento, de quem verá ou não um determinado componente ou texto, foi criado um serviço chamado o AclService (<strong>A</strong>ccess <strong>C</strong>ontrol <strong>L</strong>ist Service), que concentra:</p><ul><li>as permissões existentes;</li><li>as permissões que uma empresa cliente tem;</li><li>os métodos auxiliares que determinam o conteúdo que ela verá com base em suas permissões.</li></ul><p>Dentro desse serviço, há dois passos iniciais e essenciais, que são armazenar dentro de propriedades tanto as permissões que aquele cliente tem como um objeto com as nomenclaturas das permissões possíveis.</p><p>Enquanto a propriedade com as permissões do cliente é privada e será consumida somente por métodos do próprio serviço, a com as permissões possíveis será usada por todo o código, tendo-a como <a href="https://en.wikipedia.org/wiki/Single_source_of_truth">single source of truth</a>. Por exemplo:</p><p>No serviço, exporta-se um objeto que atribui o nome para cada produto:</p><pre>export const PERMISSIONS: <em>Record</em>&lt;<em>string</em>, <em>PermissionNames</em>&gt; = {<br>  LIGHT: ‘BUSINESSDASH_PERMISSION_LIGHT’,<br>  PRO: ‘BUSINESSDASH_PERMISSION_PRO’,<br>};</pre><p>E no componente, essa constante é usada como chave em um objeto:</p><pre>export class ExampleComponent implements <em>OnInit</em> {<br>  permissions = PERMISSIONS;</pre><pre>  contentOptions = {<br>    [<em>this</em>.permissions.PRO]: &quot;só quem é Pro vê isso&quot;,<br>    [<em>this</em>.permissions.LIGHT]: &quot;Só quem é light vê isso&quot;,<br>  };<br>}</pre><p>Dessa forma, se porventura o nome da permissão mudar (como de fato mudou ao longo do desenvolvimento), basta alterar apenas no serviço, garantindo consistência entre todas menções às permissões no código.</p><p>Com essa pequena regra, a implementação do controle de permissões já se torna infinitamente mais simples. Mas no exemplo acima, ela ainda não está sendo usada de fato — e consumir essa informação também é parte essencial do processo. Isso pode ser feito de duas maneiras:</p><ul><li><strong>Via diretiva: </strong>foi criada a diretiva *permissionControl, que recebe como parâmetro uma permissão, em que é possível definir quem poderá ver aquele elemento HTML. Por exemplo: &lt;div *permissionControl=&quot;[this.permissions.LIGHT]&quot;&gt; só será visto por clientes que tem Collact Light. Vale notar que trata-se de uma array, então é possível colocar quantas permissões forem necessárias, conforme surjam novos produtos;</li><li><strong>Via serviço: </strong>o caso de uso mais comum, em que é necessário definir no arquivo Typescript do componente o que deve acontecer para cada permissão. Isso envolve criar um objeto cujas chaves são as permissões possíveis (como no exemplo acima) e utilizar o método this.aclService.aclDecisionValue para avaliar qual valor deve ser mostrado. Basicamente, ele retornará qualquer valor que seja passado como respectivo à permissão que o cliente em questão tem. Por exemplo:</li></ul><pre>const permissionDecision = {<br>      [this.permissions.PRO]: &#39;Bem-vindo, cliente de light!&#39;,<br>      [this.permissions.LIGHT]: &#39;Bem-vindo, cliente de Pro!&#39;,<br>    };<br></pre><pre>    const title =<br>      this.aclService.aclDecisionValue(permissionDecision);</pre><p>No exemplo acima, o método retornará o título conforme as permissões do cliente — e até por isso que a propriedade com essas permissões são privadas, porque toda lógica acontece dentro do serviço.</p><h3>Conclusão</h3><p>Por mais que o texto não entre nos pormenores do funcionamento de cada diretiva ou método, a ideia é apresentar a lógica geral da implementação de acordo com aqueles três pilares — e, nesse sentido, a Collact com certeza aprendeu com seus erros.</p><p>A implementação ficou muito simples, alterações no funcionamento já valem imediatamente para todos componentes e, se um dia for necessário remover uma permissão, basta pesquisar pelas palavras-chaves no código — e o contrário também é verdade: se um dia surgir uma permissão nova, basta acrescentar nos objetos e arrays que já existem.</p><p><em>Meus agradecimentos ao Joel Lima, líder de front-end e arquiteto dessa solução brilhante!</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/0*ONh23hI0r3OluhLy.jpeg" /><figcaption><a href="https://collact.com.br/">Collact</a> / <a href="https://instagram.com/collact">Instagram</a> / <a href="https://www.collact.com.br/carreiras">vagas</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fdebd1a18c3" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/implementando-um-controle-de-permiss%C3%B5es-no-front-end-com-angular-fdebd1a18c3">Implementando um controle de permissões no front-end com Angular</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Prevenindo erro humano no envio de notificações com automações no Python]]></title>
            <link>https://medium.com/collact-tech/prevenindo-erro-humano-no-envio-de-notifica%C3%A7%C3%B5es-com-automa%C3%A7%C3%B5es-no-python-6e2ed77e9790?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/6e2ed77e9790</guid>
            <category><![CDATA[python]]></category>
            <category><![CDATA[business-intelligence]]></category>
            <category><![CDATA[notifications]]></category>
            <category><![CDATA[automation]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Mon, 08 Aug 2022 20:05:01 GMT</pubDate>
            <atom:updated>2022-08-08T20:06:21.527Z</atom:updated>
            <content:encoded><![CDATA[<p>Isto já deve ter acontecido com você alguma vez: às 12h de um dia útil, você recebe 4 notificações de uma vez do seu aplicativo de delivery preferido com exatamente o mesmo conteúdo; quem sabe até já recebeu algo do tipo “Oi, NULL! o seu restaurante favorito está com promoção”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RhExFzrFA74WQm2A29F6fA.jpeg" /></figure><p>Quem sabe até pior: você era o encarregado por enviar as notificações no time de engenharia desse mesmo aplicativo e isso aconteceu. Pois é, também já estivemos na sua pele. E foi depois de alguns erros que decidiu-se acrescentar uma camada adicional de verificação e validação de dados antes de enviar qualquer notificação.</p><h3>O problema</h3><p>Aqui, o envio de todas nossas notificações — sejam elas via e-mail, SMS, WhatsApp, push, tudo — acontece por meio de um serviço no back-end chamado (pasmem!) de <em>notifications. </em>Por se tratar de um serviço altamente automatizável e que depende de constantes <em>queries </em>ao banco de dados, os envios são de responsabilidade do time de Business Analytics &amp; Automation.</p><p><a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">A arquitetura da Collact — parte 3: Business Analytics &amp; Automation</a></p><p>Esse processo todo acontece no Jupyter Notebook. Cria-se então uma query para coletar as informações necessárias para essa notificação do nosso banco de dados e em seguida, insere-se as variáveis necessárias: quem receberá, o canal de envio, os dados para aquele canal, o template de mensagem, etc. Uma vez feito tudo isso, bastava rodar o script e pronto! A notificação é enviada.</p><p>Soa simples, né? Porque de fato era. E é justamente por essa trivialidade que as coisas davam errado: se acontecia algum erro humano na etapa de redação da query ou na escolha de variáveis, esse erro ia adiante sem nenhum passo adicional.</p><p>Os erros não eram recorrentes ou comuns, mas de alto impacto quando ocorriam. Enviar vários e-mails de uma vez para um mesmo destino é pedir para ser classificado como spam pelo provedor — sem falar na insatisfação dos clientes que recebiam, que acionavam o suporte na mesma hora.</p><h3>A solução</h3><p>Mais atenção e revisão podem até ajudar, mas nada substitui uma boa rodada de testes antes de qualquer deploy de código ou execução de script. Criou-se então um novo fluxo de elaboração e envio de notificações, controlado por uma biblioteca de funções que chamamos de notification_sender; o fluxo ficou assim:</p><h4>1. Criar uma tabela temporária para essa notificação no banco de dados</h4><p>A ideia aqui é transformar essa nova tabela em uma espécie de <em>single source of truth </em>do envio: todas informações serão inseridas nela, bem como todas verificações antes do envio serão feitas nela.</p><p>Esse controle é todo feito via notification_sender , em que a primeira coisa a se fazer é criar de fato a nova tabela. É possível observar melhorias já nessa etapa, em que a tabela é criada já com todas as colunas obrigatórias para um envio: recipiente, canal, etc.</p><p>É possível ainda acrescentar colunas adicionais (e contextuais) com outra função, quando se pretende utilizar alguma informação extra, como gastos naquele mês, número de clientes cadastrados, etc.</p><h4>2. Elaboração da query e preenchimento da tabela</h4><p>Aqui não há muito o que discorrer a respeito: com SQL consulta-se o banco de dados em busca das informações necessárias para o envio da notificação e as copia para a tabela recém-criada.</p><h4>3. Validações e envio da notificação (onde a mágica acontece)</h4><p>É aqui que o notification_sender de fato brilha. Em uma extensa e detalhada função chamada send(notification_name), são procurados potenciais erros na tabela: se atinge o limite de envios diários; se não há recipientes; se há mais de uma notificação tentando ser enviada de uma vez; se todas estão com data e horário de envio; tudo que você imaginar que pode ser um problema, provavelmente está coberto por essa função.</p><p>Quando um erro de fato acontece, além de interromper a execução, mensagens de erro personalizadas são geradas com raise Exception, a fim de facilitar o rastreamento do que ocorreu.</p><p>Uma outra validação interessante que acontece é que, antes de enviar o comum enviar uma notificação para si mesmo a fim de validá-la. Só que também acontecia de esquecer de limitar o script para só um envio e acabava recebendo 500 notificações no próprio e-mail.</p><p>Com essas duas novas implementações — criação de tabela temporária e a camada de testes — não houve mais erros no envio de notificações da Collact. Mesmo que alguma tenha escapado, basta adicionar a condição e o respectivo erro na função e ele nunca mais acontecerá.</p><p>No fluxo da Collact, a verdadeira etapa final é fazer a build no Jenkins a partir do nome da tabela encarregada pela notificação, que por sua vez rodará o notebook e acusará os potenciais erros.</p><p>São implementações relativamente simples, porém criativas — e mais importante, resolvem o problema.</p><p><em>Meus agradecimentos à Gabriela Brasil, líder técnica de BA&amp;A, por me explicar em detalhes esse mecanismo!</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/0*MFi_kfSgf2lfHL6W.jpeg" /><figcaption><a href="https://collact.com.br/">Collact</a> / <a href="https://instagram.com/collact">Instagram</a> / <a href="https://www.collact.com.br/carreiras">vagas</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6e2ed77e9790" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/prevenindo-erro-humano-no-envio-de-notifica%C3%A7%C3%B5es-com-automa%C3%A7%C3%B5es-no-python-6e2ed77e9790">Prevenindo erro humano no envio de notificações com automações no Python</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Consertando a maior limitação do método PATCH na API da Collact]]></title>
            <link>https://medium.com/collact-tech/consertando-a-maior-limita%C3%A7%C3%A3o-do-m%C3%A9todo-patch-na-api-da-collact-80faf23c8514?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/80faf23c8514</guid>
            <category><![CDATA[algorithms]]></category>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[object-oriented]]></category>
            <category><![CDATA[data-structures]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Wed, 13 Jul 2022 15:58:52 GMT</pubDate>
            <atom:updated>2022-07-13T15:58:52.390Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xqTAgiRy6zhP3IzySYvULw.jpeg" /></figure><p>Digamos que você tem uma plataforma cuja comunicação com o back-end é via REST API. Em alguns formulários ou ações tomadas, você precisa editar um único campo de um JSON e enviá-lo de volta para o servidor. Você pode fazer isso de duas maneiras:</p><ul><li>Via PUT, enviando o JSON completo com apenas esse campo editado;</li><li>Via PATCH, corrigindo apenas o campo necessário.</li></ul><p>Evidentemente, a escolha será em utilizar PATCH; e de fato, isso resolve 90% dos casos. No entanto, a API da Collact é configurada para não serializar chaves nulas, então, nos outros 10% dos casos queremos utilizar null para apagar a informação de um determinado campo e não podemos.</p><p>Nos resta então utilizar o PUT, que também tem uma série de problemas próprios: por exigir que o JSON completo seja enviado para alterar um único campo, performance pode se tornar um eventual problema dependendo do tamanho do <em>payload</em>, além do aumento no risco à integridade da informação e a própria chance de um erro ser cometido na chamada e alterar o que não deveria.</p><p>A conclusão: até tem como fazer, mas não é ideal. O caminho: escrever o próprio algoritmo para solucionar isso.</p><h3>Objetivo</h3><p>A definição de sucesso do algoritmo é permitir que sejam passados apenas os campos que espera-se editar em uma chamada PATCH, e, ainda mais importante, que ao passar um valor null o campo seja apagado do banco de dados.</p><h3>Solução</h3><p>Foi idealizado então um parâmetro chamado set, cujo valor é uma string que representa uma estrutura hierárquica similar a um JSON, só que mais simples — sem aspas nem dois pontos — , indicando todos campos que devem ser alterados:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*uc3EER0hy3oo2Qt3.png" /></figure><p>No exemplo acima, somente os campos about e color, que são filhos do campo info, deveriam ser alterados. Como é de se esperar, somente os campos que se espera alterar são enviados; no entanto, se porventura algum campo seja enviado no corpo da chamada na intenção de alterá-lo mas ele não aparece no parâmetro set, ele não será alterado.</p><h3>Execução</h3><blockquote>Nota: o algoritmo foi feito em Java 8 e muito da explicação será com base no paradigma de orientação a objetos. No entanto, a fim de torná-la mais acessível a desenvolvedores de outras linguagens, não será mostrado código.</blockquote><p>Cria-se então uma classe chamada SelectorNode, <a href="https://www.cs.cmu.edu/~clo/www/CMU/DataStructures/Lessons/lesson4_1.htm#:~:text=A%20tree%20is%20a%20nonlinear,or%20one%20or%20more%20subtrees">que é uma implementação da estrutura de dados de Árvore</a>, que será encarregada por essa operação. De cara ela conta com três propriedades:</p><ul><li>name, que armazenará o nome do <em>node</em>;</li><li>children, uma lista de <em>nodes</em> que esse <em>node</em> pode vir a ter;</li><li>parent, um único <em>node</em> que será parent dessa instância; sua ausência indica que é o primeiro de todos.</li></ul><h4>O método parse</h4><p>O ponto de entrada do algoritmo é então um método estático chamado parse, que receberá justamente a string valor do parâmetro set. De cara, ele já instancia a classe SelectorNode com uma variável chamada currentNode; ele representa o root da <a href="https://pt.wikipedia.org/wiki/%C3%81rvore_(estrutura_de_dados)">node tree</a> que está sendo construída.</p><p>Em seguida começa um <em>loop</em> que passará caractere por caractere para compreender a estrutura dessa árvore.</p><p><strong>Se for um espaço em branco</strong>, ignore e passe para o próximo.</p><p><strong>Se for uma chave aberta </strong><strong>{:</strong></p><ul><li>instancie um novo <em>node</em> na variável childNode;</li><li>atribua à sua propriedade parent<em> </em>o currentNode;</li><li>coloque o childNode na lista children do currentNode;</li><li>por fim, determine que currentNode = childNode.</li></ul><p>A instrução acima pode parecer confusa, só que é mais simples do que parece. É muito importante visualizar tudo como uma árvore:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/0*qWCKpctmJZ5ZsSS_.png" /></figure><p>Ao iniciar o método parse, o SelectorNode foi instanciado como o <em>node A</em> da imagem. Em seguida, o <em>loop</em> encontrou a primeira chave aberta e criou um childNode (<em>node B </em>na imagem), deixando explícito via propriedades de cada instância a relação entre eles: <em>A</em> é parent de <em>B</em> e <em>B</em> é child de <em>A</em>.</p><p>Por fim, como a ideia é explorar essa árvore, o <em>node B</em> passa a ser o atual, de forma que uma próxima chave aberta indicará que ele também tem children. Vamos então adiante.</p><p><strong>Se o próximo caractere for uma chave fechada </strong><strong>}</strong>, o currentNode terá como novo valor seu próprio parent. Na prática, isso significa que não há mais para onde descer na árvore, logo é hora de retornar ao parent a fim de buscar por <em>sibling nodes </em>ou simplesmente fechar a árvore.</p><p><strong>Se for uma vírgula </strong><strong>,</strong> significa que chegamos a um <em>sibling node</em>. O proceder aqui é:</p><ul><li>instanciar novamente a classe SelectorNode sob a variável nova siblingNode;</li><li>determine que a propriedade parent dessa instância é a mesma do parent do currentNode (até porque são nodes irmãos!);</li><li>acesse o parent do currentNode e adicione a instância atual (siblingNode) em sua list children;</li><li>torne a instância atual o currentNode.</li></ul><p><strong>Se for qualquer outro caractere </strong>significa que estamos tratando do nome do node e finalmente podemos começar a construí-lo. É bem simples: basta pegar o nome atual da instância e acrescentar o caractere atual no final. Deixe que o loop repita isso até encontrar o próximo caractere acionador que vá compor a árvore.</p><p>E com todas essas regras estabelecidas, o loop tem insumos para lidar com todo caractere que surgir em set, criando a árvore no caminho. Se você está atento (e se eu fui claro o suficiente) você deve ter percebido que, nessa etapa final, inevitavelmente o currentNode será o mesmo atribuído antes mesmo do loop começar, já que toda chave aberta é eventualmente fechada.</p><p>No entanto, agora sua propriedade children contém todos os nodes, bem como as relações <em>parent-child-sibling</em> entre elas. Logo, o método parse(set) retorna o currentNode!</p><h4>O método merge</h4><p>Vamos relembrar: essa árvore de nodes que temos montada diz respeito aos campos que chegaram via PATCH e que devem ser alterados no banco, mas os valores em si estão no corpo da chamada. O método merge faz exatamente isso: cruza a intenção de edição com o conteúdo em si.</p><p>ele recebe três parâmetros: o objeto com as informações conforme estão no banco de dados, o objeto com as informações que se pretende alterar e a árvore que criamos. Para simplificar, chamaremos eles de current, incoming e selected, respectivamente. O enunciado disso fica algo como:</p><blockquote>Combine as informações presentes em current com aquelas em incoming utilizando a árvore selected como verdade.</blockquote><p>Agora, é uma questão de passar chave por chave no objeto current, procurando por aquelas que sejam homônimas à propriedade name de algum node na list de children do selected; encontrar um <em>node</em> com o mesmo nome significa que esse é um dos campos que se deseja editar, logo, basta encontrar a mesma chave no objeto incoming e utilizar seu valor para substituir no objeto current.</p><p>E para solucionar nosso problema original, é questão de configurar uma regra que apagará do banco de dados o campo que estiver presente em selected mas que em incoming seu valor é null.</p><blockquote>Uma curiosidade para leitores que programam em Java: para obter a lista de chaves possíveis, listamos todas os getters possíveis da classe que está sendo manipulada via Reflection.</blockquote><p>E com isso, chegamos ao fim do algoritmo. Deu para entender também que essa solução não é apenas para o apagar um campo via PATCH: é uma forma de garantir a integridade das informações no banco, tendo a certeza de que todos os campos no corpo de uma requisição estão lá intencionalmente.</p><p>O efeito prático disso é que criamos uma forma simples de manipular informações sem a necessidade de implementar algo como o GraphQL, além de criar uma camada adicional de verificação, algo especialmente importante no contexto atual da Collact, de tornar muitas de suas APIs públicas.</p><p><em>Meus agradecimentos ao Gabriel Mourão, líder técnico de back-end, que escreveu este brilhante algoritmo e me apresentou linha a linha.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/0*zzj1Uw6Lt69bDDpC.jpeg" /><figcaption><a href="https://collact.com.br/">Collact</a> / <a href="https://instagram.com/collact">Instagram</a> / <a href="https://www.collact.com.br/carreiras">vagas</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=80faf23c8514" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/consertando-a-maior-limita%C3%A7%C3%A3o-do-m%C3%A9todo-patch-na-api-da-collact-80faf23c8514">Consertando a maior limitação do método PATCH na API da Collact</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Checklist de lançamento de um produto digital: o caso de comunicações]]></title>
            <link>https://medium.com/collact-tech/checklist-de-lan%C3%A7amento-de-um-produto-digital-o-caso-de-comunica%C3%A7%C3%B5es-69c90275ef72?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/69c90275ef72</guid>
            <category><![CDATA[product-management]]></category>
            <category><![CDATA[startup]]></category>
            <category><![CDATA[release-planning]]></category>
            <category><![CDATA[digital-product]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Wed, 29 Jun 2022 19:12:06 GMT</pubDate>
            <atom:updated>2022-06-29T19:12:06.303Z</atom:updated>
            <content:encoded><![CDATA[<p>Recentemente a Collact lançou seu produto de comunicações, resultado de um esforço interno enorme que durou meses, da idealização do recurso às primeiras telas, desenvolvimento, programa piloto e inúmeras iterações considerando o que poderia ser acrescentado ou removido.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-1IKEXmCf3ykoHvh1PL6sQ.jpeg" /></figure><p>Em um breve resumo, este produto não consiste em apenas enviar comunicações dispersas para toda base via SMS ou e-mail. Junto a ele, também implementamos um gerador automático (e, opcionalmente, manual) de grupos de clientes por frequência de visita e/ou hábitos de consumo; uma opção de enviar prêmios, cortesias ou descontos para um determinado segmento além de métricas de acompanhamento, como aberturas, resgates e até receita incremental.</p><p>E foi na primeira semana de maio de 2022 que o produto foi ao ar para toda base de clientes da Collact. Naturalmente surgiram alguns bugs pontuais, mas no geral tudo correu muito bem, com ótimos indicadores de adesão, uso e engajamento.</p><p><strong>Lançar um produto</strong> <strong>envolve antecipar e solucionar todos os problemas que ele pode vir a ter, tanto técnicos quanto operacionais</strong>: infraestrutura escalável, fluxos claros e concisos sem perder relevância, questões jurídicas, alinhamento com a força comercial, alinhamento com marketing; enfim, tudo que veremos a seguir.</p><h3>Checklist</h3><p>Sem mais delongas, vamos ao checklist, com pontos que vão muito além da etapa de tecnologia e desenvolvimento, mas que são essenciais para um lançamento de sucesso:</p><h4>Validação do Jurídico</h4><ul><li><strong>Tratamento de dados:</strong> Avaliação e análise de ponta a ponta da jornada do produto e utilização de dados para garantir que o tratamento de dados pessoais está de acordo com a Lei Geral de Proteção de Dados.</li><li><strong>Consentimento e signup:</strong> Além disso, o produto surge como uma expansão da proposta original da Collact de programa de fidelidade e, diferente dele, em que a mensalidade é fixada de acordo com número de clientes, o pagamento aqui é feito no final do mês conforme o número de envios. Foi necessário então validar que a proposta e modelo de cobrança estavam bem explicadas e com todos detalhes legais para o cliente.</li></ul><h4>Treinamentos e Materiais</h4><ul><li><strong>Treinamento:</strong> o lançamento de um novo um novo produto exige que <strong>todos</strong> na empresa estejam na mesma página; mais do que isso, sejam verdadeiros especialistas no assunto. O time de Suporte deve ter as respostas para as principais dúvidas na ponta da língua e entender do produto de ponta a ponta. Já o time de Sucesso do Cliente fica encarregado de orientar o cliente de como extrair o maior potencial da ferramenta, com dicas e exemplos de casos de sucesso.</li><li><strong>Criação de FAQ e materiais de ajuda: </strong>idealmente, o suporte só deve ser acionado em último caso, quando as informações disponíveis não suprem a dúvida. Por isso, é importante detalhar ao máximo as dúvidas mais frequentes (FAQ) e desenvolver materiais de apoio que podem tanto auxiliar quanto incentivar o uso da ferramenta.</li></ul><h4>Estratégia de Comunicação</h4><ul><li><strong>Campanha de lançamento: </strong>o nome é bastante autoexplicativo e a missão nobre: divulgar o novo produto para os clientes. Envolve coordenar calendário de ações, público-alvo, mensagem e meios em que se divulgará esse novo produto: redes sociais, e-mail marketing, blog da empresa, etc.</li><li><strong>Demonstrações: </strong>A campanha de lançamento também incluiu ações que demonstravam o valor através do produto, mostrando de fato suas potencialidades e funcionamento. A Collact fez então materiais para consulta com melhores práticas, além de demonstrações (ou demos, para os íntimos) do produto transmitidas ao vivo no YouTube e divulgada para os lojistas da plataforma, permitindo que tirem dúvidas, vejam exemplos de uso, etc.</li></ul><h4>Métricas de sucesso</h4><p>Lançar um produto sem mensurar resultados é dirigir de olhos vendados. Se você não estabelece métricas de sucesso e objetivos-chave, é impossível saber se o produto está indo bem; pior ainda, não tem como saber onde melhorar.</p><ul><li><strong>Key Results:</strong> Para os primeiros meses, os indicadores de sucesso focaram em três pilares: Adoção, Engajamento e Recorrência. Em linhas gerais, para Adoção, mediu-se a quantidade de adesões ao produto; para Engajamento, quantas pessoas que aderiram também desempenharam uma determinada ação; por fim, para Recorrência, foi definida uma ação que deveria se repetir algumas vezes em um determinado período.</li><li><strong>CES: </strong>Um novo produto pode gerar dúvidas e os usuários podem ter diferentes percepções de dificuldade de uso. O <em>Customer Effort Score </em>(ou índice de dificuldade do consumidor)<em> </em>é um excelente indicador sobre o quão difícil ou fácil está sendo para os consumidores usarem o produto, de forma que ter um CES integrado ao fluxo no lançamento é altamente recomendável.</li></ul><h4><strong>Técnica</strong></h4><ul><li><strong>Infraestrutura: </strong>o produto de comunicações exige bastante de nossos servidores: <em>queries </em>longas feitas aos bancos de dados<em> </em>e complexas definem os grupos de clientes; grandes clientes da Collact enviando 30 mil comunicações cada de uma vez; monitoramento e cálculos em tempo real de sucesso de campanhas. Tudo isso, sem a devida infraestrutura, é capaz de derrubar a Collact — como de fato derrubou em testes. É de suma importância garantir a estabilidade e escalabilidade de seus serviços antes de lançar algo novo.</li><li><strong>Estabelecimento de Fases: </strong>em um raciocínio similar, mesmo quando se está confiante do que está porvir, é sábio fazer um lançamento faseado. No caso da Collact, isso foi feito em três fases: primeiro para pessoas que se inscreveram para o <em>early-access </em>através de uma <em>fake-door</em> colocada no painel; segundo para toda base da Collact de pequeno e médio porte (em relação ao número de clientes cadastrados) e por último para as lojas com dezenas de milhares de clientes em suas bases. Assim, foi possível entender o impacto nos servidores de forma progressiva.</li><li><strong>Avisos dentro do produto:</strong> é importante também garantir que lojistas que não foram impactados pelas iniciativas de marketing fiquem sabendo do produto. Para isso, foi colocado um destaque na barra de navegação na seção de comunicações, um card na página inicial com os dados de envios (e um convite para criar a primeira comunicação, caso não tenha dados disponíveis), etc.</li></ul><p>Cada um desses pontos permite uma dissertação muito mais extensa, levantando incontáveis tópicos; no entanto, a ideia aqui é oferecer as linhas gerais do que foi feito para lançar o produto de comunicações.</p><p>É possível encontrar muito do material citado em nossas plataformas, especialmente da parte de estratégia de comunicação, como o canal do YouTube da Collact ou a landing page que criamos para isso.</p><p>É claro que cada produto digital terá suas peculiaridades — mas creio que, em linhas gerais, esse pode ser um bom checklist a ser seguido.</p><p><em>Meus agradecimentos ao Pedro Nakano, product manager responsável por coordenar todo lançamento de comunicações, pela ajuda!</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/0*shY7vxGADmymKjX_.jpeg" /><figcaption><a href="https://collact.com.br/">Collact</a> / <a href="https://instagram.com/collact">Instagram</a> / <a href="https://www.collact.com.br/carreiras">vagas</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=69c90275ef72" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/checklist-de-lan%C3%A7amento-de-um-produto-digital-o-caso-de-comunica%C3%A7%C3%B5es-69c90275ef72">Checklist de lançamento de um produto digital: o caso de comunicações</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[A organização do time de inteligência de dados da Collact]]></title>
            <link>https://medium.com/collact-tech/a-organiza%C3%A7%C3%A3o-do-time-de-intelig%C3%AAncia-de-dados-da-collact-fcdc063263e5?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/fcdc063263e5</guid>
            <category><![CDATA[cultura-organizacional]]></category>
            <category><![CDATA[data-visualization]]></category>
            <category><![CDATA[business-intelligence]]></category>
            <category><![CDATA[startup]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Mon, 06 Jun 2022 18:18:44 GMT</pubDate>
            <atom:updated>2022-06-06T18:25:11.390Z</atom:updated>
            <content:encoded><![CDATA[<p>O time de análise de dados da <a href="https://collact.com.br/">Collact</a> tem uma série de peculiaridades. Não é só seu nome — Business Analytics &amp; Automation, ou BA&amp;A — que difere de outras empresas, que costumam atender por Business Intelligence (BI); é também sua estrutura organizacional, diretamente ligada ao nascimento da área.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/720/1*m7AQtkPeoOu105xxfrg2xA.jpeg" /></figure><p>Para uma empresa de tecnologia com 10 anos de bagagem, pensar que nossa área de inteligência surgiu no começo de 2019 surpreende um pouco. A razão disso é que até então, a Collact ainda não tinha despontado e os dados que as ferramentas de CRM ofereciam para uso interno ainda supria as necessidades.</p><p>Com a integração do produto aos POSs (Point of Sale, ou maquininha) e força de vendas da <a href="https://stone.com.br/">Stone</a>, a Collact viu um aumento enorme no uso da plataforma e a demanda por análises mais sofisticadas, tanto interna quanto externamente, também cresceu.</p><p><a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">A arquitetura da Collact — parte 3: Business Analytics &amp; Automation</a></p><p>Esse aumento nas solicitações vieram de todos os lados e times, fazendo com que o BA&amp;A ganhasse destaque, fortalecendo processos e acelerando contratações. Naturalmente a equipe passou a se dividir para atender as demandas específicas de cada área, só que de forma informal.</p><p>Se por um lado alguma organização era melhor que nenhuma, por outro a falta de formalizações passou a gerar bastante retrabalho e confusão; era comum alguém pedir a mesma coisa para duas pessoas, vendo quem responderia mais rápido e no final a demanda era feita duas vezes.</p><p>Disso, foi possível concluir duas coisas:</p><ol><li>Era hora de pensar mais a fundo a organização do time;</li><li>As demandas precisavam seguir um fluxo definido.</li></ol><h3>A primeira versão</h3><p>Parte de repensar a área foi entender que <strong>o time de dados é o braço de tecnologia dentro de cada área da empresa</strong>. Uma possível conclusão seria alocar um desenvolvedor para cada, mas isso criaria um problema sério de escalabilidade e manutenção de código; logo, o caminho foi criar squads dentro de BA&amp;A.</p><p>foi criada então uma squad para atender cada time que demandava dados, o que, na prática, significava uma pessoa por squad — e, é claro, deu errado. O volume de demandas estava muito desequilibrado, então era comum uma pessoa ser de mais de uma squad, ferindo totalmente o princípio da coisa.</p><p>Outro problema percebido é que, com o ritmo de contratação aumentando, também já não dava para falar em rituais de scrum com toda a equipe: uma daily ou retro com 11 pessoas é insustentável.</p><p>Hora de iterar.</p><h3>As squads hoje</h3><p>Chegamos então ao modelo de hoje: menos squads, com escopos maiores. Ao invés de uma para cada time da área Comercial (Sales, CX e marketing), temos a squad responsável por toda a área; o mesmo vale para Produto e Suporte, sendo essas as três squads atuais.</p><h4>Produto</h4><p>Na Squad Produto, as demandas são majoritariamente consumidas pelo front-end do Painel de Controle, disponibilizando informações diretamente para os lojistas por meio de consultas que são calculadas em tempo real.</p><p>Tal qual o nome, essa squad também atua com o time de Produto, tanto na parte de criação de dashboards para acompanhar OKRs, métricas e outras informações relevantes, quanto para consultas mais sofisticadas, cruzando dados de usos de diferentes fontes para obter insights úteis para uma pesquisa ou para o próprio desenvolvimento de um recurso.</p><h4>Comercial</h4><p>Já a Squad Comercial atende principalmente a demanda enorme por integrar e sofisticar o Hubspot, a ferramenta de vendas usada pela Collact. É aqui que BA&amp;A entra forte em automações, com boa parte das etapas do funil de vendas contando com alguma inteligência por trás.</p><p>Entre as etapas automatizadas estão a geração de leads por interação com o app no POS Stone e formulários de contato, o avanço no funil e criação de conta na plataforma após o credenciamento e a sinalização de cliente perdido.</p><p>As visualizações dos dados de clientes é levada ainda para o Metabase, onde gráficos de dashboards são criados a partir de informações como o número de clientes em cada etapa do funil, clientes em risco, clientes perdidos, etc.</p><h4>Suporte</h4><p>Por fim a Squad Suporte é responsável pela inteligência e automação no pós-vendas, focando especialmente nas integrações do ZenDesk, software de helpdesk, e TakeBlip, usado para os contatos via WhatsApp.</p><p>Um dos maiores desafios aqui é garantir que as informações de cada empresa estejam sempre atualizadas dentro do próprio Zendesk, evitando que o suporte tenha que sair do ambiente da plataforma e agilizando o atendimento.</p><p>As informações de atendimento também são consumidas via API pelo metabase, em que se cria dashboards de acompanhamento de métricas como tickets abertos, tempo de resposta, produtividade, problemas mais recorrentes, etc.</p><p>Em 2022 a squad assumiu ainda o desenvolvimento do ambiente CRUD da Collact, também amplamente utilizado pelo suporte no atendimento e resolução de tickets; a criação desse Cockpit, como chamamos, é que o BA&amp;A o desenvolveu em Angular, a framework de Javascript que também usamos no front-end.</p><p><a href="https://tech.collact.com.br/o-stack-da-collact-parte-1-front-end-920980e323ac">O stack da Collact — parte 1: front-end</a></p><h3>O Organograma</h3><p>Em cada squad há uma referência, que são pontos focais das demandas e, junto à liderança técnica de BA&amp;A, também são responsáveis por estar a par de tudo que acontece no chapter. Para isso, as três referências frequentam as três dailies e participam das três plannings, a fim de evitar o problema do passado de retrabalho e também para entender o que pode ser aproveitado em sua própria squad.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/819/1*nKF144nkQn9IXPu43mdGJA.png" /><figcaption>O organoma das squads hoje</figcaption></figure><p>Isso faz com que os rituais mantenham-se concisos (evitando o problema do primeiro organograma) e consequentemente mais úteis para toda squad, já que todos os assuntos são relevantes para o próprio contexto. Além disso, não há mais conflito de demanda: o time comercial sabe que assuntos de Hubspot é com determinada pessoa e que deve passar pela referência da Squad — e o mesmo vale para as demandas vindas das outras duas áreas.</p><p>Todas as squads são monitoradas pela liderança técnica de BA&amp;A, que além de conhecer e ajudar a direcionar todas as demandas, também é responsável por projetos mais estratégicos a nível de companhia, além de estar sempre buscando melhorar os fluxos, ferramentas utilizadas, padrões de arquitetura — além, é claro, de tomadas de decisão na área.</p><p>Esse modelo corrige todos os problemas de comunicação que a primeira versão tinha, mas ainda não alcançou sua forma ideal. No futuro, é provável que as referências deixem de participar de todos os rituais, mas por enquanto esse organograma atende perfeitamente as demandas e fluxos de BA&amp;A.</p><p><em>Esse texto só foi possível com a ajuda de </em><a href="https://www.linkedin.com/in/renan-schultze/"><em>Renan Schultze</em></a><em>, analista de dados e referência de suporte, e </em><a href="https://www.linkedin.com/in/gabrielaparavani/"><em>Gabriela Brasil</em></a><em>, líder técnica de BA&amp;A. Valeu!</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fcdc063263e5" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/a-organiza%C3%A7%C3%A3o-do-time-de-intelig%C3%AAncia-de-dados-da-collact-fcdc063263e5">A organização do time de inteligência de dados da Collact</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[A Cultura do time de produto da Collact que você não encontrará pendurada na parede]]></title>
            <link>https://medium.com/collact-tech/a-cultura-do-time-de-produto-da-collact-que-voc%C3%AA-n%C3%A3o-encontrar%C3%A1-pendurada-na-parede-d6b16f1a3bc4?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/d6b16f1a3bc4</guid>
            <category><![CDATA[product-design]]></category>
            <category><![CDATA[cultura-empresarial]]></category>
            <category><![CDATA[corporate-culture]]></category>
            <category><![CDATA[product-management]]></category>
            <category><![CDATA[product-development]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Tue, 24 May 2022 13:58:06 GMT</pubDate>
            <atom:updated>2022-05-24T14:18:47.175Z</atom:updated>
            <content:encoded><![CDATA[<p>Cultura empresarial é um assunto cabeludo. Às vezes é apenas um termo vazio, às vezes é algo forçado goela abaixo… Há um ponto ideal entre esses dois extremos, em que a empresa comunica claramente seus princípios, ideais e estilo de trabalho, contratando de acordo e evitando uma empresa dividida, com princípios e objetivos discrepantes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*El-wGyOxhKdyMWXdnePKag.jpeg" /></figure><p>Gosto de pensar que a Collact se encontra nesse ponto hoje. Para além de coisas que deveriam ser óbvias e são praticadas na aqui, como oferecer boas condições materiais e morais de trabalho, percebo que as equipes tomam o tempo necessário para contratar com qualidade, mesmo com algumas vagas em alta demanda.</p><p>A “qualidade”, nesse caso, diz respeito ao alinhamento com a forma como a equipe trabalha, as práticas, o que é bem visto, o que é evitado; há um trecho no livro <a href="https://www.goodreads.com/work/quotes/68514322">What You Do Is Who You Are: How to Create Your Business Culture</a>, de Ben Horowitz, que resume bem esse conceito:</p><blockquote>“Cultura é como sua empresa toma decisões quando você não está por perto. É o conjunto de presunções utilizadas pelos funcionários para resolver problemas do dia a dia. É como eles se comportam quando ninguém está olhando.”</blockquote><p>Em outras palavras, se as lideranças soltarem o volante, o carro andará sozinho? A resposta é sim quando a cultura é forte. Decidi então entender essa questão nos <em>chapters</em> de produto da Collact, o que cada um entende que permite o carro andar sozinho.</p><p>Para isso, vesti meu traje de pesquisador e perguntei individualmente para cada product manager, designer e UX Researcher como eles enxergam esses aspectos e o que diferencia a forma da Collact de trabalhar de outras empresas.</p><p>Abaixo, agrupei os itens que mais sobressaíram nessas conversas e que, ao meu ver, traçam um belo perfil de como é trabalhar com produto na Collact.</p><ul><li><strong>Todo designer também faz papel de Product Manager:</strong> são igualmente responsáveis pelo produto em todas as etapas. Desde a criação das tasks no Sprint (no âmbito do Scrum), <em>handover</em> para desenvolvedores, análise de qualidade, definição e acompanhamento das métricas de sucesso, etc;</li><li><strong>Managers e designers também realizam testes</strong>: esse ponto nasceu da necessidade. Um time enxuto e sem recursos para contratar alguém de Q.A (<em>Quality Assurance</em>) fez com que Produto se tornasse parte essencial do fluxo de testes. Hoje isso foi incorporado como parte da filosofia de <em>ownership</em> de partes do produto, até porque quem concebe algo é quem terá mais domínio sobre aquilo — e não se olha só se o layout está de acordo com o handover, mas também se as informações estão chegando corretamente da API, se todos cenários estão sendo contemplados, etc;</li><li><strong>Se passamos uma semana sem falar com o cliente, algo está muito errado: </strong>não, não é clichê. A cultura de produto da Collact está profundamente enraizada no contato com o cliente, não só por parte de research como por todo o time de produto. É a única forma de saber exatamente as dores do pequeno varejo em todo o Brasil;</li><li><strong>A pesquisa com cliente na Collact vem antes, durante e depois</strong>: é comum em muitas empresas que pesquisa seja apenas uma das etapas do desenvolvimento de produto, muitas vezes feita para tentar trazer evidências para “a diretoria” validar uma solução. Aqui na Collact, <a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-4-produto-99aaae4517b7">mantemos constante contato com o cliente para entender se sequer vale a pena ir adiante com uma ideia</a>, falando com ele para validar o problema, fazer testes de usabilidade, testes ao vivo do produto em fase “<em>Beta</em>” e também conversas abertas com quem já usa o produto há mais tempo.</li></ul><p><a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-4-produto-99aaae4517b7">A arquitetura da Collact — parte 4: produto</a></p><ul><li><strong>Toda decisão deve ser orientada por dados: </strong>a partir do momento que pesquisa tem tanta ênfase no processo, é de se esperar que elas ganhem uso no dia a dia. Qualquer ideia ou decisão deve ser guiada por essas informações garimpadas e outras <a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">processadas pelo time de análise de dados </a>— que também oferece suporte para produto — , tanto em sua formulação quanto em seu acompanhamento e definição de métricas de sucesso;</li><li><strong>Squads multidisciplinares aproximam a equipe:</strong> as squads na Collact idealmente contam com pelo menos um Product Manager, Designer, UX Researcher, desenvolvedor front e back-end. Todos estão sob os mesmo OKRs e as trocas no dia a dia são rápidas e facilitadas;</li></ul><blockquote>“Na Collact, os desenvolvedores e os designers estão muito próximos, rola uma tabela forte no dia a dia, especialmente com front-end.”</blockquote><ul><li><strong>Research está na squad e não como chapter</strong>: a ideia aqui é que as pesquisas feitas em UX estejam diretamente relacionadas aos OKRs e aos problemas que a squad está enfrentando ou enfrentará. A ideia é evitar que o chapter esteja isolado e gere dezenas de relatórios, pesquisas e insights descontextualizados da realidade de cada squad, olhando apenas problemas macro;</li><li><strong>Divisão em squads não significa cada um por si:</strong> toda escolha é uma renúncia. Inevitavelmente as trocas dentro do chapter de produto acaba sendo menos intensa do que em outro modelo organizacional, mas tem um efeito colateral interessante: os rituais e documentações que contemplam todo o chapter ganharam qualidade, para que todos saibam de tudo que está acontecendo — o que permite também contribuições entre squads, como no Design Critique.</li><li><strong>O design critique é para mostrar coisa feia mesmo</strong>: design critique é o ritual em que o time de produto se reúne para, bem, criticar o trabalho um dos outros. A ideia aqui é que não importa o quão verde uma tela ainda está, ela está pronta para o escrutínio. É claro que contextualizar é igualmente importante, para evitar que insistam em um ponto que já será melhorado, mas o espírito é de não ter vergonha de coisa inacabada;</li><li><strong>Side quests de produto:</strong> a Collact incentiva bastante que todos toquem projetos que se identifiquem, querem realizar e, mais do que isso, tornar-se o <em>owner </em>de fato daquilo: há quem tenha assumido para si o desenvolvimento do design system, de um glossário de termos da Collact, a sofisticação do design critique… Não importa se é um ritual, um processo ou uma ferramenta, ter <em>ownership</em> de algo é parte da cultura.</li><li><strong>Designers também fazem <em>free code friday</em>:</strong> esse ritual começou na área de desenvolvimento mas hoje envolve todos em produto e engenharia. A ideia é tirar uma sexta-feira inteira a cada 15 dias para fazer algo fora do escopo da sprint e do que já está em andamento na squad. Isso dá liberdade para novas ideias nascerem, conceitos arriscados serem testados e até novos produtos surgirem.</li></ul><p>Esse levantamento buscou entender justamente o que torna o time de produto da Collact o que é. Dois pontos me chamaram bastante a atenção:</p><ul><li>A unanimidade da importância da pesquisa em todo o processo de concepção e desenvolvimento;</li><li>Não dá para esperar ordens para se mexer.</li></ul><p>Enquanto o primeiro ponto diz respeito à forma de se enxergar o processo de criar um produto, o segundo é de fato uma filosofia interna: se tem uma ideia, realize; se desenvolveu uma tela, acompanhe até o final; se está insatisfeito com algum processo, assuma para si a melhoria dele. Tudo isso é muito bem visto e parece que todos têm clareza disso do minuto que entram na Collact.</p><p>É sempre importante lembrar que não existe jeito certo de fazer produto, existe o jeito que funciona em cada contexto e empresa — e esses são alguns pontos que fazem a roda girar tão bem aqui na Collact.</p><p><em>Esse texto foi concebido depois de conversar individualmente com cada pessoa do time de produto. Meu agradecimento a todos por me ajudar a entender o que significa trabalhar ao lado de vocês!</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/1*W8L9rZaxH-IP_vxlQvUDNw.jpeg" /><figcaption><a href="https://collact.com.br/">Collact</a> / <a href="https://instagram.com/collact">Instagram</a> / <a href="https://www.collact.com.br/carreiras">vagas</a></figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d6b16f1a3bc4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/a-cultura-do-time-de-produto-da-collact-que-voc%C3%AA-n%C3%A3o-encontrar%C3%A1-pendurada-na-parede-d6b16f1a3bc4">A Cultura do time de produto da Collact que você não encontrará pendurada na parede</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como transformar uma API de uso interno em pública]]></title>
            <link>https://medium.com/collact-tech/como-transformar-uma-api-de-uso-interno-em-p%C3%BAblica-25688ac3e3af?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/25688ac3e3af</guid>
            <category><![CDATA[desenvolvimento]]></category>
            <category><![CDATA[java]]></category>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[api-development]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Tue, 10 May 2022 14:19:06 GMT</pubDate>
            <atom:updated>2022-05-10T14:19:06.737Z</atom:updated>
            <content:encoded><![CDATA[<h3>Tornando pública uma API de uso interno: as decisões e algoritmos</h3><p>Há exatos 10 anos, a <a href="https://collact.com.br/">Collact</a> nascia dentro da uma faculdade em São Paulo com a ideia de digitalizar aquele tradicional sistema de fidelidade, em que se troca alguns carimbos por uma refeição. Foi uma epopeia de iterações até o produto tornar-se o que é hoje, em que o grande ponto de inflexão foi passar a operar dentro do POS (<em>point of sale</em>, ou maquininha de cartão para os mais próximos) da <a href="https://www.stone.com.br/">Stone</a>.</p><p>Além de uma integração facilitada com lojistas, que antes precisavam adquirir um tablet com o app da Collact, a fricção com clientes do estabelecimento também diminuiu vertiginosamente, já que agora o próprio POS é capaz de convidar novos clientes a participar do programa e identificar os recorrentes por meio do cartão cadastrado no app, bastando pagar para valer no programa de fidelidade.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ViyICu7fdH69M7sLIgBJ5Q.jpeg" /></figure><h3>O Problema</h3><p>Esse universo que a Stone abriu para a Collact mudou o jogo — mas também criou vícios na forma como nossa API opera. <a href="https://tech.collact.com.br/o-stack-da-collact-parte-2-back-end-806f5e430913">Apesar de hoje nosso backend caminhar para uma arquitetura de múltiplos serviços</a>, na ocasião existia apenas o serviço <em>core,</em> um grande monolito com todas as regras de negócio.</p><p><a href="https://tech.collact.com.br/o-stack-da-collact-parte-2-back-end-806f5e430913">O stack da Collact, parte 2: back-end</a></p><p>Pela importância que o POS ganhou na operação da Collact, criou-se uma tendência de tê-lo como centro de tudo: endpoints de transações, créditos, payment gateways estavam todos voltados a esse client, minando a capacidade de inovação da Collact para novas implementações.</p><p>Um dos maiores problemas nesse aspecto é que um estabelecimento só pode existir e fazer login na Collact se ele possui um S<em>tonecode, </em>que é o identificador único de um POS.</p><blockquote><em>⚠️ </em><strong>Hoje, se você não tem maquininha Stone, você não pode ter Collact.</strong></blockquote><p>Essa necessidade de entregar nossa API como plataforma e não como algo exclusivamente voltado ao universo Stone se provou cada vez mais necessário, especialmente conforme a API, equipe e inteligência da Collact crescia.</p><p>Era hora então de expandir e explorar a possibilidade de integrar a API com outros backends, e-commerces, sistemas de frente de caixa, TEFs e o que qualquer outro desenvolvedor quiser.</p><h3>A ideia</h3><p>Como você já deve imaginar, decidimos que era necessário uma API pública que não tivesse os mesmo entraves e tampouco girasse em torno do POS; começaram então as rodadas de discussão e definição de escopo.</p><p>O primeiro passo era definir o que isso significa — ter uma API pública. Não basta ser acessível via web; a API da Collact já permite isso hoje se você tem as credenciais necessárias. API pública precisa de:</p><ul><li>documentação pública;</li><li>Definição clara de conceitos e objetos;</li><li>e um contrato estável.</li></ul><p>Se por um lado a Collact trabalha hoje também com um modelo de BFF (<em>backend for frontend</em>), em que temos APIs desenhadas especificamente para os problemas e necessidades de nossos <em>clients</em>, por outro as nossas APIs primitivas já estavam a poucos passos de se tornarem públicas; e foi esse o caminho escolhido.</p><h3>A solução</h3><p>Para fazer essa conversão de API primitiva para pública, era preciso solucionar alguns entraves:</p><h4><em>Deixar de condicionar o uso da plataforma ao </em>Stonecode</h4><p>Como era de se esperar, o primeiro passo rumo à escalabilidade foi justamente acabar com a dependência do <em>Stonecode</em> para autenticação e credenciamento, passando a adotar uma chave API que identificará uma determinada loja.</p><p>Além de auxiliar na expansão da API como plataforma, ainda ajuda a solucionar um dos vilões do churn rate da Collact, que são lojistas que saem da Stone, querem manter o programa de fidelidade mas não podem.</p><p>Vale mencionar que, para isso acontecer, o sistema que esse lojista adotar deve estar integrado com a Collact antes, de forma que seja possível processar as informações de transação e fidelidade de cada usuário que passa pela loja.</p><h4>Definição de quais APIs serão públicas e padronização dos paths</h4><p>Ter APIs públicas não quer dizer tornar-se totalmente aberta. Foi então definido quais endpoints fariam parte disso: chamadas que registram transações em cartão, transação em dinheiro, gasto e ganho de créditos, resgate de ofertas; todos os pontos essenciais para oferecer o programa de fidelidade.</p><p>Com as chamadas em mãos, era necessário fazer pequenas alterações conceituais. O ato de expor para o mundo deve ser a prova de erro e nem sempre os nomes que demos aos <em>paths</em> eram impecáveis, por exemplo: a chamada transact foi renomeada para registerTransact, reforçando que a Collact não é a adquirente responsável pela transação.</p><p>Por último, foram analisadas todas as mensagens e status de erro que um integrador pode vir a receber, criando <em>feedbacks</em> mais claros e que dependam menos de suporte para solucionar.</p><h4>Edição de campos específicos via REST API</h4><p>Se você é desenvolvedor, talvez já tenha se deparado com esse problema: editar apenas alguns campos via REST não é tarefa simples. O PUT exige que todos campos sejam enviados, o que cria um potencial problema de performance, integridade da informação e de tamanho do payload.</p><p>A solução é clara então, certo? O PATCH! De fato é o melhor caminho, mas ele também não resolve 100% nosso problema: um campo null é simplesmente ignorado, quando nossa intenção é de que ele seja interpretado como forma de apagar o valor daquele campo.</p><p>Implementar o GraphQL seria como usar um canhão para acertar uma maçã, então optamos por uma solução caseira que chamamos de <em>field selector</em>: uma chamada de PATCH com um parâmetro chamado set, em que é possível especificar as chaves que se pretende editar no JSON passado no corpo da chamada:</p><p>api.company.com.br/shop?set={info{about,color}}</p><p>Nessa chamada para o <em>endpoint</em> shop serão editadas as informações about e color, presentes no <em>parent node</em> info:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yuOTOv74iwr3crFqcA7Dzw.png" /><figcaption>Se qualquer um dos campos não estivesse no parâmetro set, seria ignorado</figcaption></figure><p>Com isso, solucionamos a única falha do PATCH sem a necessidade de trazer bibliotecas externas ou mudar fundamentalmente a forma como fazemos chamadas. O algoritmo, inclusive, será tema de um texto no futuro.</p><h4>Implementação da chave de idempotência</h4><p>A última etapa para garantir a integridade das APIs públicas é certificar de que elas não estão chegando duplicadas. A Collact lida com créditos e valores em nome de um estabelecimento, então é essencial que todas chamadas sejam únicas.</p><p>Para isso, foi implementado um mecanismo de chave de idempotência, que é um header que será enviado nas chamadas, especialmente de transação, com um identificador único e aleatório gerado no formato UUIDv4.</p><p>No servidor, um banco de dados Redis armazena todas <em>requests</em> e suas respectivas chaves, de forma que se ela repetir, será identificada a duplicidade e o valor retornado será o da primeira chamada de sucesso.</p><p>As implementações citadas foram as maiores, mas ainda há um longo caminho de pente fino a ser feito antes da API pública da Collact ser lançada. Da definição e implementação de um <em>rate limit</em> nas chamadas à redação e revisão de toda documentação pública, ainda vão alguns meses.</p><p>Além disso, junto à API, a Collact planeja ainda o lançamento de um SDK para acompanhá-la, garantindo que a experiência de desenvolvimento de qualquer implementação tenho o mínimo de fricção possível — e isso também será tema de um texto no futuro, então não se esqueça de seguir o blog da Collact Tech.</p><p><em>Esse texto só foi possível graças ao </em><a href="https://br.linkedin.com/in/heitor-neves-3962199b?original_referer=https%3A%2F%2Fwww.google.com%2F"><em>Heitor Neves</em></a><em>, CTO da Collact, e </em><a href="https://br.linkedin.com/in/gabriel-mourao-guzzo?trk=public_profile_browsemap"><em>Gabriel Mourão</em></a><em>, líder técnico do backend e do projeto de tornar as APIs públicas. Muito obrigado!</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=25688ac3e3af" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/como-transformar-uma-api-de-uso-interno-em-p%C3%BAblica-25688ac3e3af">Como transformar uma API de uso interno em pública</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Algoritmos e decorators: definindo a escala de cores de cada lojista na Collact]]></title>
            <link>https://medium.com/collact-tech/algoritmos-e-decorators-definindo-a-escala-de-cores-de-cada-lojista-na-collact-2e799e95e642?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/2e799e95e642</guid>
            <category><![CDATA[decorators]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[typescript]]></category>
            <category><![CDATA[front-end-development]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Mon, 25 Apr 2022 20:22:13 GMT</pubDate>
            <atom:updated>2022-04-26T12:12:52.977Z</atom:updated>
            <content:encoded><![CDATA[<p>Decorator é um recurso experimental do Typescript e um tipo de especial de declaração, capaz de manipular outras declarações com uma sintaxe concisa e poderosa.</p><p>Apesar de ser experimental, é a base do Angular desde que deixou de ser AngularJS em 2016. Se você utiliza a framework, já deve ter visto coisas como <a href="https://angular.io/api/core#decorators">@Inject, @Pipe, @Component</a> e outras arrobas em cima de classes — que se chamam <em>annotations</em> — , capazes de abstrair toda a lógica avançada em uma única linha.</p><p>Mas <em>decorators</em> não são úteis somente no topo das classes em si. Na verdade, podem ter como alvo tanto as classes quanto seus <a href="https://www.typescriptlang.org/docs/handbook/decorators.html#method-decorators">métodos</a>, <a href="https://www.typescriptlang.org/docs/handbook/decorators.html#accessor-decorators">acessadores</a>, <a href="https://www.typescriptlang.org/docs/handbook/decorators.html#property-decorators">propriedades</a> ou <a href="https://www.typescriptlang.org/docs/handbook/decorators.html#parameter-decorators">parâmetros</a>. Este é um assunto denso e explicado com excelência pelo<a href="https://www.youtube.com/watch?v=AJf0NAxPVHI&amp;t=415s"> Eduardo Florence no AngularSP Talks #30</a>, com exemplos para cada um deles.</p><figure><img alt="capa do texto, em tema cibernético e com uma arroba no centro" src="https://cdn-images-1.medium.com/max/1024/1*CeqvM1GJ7qAYL465BgfVWw.jpeg" /></figure><p>Na <a href="https://www.collact.com.br/">Collact</a>, cuja plataforma é escrita em Angular, 99% dos componentes utilizam ao menos dois decorators autorais: @AutoUnsubscribe() e @CombineSubscriptions(). Como os nomes sugerem, auxiliam na gestão de subscriptions do RxJS, sendo o primeiro um <em>class decorator</em> que e o segundo um <em>property decorator.</em></p><p><a href="https://tech.collact.com.br/o-stack-da-collact-parte-1-front-end-920980e323ac">O stack da Collact — parte 1: front-end</a></p><p>Apesar de bastante sofisticados em sua implementação, ambos representam um caso de uso bastante difundido, sendo representados tanto no Angular Talks citado acima quanto em outros artigos de Medium, como<a href="https://medium.com/@2muchcoffee/trick-or-unsubscribe-in-rxjs-a-custom-angular-decorator-c10d4afad71c"> esse que inspirou o usado na Collact</a>, então não entrarei em detalhes.</p><p>Outro criado para simplificar rotinas foi o <strong><em>@Timeout(ms)</em></strong>, um <em>method decorator</em> que recebe como parâmetro os milissegundos, simplifica a sintaxe e, o mais importante, permite “substituir” a função de callback por um método de classe.</p><p>Por fim, há o @<strong><em>ColorPalette</em></strong>, um decorator de propriedade que atende um uso bastante particular da Collact e tem uma implementação brilhante, que é o tema do texto de hoje.</p><h3>O Problema</h3><p>No painel do lojista que contrata a Collact, ao fazer <em>upload</em> de seu logotipo, um algoritmo analisa a cor predominante na imagem e a define como a cor primária daquela empresa, podendo também ser alterada manualmente.</p><p>Essa escolha é refletida em toda a experiência na plataforma, cuja interface é personalizada de acordo: ícones, botões, banners, comunicações, etc. estarão na cor da empresa, ou pelo menos em uma cor dentro da escala de cores definida.</p><p>Mas isso cria um belo problema: como criar um sistema que compreendesse nuances e tons daquela cor, que outra cor serve de contraste, etc. considerando que há mais de 16 milhões de combinações RGB possíveis?</p><h3>A Solução</h3><p>O primeiro passo foi criar as diretrizes: cada empresa teria então uma escala com nove tons gerados a partir da cor selecionada no painel, variando somente a luminosidade entre elas. A forma encontrada foi converter a cor de RGB para HSL — que significa <em>Hue</em>, <em>Saturation</em> e <em>Lightness</em> (ou matiz, saturação e luminosidade).</p><p>É agora que as coisas começam a ficar complicadas: essa escala é definida em 9 tons, em que o mais claro terá 96% de luminosidade e o mais escuro 10% — e os outros sete também são pré-estabelecidos. Só que se esse aspecto da cor de uma empresa em HSL for de 27%, como fica essa paleta?</p><p>Eis que a beleza do HSL se revela. Já que sabemos exatamente qual <em>lightness</em> queremos para cada tom em nossa escala, podemos usar somente o <em>Hue</em> e <em>Saturation</em> daquela cor original, aproximando-a de um dos 9 tons e colocando ele como padrão.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/638/1*HTiEzIRBlMl4_BkN444W0g.png" /><figcaption>Exemplo de como o sistema atua, pegando a tom mais próximo da original.</figcaption></figure><p>Esse sistema foi pensado junto ao time de produto, de forma que ao dizer que um botão deve estar no tom s400, isso valeria para qualquer cor de painel, não importa a empresa. Agora é questão de transformar isso em código.</p><h3>O Decorator</h3><p>A melhor forma de compreender o que foi feito é construí-lo aqui, pouco a pouco. O primeiro passo é criar a função de fato:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NEWT8z0nflfrcucT_gpYkg.png" /></figure><p>A primeira coisa que já chama a atenção é que essa função retorna outra; é uma <a href="https://www.theodinproject.com/paths/full-stack-javascript/courses/javascript/lessons/factory-functions-and-the-module-pattern">factory function</a>. Isso é especialmente útil para decorators, cujos parâmetros obrigatoriamente dizem respeito ao seu alvo — nesse caso a propriedade de uma classe — , fazendo com que esse <em>pattern</em> seja necessário para passar parâmetros próprios, como scale, que permitirá que a tonalidade, entre as nove possíveis, seja escolhida.</p><p>Conforme mencionado, a cor primária da empresa é definida no painel e, como é de se esperar, é salva com as outras informações da empresa no back-end. Na nossa arquitetura, isso significa que essa informação virá por meio de um <a href="https://rxjs.dev/guide/observable">observable stream</a> e, para que se possa usufruir do <a href="https://angular.io/guide/property-binding">property binding</a> do Angular, deverá ser atribuída a uma uma propriedade da classe do componente.</p><p>Isso significa que a propriedade será inicializada vazia e só receberá um valor quando a informação estiver disponível. A ação de definir um novo valor à propriedade de um objeto chama-se set e pode ser manipulada para executar uma função mais sofisticada do que a mera atribuição do novo valor:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IPU0mh2ST1jWTxLCTrkg1A.png" /></figure><p>Vamos analisar o que está sendo feito, trecho a trecho:</p><ol><li>Variável value é definida no escopo da função, com seus dois tipos possíveis;</li><li>Função setter, que vai manipular o valor newValue que está sendo atribuído à propriedade;</li><li>Condicional que interromperá a função caso newValue esteja vazio;</li><li>Inicialização do serviço colorPaletteService, responsável pela conversão do RGB ou HEX da cor para HSL e criação dos diferentes tons;</li><li>Em seguida, a criação da variável cPalette, que é atribuída será um objeto com os nove tons da paleta a partir da cor primária do lojista;</li><li>Caso o decorator tenha recebido alguma chave do objeto de tons (<em>s100</em>, <em>s200</em>, <em>s300</em>, etc.) como parâmetro, a variável cPalette deixará de ser todo o objeto e será apenas a cor solicitada;</li><li>A variável value, declarada fora do escopo da função setter, será igual ao objeto completo ou ao tom exato.</li></ol><p>Bom, agora já temos a função responsável por transformar o valor atribuído à propriedade-alvo do decorator, mas por enquanto é só uma função sem uso. É necessário acessar as propriedades do objeto para que isso seja finalmente implementado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ugp4cuxGw3MP27H0XJKpZg.png" /></figure><p>E com isso nosso decorator está finalizado e pronto para uso! Com Object.defineProperty estamos alterando o comportamento do objeto (a classe) para quando a propriedade propertyName é definida (set) e utilizada (get), sendo o <em>getter</em> apenas uma <a href="https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Functions/Arrow_functions">arrow function</a> que retorna o valor tratado no <em>setter</em>.</p><p>Para utilizar, basta colocá-lo imediatamente antes da declaração de uma propriedade:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GLTO0SEzbwyngCF6ok9Cpg.png" /></figure><p>O exemplo acima é um típico componente da plataforma Collact. Com <em>class decorators</em> acima da classe, o Angular já realiza todas ações necessárias para que isso seja um componente reutilizável, enquanto o @AutoUnsubscribe garante que todas subscriptions coletadas pelo <em>property decorator</em> @CombineSubscriptions sejam destruídas quando o componente for desmontado.</p><p>Logo abaixo, o fruto da criação de hoje @ColorPalette(&#39;s600&#39;) atua sobre a propriedade recém-inicializada businessColor600, fazendo com que toda vez que um novo valor é atribuído a ela (como acontece dentro do <em>subscription</em> do observable getBusiness()), o processo do <em>setter</em> aconteça — e o do <em>get</em> quando é chamada.</p><p>Por fim, o <em>method decorator </em><em>@Timeout(1000)</em> que garante um atraso de 1 segundo quando o método logOnClick é chamado, mediante clique no botão criado no template.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/464/1*IdSJXMaAKzBF3I4wOrieNg.png" /><figcaption>ao clicar, depois de um segundo o console.log nos dirá que sim, funcionou!</figcaption></figure><p>Chegamos ao fim de mais um texto! Espero que tenha ficado claro tanto para que serve um decorator, onde que ele atua em um objeto e como deve ser sua implementação.</p><p>Algo que eu também espero que tenha ficado claro ao longo das etapas é que, por mais que decorators sejam recursos do Typescript, todo o código usado é Javascript. Getters, Setters, Object.defineProperty são elementos que evidenciam Javascript como uma linguagem orientada a objetos, que você pode (e deve!) usar sempre, assim como todas outras formas de manipular e utilizar objetos em seu código.</p><p>Como alguém que aprendeu a programar já mirando em uma framework, voltar às bases e entender melhor como objetos de fato funcionam me ajudou a enxergar o panorama geral, abrindo todas as portas que frameworks mantêm intencionalmente fechadas, para abstrair a complexidade do código.</p><p>Saber Angular, React, Vue, etc. é importante, mas são as bases da programação que preparam para a próxima linguagem ou framework da vez.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2e799e95e642" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/algoritmos-e-decorators-definindo-a-escala-de-cores-de-cada-lojista-na-collact-2e799e95e642">Algoritmos e decorators: definindo a escala de cores de cada lojista na Collact</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[A arquitetura da Collact — parte 4: produto]]></title>
            <link>https://medium.com/collact-tech/a-arquitetura-da-collact-parte-4-produto-99aaae4517b7?source=rss-bfcccca1eda6------2</link>
            <guid isPermaLink="false">https://medium.com/p/99aaae4517b7</guid>
            <category><![CDATA[product]]></category>
            <category><![CDATA[agile]]></category>
            <category><![CDATA[product-design]]></category>
            <category><![CDATA[discovery]]></category>
            <category><![CDATA[product-management]]></category>
            <dc:creator><![CDATA[Guilherme Almeida]]></dc:creator>
            <pubDate>Mon, 11 Apr 2022 14:19:24 GMT</pubDate>
            <atom:updated>2022-04-11T14:19:24.668Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>A arquitetura da Collact — parte 4: produto</strong></h3><p>Como parte da série de apresentar a arquitetura de cada time dentro de produto &amp; engenharia da <a href="https://www.collact.com.br/">Collact</a> — já passamos pelo <a href="https://tech.collact.com.br/o-stack-da-collact-parte-1-front-end-920980e323ac">front-end</a>, <a href="https://tech.collact.com.br/o-stack-da-collact-parte-2-back-end-806f5e430913">back-end</a> e <a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">BA&amp;A</a> -, chegamos ao último texto da série, sobre o time de Produto. Como é de se imaginar, o que tange a arquitetura de produto é diferente de engenharia, mas isso não significa que seus métodos não são baseados em frameworks, metodologias e tecnologias.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*L91pZIRFJLwXGD2g" /></figure><p>Desde janeiro de 2022, a Collact passou a se organizar em squads, com profissionais de UX com ênfase em pesquisa, design e gestão de produto, front e back-end; em um primeiro momento, são elas a Squad Core e a Squad Neo, responsáveis pelo produto central e pelo produto ampliado, respectivamente. Ambas operam em sprints quinzenais e alternadas entre si, ou seja, quando a de um squad termina, a do outro começa.</p><p>E é no âmbito de cada squad que a Collact está em um fluxo contínuo de descoberta, exploração, desenvolvimento e validação. É difícil traçar a linha do que é inspiração e o que é reflexo, mas entre as frameworks mais difundidas no mercado, o processo da Collact se assemelha muito ao <em>Triple Track Agile </em>e ao <em>triple diamond</em>, criado no Zendesk.</p><p><strong>Não quer dizer que encaramos um ou outro modelo como bala de prata e nem consideramos essa a única forma de se trabalhar</strong> — até porque <em>framework</em> quer dizer estrutura em inglês; é uma maneira de abordar um problema de forma estruturada, não uma solução final. Dito isso, para dar linearidade à explicação, vamos nos basear nos três diamantes para ilustrar o fluxo do produto da Collact:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*A0jgdG5mL9AiIz5O" /><figcaption>O triplo diamante do Zendesk, em tradução livre. fonte: <a href="https://medium.com/zendesk-creative-blog/the-zendesk-triple-diamond-process-fd857a11c179">Zendesk Creative Blog</a></figcaption></figure><h3><strong>Descoberta</strong></h3><h4><strong>Identificação do problema</strong></h4><p>Tudo começa na identificação do problema. Ele pode surgir como uma descoberta em rodadas de pesquisas anteriores ou algo identificado pela frente de negócios e/ou estratégia da empresa que merece aprofundamento. A partir disso, começam as rodadas de recrutamento e seleção de clientes-chave para a Collact.</p><p>Essa seleção é embasada com critérios bastante claros. Todos clientes da Collact estão listados em nosso <a href="https://airtable.com/">Airtable</a>, uma plataforma que, dentre seus recursos, funciona como uma espécie de híbrido entre planilha e bancos de dados; isso permite uma visão detalhada e em tempo real de número de clientes, valor transacionado, números dos últimos 30 dias, entre outros dados-chave.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*vhOc-SS9cSw1HQ5i" /><figcaption>Airtable de conhecimento sobre o cliente, em que cada bloco é uma entrevista realizada</figcaption></figure><p>Há ainda situações em que queremos algo ainda mais específico para avaliar essa escolha, recorrendo então ao <a href="https://www.metabase.com/">Metabase</a> — plataforma de consulta e <a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">visualização de dados</a> — onde é possível fazer consultas aprofundadas ao banco de dados da Collact, cruzando uma série de informações de um determinado negócio.</p><p><a href="https://tech.collact.com.br/a-arquitetura-da-collact-parte-3-business-analytics-automation-296b82435364">A arquitetura da Collact — parte 3: Business Analytics &amp; Automation</a></p><h4><strong>Definição do problema e descoberta da solução</strong></h4><p>Selecionadas a amostra participante, um arquivo no <a href="https://www.atlassian.com/br/software/confluence">Confluence</a> é criado contendo o plano de pesquisa ou escopo do projeto de pesquisa, em que são descritos pontos como <strong>objetivo, problema, amostra participante, modelo de recrutamento, ambiente de documentação dos resultados e seu cronograma</strong>. A entrevista pode ser com metodologia exploratória estruturada ou fechada, variando de acordo com seus objetivos.</p><p>Ao final da entrevista — que é gravada — acontece um debriefing, em que pode-se discutir aprendizados, dados adquiridos e acumulados ao longo de todo projeto de pesquisa e/ou insights, mapeando dificuldades, desejos, bugs, sugestões, etc.</p><p>Os trechos mais relevantes da pesquisa são documentados em vídeos curtos, com título explicando brevemente a razão pelo destaque, sendo acompanhado também por tags que nos ajudam a reunir os diversos pontos comuns entre diferentes baterias de pesquisa; por exemplo: “O que o cliente pensa sobre nossa precificação” ou “como começou empreender”.</p><p>Com essa riqueza de informações, coletadas de diversas fontes e devidamente catalogadas, <strong>cria-se uma base de conhecimento cada vez maior e mais assertiva acerca do público-alvo da Collact</strong>, tornando o processo de descoberta cada vez mais ágil.</p><p>Aqui já levantamos algumas hipóteses, mas raramente haverá apenas uma solução ou caminho para o problema — e mesmo dentro de um caminho, terão de ser feitas prioridades. Para situações que ainda estão muito ambíguas, utilizamos uma matriz RICE, sigla em inglês para <strong>Confiança, Alcance, Impacto, e Esforço</strong>, que nos ajuda a colocar na balança por qual caminho seguir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*IAQ6XQjPPKXYOUcR" /><figcaption>Nossa matriz RICE no Airtable. O score final é calculado automaticamente com base nos outros campos.</figcaption></figure><h3><strong>Desenvolvimento</strong></h3><h4><strong>Design e desenvolvimento</strong></h4><p>Com uma potencial solução escolhida após a etapa anterior, é hora de pular para o <a href="https://www.figma.com/">Figma</a> e rabiscar. Começa então o desenvolvimento das primeiras telas, que pouco a pouco engatinham em direção ao ideal, em um longo ciclo de iterações com o passar dos <em>sprints</em>.</p><p><strong>As pesquisas com a base não param e ganham corpo ao longo desse tempo</strong>. O que começa como validação do conceito da solução, torna-se protótipo e depois é integrado às telas da plataforma — que já é familiar ao cliente -, de forma que ele pode navegar nesse protótipo de alta fidelidade como se estivesse utilizando o próprio produto da Collact.</p><p>Paralelamente, essas telas e caminhos também passam por feedback dos outros profissionais de produto da Collact, em um ritual semanal chamado<em> design critique</em>, em que é apontado tudo que pode melhorar, acrescentar ou remover; vale dizer, no entanto, que essas mudanças são apenas sugestões, que podem ou não ser acatadas.</p><p>Com feedbacks dos pares e de clientes, a cada sprint as telas ganham mais maturidade e qualidade, <strong>se aproximando cada vez mais do ideal, enquanto as incertezas diminuem no mesmo ritmo</strong>; e é neste momento que a ideia ganha vida.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*f0l93wBu0GbPuKk_" /><figcaption>A evolução de um card na seção de cobranças a partir de feedbacks e iterações</figcaption></figure><p>Com isso, já é possível falar em programação. É claro que nada é tão linear quanto parece: enquanto designers trabalham nas telas, os times de operações, produto e back-end já discutem regras de negócios, implementação de APIs, impacto na base, etc; de qualquer forma, o desenvolvimento da solução já passa a configurar nas sprints de front-end.</p><h3><strong>Validação</strong></h3><h4><strong>Programa de acesso antecipado</strong></h4><p>O primeiro passo é definir quem vai participar dessa validação, tendo o cuidado de incluir uma amostra que seja representativa da base de clientes impactada pela solução; pessoas que passaram por pesquisas nos passos anteriores e demonstraram interesse ou que o time de operações identificou que podem se beneficiar também costumam ser convidadas. Por fim, há situações em que abrimos um formulário de inscrição na própria plataforma por meio de uma <a href="https://medium.com/@karina.napoli.carvalheiro/fake-door-testing-quando-descobri-o-que-existe-por-tr%C3%A1s-de-essa-fun%C3%A7%C3%A3o-n%C3%A3o-est%C3%A1-dispon%C3%ADvel-80f27bd73c4b">fake door,</a> algo que ainda ajuda a medir o interesse da base.</p><p>Como estamos falando de implementar o recurso no produto de fato, mostrando para apenas alguns clientes, condicionamos a visualização e utilização dele com um mecanismo que chamamos de <em>feature flag.</em> Basicamente, clientes selecionados são sinalizados no banco de dados e, por meio da nossa API, permitimos ou não o uso do recurso na plataforma.</p><p>Essa etapa costuma trazer uma riqueza de insights imensa. Não só para polir a solução, encontrando bugs e oportunidades de melhoria, mas também para entender como clientes de fato usarão aquilo. Muitas vezes, mesmo com pesquisas e validações com os protótipos de alta fidelidade, o benefício entendido ou o uso que se dá é diferente do que se espera — e isso não é sinal de que a solução não funcionou; inclusive pode ser que ela tenha uma entrega ainda maior. <strong>A verdade é que, no final, a realidade se impõe.</strong></p><p>O mais importante nessa etapa é o acompanhamento ativo. É necessário agendar pesquisas, analisar dados de uso, comparar o uso esperado com o uso que se dá e até mesmo de fato observar como o cliente está interagindo com aquela solução, utilizando ferramentas como o <a href="https://www.hotjar.com/">Hotjar</a>.</p><h3><strong>Lançamento</strong></h3><h4><strong>Disponibilização comercial</strong></h4><p>É hora de finalmente lançar a solução. Não basta simplesmente ativá-la para toda a base e ver o que acontece; isso exige que todos os times da Collact, sem exceção, estejam em plena sincronia, sob coordenação do gerente de produto:</p><ul><li>Em operações, quem de fato está na linha de frente, ajudando o cliente a ter sucesso, prestando suporte ou realizando vendas precisa integrar a solução em sua rotina;</li><li>O time jurídico precisa ter certeza de que não há nenhum entrave legal, principalmente em relação ao uso de dados;</li><li>O marketing precisa trabalhar em sua divulgação e adoção, considerando inclusive os insights coletados no programa de acesso antecipado para destacar a proposta de valor do produto e orientar o foco de campanhas.</li><li>O back-end precisa analisar os possíveis gargalos de performance e escalabilidade da solução;</li></ul><p>Uma vez que todos estão em perfeita harmonia, o recurso é lançado. Isso significa que o trabalho de manutenção acabou? Jamais. Com certeza surgirão melhorias de menor impacto e mais importante ainda, é preciso compreender a adesão da base.</p><p>Uma métrica bastante importante aqui é CES (<em>Customer Effort Score</em>, ou Nota de Esforço do Cliente), que mede o esforço realizado em uma determinada ação no produto. Ela é reveladora porque ajuda a entender os bloqueios do cliente e se os fluxos da solução estão simples de interagir e navegar — ou, pelo menos, facilitados. Quanto mais difícil o processo, mais difícil será a adesão da base.</p><p>Há também métricas que mudam de caso para caso; de qualquer forma, algumas delas são: recorrência, CTR, engajamento, etc; em soluções com impacto direto na receita, é interessante acompanhar também a Receita Média Por Usuário (ARPU) e Receita Recorrente Mensal e Anual (MRR e ARR). Por fim, há métricas mais globais da Collact que com certeza verão impacto, como Usuários Ativos Mensais (MAU), <em>churn rate</em> e valor vitalício do cliente (LTV).</p><p>Observando a imagem do triplo diamante do começo do texto, daria para dizer que chegamos ao fim do fluxo. Na verdade, é um erro acreditar que há um fim: o <strong>desenvolvimento de um produto não pode ser encarado como projeto</strong>, com começo, meio e fim; é um processo constante de melhoria contínua.</p><p>É importante ressaltar que nossos processos estão em constante evolução. Esse fluxo é nosso ideal, é o melhor que conseguimos fazer até hoje em recursos mais novos que estão em beta ou que sequer saíram — mas não quer dizer que é o que sempre conseguimos fazer.</p><p>Isso é algo que vale frisar porque, se você não está fazendo tudo isso, não se desespere; leva tempo, prática e pessoas para alcançar esse nível de amadurecimento — e mesmo o time de produto da Collact tem um longo caminho pela frente.</p><p><em>Este texto só foi possível graças à consultoria dos meus colegas aqui na Collact: </em><a href="https://www.linkedin.com/in/vladimirfigueiredo/"><em>Vladimir Figueiredo</em></a><em> (Head de Produto), </em><a href="https://www.linkedin.com/in/felipeemarcon/"><em>Felipe Marcon</em></a><em> (Product Designer), </em><a href="https://www.linkedin.com/in/pedronakano/"><em>Pedro Nakano</em></a><em> (Product Manager) e </em><a href="https://www.linkedin.com/in/enzo-dulius/"><em>Enzo Dulius</em></a><em> (UX Researcher). Obrigado, pessoal!</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=99aaae4517b7" width="1" height="1" alt=""><hr><p><a href="https://medium.com/collact-tech/a-arquitetura-da-collact-parte-4-produto-99aaae4517b7">A arquitetura da Collact — parte 4: produto</a> was originally published in <a href="https://medium.com/collact-tech">Collact Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>