{"id":616,"date":"2026-08-04T15:25:05","date_gmt":"2026-08-04T18:25:05","guid":{"rendered":"https:\/\/carloslopes.programandosolucoes.com.br\/index.php\/portfolio-migrador-email\/"},"modified":"2026-08-05T17:05:51","modified_gmt":"2026-08-05T20:05:51","slug":"portfolio-migrador-email","status":"publish","type":"page","link":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/portfolio-migrador-email\/","title":{"rendered":"Migrador de Caixa Postal IMAP para Outlook"},"content":{"rendered":"<style>\n.pf-wrap{max-width:1100px;margin:0 auto;font-size:16px;line-height:1.65}\n.pf-chamada{font-size:1.15rem;opacity:.85;margin:0 0 2rem}\n.pf-grade{display:grid;grid-template-columns:repeat(auto-fill,minmax(300px,1fr));gap:1.5rem}\n.pf-card{border:1px solid rgba(128,128,128,.3);border-radius:10px;overflow:hidden;display:flex;flex-direction:column;transition:transform .15s ease,box-shadow .15s ease}\n.pf-card:hover{transform:translateY(-3px);box-shadow:0 8px 24px rgba(0,0,0,.12)}\n.pf-card img{width:100%;height:180px;object-fit:cover;display:block;background:rgba(128,128,128,.12)}\n.pf-card-corpo{padding:1rem 1.1rem 1.2rem;display:flex;flex-direction:column;gap:.6rem;flex:1}\n.pf-card h3{margin:0;font-size:1.05rem;line-height:1.35}\n.pf-card p{margin:0;font-size:.92rem;opacity:.85;flex:1}\n.pf-chips{display:flex;flex-wrap:wrap;gap:.35rem}\n.pf-chip{font-size:.75rem;padding:.18rem .55rem;border-radius:999px;border:1px solid rgba(128,128,128,.35);opacity:.9}\n.pf-meta{font-size:.8rem;opacity:.7}\n.pf-cadeado{font-size:.8rem;opacity:.75}\n.pf-hero{margin:0 0 1.5rem}\n.pf-hero h1{margin:0 0 .4rem;line-height:1.2}\n.pf-secao{margin:2rem 0}\n.pf-secao h2{font-size:1.15rem;margin:0 0 .6rem;text-transform:uppercase;letter-spacing:.06em;opacity:.75}\n.pf-galeria{display:grid;gap:1.2rem;margin:2rem 0}\n.pf-galeria figure{margin:0}\n.pf-galeria img{width:100%;border:1px solid rgba(128,128,128,.3);border-radius:8px;display:block}\n.pf-galeria figcaption{font-size:.85rem;opacity:.75;margin-top:.4rem}\n.pf-repo{border:1px solid rgba(128,128,128,.35);border-left-width:4px;border-radius:8px;padding:1rem 1.2rem;margin:2rem 0}\n.pf-repo h2{margin:0 0 .5rem;font-size:1rem;text-transform:uppercase;letter-spacing:.06em}\n.pf-repo pre{background:rgba(128,128,128,.12);padding:.7rem .9rem;border-radius:6px;overflow-x:auto;margin:.6rem 0;font-size:.85rem}\n.pf-contato{margin:2rem 0;padding-top:1.2rem;border-top:1px solid rgba(128,128,128,.3);font-size:.95rem}\n.pf-voltar{display:inline-block;margin-bottom:1rem;font-size:.9rem}\n@media (max-width:600px){.pf-card img{height:150px}}\n<\/style>\n<div class=\"pf-wrap\">\n  <a class=\"pf-voltar\" href=\"\/index.php\/portfolio-frontend\/\">\u2190 voltar ao portf\u00f3lio<\/a><\/p>\n<header class=\"pf-hero\">\n<p class=\"pf-meta\">08\/2026 \u00b7 1 semana<\/p>\n<p>Aplicativo de mesa que migra uma conta IMAP inteira para o Outlook com backup em mbox, retom\u00e1vel, s\u00f3 com a biblioteca padr\u00e3o do Python.<\/p>\n<div class=\"pf-chips\"><span class=\"pf-chip\">Python<\/span><span class=\"pf-chip\">Tkinter<\/span><span class=\"pf-chip\">IMAP<\/span><span class=\"pf-chip\">OAuth2<\/span><span class=\"pf-chip\">mbox<\/span><span class=\"pf-chip\">Docker<\/span><span class=\"pf-chip\">Dovecot<\/span><span class=\"pf-chip\">Xvfb<\/span><span class=\"pf-chip\">unittest<\/span><\/div>\n<\/header>\n<section class=\"pf-secao\">\n<h2>O problema<\/h2>\n<p>Migrar caixa postal entre provedores \u00e9 trabalho que costuma acabar em ferramenta paga, script fr\u00e1gil de uso \u00fanico ou arrastar pasta no cliente de e-mail. Os tr\u00eas perdem o que mais importa: a data original das mensagens. Sem ela a caixa migrada aparece inteira com a data da migra\u00e7\u00e3o e a ordem cronol\u00f3gica se perde. E a Microsoft desligou autentica\u00e7\u00e3o por senha no IMAP das contas 365, o que quebra a maioria dos scripts existentes.<\/p>\n<\/section>\n<section class=\"pf-secao\">\n<h2>A arquitetura<\/h2>\n<p>Duas etapas separadas e retom\u00e1veis \u2014 do servidor de origem para mbox no disco, e do mbox para a conta de destino \u2014 com um \u00edndice JSON ao lado de cada arquivo mbox registrando onde cada mensagem est\u00e1, suas flags e a data original. \u00c9 esse \u00edndice que permite retomada exata sem varrer o arquivo inteiro e garante que rodar duas vezes n\u00e3o duplique mensagem. A autentica\u00e7\u00e3o cobre os dois mundos: OAuth2 no fluxo device code para Microsoft 365 e Outlook.com, onde a senha no IMAP foi desligada, e usu\u00e1rio e senha para Exchange local, cPanel, Dovecot e Zimbra. A restri\u00e7\u00e3o autoimposta de usar apenas a biblioteca padr\u00e3o do Python eliminou a etapa de instala\u00e7\u00e3o de depend\u00eancias para quem recebe o programa. Os m\u00f3dulos t\u00eam fronteira expl\u00edcita: o cliente IMAP n\u00e3o conhece mbox nem destino, o reposit\u00f3rio mbox n\u00e3o conhece IMAP, e a interface apenas chama os m\u00f3dulos \u2014 por isso o motor \u00e9 test\u00e1vel sem Tkinter. H\u00e1 ainda um conversor opcional de PST para mbox, que l\u00ea mas n\u00e3o escreve o formato, porque n\u00e3o existe biblioteca livre confi\u00e1vel que escreva PST em nenhuma linguagem.<\/p>\n<\/section>\n<section class=\"pf-secao\">\n<h2>O resultado<\/h2>\n<p>Aplicativo que roda no Windows e no Linux com o Python oficial, sem instalar depend\u00eancia. A su\u00edte roda contra dois servidores Dovecot reais em cont\u00eaineres, com 2.054 linhas de teste, e a interface gr\u00e1fica \u00e9 verificada de verdade em tela virtual dentro de um cont\u00eainer \u2014 janela constru\u00edda, abas percorridas, controles acionados \u2014 opcionalmente salvando um PNG de cada aba como evid\u00eancia. O que n\u00e3o \u00e9 migrado est\u00e1 dito na documenta\u00e7\u00e3o em vez de descoberto no uso: contatos e agenda n\u00e3o trafegam por IMAP e precisam ser exportados pela interface do provedor.<\/p>\n<\/section>\n<div class=\"pf-galeria\">\n<figure>\n      <img decoding=\"async\" src=\"https:\/\/carloslopes.programandosolucoes.com.br\/wp-content\/uploads\/portfolio\/migrador-email-01-etapas.png\" alt=\"As duas etapas retom\u00e1veis e o \u00edndice que impede duplicar mensagem\" loading=\"lazy\"><figcaption>As duas etapas retom\u00e1veis e o \u00edndice que impede duplicar mensagem<\/figcaption><\/figure>\n<figure>\n      <img decoding=\"async\" src=\"https:\/\/carloslopes.programandosolucoes.com.br\/wp-content\/uploads\/portfolio\/migrador-email-02-testes.png\" alt=\"A su\u00edte contra Dovecot real e a verifica\u00e7\u00e3o de interface em tela virtual\" loading=\"lazy\"><figcaption>A su\u00edte contra Dovecot real e a verifica\u00e7\u00e3o de interface em tela virtual<\/figcaption><\/figure>\n<\/p><\/div>\n<div class=\"pf-repo\">\n<h2>\ud83d\udd12 C\u00f3digo-fonte<\/h2>\n<pre><code>git clone https:\/\/git.programandosolucoes.com.br\/git\/repos\/migrador-email.git<\/code><\/pre>\n<p>C\u00f3digo-fonte privado. As credenciais de leitura s\u00e3o liberadas sob solicita\u00e7\u00e3o \u2014 me chame para conversar sobre o projeto.<\/p>\n<\/p><\/div>\n<div class=\"pf-contato\">\n    <strong>Carlos Alberto<\/strong> \u2014 carlosalberto4ti@gmail.com \u00b7 +55 11 2615-2880\n  <\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>\u2190 voltar ao portf\u00f3lio 08\/2026 \u00b7 1 semana Aplicativo de mesa que migra uma conta IMAP inteira para o Outlook com backup em mbox, retom\u00e1vel, s\u00f3 com a biblioteca padr\u00e3o do Python. PythonTkinterIMAPOAuth2mboxDockerDovecotXvfbunittest O problema Migrar caixa postal entre provedores \u00e9 trabalho que costuma acabar em ferramenta paga, script fr\u00e1gil de uso \u00fanico ou arrastar [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-616","page","type-page","status-publish","hentry"],"translation":{"provider":"WPGlobus","version":"3.0.2","language":"it","enabled_languages":["en","br","it"],"languages":{"en":{"title":true,"content":true,"excerpt":false},"br":{"title":false,"content":false,"excerpt":false},"it":{"title":false,"content":false,"excerpt":false}}},"_links":{"self":[{"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/pages\/616","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/comments?post=616"}],"version-history":[{"count":1,"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/pages\/616\/revisions"}],"predecessor-version":[{"id":628,"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/pages\/616\/revisions\/628"}],"wp:attachment":[{"href":"https:\/\/carloslopes.programandosolucoes.com.br\/it\/index.php\/wp-json\/wp\/v2\/media?parent=616"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}