[{"data":1,"prerenderedAt":888},["ShallowReactive",2],{"project-pt-resy-booking":3,"project-nav-pt":143},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"slug":10,"year":7,"role":11,"featured":12,"order":13,"technologies":14,"category":20,"placeholder":6,"retrospective":12,"status":21,"architecture":22,"diagram":27,"body":42,"_type":137,"_id":138,"_source":139,"_file":140,"_stem":141,"_extension":142},"\u002Fprojects\u002Fpt\u002Fresy-booking","pt",false,"","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",true,3,[15,16,17,18,19],"Python","React","Selenium","Nginx","VPS","Aplicação web e automação","Encerrado após mudança na plataforma",[23,24,25,26],"Preferências · React","Backend · Python","Navegador · Selenium","Reservas · Resy",{"title":28,"steps":29},"Da preferência à reserva",[30,33,36,39],{"title":31,"description":32},"Preferências","Restaurante, pessoas, datas e horários.",{"title":34,"description":35},"Monitoramento","Consulta contínua da página de reservas.",{"title":37,"description":38},"Disponibilidade","Uma mesa dentro dos intervalos escolhidos.",{"title":40,"description":41},"Reserva","Conclusão pelo navegador autenticado.",{"type":43,"children":44,"toc":129},"root",[45,54,60,65,71,76,81,87,92,97,102,108,113,118,124],{"type":46,"tag":47,"props":48,"children":50},"element","h2",{"id":49},"uma-mesa-antes-que-o-horário-se-esgotasse",[51],{"type":52,"value":53},"text","Uma mesa antes que o horário se esgotasse",{"type":46,"tag":55,"props":56,"children":57},"p",{},[58],{"type":52,"value":59},"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":46,"tag":55,"props":61,"children":62},{},[63],{"type":52,"value":64},"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":46,"tag":47,"props":66,"children":68},{"id":67},"da-interface-ao-servidor",[69],{"type":52,"value":70},"Da interface ao servidor",{"type":46,"tag":55,"props":72,"children":73},{},[74],{"type":52,"value":75},"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":46,"tag":55,"props":77,"children":78},{},[79],{"type":52,"value":80},"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":46,"tag":47,"props":82,"children":84},{"id":83},"sessão-e-execução-do-navegador",[85],{"type":52,"value":86},"Sessão e execução do navegador",{"type":46,"tag":55,"props":88,"children":89},{},[90],{"type":52,"value":91},"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":46,"tag":55,"props":93,"children":94},{},[95],{"type":52,"value":96},"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":46,"tag":55,"props":98,"children":99},{},[100],{"type":52,"value":101},"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":46,"tag":47,"props":103,"children":105},{"id":104},"uso-e-encerramento",[106],{"type":52,"value":107},"Uso e encerramento",{"type":46,"tag":55,"props":109,"children":110},{},[111],{"type":52,"value":112},"O cliente utilizou o bot pelo menos uma vez por semana durante boa parte de um ano.",{"type":46,"tag":55,"props":114,"children":115},{},[116],{"type":52,"value":117},"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":46,"tag":47,"props":119,"children":121},{"id":120},"tecnologias",[122],{"type":52,"value":123},"Tecnologias",{"type":46,"tag":55,"props":125,"children":126},{},[127],{"type":52,"value":128},"Python · React · Selenium · Nginx · VPS",{"title":7,"searchDepth":130,"depth":130,"links":131},2,[132,133,134,135,136],{"id":49,"depth":130,"text":53},{"id":67,"depth":130,"text":70},{"id":83,"depth":130,"text":86},{"id":104,"depth":130,"text":107},{"id":120,"depth":130,"text":123},"markdown","content:projects:pt:resy-booking.md","content","projects\u002Fpt\u002Fresy-booking.md","projects\u002Fpt\u002Fresy-booking","md",[144,349,579,657,779],{"_path":145,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":146,"description":147,"slug":148,"year":7,"role":149,"featured":12,"order":150,"technologies":151,"github":7,"demo":7,"cover":156,"coverAlt":157,"coverWidth":158,"coverHeight":159,"category":160,"placeholder":6,"architecture":161,"screenshots":166,"body":197,"_type":137,"_id":346,"_source":139,"_file":347,"_stem":348,"_extension":142},"\u002Fprojects\u002Fpt\u002Ffinance-platform","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",1,[152,153,154,155],"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",[162,163,164,165],"Nuxt · Vue · TypeScript","FastAPI · Serviços de aplicação","Domínio · Regras financeiras","SQLAlchemy · PostgreSQL",[167,172,177,182,187,192],{"src":168,"title":169,"description":170,"alt":171,"width":158,"height":159},"\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":173,"title":174,"description":175,"alt":176,"width":158,"height":159},"\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":178,"title":179,"description":180,"alt":181,"width":158,"height":159},"\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":183,"title":184,"description":185,"alt":186,"width":158,"height":159},"\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":188,"title":189,"description":190,"alt":191,"width":158,"height":159},"\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":193,"title":194,"description":195,"alt":196,"width":158,"height":159},"\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":43,"children":198,"toc":338},[199,205,210,216,221,226,231,237,242,247,253,308,314,319,324,329,333],{"type":46,"tag":47,"props":200,"children":202},{"id":201},"duas-rotinas-na-mesma-aplicação",[203],{"type":52,"value":204},"Duas rotinas na mesma aplicação",{"type":46,"tag":55,"props":206,"children":207},{},[208],{"type":52,"value":209},"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":46,"tag":47,"props":211,"children":213},{"id":212},"o-que-desenvolvi",[214],{"type":52,"value":215},"O que desenvolvi",{"type":46,"tag":55,"props":217,"children":218},{},[219],{"type":52,"value":220},"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":46,"tag":55,"props":222,"children":223},{},[224],{"type":52,"value":225},"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":46,"tag":55,"props":227,"children":228},{},[229],{"type":52,"value":230},"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":46,"tag":47,"props":232,"children":234},{"id":233},"organização-da-aplicação",[235],{"type":52,"value":236},"Organização da aplicação",{"type":46,"tag":55,"props":238,"children":239},{},[240],{"type":52,"value":241},"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":46,"tag":55,"props":243,"children":244},{},[245],{"type":52,"value":246},"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":46,"tag":47,"props":248,"children":250},{"id":249},"decisões-técnicas",[251],{"type":52,"value":252},"Decisões técnicas",{"type":46,"tag":254,"props":255,"children":256},"ul",{},[257,278,288,298],{"type":46,"tag":258,"props":259,"children":260},"li",{},[261,267,269,276],{"type":46,"tag":262,"props":263,"children":264},"strong",{},[265],{"type":52,"value":266},"Cálculos monetários:",{"type":52,"value":268}," uso centavos e ",{"type":46,"tag":270,"props":271,"children":273},"code",{"className":272},[],[274],{"type":52,"value":275},"Decimal",{"type":52,"value":277}," 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":46,"tag":258,"props":279,"children":280},{},[281,286],{"type":46,"tag":262,"props":282,"children":283},{},[284],{"type":52,"value":285},"Permissões na API:",{"type":52,"value":287}," 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":46,"tag":258,"props":289,"children":290},{},[291,296],{"type":46,"tag":262,"props":292,"children":293},{},[294],{"type":52,"value":295},"Confirmações de pagamento:",{"type":52,"value":297}," 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":46,"tag":258,"props":299,"children":300},{},[301,306],{"type":46,"tag":262,"props":302,"children":303},{},[304],{"type":52,"value":305},"Limites das integrações:",{"type":52,"value":307}," 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":46,"tag":47,"props":309,"children":311},{"id":310},"o-que-a-aplicação-permite-fazer",[312],{"type":52,"value":313},"O que a aplicação permite fazer",{"type":46,"tag":55,"props":315,"children":316},{},[317],{"type":52,"value":318},"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":46,"tag":55,"props":320,"children":321},{},[322],{"type":52,"value":323},"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":46,"tag":55,"props":325,"children":326},{},[327],{"type":52,"value":328},"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":46,"tag":47,"props":330,"children":331},{"id":120},[332],{"type":52,"value":123},{"type":46,"tag":55,"props":334,"children":335},{},[336],{"type":52,"value":337},"Nuxt · Vue · TypeScript · Nuxt UI · FastAPI · Python · PostgreSQL · SQLAlchemy · Alembic",{"title":7,"searchDepth":130,"depth":130,"links":339},[340,341,342,343,344,345],{"id":201,"depth":130,"text":204},{"id":212,"depth":130,"text":215},{"id":233,"depth":130,"text":236},{"id":249,"depth":130,"text":252},{"id":310,"depth":130,"text":313},{"id":120,"depth":130,"text":123},"content:projects:pt:finance-platform.md","projects\u002Fpt\u002Ffinance-platform.md","projects\u002Fpt\u002Ffinance-platform",{"_path":350,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":351,"description":352,"slug":353,"year":354,"featured":12,"order":130,"technologies":355,"github":7,"demo":7,"cover":358,"coverWidth":158,"coverHeight":359,"placeholder":6,"role":149,"category":360,"coverAlt":361,"architecture":362,"galleryTitle":367,"galleryDescription":368,"screenshots":369,"body":399,"_type":137,"_id":576,"_source":139,"_file":577,"_stem":578,"_extension":142},"\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",[152,356,153,154,357],"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.",[363,364,365,366],"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.",[370,376,381,387,393],{"src":371,"title":372,"description":373,"alt":374,"width":158,"height":375},"\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":377,"title":378,"description":379,"alt":380,"width":158,"height":375},"\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":382,"title":383,"description":384,"alt":385,"width":158,"height":386},"\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":388,"title":389,"description":390,"alt":391,"width":158,"height":392},"\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":394,"title":395,"description":396,"alt":397,"width":158,"height":398},"\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":43,"children":400,"toc":568},[401,407,412,417,423,428,433,439,455,460,466,529,535,554,559,563],{"type":46,"tag":47,"props":402,"children":404},{"id":403},"entender-a-destinação-dos-recursos",[405],{"type":52,"value":406},"Entender a destinação dos recursos",{"type":46,"tag":55,"props":408,"children":409},{},[410],{"type":52,"value":411},"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":46,"tag":55,"props":413,"children":414},{},[415],{"type":52,"value":416},"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":46,"tag":47,"props":418,"children":420},{"id":419},"da-importação-à-consulta",[421],{"type":52,"value":422},"Da importação à consulta",{"type":46,"tag":55,"props":424,"children":425},{},[426],{"type":52,"value":427},"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":46,"tag":55,"props":429,"children":430},{},[431],{"type":52,"value":432},"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":46,"tag":47,"props":434,"children":436},{"id":435},"arquitetura",[437],{"type":52,"value":438},"Arquitetura",{"type":46,"tag":55,"props":440,"children":441},{},[442,444,453],{"type":52,"value":443},"A base de emendas do ",{"type":46,"tag":445,"props":446,"children":450},"a",{"href":447,"rel":448},"https:\u002F\u002Fportaldatransparencia.gov.br\u002Fdownload-de-dados\u002Femendas-parlamentares",[449],"nofollow",[451],{"type":52,"value":452},"Portal da Transparência",{"type":52,"value":454}," é importada por scripts Python para PostgreSQL. Uma API FastAPI consulta os registros e calcula as agregações no servidor, usando asyncpg.",{"type":46,"tag":55,"props":456,"children":457},{},[458],{"type":52,"value":459},"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":46,"tag":47,"props":461,"children":463},{"id":462},"decisões-para-consultar-e-interpretar-os-dados",[464],{"type":52,"value":465},"Decisões para consultar e interpretar os dados",{"type":46,"tag":254,"props":467,"children":468},{},[469,479,489,499,509,519],{"type":46,"tag":258,"props":470,"children":471},{},[472,477],{"type":46,"tag":262,"props":473,"children":474},{},[475],{"type":52,"value":476},"O mesmo recorte em cada visualização:",{"type":52,"value":478}," 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":46,"tag":258,"props":480,"children":481},{},[482,487],{"type":46,"tag":262,"props":483,"children":484},{},[485],{"type":52,"value":486},"Entrada do usuário nas consultas:",{"type":52,"value":488}," 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":46,"tag":258,"props":490,"children":491},{},[492,497],{"type":46,"tag":262,"props":493,"children":494},{},[495],{"type":52,"value":496},"Leitura dos resultados:",{"type":52,"value":498}," 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":46,"tag":258,"props":500,"children":501},{},[502,507],{"type":46,"tag":262,"props":503,"children":504},{},[505],{"type":52,"value":506},"Etapas do gasto separadas:",{"type":52,"value":508}," 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":46,"tag":258,"props":510,"children":511},{},[512,517],{"type":46,"tag":262,"props":513,"children":514},{},[515],{"type":52,"value":516},"Limites da comparação geográfica:",{"type":52,"value":518}," 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":46,"tag":258,"props":520,"children":521},{},[522,527],{"type":46,"tag":262,"props":523,"children":524},{},[525],{"type":52,"value":526},"Consulta por teclado e no celular:",{"type":52,"value":528}," o layout é responsivo; o mapa permite seleção por teclado e o diálogo de detalhes tem navegação por foco.",{"type":46,"tag":47,"props":530,"children":532},{"id":531},"escopo-e-validação",[533],{"type":52,"value":534},"Escopo e validação",{"type":46,"tag":55,"props":536,"children":537},{},[538,540,545,547,552],{"type":52,"value":539},"A base apresentada contém ",{"type":46,"tag":262,"props":541,"children":542},{},[543],{"type":52,"value":544},"86.871 registros",{"type":52,"value":546},", com anos de proposição de ",{"type":46,"tag":262,"props":548,"children":549},{},[550],{"type":52,"value":551},"2014 a 2025",{"type":52,"value":553},". Na aplicação, é possível comparar a distribuição dos recursos, consultar uma destinação e exportar o recorte escolhido.",{"type":46,"tag":55,"props":555,"children":556},{},[557],{"type":52,"value":558},"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":46,"tag":47,"props":560,"children":561},{"id":120},[562],{"type":52,"value":123},{"type":46,"tag":55,"props":564,"children":565},{},[566],{"type":52,"value":567},"Python · FastAPI · asyncpg · PostgreSQL · Piccolo · Nuxt · Vue · TypeScript · Nuxt UI · D3",{"title":7,"searchDepth":130,"depth":130,"links":569},[570,571,572,573,574,575],{"id":403,"depth":130,"text":406},{"id":419,"depth":130,"text":422},{"id":435,"depth":130,"text":438},{"id":462,"depth":130,"text":465},{"id":531,"depth":130,"text":534},{"id":120,"depth":130,"text":123},"content:projects:pt:govt-analyser.md","projects\u002Fpt\u002Fgovt-analyser.md","projects\u002Fpt\u002Fgovt-analyser",{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"slug":10,"year":7,"role":11,"featured":12,"order":13,"technologies":580,"category":20,"placeholder":6,"retrospective":12,"status":21,"architecture":581,"diagram":582,"body":588,"_type":137,"_id":138,"_source":139,"_file":140,"_stem":141,"_extension":142},[15,16,17,18,19],[23,24,25,26],{"title":28,"steps":583},[584,585,586,587],{"title":31,"description":32},{"title":34,"description":35},{"title":37,"description":38},{"title":40,"description":41},{"type":43,"children":589,"toc":650},[590,594,598,602,606,610,614,618,622,626,630,634,638,642,646],{"type":46,"tag":47,"props":591,"children":592},{"id":49},[593],{"type":52,"value":53},{"type":46,"tag":55,"props":595,"children":596},{},[597],{"type":52,"value":59},{"type":46,"tag":55,"props":599,"children":600},{},[601],{"type":52,"value":64},{"type":46,"tag":47,"props":603,"children":604},{"id":67},[605],{"type":52,"value":70},{"type":46,"tag":55,"props":607,"children":608},{},[609],{"type":52,"value":75},{"type":46,"tag":55,"props":611,"children":612},{},[613],{"type":52,"value":80},{"type":46,"tag":47,"props":615,"children":616},{"id":83},[617],{"type":52,"value":86},{"type":46,"tag":55,"props":619,"children":620},{},[621],{"type":52,"value":91},{"type":46,"tag":55,"props":623,"children":624},{},[625],{"type":52,"value":96},{"type":46,"tag":55,"props":627,"children":628},{},[629],{"type":52,"value":101},{"type":46,"tag":47,"props":631,"children":632},{"id":104},[633],{"type":52,"value":107},{"type":46,"tag":55,"props":635,"children":636},{},[637],{"type":52,"value":112},{"type":46,"tag":55,"props":639,"children":640},{},[641],{"type":52,"value":117},{"type":46,"tag":47,"props":643,"children":644},{"id":120},[645],{"type":52,"value":123},{"type":46,"tag":55,"props":647,"children":648},{},[649],{"type":52,"value":128},{"title":7,"searchDepth":130,"depth":130,"links":651},[652,653,654,655,656],{"id":49,"depth":130,"text":53},{"id":67,"depth":130,"text":70},{"id":83,"depth":130,"text":86},{"id":104,"depth":130,"text":107},{"id":120,"depth":130,"text":123},{"_path":658,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":659,"description":660,"slug":661,"year":7,"role":662,"featured":6,"order":663,"technologies":664,"category":668,"placeholder":6,"retrospective":12,"architecture":669,"diagram":674,"body":689,"_type":137,"_id":776,"_source":139,"_file":777,"_stem":778,"_extension":142},"\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,[15,154,665,666,667],"Playwright","Beautiful Soup","Agendador do Windows","Coleta de dados e automação",[670,671,672,673],"Busca por gênero · SoundCloud","Coleta e seleção · Python","Perfis e contatos · PostgreSQL","Envio de mensagens · Playwright",{"title":675,"steps":676},"Da música publicada ao contato",[677,680,683,686],{"title":678,"description":679},"Descoberta","Músicas recentes nos gêneros do produtor.",{"title":681,"description":682},"Seleção","Consulta ao perfil e às reproduções.",{"title":684,"description":685},"Cadastro","Identificador e estado do contato no banco.",{"title":687,"description":688},"Mensagem","Template com o artista e a música encontrada.",{"type":43,"children":690,"toc":769},[691,697,702,707,713,718,723,728,734,739,744,750,755,760,764],{"type":46,"tag":47,"props":692,"children":694},{"id":693},"encontrar-artistas-com-quem-trabalhar",[695],{"type":52,"value":696},"Encontrar artistas com quem trabalhar",{"type":46,"tag":55,"props":698,"children":699},{},[700],{"type":52,"value":701},"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":46,"tag":55,"props":703,"children":704},{},[705],{"type":52,"value":706},"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":46,"tag":47,"props":708,"children":710},{"id":709},"busca-e-contato-em-processos-separados",[711],{"type":52,"value":712},"Busca e contato em processos separados",{"type":46,"tag":55,"props":714,"children":715},{},[716],{"type":52,"value":717},"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":46,"tag":55,"props":719,"children":720},{},[721],{"type":52,"value":722},"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":46,"tag":55,"props":724,"children":725},{},[726],{"type":52,"value":727},"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":46,"tag":47,"props":729,"children":731},{"id":730},"integração-com-a-plataforma",[732],{"type":52,"value":733},"Integração com a plataforma",{"type":46,"tag":55,"props":735,"children":736},{},[737],{"type":52,"value":738},"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":46,"tag":55,"props":740,"children":741},{},[742],{"type":52,"value":743},"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":46,"tag":47,"props":745,"children":747},{"id":746},"uso-pelo-produtor",[748],{"type":52,"value":749},"Uso pelo produtor",{"type":46,"tag":55,"props":751,"children":752},{},[753],{"type":52,"value":754},"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":46,"tag":55,"props":756,"children":757},{},[758],{"type":52,"value":759},"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":46,"tag":47,"props":761,"children":762},{"id":120},[763],{"type":52,"value":123},{"type":46,"tag":55,"props":765,"children":766},{},[767],{"type":52,"value":768},"Python · PostgreSQL · Playwright · Beautiful Soup · Agendador de Tarefas do Windows",{"title":7,"searchDepth":130,"depth":130,"links":770},[771,772,773,774,775],{"id":693,"depth":130,"text":696},{"id":709,"depth":130,"text":712},{"id":730,"depth":130,"text":733},{"id":746,"depth":130,"text":749},{"id":120,"depth":130,"text":123},"content:projects:pt:soundcloud-prospecting.md","projects\u002Fpt\u002Fsoundcloud-prospecting.md","projects\u002Fpt\u002Fsoundcloud-prospecting",{"_path":780,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":781,"description":782,"slug":783,"year":7,"role":784,"featured":6,"order":785,"technologies":786,"category":789,"placeholder":6,"retrospective":12,"architecture":790,"diagram":795,"body":810,"_type":137,"_id":885,"_source":139,"_file":886,"_stem":887,"_extension":142},"\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,[15,787,788],"pandas","NumPy","API e processamento de dados",[791,792,793,794],"Planilha · XLSX","Leitura e organização · pandas","Pareamento de operações · FIFO","Resposta consolidada · JSON",{"title":796,"steps":797},"Da planilha ao resultado por ação",[798,801,804,807],{"title":799,"description":800},"Planilha","Operações em inglês ou ucraniano.",{"title":802,"description":803},"Organização","Compras e vendas agrupadas por ação.",{"title":805,"description":806},"Cálculo","Pareamento pelas compras mais antigas.",{"title":808,"description":809},"Resposta","Valores por ação e total em JSON.",{"type":43,"children":811,"toc":879},[812,818,823,828,834,839,844,849,855,860,865,870,874],{"type":46,"tag":47,"props":813,"children":815},{"id":814},"reunir-as-operações-de-um-período",[816],{"type":52,"value":817},"Reunir as operações de um período",{"type":46,"tag":55,"props":819,"children":820},{},[821],{"type":52,"value":822},"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":46,"tag":55,"props":824,"children":825},{},[826],{"type":52,"value":827},"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":46,"tag":47,"props":829,"children":831},{"id":830},"compras-e-vendas-da-mesma-ação",[832],{"type":52,"value":833},"Compras e vendas da mesma ação",{"type":46,"tag":55,"props":835,"children":836},{},[837],{"type":52,"value":838},"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":46,"tag":55,"props":840,"children":841},{},[842],{"type":52,"value":843},"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":46,"tag":55,"props":845,"children":846},{},[847],{"type":52,"value":848},"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":46,"tag":47,"props":850,"children":852},{"id":851},"entrega-e-alcance-deste-relato",[853],{"type":52,"value":854},"Entrega e alcance deste relato",{"type":46,"tag":55,"props":856,"children":857},{},[858],{"type":52,"value":859},"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":46,"tag":55,"props":861,"children":862},{},[863],{"type":52,"value":864},"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":46,"tag":55,"props":866,"children":867},{},[868],{"type":52,"value":869},"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":46,"tag":47,"props":871,"children":872},{"id":120},[873],{"type":52,"value":123},{"type":46,"tag":55,"props":875,"children":876},{},[877],{"type":52,"value":878},"Python · pandas · NumPy",{"title":7,"searchDepth":130,"depth":130,"links":880},[881,882,883,884],{"id":814,"depth":130,"text":817},{"id":830,"depth":130,"text":833},{"id":851,"depth":130,"text":854},{"id":120,"depth":130,"text":123},"content:projects:pt:investment-tax-api.md","projects\u002Fpt\u002Finvestment-tax-api.md","projects\u002Fpt\u002Finvestment-tax-api",1794934302374]