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