[{"data":1,"prerenderedAt":810},["ShallowReactive",2],{"projects":3},[4,224,454,579,701],{"_path":5,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":9,"description":10,"slug":11,"year":8,"role":12,"featured":13,"order":14,"technologies":15,"github":8,"demo":8,"cover":20,"coverAlt":21,"coverWidth":22,"coverHeight":23,"category":24,"placeholder":7,"architecture":25,"screenshots":30,"body":61,"_type":218,"_id":219,"_source":220,"_file":221,"_stem":222,"_extension":223},"\u002Fprojects\u002Fpt\u002Ffinance-platform","pt",false,"","Blanco Finanças","Portal para clientes acompanharem planos de poupança e pagamentos, com uma área administrativa para gerenciar planos e fluxo de caixa.","finance-platform","Desenvolvimento full stack",true,1,[16,17,18,19],"Nuxt","FastAPI","PostgreSQL","SQLAlchemy","\u002Fimages\u002Fblanco-financas\u002Fclient-dashboard.webp","Dashboard do cliente no Blanco Finanças com saldo, planos ativos, parcelas pendentes e histórico de pagamentos.",1440,1000,"Aplicação web",[26,27,28,29],"Nuxt · Vue · TypeScript","FastAPI · Serviços de aplicação","Domínio · Regras financeiras","SQLAlchemy · PostgreSQL",[31,36,41,46,51,56],{"src":32,"title":33,"description":34,"alt":35,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fclient-plans.webp","Poupanças e metas","Planos do cliente com progresso, saldo e próximos vencimentos, em visualizações compacta e detalhada.","Visualização detalhada das poupanças do cliente, com status e progresso de cada plano.",{"src":37,"title":38,"description":39,"alt":40,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fclient-finance.webp","Parcelas e pagamentos","Área financeira com parcelas disponíveis, valores e vencimentos, além de acesso a retiradas e histórico.","Área financeira do cliente com lista de parcelas, valores, datas de vencimento e status.",{"src":42,"title":43,"description":44,"alt":45,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fadmin-dashboard.webp","Visão administrativa","Indicadores de clientes, planos, entradas, saídas, fundo de proteção e saques pendentes em uma única tela.","Dashboard administrativo com indicadores financeiros e distribuição de clientes por status.",{"src":47,"title":48,"description":49,"alt":50,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fadmin-finance.webp","Fluxo de caixa","Consulta das movimentações por período, categoria e tipo, com totais e detalhamento de cada lançamento.","Controle financeiro administrativo com filtros de período e categoria, totais e tabela de movimentações.",{"src":52,"title":53,"description":54,"alt":55,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fadmin-plans.webp","Gestão de planos","Catálogo administrativo com status, limites de contratação e duração dos planos de poupança.","Painel de gestão de planos com cartões de planos ativos e inativos, valores e duração.",{"src":57,"title":58,"description":59,"alt":60,"width":22,"height":23},"\u002Fimages\u002Fblanco-financas\u002Fadmin-reports.webp","Relatórios","Seleção de período e opções de exportação de clientes, transações, fluxo de caixa e rendimentos.","Tela de relatórios com filtros de data e opções de exportação em Excel, CSV e PDF.",{"type":62,"children":63,"toc":209},"root",[64,73,79,85,90,95,100,106,111,116,122,177,183,188,193,198,204],{"type":65,"tag":66,"props":67,"children":69},"element","h2",{"id":68},"duas-rotinas-na-mesma-aplicação",[70],{"type":71,"value":72},"text","Duas rotinas na mesma aplicação",{"type":65,"tag":74,"props":75,"children":76},"p",{},[77],{"type":71,"value":78},"No Blanco Finanças, o cliente precisa consultar o saldo de seus planos de poupança, saber quais parcelas vencem a seguir e acompanhar pagamentos. A administração precisa de outra visão: clientes, catálogo de planos, entradas, saídas e saques pendentes. Desenvolvi as duas áreas com acesso aos dados pela mesma API e permissões específicas para cada perfil.",{"type":65,"tag":66,"props":80,"children":82},{"id":81},"o-que-desenvolvi",[83],{"type":71,"value":84},"O que desenvolvi",{"type":65,"tag":74,"props":86,"children":87},{},[88],{"type":71,"value":89},"Minha contribuição abrange o frontend em Nuxt e o backend em FastAPI, incluindo as regras financeiras e as integrações. No portal, o cliente acompanha o progresso dos planos, consulta parcelas e histórico de pagamentos e acessa a área de retiradas.",{"type":65,"tag":74,"props":91,"children":92},{},[93],{"type":71,"value":94},"O fluxo de contratação apresenta uma recomendação de plano, detalha os custos e permite a ativação por Pix. A integração com o Mercado Pago fica no backend, que acompanha os estados das transações e recebe as confirmações de pagamento.",{"type":65,"tag":74,"props":96,"children":97},{},[98],{"type":71,"value":99},"No painel administrativo, é possível consultar indicadores, filtrar movimentações por período e categoria, gerenciar o catálogo de planos e acessar relatórios de clientes, transações, fluxo de caixa e rendimentos.",{"type":65,"tag":66,"props":101,"children":103},{"id":102},"organização-da-aplicação",[104],{"type":71,"value":105},"Organização da aplicação",{"type":65,"tag":74,"props":107,"children":108},{},[109],{"type":71,"value":110},"O frontend usa Nuxt, Vue e TypeScript, com componentes do Nuxt UI. As páginas organizam a navegação, enquanto os composables concentram o acesso à API para as telas de clientes e administradores.",{"type":65,"tag":74,"props":112,"children":113},{},[114],{"type":71,"value":115},"No backend, o FastAPI recebe as requisições e os serviços de aplicação coordenam os casos de uso. As regras financeiras ficam em entidades e serviços de domínio, separadas dos adaptadores de serviços externos. Os dados são persistidos em PostgreSQL com SQLAlchemy assíncrono; as migrações usam Alembic.",{"type":65,"tag":66,"props":117,"children":119},{"id":118},"decisões-técnicas",[120],{"type":71,"value":121},"Decisões técnicas",{"type":65,"tag":123,"props":124,"children":125},"ul",{},[126,147,157,167],{"type":65,"tag":127,"props":128,"children":129},"li",{},[130,136,138,145],{"type":65,"tag":131,"props":132,"children":133},"strong",{},[134],{"type":71,"value":135},"Cálculos monetários:",{"type":71,"value":137}," uso centavos e ",{"type":65,"tag":139,"props":140,"children":142},"code",{"className":141},[],[143],{"type":71,"value":144},"Decimal",{"type":71,"value":146}," no backend, com arredondamento definido no objeto de valor monetário. Isso explicita como os valores são representados e arredondados nas regras financeiras.",{"type":65,"tag":127,"props":148,"children":149},{},[150,155],{"type":65,"tag":131,"props":151,"children":152},{},[153],{"type":71,"value":154},"Permissões na API:",{"type":71,"value":156}," a autenticação usa JWT, e as operações verificam o perfil de acesso no backend. A separação entre clientes e administradores não depende apenas das telas disponíveis.",{"type":65,"tag":127,"props":158,"children":159},{},[160,165],{"type":65,"tag":131,"props":161,"children":162},{},[163],{"type":71,"value":164},"Confirmações de pagamento:",{"type":71,"value":166}," o backend mantém os estados das transações e trata confirmações Pix de forma idempotente, para que uma confirmação repetida não aplique a mesma operação novamente.",{"type":65,"tag":127,"props":168,"children":169},{},[170,175],{"type":65,"tag":131,"props":171,"children":172},{},[173],{"type":71,"value":174},"Limites das integrações:",{"type":71,"value":176}," adaptadores concentram o acesso ao Mercado Pago, Banco Central, envio de email e exportação de relatórios, mantendo esses detalhes fora das regras de domínio.",{"type":65,"tag":66,"props":178,"children":180},{"id":179},"o-que-a-aplicação-permite-fazer",[181],{"type":71,"value":182},"O que a aplicação permite fazer",{"type":65,"tag":74,"props":184,"children":185},{},[186],{"type":71,"value":187},"O cliente consegue acompanhar seus planos e pagamentos, enquanto a administração consulta movimentações e gerencia os planos no mesmo sistema. As duas áreas estão implementadas e são apresentadas nas telas desta página.",{"type":65,"tag":74,"props":189,"children":190},{},[191],{"type":71,"value":192},"Em uso, a aplicação atendeu mais de 100 usuários, com três administradores simultâneos. A centralização das rotinas reduziu cerca de 30 horas de trabalho com planilhas por semana e permitiu ampliar a operação.",{"type":65,"tag":74,"props":194,"children":195},{},[196],{"type":71,"value":197},"As capturas foram feitas na aplicação em execução local, com contas de teste e movimentações existentes. Os dados de identificação foram ocultados.",{"type":65,"tag":66,"props":199,"children":201},{"id":200},"tecnologias",[202],{"type":71,"value":203},"Tecnologias",{"type":65,"tag":74,"props":205,"children":206},{},[207],{"type":71,"value":208},"Nuxt · Vue · TypeScript · Nuxt UI · FastAPI · Python · PostgreSQL · SQLAlchemy · Alembic",{"title":8,"searchDepth":210,"depth":210,"links":211},2,[212,213,214,215,216,217],{"id":68,"depth":210,"text":72},{"id":81,"depth":210,"text":84},{"id":102,"depth":210,"text":105},{"id":118,"depth":210,"text":121},{"id":179,"depth":210,"text":182},{"id":200,"depth":210,"text":203},"markdown","content:projects:pt:finance-platform.md","content","projects\u002Fpt\u002Ffinance-platform.md","projects\u002Fpt\u002Ffinance-platform","md",{"_path":225,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":226,"description":227,"slug":228,"year":229,"featured":13,"order":210,"technologies":230,"github":8,"demo":8,"cover":233,"coverWidth":22,"coverHeight":234,"placeholder":7,"role":12,"category":235,"coverAlt":236,"architecture":237,"galleryTitle":242,"galleryDescription":243,"screenshots":244,"body":274,"_type":218,"_id":451,"_source":220,"_file":452,"_stem":453,"_extension":223},"\u002Fprojects\u002Fpt\u002Fgovt-analyser","Analisador de Gastos Públicos","Ement: aplicação para comparar a destinação de emendas parlamentares entre estados, consultar registros e exportar dados do Portal da Transparência.","govt-analyser","2026",[16,231,17,18,232],"TypeScript","D3","\u002Fimages\u002Fement\u002Foverview.webp",1261,"Dados e transparência","Visão geral do Ement com valores empenhados, liquidados e pagos, evolução por ano e principais áreas de destinação.",[238,239,240,241],"CGU · Dados abertos em CSV","Python · PostgreSQL","FastAPI · Consultas e agregações","Nuxt · Vue · D3","Do panorama nacional a cada emenda","Telas reais da aplicação com dados do Portal da Transparência: comparação entre estados, consulta de registros e contexto para interpretar os valores.",[245,251,256,262,268],{"src":246,"title":247,"description":248,"alt":249,"width":22,"height":250},"\u002Fimages\u002Fement\u002Fmap.webp","Distribuição pelo Brasil","Mapa das 27 unidades federativas com valores empenhados em 2025, ranking dos estados e seleção de UF para refinar a consulta.","Mapa do Brasil no Ement com distribuição do valor empenhado e ranking dos estados.",1128,{"src":252,"title":253,"description":254,"alt":255,"width":22,"height":250},"\u002Fimages\u002Fement\u002Fmap-per-capita.webp","Recursos por habitante","Comparação do valor empenhado pela população de referência do Censo 2022. O indicador e o ranking mudam juntos.","Mapa e ranking de emendas por habitante, com referência populacional do IBGE.",{"src":257,"title":258,"description":259,"alt":260,"width":22,"height":261},"\u002Fimages\u002Fement\u002Frecords.webp","Consulta e exportação","Filtros combinados de ano, estado e área, ordenação e paginação. O CSV inclui todos os registros encontrados no recorte.","Tabela de emendas de 2024 para saúde em São Paulo, com autor, destino, valores e exportação CSV.",1331,{"src":263,"title":264,"description":265,"alt":266,"width":22,"height":267},"\u002Fimages\u002Fement\u002Frecord-detail.webp","Detalhamento da emenda","Autor, localidade, programa e ação orçamentária reunidos com a execução financeira e os restos a pagar.","Diálogo de detalhes de uma emenda, mostrando destinação e valores empenhados, liquidados, pagos e de restos a pagar.",1100,{"src":269,"title":270,"description":271,"alt":272,"width":22,"height":273},"\u002Fimages\u002Fement\u002Fsources.webp","Fontes e critérios","Cobertura da base, definição dos indicadores e links para os dados oficiais da CGU e do IBGE.","Página Sobre os dados com a fonte, cobertura de 86.871 registros e critérios de interpretação.",1213,{"type":62,"children":275,"toc":443},[276,282,287,292,298,303,308,314,330,335,341,404,410,429,434,438],{"type":65,"tag":66,"props":277,"children":279},{"id":278},"entender-a-destinação-dos-recursos",[280],{"type":71,"value":281},"Entender a destinação dos recursos",{"type":65,"tag":74,"props":283,"children":284},{},[285],{"type":71,"value":286},"Consultar uma emenda na base pública é diferente de entender como os recursos se distribuem pelo país. Para comparar estados ou investigar uma área como saúde, é preciso filtrar milhares de registros, somar valores e distinguir o que foi empenhado, liquidado e pago.",{"type":65,"tag":74,"props":288,"children":289},{},[290],{"type":71,"value":291},"Desenvolvi o Ement para reunir essas consultas em uma aplicação: partir de uma visão nacional, escolher um recorte e chegar aos detalhes de cada destinação sem perder os filtros usados na análise.",{"type":65,"tag":66,"props":293,"children":295},{"id":294},"da-importação-à-consulta",[296],{"type":71,"value":297},"Da importação à consulta",{"type":65,"tag":74,"props":299,"children":300},{},[301],{"type":71,"value":302},"Meu trabalho abrange a importação da base, as consultas e agregações na API e a interface de exploração. A visão geral mostra os valores empenhados, liquidados e pagos, a distribuição por ano de proposição e as principais áreas e unidades federativas de aplicação.",{"type":65,"tag":74,"props":304,"children":305},{},[306],{"type":71,"value":307},"No mapa, é possível comparar os estados por valor empenhado, pago ou empenhado por habitante. A consulta de registros combina ano, estado, área e busca por texto, com ordenação e paginação. Cada registro reúne autor, localidade, programa, ação orçamentária e valores detalhados. Os filtros ficam na URL, preservando o recorte ao navegar entre as telas.",{"type":65,"tag":66,"props":309,"children":311},{"id":310},"arquitetura",[312],{"type":71,"value":313},"Arquitetura",{"type":65,"tag":74,"props":315,"children":316},{},[317,319,328],{"type":71,"value":318},"A base de emendas do ",{"type":65,"tag":320,"props":321,"children":325},"a",{"href":322,"rel":323},"https:\u002F\u002Fportaldatransparencia.gov.br\u002Fdownload-de-dados\u002Femendas-parlamentares",[324],"nofollow",[326],{"type":71,"value":327},"Portal da Transparência",{"type":71,"value":329}," é importada por scripts Python para PostgreSQL. Uma API FastAPI consulta os registros e calcula as agregações no servidor, usando asyncpg.",{"type":65,"tag":74,"props":331,"children":332},{},[333],{"type":71,"value":334},"O frontend usa Nuxt, Vue e TypeScript. Os componentes organizam filtros, indicadores, gráficos e detalhes. O D3 desenha o mapa a partir de um arquivo geográfico local com os 26 estados e o Distrito Federal. O cálculo por habitante usa a população do Censo 2022 do IBGE.",{"type":65,"tag":66,"props":336,"children":338},{"id":337},"decisões-para-consultar-e-interpretar-os-dados",[339],{"type":71,"value":340},"Decisões para consultar e interpretar os dados",{"type":65,"tag":123,"props":342,"children":343},{},[344,354,364,374,384,394],{"type":65,"tag":127,"props":345,"children":346},{},[347,352],{"type":65,"tag":131,"props":348,"children":349},{},[350],{"type":71,"value":351},"O mesmo recorte em cada visualização:",{"type":71,"value":353}," indicadores, mapa, lista e CSV usam os mesmos parâmetros. A exportação inclui todos os registros encontrados, não apenas a página visível.",{"type":65,"tag":127,"props":355,"children":356},{},[357,362],{"type":65,"tag":131,"props":358,"children":359},{},[360],{"type":71,"value":361},"Entrada do usuário nas consultas:",{"type":71,"value":363}," os valores são enviados como parâmetros SQL, e a ordenação aceita opções predefinidas. Assim, filtros e escolha de ordenação não são inseridos livremente no texto da consulta.",{"type":65,"tag":127,"props":365,"children":366},{},[367,372],{"type":65,"tag":131,"props":368,"children":369},{},[370],{"type":71,"value":371},"Leitura dos resultados:",{"type":71,"value":373}," totais e agrupamentos são consultados em uma mesma transação. A exportação percorre os resultados em lotes, sem carregar todo o CSV na memória de uma vez.",{"type":65,"tag":127,"props":375,"children":376},{},[377,382],{"type":65,"tag":131,"props":378,"children":379},{},[380],{"type":71,"value":381},"Etapas do gasto separadas:",{"type":71,"value":383}," empenhado, liquidado e pago têm indicadores próprios. Os pagamentos de restos a pagar também são identificados, preservando a distinção entre as etapas e os compromissos de exercícios anteriores.",{"type":65,"tag":127,"props":385,"children":386},{},[387,392],{"type":65,"tag":131,"props":388,"children":389},{},[390],{"type":71,"value":391},"Limites da comparação geográfica:",{"type":71,"value":393}," registros sem UF permanecem nos totais, mas não são atribuídos a um estado. O indicador por habitante informa o ano da população usada, para explicitar a referência da comparação.",{"type":65,"tag":127,"props":395,"children":396},{},[397,402],{"type":65,"tag":131,"props":398,"children":399},{},[400],{"type":71,"value":401},"Consulta por teclado e no celular:",{"type":71,"value":403}," o layout é responsivo; o mapa permite seleção por teclado e o diálogo de detalhes tem navegação por foco.",{"type":65,"tag":66,"props":405,"children":407},{"id":406},"escopo-e-validação",[408],{"type":71,"value":409},"Escopo e validação",{"type":65,"tag":74,"props":411,"children":412},{},[413,415,420,422,427],{"type":71,"value":414},"A base apresentada contém ",{"type":65,"tag":131,"props":416,"children":417},{},[418],{"type":71,"value":419},"86.871 registros",{"type":71,"value":421},", com anos de proposição de ",{"type":65,"tag":131,"props":423,"children":424},{},[425],{"type":71,"value":426},"2014 a 2025",{"type":71,"value":428},". Na aplicação, é possível comparar a distribuição dos recursos, consultar uma destinação e exportar o recorte escolhido.",{"type":65,"tag":74,"props":430,"children":431},{},[432],{"type":71,"value":433},"A validação compara os totais da API com o CSV de origem, centavo a centavo, e verifica filtros combinados, paginação, exportação e tratamento de consultas inválidas. A página de fontes explica a cobertura e o significado dos indicadores, com links para conferência. As capturas mostram a aplicação em execução com essa base.",{"type":65,"tag":66,"props":435,"children":436},{"id":200},[437],{"type":71,"value":203},{"type":65,"tag":74,"props":439,"children":440},{},[441],{"type":71,"value":442},"Python · FastAPI · asyncpg · PostgreSQL · Piccolo · Nuxt · Vue · TypeScript · Nuxt UI · D3",{"title":8,"searchDepth":210,"depth":210,"links":444},[445,446,447,448,449,450],{"id":278,"depth":210,"text":281},{"id":294,"depth":210,"text":297},{"id":310,"depth":210,"text":313},{"id":337,"depth":210,"text":340},{"id":406,"depth":210,"text":409},{"id":200,"depth":210,"text":203},"content:projects:pt:govt-analyser.md","projects\u002Fpt\u002Fgovt-analyser.md","projects\u002Fpt\u002Fgovt-analyser",{"_path":455,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":456,"description":457,"slug":458,"year":8,"role":459,"featured":13,"order":460,"technologies":461,"category":467,"placeholder":7,"retrospective":13,"status":468,"architecture":469,"diagram":474,"body":489,"_type":218,"_id":576,"_source":220,"_file":577,"_stem":578,"_extension":223},"\u002Fprojects\u002Fpt\u002Fresy-booking","Reservas no Resy","Aplicação para acompanhar a disponibilidade em restaurantes de Nova York e fazer uma reserva dentro das preferências do cliente.","resy-booking","Desenvolvimento full stack e deploy",3,[462,463,464,465,466],"Python","React","Selenium","Nginx","VPS","Aplicação web e automação","Encerrado após mudança na plataforma",[470,471,472,473],"Preferências · React","Backend · Python","Navegador · Selenium","Reservas · Resy",{"title":475,"steps":476},"Da preferência à reserva",[477,480,483,486],{"title":478,"description":479},"Preferências","Restaurante, pessoas, datas e horários.",{"title":481,"description":482},"Monitoramento","Consulta contínua da página de reservas.",{"title":484,"description":485},"Disponibilidade","Uma mesa dentro dos intervalos escolhidos.",{"title":487,"description":488},"Reserva","Conclusão pelo navegador autenticado.",{"type":62,"children":490,"toc":569},[491,497,502,507,513,518,523,529,534,539,544,550,555,560,564],{"type":65,"tag":66,"props":492,"children":494},{"id":493},"uma-mesa-antes-que-o-horário-se-esgotasse",[495],{"type":71,"value":496},"Uma mesa antes que o horário se esgotasse",{"type":65,"tag":74,"props":498,"children":499},{},[500],{"type":71,"value":501},"O cliente morava em Nova York e queria reservar mesas em restaurantes muito concorridos. Os horários eram preenchidos assim que ficavam disponíveis, e acompanhar as páginas manualmente exigia estar atento no momento certo.",{"type":65,"tag":74,"props":503,"children":504},{},[505],{"type":71,"value":506},"Desenvolvi uma aplicação em que ele informava o restaurante, a quantidade de pessoas e os intervalos de datas e horários que aceitava. A partir dessas preferências, o sistema acompanhava a disponibilidade no Resy e fazia a reserva quando encontrava uma opção compatível.",{"type":65,"tag":66,"props":508,"children":510},{"id":509},"da-interface-ao-servidor",[511],{"type":71,"value":512},"Da interface ao servidor",{"type":65,"tag":74,"props":514,"children":515},{},[516],{"type":71,"value":517},"Fiz o frontend em React, o backend em Python e a automação do navegador com Selenium. Também cuidei do deploy em uma VPS e configurei o Nginx como proxy reverso para a aplicação.",{"type":65,"tag":74,"props":519,"children":520},{},[521],{"type":71,"value":522},"O monitoramento rodava no servidor. A interface reunia as preferências do cliente, enquanto o backend coordenava a consulta à página e as etapas necessárias para concluir a reserva.",{"type":65,"tag":66,"props":524,"children":526},{"id":525},"sessão-e-execução-do-navegador",[527],{"type":71,"value":528},"Sessão e execução do navegador",{"type":65,"tag":74,"props":530,"children":531},{},[532],{"type":71,"value":533},"Manter a sessão autenticada foi uma das partes mais trabalhosas. A automação precisava acessar a conta do cliente para concluir a operação, e usei cookies de sessão para preservar esse acesso entre as interações. Os elementos da página eram localizados com seletores XPath no Selenium.",{"type":65,"tag":74,"props":535,"children":536},{},[537],{"type":71,"value":538},"Outro problema apareceu na VPS: naquele ambiente, o site não carregava corretamente quando o navegador rodava sem interface gráfica. Configurei uma tela virtual no servidor para executar o navegador com interface, mesmo sem um monitor físico conectado.",{"type":65,"tag":74,"props":540,"children":541},{},[542],{"type":71,"value":543},"Esses ajustes faziam parte da operação da aplicação. Além de encontrar uma mesa, o sistema precisava manter um navegador capaz de percorrer o fluxo de reserva.",{"type":65,"tag":66,"props":545,"children":547},{"id":546},"uso-e-encerramento",[548],{"type":71,"value":549},"Uso e encerramento",{"type":65,"tag":74,"props":551,"children":552},{},[553],{"type":71,"value":554},"O cliente utilizou o bot pelo menos uma vez por semana durante boa parte de um ano.",{"type":65,"tag":74,"props":556,"children":557},{},[558],{"type":71,"value":559},"Depois de uma mudança na interface do Resy, a automação precisou de atualização. O cliente preferiu encerrar o uso. Como a integração dependia dos elementos da página, mudanças na plataforma exigiam revisar os seletores e o fluxo de navegação.",{"type":65,"tag":66,"props":561,"children":562},{"id":200},[563],{"type":71,"value":203},{"type":65,"tag":74,"props":565,"children":566},{},[567],{"type":71,"value":568},"Python · React · Selenium · Nginx · VPS",{"title":8,"searchDepth":210,"depth":210,"links":570},[571,572,573,574,575],{"id":493,"depth":210,"text":496},{"id":509,"depth":210,"text":512},{"id":525,"depth":210,"text":528},{"id":546,"depth":210,"text":549},{"id":200,"depth":210,"text":203},"content:projects:pt:resy-booking.md","projects\u002Fpt\u002Fresy-booking.md","projects\u002Fpt\u002Fresy-booking",{"_path":580,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":581,"description":582,"slug":583,"year":8,"role":584,"featured":7,"order":585,"technologies":586,"category":590,"placeholder":7,"retrospective":13,"architecture":591,"diagram":596,"body":611,"_type":218,"_id":698,"_source":220,"_file":699,"_stem":700,"_extension":223},"\u002Fprojects\u002Fpt\u002Fsoundcloud-prospecting","Prospecção musical no SoundCloud","Automação para encontrar artistas a partir de músicas recentes, organizar os perfis e oferecer serviços de um produtor musical por mensagem.","soundcloud-prospecting","Desenvolvimento da automação",4,[462,18,587,588,589],"Playwright","Beautiful Soup","Agendador do Windows","Coleta de dados e automação",[592,593,594,595],"Busca por gênero · SoundCloud","Coleta e seleção · Python","Perfis e contatos · PostgreSQL","Envio de mensagens · Playwright",{"title":597,"steps":598},"Da música publicada ao contato",[599,602,605,608],{"title":600,"description":601},"Descoberta","Músicas recentes nos gêneros do produtor.",{"title":603,"description":604},"Seleção","Consulta ao perfil e às reproduções.",{"title":606,"description":607},"Cadastro","Identificador e estado do contato no banco.",{"title":609,"description":610},"Mensagem","Template com o artista e a música encontrada.",{"type":62,"children":612,"toc":691},[613,619,624,629,635,640,645,650,656,661,666,672,677,682,686],{"type":65,"tag":66,"props":614,"children":616},{"id":615},"encontrar-artistas-com-quem-trabalhar",[617],{"type":71,"value":618},"Encontrar artistas com quem trabalhar",{"type":65,"tag":74,"props":620,"children":621},{},[622],{"type":71,"value":623},"Um produtor musical precisava encontrar artistas iniciantes nos gêneros em que oferecia seus serviços. A pesquisa envolvia acompanhar lançamentos, visitar perfis e entrar em contato para apresentar uma proposta de produção com um teste gratuito.",{"type":65,"tag":74,"props":625,"children":626},{},[627],{"type":71,"value":628},"Desenvolvi uma automação em Python para fazer essa busca, organizar os perfis encontrados e enviar mensagens pela conta do produtor. O sistema rodava na máquina local do cliente, conforme ele havia solicitado.",{"type":65,"tag":66,"props":630,"children":632},{"id":631},"busca-e-contato-em-processos-separados",[633],{"type":71,"value":634},"Busca e contato em processos separados",{"type":65,"tag":74,"props":636,"children":637},{},[638],{"type":71,"value":639},"A cada 30 minutos, um script buscava as músicas mais recentes dos gêneros selecionados no SoundCloud. Em seguida, visitava o perfil de cada artista e usava o número de reproduções como critério para selecionar quem estava no início da carreira.",{"type":65,"tag":74,"props":641,"children":642},{},[643],{"type":71,"value":644},"Os perfis eram armazenados em PostgreSQL. Antes de cadastrar um artista, o script consultava seu identificador no banco para evitar registros repetidos. Uma flag indicava se o perfil já havia sido contatado.",{"type":65,"tag":74,"props":646,"children":647},{},[648],{"type":71,"value":649},"Outro script consultava os perfis ainda não contatados e enviava as mensagens. Um dos templates era sorteado e preenchido com o nome usado pelo artista no SoundCloud e a música que havia levado à descoberta do perfil. A mensagem oferecia o serviço de produção e um teste gratuito. O envio seguia intervalos variáveis e um limite diário de mensagens.",{"type":65,"tag":66,"props":651,"children":653},{"id":652},"integração-com-a-plataforma",[654],{"type":71,"value":655},"Integração com a plataforma",{"type":65,"tag":74,"props":657,"children":658},{},[659],{"type":71,"value":660},"O maior desafio foi fazer a automação navegar pelo SoundCloud e interagir com a conta autenticada do produtor. Usei Playwright, tokens de sessão e Beautiful Soup para a navegação e a leitura das informações das páginas.",{"type":65,"tag":74,"props":662,"children":663},{},[664],{"type":71,"value":665},"O Agendador de Tarefas do Windows executava as rotinas na máquina do cliente. A separação dos scripts permitia que a busca por músicas e o contato com artistas seguissem ritmos diferentes, compartilhando os registros no PostgreSQL.",{"type":65,"tag":66,"props":667,"children":669},{"id":668},"uso-pelo-produtor",[670],{"type":71,"value":671},"Uso pelo produtor",{"type":65,"tag":74,"props":673,"children":674},{},[675],{"type":71,"value":676},"O produtor utilizou a ferramenta por um período prolongado. Pelo que acompanhei, foram encontrados pelo menos 10 mil perfis e enviadas milhares de mensagens. Não tenho mais os registros de execução para conferir esses números, nem dados sobre quantos contatos se tornaram clientes.",{"type":65,"tag":74,"props":678,"children":679},{},[680],{"type":71,"value":681},"O resultado que posso descrever é a automação da pesquisa e do contato, com uma base de perfis que permitia acompanhar quem já havia recebido uma mensagem.",{"type":65,"tag":66,"props":683,"children":684},{"id":200},[685],{"type":71,"value":203},{"type":65,"tag":74,"props":687,"children":688},{},[689],{"type":71,"value":690},"Python · PostgreSQL · Playwright · Beautiful Soup · Agendador de Tarefas do Windows",{"title":8,"searchDepth":210,"depth":210,"links":692},[693,694,695,696,697],{"id":615,"depth":210,"text":618},{"id":631,"depth":210,"text":634},{"id":652,"depth":210,"text":655},{"id":668,"depth":210,"text":671},{"id":200,"depth":210,"text":203},"content:projects:pt:soundcloud-prospecting.md","projects\u002Fpt\u002Fsoundcloud-prospecting.md","projects\u002Fpt\u002Fsoundcloud-prospecting",{"_path":702,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":703,"description":704,"slug":705,"year":8,"role":706,"featured":7,"order":707,"technologies":708,"category":711,"placeholder":7,"retrospective":13,"architecture":712,"diagram":717,"body":732,"_type":218,"_id":807,"_source":220,"_file":808,"_stem":809,"_extension":223},"\u002Fprojects\u002Fpt\u002Finvestment-tax-api","API de apoio ao cálculo tributário","API em Python que recebia operações da bolsa americana em XLSX e retornava cálculos por ação e um total consolidado para um cliente ucraniano.","investment-tax-api","Desenvolvimento da API e processamento dos dados",5,[462,709,710],"pandas","NumPy","API e processamento de dados",[713,714,715,716],"Planilha · XLSX","Leitura e organização · pandas","Pareamento de operações · FIFO","Resposta consolidada · JSON",{"title":718,"steps":719},"Da planilha ao resultado por ação",[720,723,726,729],{"title":721,"description":722},"Planilha","Operações em inglês ou ucraniano.",{"title":724,"description":725},"Organização","Compras e vendas agrupadas por ação.",{"title":727,"description":728},"Cálculo","Pareamento pelas compras mais antigas.",{"title":730,"description":731},"Resposta","Valores por ação e total em JSON.",{"type":62,"children":733,"toc":801},[734,740,745,750,756,761,766,771,777,782,787,792,796],{"type":65,"tag":66,"props":735,"children":737},{"id":736},"reunir-as-operações-de-um-período",[738],{"type":71,"value":739},"Reunir as operações de um período",{"type":65,"tag":74,"props":741,"children":742},{},[743],{"type":71,"value":744},"Um cliente ucraniano operava na bolsa americana, principalmente com swing trade, e precisava calcular os valores relacionados aos impostos de suas operações. As informações chegavam em uma planilha XLSX, geralmente com os movimentos de um ano.",{"type":65,"tag":74,"props":746,"children":747},{},[748],{"type":71,"value":749},"Desenvolvi toda a API em Python. Ela recebia o arquivo, organizava as operações e devolvia um JSON com os valores por ação e o total consolidado. Usei pandas e NumPy na leitura, no processamento e nos cálculos.",{"type":65,"tag":66,"props":751,"children":753},{"id":752},"compras-e-vendas-da-mesma-ação",[754],{"type":71,"value":755},"Compras e vendas da mesma ação",{"type":65,"tag":74,"props":757,"children":758},{},[759],{"type":71,"value":760},"O principal desafio estava no histórico de cada ativo. Uma compra podia ser vendida em várias partes, e outras compras e vendas da mesma ação podiam acontecer ao longo do período.",{"type":65,"tag":74,"props":762,"children":763},{},[764],{"type":71,"value":765},"Organizei o pareamento em uma fila: conforme as vendas eram processadas, elas consumiam as compras mais antigas disponíveis no arquivo. Esse critério, conhecido como FIFO, permitia acompanhar as quantidades associadas a cada operação.",{"type":65,"tag":74,"props":767,"children":768},{},[769],{"type":71,"value":770},"Outro cuidado era a leitura das planilhas. O cliente precisava enviar documentos em inglês e em ucraniano, então o processamento reconhecia as informações nos dois formatos de idioma.",{"type":65,"tag":66,"props":772,"children":774},{"id":773},"entrega-e-alcance-deste-relato",[775],{"type":71,"value":776},"Entrega e alcance deste relato",{"type":65,"tag":74,"props":778,"children":779},{},[780],{"type":71,"value":781},"O cliente utilizou a API e confirmou seu funcionamento. A entrega automatizou a leitura da planilha e a consolidação dos cálculos em uma resposta que podia ser consumida por outro sistema.",{"type":65,"tag":74,"props":783,"children":784},{},[785],{"type":71,"value":786},"Minha estimativa é que a automação tenha poupado cerca de um mês de trabalho manual por ano. Esse valor é uma estimativa retrospectiva, sem medição de horas ou confirmação do cliente.",{"type":65,"tag":74,"props":788,"children":789},{},[790],{"type":71,"value":791},"A validação que recebi foi o retorno do cliente após o uso. Este relato não inclui uma revisão tributária independente.",{"type":65,"tag":66,"props":793,"children":794},{"id":200},[795],{"type":71,"value":203},{"type":65,"tag":74,"props":797,"children":798},{},[799],{"type":71,"value":800},"Python · pandas · NumPy",{"title":8,"searchDepth":210,"depth":210,"links":802},[803,804,805,806],{"id":736,"depth":210,"text":739},{"id":752,"depth":210,"text":755},{"id":773,"depth":210,"text":776},{"id":200,"depth":210,"text":203},"content:projects:pt:investment-tax-api.md","projects\u002Fpt\u002Finvestment-tax-api.md","projects\u002Fpt\u002Finvestment-tax-api",1794934301462]