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