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