{"id":1686,"date":"2026-11-16T13:09:56","date_gmt":"2026-11-16T16:09:56","guid":{"rendered":"https:\/\/micheladrianomedeiros.com.br\/blog\/?p=1686"},"modified":"2026-11-16T13:14:55","modified_gmt":"2026-11-16T16:14:55","slug":"arquitetura-full-stack-react-express-mongodb","status":"publish","type":"post","link":"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/","title":{"rendered":"Assignment Contest Tracker \u2014 Aula 1: Arquitetura e Reconhecimento do C\u00f3digo"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><strong>Arquitetura full stack React Express MongoDB<\/strong>: Quando voc\u00ea encontra uma aplica\u00e7\u00e3o completa no GitHub, por onde come\u00e7a: instala as depend\u00eancias, abre o primeiro arquivo ou tenta entender o problema que ela resolve?<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta forma\u00e7\u00e3o, vamos seguir um caminho diferente de simplesmente executar comandos. Nosso laborat\u00f3rio ser\u00e1 o projeto p\u00fablico <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\" target=\"_blank\" rel=\"noopener\">dgvijaytorg\/assignment<\/a>, denominado <strong>Assignment Contest Tracker and Solution Uploader<\/strong> e associado, no README original, ao nome <em>TLE Eliminators Assignment<\/em>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ele \u00e9 um exemplo real de aplica\u00e7\u00e3o <strong>full stack<\/strong>: tem uma interface em React, um servidor em Express, persist\u00eancia com MongoDB e integra\u00e7\u00f5es com servi\u00e7os externos. Tamb\u00e9m cont\u00e9m limita\u00e7\u00f5es t\u00e9cnicas interessantes para o aprendizado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta primeira aula, nossa tarefa \u00e9 <strong>reconhecer a arquitetura, seguir o percurso de uma requisi\u00e7\u00e3o e separar o que o c\u00f3digo realmente faz do que sua documenta\u00e7\u00e3o promete<\/strong>. N\u00e3o \u00e9 necess\u00e1rio executar o projeto.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Nota editorial:<\/strong> este \u00e9 um estudo t\u00e9cnico independente, baseado na leitura do c\u00f3digo p\u00fablico do reposit\u00f3rio. N\u00e3o \u00e9 uma publica\u00e7\u00e3o oficial dos autores nem uma certifica\u00e7\u00e3o. As an\u00e1lises de seguran\u00e7a s\u00e3o constata\u00e7\u00f5es de revis\u00e3o est\u00e1tica: n\u00e3o representam uma auditoria completa nem um teste de invas\u00e3o. Os exemplos did\u00e1ticos adicionais s\u00e3o explica\u00e7\u00f5es pr\u00f3prias.<\/p>\n<\/blockquote>\n\n\n\n<div class=\"markdown-heading\"><div id=\"ez-toc-container\" class=\"ez-toc-v2_0_90 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Arquitetura_full_stack_React_Express_MongoDB_1_O_que_vamos_aprender\" >Arquitetura full stack React Express MongoDB: 1. O que vamos aprender<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#2_Qual_problema_o_projeto_tenta_resolver\" >2. Qual problema o projeto tenta resolver?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#3_O_que_significa_ser_uma_aplicacao_full_stack\" >3. O que significa ser uma aplica\u00e7\u00e3o full stack?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#4_Desenhando_a_arquitetura_do_sistema\" >4. Desenhando a arquitetura do sistema<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#5_Explorando_a_estrutura_real_do_repositorio\" >5. Explorando a estrutura real do reposit\u00f3rio<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#6_Encontrando_o_ponto_de_entrada_do_backend\" >6. Encontrando o ponto de entrada do backend<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#7_Entendendo_a_diferenca_entre_rota_e_controlador\" >7. Entendendo a diferen\u00e7a entre rota e controlador<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#8_Acompanhando_uma_requisicao_do_inicio_ao_fim\" >8. Acompanhando uma requisi\u00e7\u00e3o do in\u00edcio ao fim<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_1_%E2%80%94_A_interface_e_renderizada\" >Passo 1 \u2014 A interface \u00e9 renderizada<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_2_%E2%80%94_O_hook_consulta_a_API\" >Passo 2 \u2014 O hook consulta a API<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_3_%E2%80%94_O_Express_localiza_a_rota\" >Passo 3 \u2014 O Express localiza a rota<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_4_%E2%80%94_O_controlador_consulta_as_fontes\" >Passo 4 \u2014 O controlador consulta as fontes<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_5_%E2%80%94_O_backend_organiza_e_responde\" >Passo 5 \u2014 O backend organiza e responde<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Passo_6_%E2%80%94_O_React_atualiza_a_tela\" >Passo 6 \u2014 O React atualiza a tela<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-15\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#9_Por_que_padronizar_os_dados_recebidos\" >9. Por que padronizar os dados recebidos?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-16\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#10_Consultando_competicoes_anteriores_e_salvando_favoritos\" >10. Consultando competi\u00e7\u00f5es anteriores e salvando favoritos<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-17\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#11_Quais_endpoints_REST_identificamos\" >11. Quais endpoints REST identificamos?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-18\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#12_Entendendo_a_automacao_com_node-cron\" >12. Entendendo a automa\u00e7\u00e3o com node-cron<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-19\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#13_Seguranca_o_que_precisa_ser_revisto_antes_de_executar\" >13. Seguran\u00e7a: o que precisa ser revisto antes de executar?<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-20\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#131_Decodificar_JWT_nao_e_validar_JWT\" >13.1 Decodificar JWT n\u00e3o \u00e9 validar JWT<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-21\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#132_Endpoint_sensivel_sem_middleware_de_autenticacao\" >13.2 Endpoint sens\u00edvel sem middleware de autentica\u00e7\u00e3o<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-22\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#133_Configuracao_previsivel_do_banco\" >13.3 Configura\u00e7\u00e3o previs\u00edvel do banco<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-23\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#134_Tratamento_de_ausencia_de_usuario\" >13.4 Tratamento de aus\u00eancia de usu\u00e1rio<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-24\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#135_Ambientes_de_desenvolvimento_e_producao_misturados\" >13.5 Ambientes de desenvolvimento e produ\u00e7\u00e3o misturados<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-25\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#136_Arquivo_compactado_desconhecido\" >13.6 Arquivo compactado desconhecido<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-26\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#14_Como_transformar_problemas_em_plano_de_melhoria\" >14. Como transformar problemas em plano de melhoria?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-27\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#15_Exercicio_pratico_investigacao_somente_pela_interface_do_GitHub\" >15. Exerc\u00edcio pr\u00e1tico: investiga\u00e7\u00e3o somente pela interface do GitHub<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-28\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Exercicio_1_%E2%80%94_Identifique_a_inicializacao_do_servidor\" >Exerc\u00edcio 1 \u2014 Identifique a inicializa\u00e7\u00e3o do servidor<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-29\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Exercicio_2_%E2%80%94_Siga_uma_rota\" >Exerc\u00edcio 2 \u2014 Siga uma rota<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-30\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Exercicio_3_%E2%80%94_Encontre_a_ordenacao\" >Exerc\u00edcio 3 \u2014 Encontre a ordena\u00e7\u00e3o<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-31\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Exercicio_4_%E2%80%94_Identifique_um_risco\" >Exerc\u00edcio 4 \u2014 Identifique um risco<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-32\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Modelo_de_registro_do_laboratorio\" >Modelo de registro do laborat\u00f3rio<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-33\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#16_Questoes_de_revisao\" >16. Quest\u00f5es de revis\u00e3o<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-34\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Gabarito_comentado\" >Gabarito comentado<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-35\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#17_Checklist_de_aprendizagem\" >17. Checklist de aprendizagem<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-36\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#18_O_que_faremos_na_Aula_2\" >18. O que faremos na Aula 2?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-37\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#19_Conclusao_compreender_antes_de_modificar\" >19. Conclus\u00e3o: compreender antes de modificar<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-38\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/arquitetura-full-stack-react-express-mongodb\/#Fontes_e_materiais_de_estudo\" >Fontes e materiais de estudo<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Arquitetura_full_stack_React_Express_MongoDB_1_O_que_vamos_aprender\"><\/span>Arquitetura full stack React Express MongoDB: 1. O que vamos aprender<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-1-o-que-vamos-aprender\" class=\"anchor\" aria-label=\"Permalink: 1. O que vamos aprender\" href=\"#1-o-que-vamos-aprender\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Ao concluir a aula, voc\u00ea dever\u00e1 conseguir:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>explicar a finalidade do Assignment Contest Tracker;<\/li>\n\n\n\n<li>distinguir <strong>frontend<\/strong>, <strong>backend<\/strong>, <strong>persist\u00eancia<\/strong> e <strong>APIs externas<\/strong>;<\/li>\n\n\n\n<li>reconhecer os pap\u00e9is de React, Vite, TypeScript, Express, Mongoose e MongoDB;<\/li>\n\n\n\n<li>navegar na estrutura de pastas do reposit\u00f3rio;<\/li>\n\n\n\n<li>identificar o arquivo de entrada do servidor e o registro das rotas;<\/li>\n\n\n\n<li>acompanhar uma chamada HTTP, da interface at\u00e9 a resposta em JSON;<\/li>\n\n\n\n<li>entender a diferen\u00e7a entre dados consultados de terceiros e dados persistidos pela aplica\u00e7\u00e3o;<\/li>\n\n\n\n<li>reconhecer problemas iniciais de autentica\u00e7\u00e3o, configura\u00e7\u00e3o e tratamento de erros;<\/li>\n\n\n\n<li>justificar por que devemos revisar o c\u00f3digo antes de executar depend\u00eancias ou arquivos desconhecidos.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pr\u00e9-requisito:<\/strong> saber navegar por arquivos e diret\u00f3rios no GitHub. Conhecimento pr\u00e9vio de JavaScript, React ou Node.js ajuda, mas n\u00e3o \u00e9 obrigat\u00f3rio para esta etapa.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"2_Qual_problema_o_projeto_tenta_resolver\"><\/span>2. Qual problema o projeto tenta resolver?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-2-qual-problema-o-projeto-tenta-resolver\" class=\"anchor\" aria-label=\"Permalink: 2. Qual problema o projeto tenta resolver?\" href=\"#2-qual-problema-o-projeto-tenta-resolver\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Imagine acompanhar competi\u00e7\u00f5es de programa\u00e7\u00e3o em tr\u00eas plataformas: <strong>Codeforces<\/strong>, <strong>CodeChef<\/strong> e <strong>LeetCode<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sem um agregador, seria necess\u00e1rio visitar sites distintos para verificar os pr\u00f3ximos eventos, consultar competi\u00e7\u00f5es encerradas e encontrar material relacionado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O Assignment Contest Tracker re\u00fane essas informa\u00e7\u00f5es em uma \u00fanica interface e oferece funcionalidades como:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>listar competi\u00e7\u00f5es futuras;<\/li>\n\n\n\n<li>consultar competi\u00e7\u00f5es anteriores;<\/li>\n\n\n\n<li>filtrar resultados pela plataforma;<\/li>\n\n\n\n<li>marcar competi\u00e7\u00f5es como favoritas (<em>bookmarks<\/em>);<\/li>\n\n\n\n<li>autenticar usu\u00e1rios por meio do Google;<\/li>\n\n\n\n<li>associar links de v\u00eddeos com solu\u00e7\u00f5es de competi\u00e7\u00f5es;<\/li>\n\n\n\n<li>executar uma rotina agendada que procura v\u00eddeos e tenta relacion\u00e1-los a eventos.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Aqui h\u00e1 uma distin\u00e7\u00e3o importante: o nome e o README falam em <em>upload<\/em> de solu\u00e7\u00f5es, mas o c\u00f3digo da rotina agendada que examinamos <strong>consulta v\u00eddeos no YouTube e armazena links no MongoDB<\/strong>. Ele n\u00e3o demonstra a publica\u00e7\u00e3o de um v\u00eddeo novo em um canal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Primeira li\u00e7\u00e3o de engenharia:<\/strong> a descri\u00e7\u00e3o de um produto \u00e9 uma hip\u00f3tese sobre seu comportamento. O c\u00f3digo, os testes e a execu\u00e7\u00e3o controlada fornecem evid\u00eancias mais concretas.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"3_O_que_significa_ser_uma_aplicacao_full_stack\"><\/span>3. O que significa ser uma aplica\u00e7\u00e3o full stack?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-3-o-que-significa-ser-uma-aplica\u00e7\u00e3o-full-stack\" class=\"anchor\" aria-label=\"Permalink: 3. O que significa ser uma aplica\u00e7\u00e3o full stack?\" href=\"#3-o-que-significa-ser-uma-aplica%C3%A7%C3%A3o-full-stack\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Uma aplica\u00e7\u00e3o full stack possui componentes que trabalham em camadas diferentes.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Parte<\/th><th>Responsabilidade<\/th><th>Tecnologias observadas<\/th><\/tr><\/thead><tbody><tr><td>Frontend<\/td><td>Mostrar telas e reagir a a\u00e7\u00f5es do usu\u00e1rio<\/td><td>React, TypeScript, Vite<\/td><\/tr><tr><td>Comunica\u00e7\u00e3o<\/td><td>Transportar solicita\u00e7\u00f5es e respostas<\/td><td>HTTP, JSON, Axios<\/td><\/tr><tr><td>Backend<\/td><td>Expor rotas e executar regras da aplica\u00e7\u00e3o<\/td><td>Node.js, Express<\/td><\/tr><tr><td>Persist\u00eancia<\/td><td>Armazenar usu\u00e1rios, favoritos e links<\/td><td>MongoDB, Mongoose<\/td><\/tr><tr><td>Integra\u00e7\u00f5es<\/td><td>Consultar dados externos<\/td><td>APIs de competi\u00e7\u00f5es e YouTube<\/td><\/tr><tr><td>Agendamento<\/td><td>Executar tarefas sem intera\u00e7\u00e3o manual<\/td><td>node-cron<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">O frontend n\u00e3o precisa conhecer os detalhes internos de todas as plataformas de competi\u00e7\u00e3o. Ele conversa com uma API pr\u00f3pria, que pode realizar consultas e devolver uma representa\u00e7\u00e3o padronizada dos resultados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Essa separa\u00e7\u00e3o reduz o acoplamento entre a interface e as diversas fontes de dados \u2014 embora n\u00e3o elimine a necessidade de tratar falhas de cada integra\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"4_Desenhando_a_arquitetura_do_sistema\"><\/span>4. Desenhando a arquitetura do sistema<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-4-desenhando-a-arquitetura-do-sistema\" class=\"anchor\" aria-label=\"Permalink: 4. Desenhando a arquitetura do sistema\" href=\"#4-desenhando-a-arquitetura-do-sistema\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Uma representa\u00e7\u00e3o simplificada do fluxo \u00e9:<\/p>\n\n\n\n<pre class=\"wp-block-code\" lang=\"text\"><code>                  USU\u00c1RIO\n                     |\n                     v\n                NAVEGADOR\n                     |\n                     v\n       FRONTEND \u2014 React + TypeScript\n          p\u00e1ginas, hooks e estado\n                     |\n             HTTP \/ JSON (Axios)\n                     |\n                     v\n         BACKEND \u2014 Node.js + Express\n          roteadores e controladores\n                 \/       \\\n                \/         \\\n               v           v\n       MongoDB\/Mongoose   APIs externas\n       usu\u00e1rios, favoritos Codeforces\n       e links de solu\u00e7\u00e3o  CodeChef\n                           LeetCode\n                           YouTube\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">H\u00e1 tamb\u00e9m um processo agendado no backend que busca v\u00eddeos e grava associa\u00e7\u00f5es no banco.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">N\u00e3o confunda os conceitos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><br><strong>React<\/strong> \u00e9 uma biblioteca de interface, n\u00e3o um banco de dados.<\/li>\n\n\n\n<li><br><strong>Express<\/strong> \u00e9 o framework HTTP que organiza o servidor, n\u00e3o a plataforma de competi\u00e7\u00f5es.<\/li>\n\n\n\n<li><br><strong>Mongoose<\/strong> \u00e9 uma biblioteca que facilita o trabalho com documentos do MongoDB.<\/li>\n\n\n\n<li><br><strong>MongoDB<\/strong> guarda documentos da aplica\u00e7\u00e3o; n\u00e3o \u00e9 a origem de todas as competi\u00e7\u00f5es exibidas.<\/li>\n\n\n\n<li><br><strong>Axios<\/strong> envia requisi\u00e7\u00f5es HTTP. Ele n\u00e3o substitui a API nem o banco.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A arquitetura acima \u00e9 uma abstra\u00e7\u00e3o did\u00e1tica das responsabilidades identificadas no c\u00f3digo, n\u00e3o um diagrama oficial do projeto.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"5_Explorando_a_estrutura_real_do_repositorio\"><\/span>5. Explorando a estrutura real do reposit\u00f3rio<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-5-explorando-a-estrutura-real-do-reposit\u00f3rio\" class=\"anchor\" aria-label=\"Permalink: 5. Explorando a estrutura real do reposit\u00f3rio\" href=\"#5-explorando-a-estrutura-real-do-reposit%C3%B3rio\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O projeto possui dois diret\u00f3rios principais e um README na raiz:<\/p>\n\n\n\n<pre class=\"wp-block-code\" lang=\"text\"><code>assignment\/\n\u251c\u2500\u2500 backend\/\n\u2502   \u251c\u2500\u2500 src\/\n\u2502   \u2502   \u251c\u2500\u2500 controllers\/\n\u2502   \u2502   \u251c\u2500\u2500 cron\/\n\u2502   \u2502   \u251c\u2500\u2500 middleware\/\n\u2502   \u2502   \u251c\u2500\u2500 models\/\n\u2502   \u2502   \u251c\u2500\u2500 routers\/\n\u2502   \u2502   \u251c\u2500\u2500 types\/\n\u2502   \u2502   \u2514\u2500\u2500 index.ts\n\u2502   \u251c\u2500\u2500 docker-compose.yml\n\u2502   \u251c\u2500\u2500 package.json\n\u2502   \u2514\u2500\u2500 tsconfig.json\n\u251c\u2500\u2500 frontend\/\n\u2502   \u251c\u2500\u2500 src\/\n\u2502   \u2502   \u251c\u2500\u2500 components\/\n\u2502   \u2502   \u251c\u2500\u2500 hooks\/\n\u2502   \u2502   \u251c\u2500\u2500 pages\/\n\u2502   \u2502   \u251c\u2500\u2500 store\/\n\u2502   \u2502   \u251c\u2500\u2500 types\/\n\u2502   \u2502   \u251c\u2500\u2500 App.tsx\n\u2502   \u2502   \u2514\u2500\u2500 main.tsx\n\u2502   \u251c\u2500\u2500 package.json\n\u2502   \u2514\u2500\u2500 vite.config.ts\n\u2514\u2500\u2500 readme.md\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Para explorar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/tree\/main\/backend\/src\" target=\"_blank\" rel=\"noopener\">C\u00f3digo do backend<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/tree\/main\/frontend\/src\" target=\"_blank\" rel=\"noopener\">C\u00f3digo do frontend<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/readme.md\" target=\"_blank\" rel=\"noopener\">README original<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Como interpretar essas pastas?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A pasta <code>routers<\/code> declara caminhos da API. A pasta <code>controllers<\/code> concentra fun\u00e7\u00f5es que atendem \u00e0s solicita\u00e7\u00f5es. Os <code>models<\/code> descrevem documentos usados com o MongoDB. Os arquivos em <code>cron<\/code> tratam tarefas agendadas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No frontend, <code>pages<\/code> re\u00fane telas; <code>components<\/code>, elementos reutiliz\u00e1veis; <code>hooks<\/code>, comportamentos reutiliz\u00e1veis do React; e <code>store<\/code>, estado compartilhado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esses nomes descrevem uma organiza\u00e7\u00e3o escolhida pelos autores. Eles n\u00e3o s\u00e3o uma regra obrigat\u00f3ria de React ou Express.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"6_Encontrando_o_ponto_de_entrada_do_backend\"><\/span>6. Encontrando o ponto de entrada do backend<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-6-encontrando-o-ponto-de-entrada-do-backend\" class=\"anchor\" aria-label=\"Permalink: 6. Encontrando o ponto de entrada do backend\" href=\"#6-encontrando-o-ponto-de-entrada-do-backend\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Abra o arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/index.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/index.ts<\/code><\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ele executa, em linhas gerais, as seguintes tarefas:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>carrega bibliotecas e vari\u00e1veis de ambiente;<\/li>\n\n\n\n<li>cria a inst\u00e2ncia do Express;<\/li>\n\n\n\n<li>habilita o processamento de JSON;<\/li>\n\n\n\n<li>configura o CORS;<\/li>\n\n\n\n<li>tenta se conectar ao MongoDB;<\/li>\n\n\n\n<li>registra as rotas de autentica\u00e7\u00e3o, competi\u00e7\u00f5es e usu\u00e1rios;<\/li>\n\n\n\n<li>inicia o servidor HTTP;<\/li>\n\n\n\n<li>inicia a rotina agendada de v\u00eddeos depois que o MongoDB se conecta.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Observe um trecho ilustrativo extra\u00eddo da l\u00f3gica do projeto:<\/p>\n\n\n\n<div class=\"highlight highlight-source-ts\"><pre><span class=\"pl-k\">const<\/span> <span class=\"pl-s1\">app<\/span> <span class=\"pl-c1\">=<\/span> <span class=\"pl-en\">express<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n<span class=\"pl-s1\">app<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">use<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s1\">express<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">json<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n<span class=\"pl-s1\">app<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">use<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-en\">cors<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n\n<span class=\"pl-s1\">app<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">use<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s\">\"\/auth\"<\/span><span class=\"pl-kos\">,<\/span> <span class=\"pl-s1\">auth_router<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n<span class=\"pl-s1\">app<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">use<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s\">\"\/contests\"<\/span><span class=\"pl-kos\">,<\/span> <span class=\"pl-s1\">contest_router<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n<span class=\"pl-s1\">app<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">use<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s\">\"\/user\"<\/span><span class=\"pl-kos\">,<\/span> <span class=\"pl-s1\">user_router<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O primeiro comando cria a aplica\u00e7\u00e3o Express. O segundo prepara o servidor para interpretar corpos JSON. O terceiro habilita o middleware CORS com a configura\u00e7\u00e3o padr\u00e3o. Os demais associam prefixos de URL a roteadores.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Assim, a rota <code>\/contests\/past_contest<\/code> combina o prefixo <code>\/contests<\/code> com o caminho declarado no roteador.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Aten\u00e7\u00e3o:<\/strong> uma configura\u00e7\u00e3o aberta de CORS n\u00e3o equivale a autentica\u00e7\u00e3o. Mesmo com pol\u00edticas de origem restritas, o backend precisa validar as permiss\u00f5es de quem chama endpoints sens\u00edveis.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Outro detalhe: o servidor chama <code>app.listen<\/code> independentemente do sucesso da conex\u00e3o ao banco. Por isso, a mensagem de que o servidor iniciou n\u00e3o comprova, sozinha, que todas as depend\u00eancias estejam funcionando.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"7_Entendendo_a_diferenca_entre_rota_e_controlador\"><\/span>7. Entendendo a diferen\u00e7a entre rota e controlador<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-7-entendendo-a-diferen\u00e7a-entre-rota-e-controlador\" class=\"anchor\" aria-label=\"Permalink: 7. Entendendo a diferen\u00e7a entre rota e controlador\" href=\"#7-entendendo-a-diferen%C3%A7a-entre-rota-e-controlador\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Vamos abrir <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/contest_router.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/routers\/contest_router.ts<\/code><\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O arquivo associa m\u00e9todos e caminhos HTTP a fun\u00e7\u00f5es que executam as opera\u00e7\u00f5es:<\/p>\n\n\n\n<div class=\"highlight highlight-source-ts\"><pre><span class=\"pl-s1\">contest_router<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">get<\/span><span class=\"pl-kos\">(<\/span>\n  <span class=\"pl-s\">\"\/upcomming_contest\"<\/span><span class=\"pl-kos\">,<\/span>\n  <span class=\"pl-s1\">contest_controllers<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">fetchUpcommingContest<\/span>\n<span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n\n<span class=\"pl-s1\">contest_router<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">get<\/span><span class=\"pl-kos\">(<\/span>\n  <span class=\"pl-s\">\"\/past_contest\"<\/span><span class=\"pl-kos\">,<\/span>\n  <span class=\"pl-s1\">contest_controllers<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">fetchPastContest<\/span>\n<span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n\n<span class=\"pl-s1\">contest_router<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">post<\/span><span class=\"pl-kos\">(<\/span>\n  <span class=\"pl-s\">\"\/upload_solution\"<\/span><span class=\"pl-kos\">,<\/span>\n  <span class=\"pl-s1\">contest_controllers<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">uploadVideoSolutionLink<\/span>\n<span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O <strong>roteador<\/strong> decide <em>qual fun\u00e7\u00e3o ser\u00e1 chamada<\/em>. O <strong>controlador<\/strong> executa o processamento da requisi\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Note que o nome <code>upcomming_contest<\/code> aparece com uma grafia incomum de <em>upcoming<\/em>. Mantemos a grafia original ao estudar o c\u00f3digo, porque alterar um caminho em apenas um lado da comunica\u00e7\u00e3o quebraria as chamadas existentes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Em uma melhoria futura, poder\u00edamos introduzir rotas padronizadas e migrar os consumidores de maneira controlada.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"8_Acompanhando_uma_requisicao_do_inicio_ao_fim\"><\/span>8. Acompanhando uma requisi\u00e7\u00e3o do in\u00edcio ao fim<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-8-acompanhando-uma-requisi\u00e7\u00e3o-do-in\u00edcio-ao-fim\" class=\"anchor\" aria-label=\"Permalink: 8. Acompanhando uma requisi\u00e7\u00e3o do in\u00edcio ao fim\" href=\"#8-acompanhando-uma-requisi%C3%A7%C3%A3o-do-in%C3%ADcio-ao-fim\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Vamos seguir a opera\u00e7\u00e3o <strong>Consultar pr\u00f3ximas competi\u00e7\u00f5es<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_1_%E2%80%94_A_interface_e_renderizada\"><\/span>Passo 1 \u2014 A interface \u00e9 renderizada<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-1--a-interface-\u00e9-renderizada\" class=\"anchor\" aria-label=\"Permalink: Passo 1 \u2014 A interface \u00e9 renderizada\" href=\"#passo-1--a-interface-%C3%A9-renderizada\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A p\u00e1gina <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/pages\/Home.tsx\" target=\"_blank\" rel=\"noopener\"><code>frontend\/src\/pages\/Home.tsx<\/code><\/a> utiliza um hook personalizado chamado <code>useUpcommingContests<\/code>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_2_%E2%80%94_O_hook_consulta_a_API\"><\/span>Passo 2 \u2014 O hook consulta a API<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-2--o-hook-consulta-a-api\" class=\"anchor\" aria-label=\"Permalink: Passo 2 \u2014 O hook consulta a API\" href=\"#passo-2--o-hook-consulta-a-api\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/hooks\/UseUpcommingContests.tsx\" target=\"_blank\" rel=\"noopener\"><code>frontend\/src\/hooks\/UseUpcommingContests.tsx<\/code><\/a>, o Axios faz uma chamada GET para a rota de competi\u00e7\u00f5es futuras:<\/p>\n\n\n\n<div class=\"highlight highlight-source-ts\"><pre><span class=\"pl-k\">const<\/span> <span class=\"pl-s1\">response<\/span> <span class=\"pl-c1\">=<\/span> <span class=\"pl-k\">await<\/span> <span class=\"pl-s1\">axios<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">get<\/span><span class=\"pl-kos\">(<\/span>\n  <span class=\"pl-s\">`<span class=\"pl-s1\"><span class=\"pl-kos\">${<\/span><span class=\"pl-k\">import<\/span><span class=\"pl-kos\">.<\/span>meta<span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">env<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">VITE_PROD_BACKEND_URL<\/span><span class=\"pl-kos\">}<\/span><\/span>\/contests\/upcomming_contest`<\/span>\n<span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span>\n\n<span class=\"pl-en\">setUpcomingContests<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s1\">response<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">data<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-c1\">upcomingContests<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O c\u00f3digo acima \u00e9 uma leitura do comportamento existente, n\u00e3o uma recomenda\u00e7\u00e3o para usar a URL de produ\u00e7\u00e3o em desenvolvimento.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_3_%E2%80%94_O_Express_localiza_a_rota\"><\/span>Passo 3 \u2014 O Express localiza a rota<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-3--o-express-localiza-a-rota\" class=\"anchor\" aria-label=\"Permalink: Passo 3 \u2014 O Express localiza a rota\" href=\"#passo-3--o-express-localiza-a-rota\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O prefixo <code>\/contests<\/code> est\u00e1 registrado em <code>index.ts<\/code>. O roteador identifica <code>\/upcomming_contest<\/code> e encaminha para <code>fetchUpcommingContest<\/code>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_4_%E2%80%94_O_controlador_consulta_as_fontes\"><\/span>Passo 4 \u2014 O controlador consulta as fontes<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-4--o-controlador-consulta-as-fontes\" class=\"anchor\" aria-label=\"Permalink: Passo 4 \u2014 O controlador consulta as fontes\" href=\"#passo-4--o-controlador-consulta-as-fontes\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/controllers\/contests.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/controllers\/contests.ts<\/code><\/a>, a fun\u00e7\u00e3o chama as plataformas externas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A implementa\u00e7\u00e3o utiliza <code>Promise.all<\/code> para iniciar as requisi\u00e7\u00f5es em conjunto. Depois, filtra e transforma os resultados de cada plataforma para uma estrutura equivalente.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_5_%E2%80%94_O_backend_organiza_e_responde\"><\/span>Passo 5 \u2014 O backend organiza e responde<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-5--o-backend-organiza-e-responde\" class=\"anchor\" aria-label=\"Permalink: Passo 5 \u2014 O backend organiza e responde\" href=\"#passo-5--o-backend-organiza-e-responde\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Os dados s\u00e3o combinados e ordenados pela data de in\u00edcio da competi\u00e7\u00e3o. A resposta HTTP inclui o campo <code>upcomingContests<\/code>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Passo_6_%E2%80%94_O_React_atualiza_a_tela\"><\/span>Passo 6 \u2014 O React atualiza a tela<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-passo-6--o-react-atualiza-a-tela\" class=\"anchor\" aria-label=\"Permalink: Passo 6 \u2014 O React atualiza a tela\" href=\"#passo-6--o-react-atualiza-a-tela\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O hook guarda o resultado no estado. A p\u00e1gina <code>Home<\/code> filtra os dados conforme as plataformas selecionadas e os apresenta em cart\u00f5es.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O percurso resumido \u00e9:<\/p>\n\n\n\n<pre class=\"wp-block-code\" lang=\"text\"><code>Home.tsx\n   |\n   v\nuseUpcommingContests()\n   |\n   v\nGET \/contests\/upcomming_contest\n   |\n   v\ncontest_router.ts\n   |\n   v\nfetchUpcommingContest()\n   |\n   v\nAPIs externas \u2192 normaliza\u00e7\u00e3o \u2192 ordena\u00e7\u00e3o\n   |\n   v\nJSON { upcomingContests: [...] }\n   |\n   v\nReact atualiza a interface\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Se voc\u00ea conseguir explicar esse caminho sem consultar o diagrama, ter\u00e1 compreendido uma parte fundamental da arquitetura.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"9_Por_que_padronizar_os_dados_recebidos\"><\/span>9. Por que padronizar os dados recebidos?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-9-por-que-padronizar-os-dados-recebidos\" class=\"anchor\" aria-label=\"Permalink: 9. Por que padronizar os dados recebidos?\" href=\"#9-por-que-padronizar-os-dados-recebidos\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">As plataformas n\u00e3o devolvem, necessariamente, os mesmos nomes de propriedades ou representa\u00e7\u00f5es de datas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O controlador resolve essa diferen\u00e7a criando objetos com campos como:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Campo<\/th><th>Significado<\/th><\/tr><\/thead><tbody><tr><td><code>id<\/code><\/td><td>Identificador da competi\u00e7\u00e3o<\/td><\/tr><tr><td><code>title<\/code><\/td><td>Nome apresentado ao usu\u00e1rio<\/td><\/tr><tr><td><code>type<\/code><\/td><td>Plataforma de origem<\/td><\/tr><tr><td><code>link<\/code><\/td><td>Endere\u00e7o da competi\u00e7\u00e3o<\/td><\/tr><tr><td><code>start_date<\/code><\/td><td>Data e hora de in\u00edcio<\/td><\/tr><tr><td><code>end_date<\/code><\/td><td>Data e hora de t\u00e9rmino<\/td><\/tr><tr><td><code>duration<\/code><\/td><td>Dura\u00e7\u00e3o<\/td><\/tr><tr><td><code>video_solution<\/code><\/td><td>Link associado, quando existir<\/td><\/tr><tr><td><code>status<\/code><\/td><td>Situa\u00e7\u00e3o do evento<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Exemplo <strong>fict\u00edcio<\/strong>, apenas para ilustrar a estrutura de um item:<\/p>\n\n\n\n<div class=\"highlight highlight-source-json\"><pre>{\n  <span class=\"pl-ent\">\"id\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>12345<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"title\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>Competi\u00e7\u00e3o de exemplo<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"type\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>Codeforces<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"link\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>https:\/\/codeforces.com\/contests\/12345<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"start_date\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>2026-11-20T14:00:00.000Z<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"end_date\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>2026-11-20T16:00:00.000Z<span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"duration\"<\/span>: <span class=\"pl-c1\">120<\/span>,\n  <span class=\"pl-ent\">\"video_solution\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span><span class=\"pl-pds\">\"<\/span><\/span>,\n  <span class=\"pl-ent\">\"status\"<\/span>: <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>upcoming<span class=\"pl-pds\">\"<\/span><\/span>\n}<\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O exemplo <strong>n\u00e3o foi retornado pela API<\/strong> e o identificador n\u00e3o representa uma competi\u00e7\u00e3o verificada.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Por que isso importa?<\/strong> Uma interface \u00fanica pode renderizar objetos de v\u00e1rias origens sem conhecer o formato de cada servi\u00e7o externo. Esse processo \u00e9 conhecido como <strong>normaliza\u00e7\u00e3o<\/strong> ou adapta\u00e7\u00e3o dos dados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uma limita\u00e7\u00e3o da implementa\u00e7\u00e3o atual \u00e9 o <code>Promise.all<\/code> conjunto: se uma das chamadas externas falhar, a opera\u00e7\u00e3o pode cair no tratamento geral de erro, mesmo que outras fontes estejam dispon\u00edveis. Em uma refatora\u00e7\u00e3o, podemos avaliar <code>Promise.allSettled<\/code>, timeouts e respostas parciais.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"10_Consultando_competicoes_anteriores_e_salvando_favoritos\"><\/span>10. Consultando competi\u00e7\u00f5es anteriores e salvando favoritos<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-10-consultando-competi\u00e7\u00f5es-anteriores-e-salvando-favoritos\" class=\"anchor\" aria-label=\"Permalink: 10. Consultando competi\u00e7\u00f5es anteriores e salvando favoritos\" href=\"#10-consultando-competi%C3%A7%C3%B5es-anteriores-e-salvando-favoritos\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O controlador <code>fetchPastContest<\/code> consulta eventos encerrados. O c\u00f3digo tamb\u00e9m procura links de solu\u00e7\u00f5es j\u00e1 armazenados no banco, associando-os \u00e0s competi\u00e7\u00f5es retornadas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Os favoritos seguem outra l\u00f3gica. O usu\u00e1rio seleciona uma competi\u00e7\u00e3o, e o backend registra essa associa\u00e7\u00e3o no MongoDB.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/controllers\/user.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/controllers\/user.ts<\/code><\/a> cont\u00e9m fun\u00e7\u00f5es para obter o perfil, adicionar uma competi\u00e7\u00e3o aos favoritos e recuperar os favoritos do usu\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Esse contraste ajuda a compreender duas categorias de dados:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><br><strong>Dados de refer\u00eancia externos:<\/strong> informa\u00e7\u00f5es de competi\u00e7\u00f5es que podem ser consultadas nas plataformas.<\/li>\n\n\n\n<li><br><strong>Dados espec\u00edficos do produto:<\/strong> perfil, sele\u00e7\u00e3o de favoritos e links de solu\u00e7\u00f5es associados \u00e0 aplica\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">A arquitetura poderia, no futuro, armazenar cache de dados externos para melhorar disponibilidade e reduzir chamadas. Isso seria uma evolu\u00e7\u00e3o; n\u00e3o devemos afirmar que j\u00e1 existe um cache completo sem encontr\u00e1-lo no c\u00f3digo.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"11_Quais_endpoints_REST_identificamos\"><\/span>11. Quais endpoints REST identificamos?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-11-quais-endpoints-rest-identificamos\" class=\"anchor\" aria-label=\"Permalink: 11. Quais endpoints REST identificamos?\" href=\"#11-quais-endpoints-rest-identificamos\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A partir dos roteadores, encontramos:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>M\u00e9todo<\/th><th>Endpoint<\/th><th>Objetivo<\/th><\/tr><\/thead><tbody><tr><td>GET<\/td><td><code>\/contests\/upcomming_contest<\/code><\/td><td>Consultar pr\u00f3ximas competi\u00e7\u00f5es<\/td><\/tr><tr><td>GET<\/td><td><code>\/contests\/past_contest<\/code><\/td><td>Consultar competi\u00e7\u00f5es passadas<\/td><\/tr><tr><td>POST<\/td><td><code>\/contests\/upload_solution<\/code><\/td><td>Registrar ou atualizar link de solu\u00e7\u00e3o<\/td><\/tr><tr><td>POST<\/td><td><code>\/auth\/google<\/code><\/td><td>Processar login via Google<\/td><\/tr><tr><td>GET<\/td><td><code>\/user\/profile<\/code><\/td><td>Consultar perfil<\/td><\/tr><tr><td>POST<\/td><td><code>\/user\/bookmarks<\/code><\/td><td>Adicionar favorito<\/td><\/tr><tr><td>GET<\/td><td><code>\/user\/bookmarks<\/code><\/td><td>Listar favoritos<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>GET<\/strong> costuma representar consultas sem altera\u00e7\u00e3o intencional do estado do recurso. <strong>POST<\/strong> envia dados para processamento e frequentemente \u00e9 utilizado em opera\u00e7\u00f5es que criam ou modificam informa\u00e7\u00f5es.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Essa tabela representa as rotas encontradas na revis\u00e3o do c\u00f3digo. Ela n\u00e3o substitui uma especifica\u00e7\u00e3o formal de API com contratos, esquemas e respostas de erro.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"12_Entendendo_a_automacao_com_node-cron\"><\/span>12. Entendendo a automa\u00e7\u00e3o com node-cron<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-12-entendendo-a-automa\u00e7\u00e3o-com-node-cron\" class=\"anchor\" aria-label=\"Permalink: 12. Entendendo a automa\u00e7\u00e3o com node-cron\" href=\"#12-entendendo-a-automa%C3%A7%C3%A3o-com-node-cron\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/cron\/video_link_fetcher.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/cron\/video_link_fetcher.ts<\/code><\/a> agenda a verifica\u00e7\u00e3o de v\u00eddeos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A express\u00e3o de agendamento utilizada \u00e9:<\/p>\n\n\n\n<div class=\"highlight highlight-source-ts\"><pre><span class=\"pl-s1\">cron<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">schedule<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s\">\"0 8 * * *\"<\/span><span class=\"pl-kos\">,<\/span> <span class=\"pl-k\">async<\/span> <span class=\"pl-kos\">(<\/span><span class=\"pl-kos\">)<\/span> <span class=\"pl-c1\">=&gt;<\/span> <span class=\"pl-kos\">{<\/span>\n  <span class=\"pl-c\">\/\/ Consulta v\u00eddeos e procura competi\u00e7\u00f5es correspondentes.<\/span>\n<span class=\"pl-kos\">}<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Ela indica execu\u00e7\u00e3o di\u00e1ria \u00e0s 8 horas <strong>no fuso hor\u00e1rio usado pelo processo<\/strong>, caso n\u00e3o exista uma configura\u00e7\u00e3o expl\u00edcita que altere esse comportamento. N\u00e3o devemos presumir que ser\u00e1 sempre o hor\u00e1rio de Bras\u00edlia.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A rotina consulta v\u00eddeos de um canal espec\u00edfico usando a API do YouTube, analisa t\u00edtulos com express\u00f5es regulares e procura correspond\u00eancias com competi\u00e7\u00f5es do Codeforces, CodeChef e LeetCode.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Quando reconhece uma associa\u00e7\u00e3o e n\u00e3o encontra um registro existente para aquele identificador, grava o link da solu\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Isso mostra um caso pr\u00e1tico de <strong>automa\u00e7\u00e3o recorrente<\/strong>: integrar servi\u00e7os, aplicar regras de correspond\u00eancia e persistir resultados sem depender de um clique do usu\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Tamb\u00e9m revela poss\u00edveis limita\u00e7\u00f5es: t\u00edtulos podem mudar, padr\u00f5es de nomenclatura podem variar, APIs podem impor limites e o agendamento pode deixar de funcionar se o processo estiver parado.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"13_Seguranca_o_que_precisa_ser_revisto_antes_de_executar\"><\/span>13. Seguran\u00e7a: o que precisa ser revisto antes de executar?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-13-seguran\u00e7a-o-que-precisa-ser-revisto-antes-de-executar\" class=\"anchor\" aria-label=\"Permalink: 13. Seguran\u00e7a: o que precisa ser revisto antes de executar?\" href=\"#13-seguran%C3%A7a-o-que-precisa-ser-revisto-antes-de-executar\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Uma parte importante do estudo \u00e9 identificar riscos concretos sem transformar toda suspeita em vulnerabilidade comprovadamente explorada.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"131_Decodificar_JWT_nao_e_validar_JWT\"><\/span>13.1 Decodificar JWT n\u00e3o \u00e9 validar JWT<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-131-decodificar-jwt-n\u00e3o-\u00e9-validar-jwt\" class=\"anchor\" aria-label=\"Permalink: 13.1 Decodificar JWT n\u00e3o \u00e9 validar JWT\" href=\"#131-decodificar-jwt-n%C3%A3o-%C3%A9-validar-jwt\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/auth_router.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/routers\/auth_router.ts<\/code><\/a>, o sistema utiliza:<\/p>\n\n\n\n<div class=\"highlight highlight-source-ts\"><pre><span class=\"pl-k\">const<\/span> <span class=\"pl-s1\">json_data<\/span> <span class=\"pl-c1\">=<\/span> <span class=\"pl-s1\">jwt<\/span><span class=\"pl-kos\">.<\/span><span class=\"pl-en\">decode<\/span><span class=\"pl-kos\">(<\/span><span class=\"pl-s1\">token<\/span><span class=\"pl-kos\">)<\/span><span class=\"pl-kos\">;<\/span><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A mesma abordagem aparece no <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/middleware\/middleware.ts\" target=\"_blank\" rel=\"noopener\">middleware de autentica\u00e7\u00e3o<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A fun\u00e7\u00e3o <code>decode<\/code> l\u00ea o conte\u00fado do token, mas <strong>n\u00e3o verifica sua assinatura criptogr\u00e1fica<\/strong>. Assim, confiar diretamente no e-mail declarado pelo token \u00e9 uma decis\u00e3o insegura.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para autentica\u00e7\u00e3o com Google, a evolu\u00e7\u00e3o apropriada \u00e9 verificar o ID token no backend, incluindo assinatura, emissor, audi\u00eancia e validade, usando uma biblioteca adequada, como <code>google-auth-library<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Refer\u00eancia: <a href=\"https:\/\/developers.google.com\/identity\/gsi\/web\/guides\/verify-google-id-token\" target=\"_blank\" rel=\"noopener\">Google Identity \u2014 verificar ID tokens no backend<\/a>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"132_Endpoint_sensivel_sem_middleware_de_autenticacao\"><\/span>13.2 Endpoint sens\u00edvel sem middleware de autentica\u00e7\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-132-endpoint-sens\u00edvel-sem-middleware-de-autentica\u00e7\u00e3o\" class=\"anchor\" aria-label=\"Permalink: 13.2 Endpoint sens\u00edvel sem middleware de autentica\u00e7\u00e3o\" href=\"#132-endpoint-sens%C3%ADvel-sem-middleware-de-autentica%C3%A7%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A rota <code>POST \/contests\/upload_solution<\/code> aparece declarada sem middleware de autentica\u00e7\u00e3o no roteador de competi\u00e7\u00f5es.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O controlador modifica registros de links no MongoDB. Portanto, precisamos definir quem possui permiss\u00e3o para realizar essa altera\u00e7\u00e3o e aplicar autentica\u00e7\u00e3o e autoriza\u00e7\u00e3o no servidor.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"133_Configuracao_previsivel_do_banco\"><\/span>13.3 Configura\u00e7\u00e3o previs\u00edvel do banco<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-133-configura\u00e7\u00e3o-previs\u00edvel-do-banco\" class=\"anchor\" aria-label=\"Permalink: 13.3 Configura\u00e7\u00e3o previs\u00edvel do banco\" href=\"#133-configura%C3%A7%C3%A3o-previs%C3%ADvel-do-banco\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/docker-compose.yml\" target=\"_blank\" rel=\"noopener\"><code>backend\/docker-compose.yml<\/code><\/a> inclui credenciais previs\u00edveis para o MongoDB e publica portas no host.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Em um ambiente local isolado, configura\u00e7\u00f5es de demonstra\u00e7\u00e3o ajudam a explicar os servi\u00e7os. Por\u00e9m, n\u00e3o devem ser copiadas diretamente para um servidor acess\u00edvel por outras pessoas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Na etapa de instala\u00e7\u00e3o, vamos revisar credenciais, volumes, portas expostas e a necessidade de interfaces administrativas.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"134_Tratamento_de_ausencia_de_usuario\"><\/span>13.4 Tratamento de aus\u00eancia de usu\u00e1rio<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-134-tratamento-de-aus\u00eancia-de-usu\u00e1rio\" class=\"anchor\" aria-label=\"Permalink: 13.4 Tratamento de aus\u00eancia de usu\u00e1rio\" href=\"#134-tratamento-de-aus%C3%AAncia-de-usu%C3%A1rio\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">No arquivo <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/App.tsx\" target=\"_blank\" rel=\"noopener\"><code>frontend\/src\/App.tsx<\/code><\/a>, a busca do usu\u00e1rio atual pode retornar <code>null<\/code>. Em seguida, o c\u00f3digo tenta acessar propriedades como <code>currentUser.name<\/code>, sem uma guarda expl\u00edcita naquele trecho.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Isso pode causar erro quando a aplica\u00e7\u00e3o \u00e9 aberta sem uma sess\u00e3o v\u00e1lida.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Uma melhoria simples seria conferir se o objeto existe antes de ler seus campos e representar explicitamente o estado de visitante.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"135_Ambientes_de_desenvolvimento_e_producao_misturados\"><\/span>13.5 Ambientes de desenvolvimento e produ\u00e7\u00e3o misturados<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-135-ambientes-de-desenvolvimento-e-produ\u00e7\u00e3o-misturados\" class=\"anchor\" aria-label=\"Permalink: 13.5 Ambientes de desenvolvimento e produ\u00e7\u00e3o misturados\" href=\"#135-ambientes-de-desenvolvimento-e-produ%C3%A7%C3%A3o-misturados\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O frontend declara vari\u00e1veis de ambiente para URLs de desenvolvimento e produ\u00e7\u00e3o, mas alguns componentes chamam diretamente <code>VITE_PROD_BACKEND_URL<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Al\u00e9m disso, a configura\u00e7\u00e3o de desenvolvimento aponta para a porta 4000, enquanto o backend usa a porta 5000 como padr\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Essas escolhas podem provocar chamadas para o servidor errado e dificultar os testes locais.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"136_Arquivo_compactado_desconhecido\"><\/span>13.6 Arquivo compactado desconhecido<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-136-arquivo-compactado-desconhecido\" class=\"anchor\" aria-label=\"Permalink: 13.6 Arquivo compactado desconhecido\" href=\"#136-arquivo-compactado-desconhecido\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">O reposit\u00f3rio cont\u00e9m o arquivo <code>frontend\/src\/lib\/Software-1.9.zip<\/code> e o README oferece um link para download.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">N\u00e3o precisamos baixar ou executar esse pacote para estudar o projeto. Antes de utilizar um bin\u00e1rio ou arquivo compactado de origem desconhecida, \u00e9 necess\u00e1rio verificar sua proced\u00eancia, conte\u00fado e riscos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Regra pr\u00e1tica:<\/strong> primeiro lemos e compreendemos o c\u00f3digo; depois preparamos um ambiente isolado e controlado. N\u00e3o h\u00e1 necessidade de executar esse ZIP nesta forma\u00e7\u00e3o.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"14_Como_transformar_problemas_em_plano_de_melhoria\"><\/span>14. Como transformar problemas em plano de melhoria?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-14-como-transformar-problemas-em-plano-de-melhoria\" class=\"anchor\" aria-label=\"Permalink: 14. Como transformar problemas em plano de melhoria?\" href=\"#14-como-transformar-problemas-em-plano-de-melhoria\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">A an\u00e1lise inicial pode ser organizada assim:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>\u00c1rea<\/th><th>Observa\u00e7\u00e3o<\/th><th>Melhoria proposta<\/th><\/tr><\/thead><tbody><tr><td>Autentica\u00e7\u00e3o<\/td><td>Uso de <code>jwt.decode<\/code> como base de confian\u00e7a<\/td><td>Verificar criptograficamente ID tokens<\/td><\/tr><tr><td>Autoriza\u00e7\u00e3o<\/td><td>Rota de solu\u00e7\u00e3o sem prote\u00e7\u00e3o declarada<\/td><td>Exigir identidade e permiss\u00e3o<\/td><\/tr><tr><td>Configura\u00e7\u00e3o<\/td><td>Credenciais previs\u00edveis e portas publicadas<\/td><td>Isolar servi\u00e7os e parametrizar segredos<\/td><\/tr><tr><td>Frontend<\/td><td>Acesso a propriedades quando usu\u00e1rio pode ser <code>null<\/code>\n<\/td><td>Tratar estado n\u00e3o autenticado<\/td><\/tr><tr><td>Integra\u00e7\u00f5es<\/td><td>\n<code>Promise.all<\/code> pode falhar integralmente<\/td><td>Considerar falhas parciais e timeout<\/td><\/tr><tr><td>Desenvolvimento<\/td><td>URLs e portas potencialmente inconsistentes<\/td><td>Centralizar configura\u00e7\u00e3o por ambiente<\/td><\/tr><tr><td>Qualidade<\/td><td>Backend n\u00e3o declara scripts \u00fateis de teste e execu\u00e7\u00e3o<\/td><td>Organizar build, execu\u00e7\u00e3o e testes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Essa lista \u00e9 um <strong>backlog did\u00e1tico preliminar<\/strong>, n\u00e3o uma classifica\u00e7\u00e3o definitiva de severidade baseada em explora\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Vamos abordar esses t\u00f3picos de forma progressiva nas pr\u00f3ximas aulas.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"15_Exercicio_pratico_investigacao_somente_pela_interface_do_GitHub\"><\/span>15. Exerc\u00edcio pr\u00e1tico: investiga\u00e7\u00e3o somente pela interface do GitHub<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-15-exerc\u00edcio-pr\u00e1tico-investiga\u00e7\u00e3o-somente-pela-interface-do-github\" class=\"anchor\" aria-label=\"Permalink: 15. Exerc\u00edcio pr\u00e1tico: investiga\u00e7\u00e3o somente pela interface do GitHub\" href=\"#15-exerc%C3%ADcio-pr%C3%A1tico-investiga%C3%A7%C3%A3o-somente-pela-interface-do-github\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta primeira pr\u00e1tica, <strong>n\u00e3o vamos instalar depend\u00eancias nem iniciar cont\u00eaineres<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_1_%E2%80%94_Identifique_a_inicializacao_do_servidor\"><\/span>Exerc\u00edcio 1 \u2014 Identifique a inicializa\u00e7\u00e3o do servidor<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-1--identifique-a-inicializa\u00e7\u00e3o-do-servidor\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 1 \u2014 Identifique a inicializa\u00e7\u00e3o do servidor\" href=\"#exerc%C3%ADcio-1--identifique-a-inicializa%C3%A7%C3%A3o-do-servidor\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Abra <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/index.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/index.ts<\/code><\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Encontre:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>onde a inst\u00e2ncia do Express \u00e9 criada;<\/li>\n\n\n\n<li>onde o MongoDB \u00e9 conectado;<\/li>\n\n\n\n<li>onde os roteadores s\u00e3o registrados;<\/li>\n\n\n\n<li>onde <code>app.listen<\/code> inicia o servidor;<\/li>\n\n\n\n<li>em que momento a rotina do YouTube \u00e9 iniciada.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pergunta:<\/strong> o servidor HTTP espera a conex\u00e3o com MongoDB ser conclu\u00edda para chamar <code>app.listen<\/code>?<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_2_%E2%80%94_Siga_uma_rota\"><\/span>Exerc\u00edcio 2 \u2014 Siga uma rota<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-2--siga-uma-rota\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 2 \u2014 Siga uma rota\" href=\"#exerc%C3%ADcio-2--siga-uma-rota\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Abra <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/contest_router.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/routers\/contest_router.ts<\/code><\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Localize o endpoint <code>\/upcomming_contest<\/code> e identifique o nome do controlador que ele chama.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depois, abra <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/controllers\/contests.ts\" target=\"_blank\" rel=\"noopener\"><code>backend\/src\/controllers\/contests.ts<\/code><\/a> e encontre a fun\u00e7\u00e3o correspondente.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pergunta:<\/strong> quais s\u00e3o as tr\u00eas plataformas consultadas?<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_3_%E2%80%94_Encontre_a_ordenacao\"><\/span>Exerc\u00edcio 3 \u2014 Encontre a ordena\u00e7\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-3--encontre-a-ordena\u00e7\u00e3o\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 3 \u2014 Encontre a ordena\u00e7\u00e3o\" href=\"#exerc%C3%ADcio-3--encontre-a-ordena%C3%A7%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Ainda no controlador, procure o trecho que re\u00fane as listas de competi\u00e7\u00f5es futuras e as ordena pela data de in\u00edcio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pergunta:<\/strong> o c\u00f3digo apresenta primeiro os eventos com in\u00edcio mais pr\u00f3ximo ou os mais distantes?<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Exercicio_4_%E2%80%94_Identifique_um_risco\"><\/span>Exerc\u00edcio 4 \u2014 Identifique um risco<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-exerc\u00edcio-4--identifique-um-risco\" class=\"anchor\" aria-label=\"Permalink: Exerc\u00edcio 4 \u2014 Identifique um risco\" href=\"#exerc%C3%ADcio-4--identifique-um-risco\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Abra o <a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/middleware\/middleware.ts\" target=\"_blank\" rel=\"noopener\">middleware de autentica\u00e7\u00e3o<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Procure a chamada a <code>jwt.decode<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Pergunta:<\/strong> por que ler o e-mail de um token n\u00e3o \u00e9 suficiente para autenticar o usu\u00e1rio?<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Modelo_de_registro_do_laboratorio\"><\/span>Modelo de registro do laborat\u00f3rio<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-modelo-de-registro-do-laborat\u00f3rio\" class=\"anchor\" aria-label=\"Permalink: Modelo de registro do laborat\u00f3rio\" href=\"#modelo-de-registro-do-laborat%C3%B3rio\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<pre class=\"wp-block-code\" lang=\"text\"><code>Arquivo analisado:\nFun\u00e7\u00e3o ou rota encontrada:\nO que a fun\u00e7\u00e3o faz:\nDe qual componente recebe dados:\nPara qual componente envia dados:\nD\u00favida ou risco identificado:\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Utilize esse pequeno registro sempre que estudarmos uma nova parte do projeto. Ele ajudar\u00e1 a documentar o racioc\u00ednio, n\u00e3o apenas decorar nomes de fun\u00e7\u00f5es.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"16_Questoes_de_revisao\"><\/span>16. Quest\u00f5es de revis\u00e3o<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-16-quest\u00f5es-de-revis\u00e3o\" class=\"anchor\" aria-label=\"Permalink: 16. Quest\u00f5es de revis\u00e3o\" href=\"#16-quest%C3%B5es-de-revis%C3%A3o\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Tente responder antes de consultar o gabarito.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>1. Qual componente consulta as plataformas de competi\u00e7\u00e3o e transforma os resultados?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) MongoDB<br>\nB) Controlador do backend<br>\nC) Navbar do React<br>\nD) Docker Compose<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>2. O que acontece quando o frontend chama <code>GET \/contests\/upcomming_contest<\/code>?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) O navegador acessa diretamente as cole\u00e7\u00f5es do MongoDB<br>\nB) O Express encaminha a requisi\u00e7\u00e3o ao controlador configurado<br>\nC) O Docker Compose cria a interface<br>\nD) O GitHub executa o cron<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>3. Por que o backend normaliza os dados?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Para que todas as APIs externas tenham de alterar seus formatos<br>\nB) Para facilitar a apresenta\u00e7\u00e3o de dados de fontes diferentes em uma estrutura comum<br>\nC) Para eliminar a necessidade de HTTP<br>\nD) Para substituir a autentica\u00e7\u00e3o<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>4. O uso isolado de <code>jwt.decode<\/code> comprova a autenticidade de um token?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Sim, porque o token tem tr\u00eas partes<br>\nB) Sim, se contiver um e-mail conhecido<br>\nC) N\u00e3o, porque a assinatura n\u00e3o \u00e9 verificada<br>\nD) Sim, desde que seja armazenado no navegador<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>5. O que a rotina de v\u00eddeos faz, conforme o c\u00f3digo analisado?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A) Publica v\u00eddeos novos automaticamente no YouTube<br>\nB) Consulta v\u00eddeos, tenta associ\u00e1-los a eventos e grava links<br>\nC) Compila o React diariamente<br>\nD) Cria usu\u00e1rios no Google<\/p>\n\n\n\n<div class=\"markdown-heading\"><h3 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Gabarito_comentado\"><\/span>Gabarito comentado<span class=\"ez-toc-section-end\"><\/span><\/h3><a id=\"user-content-gabarito-comentado\" class=\"anchor\" aria-label=\"Permalink: Gabarito comentado\" href=\"#gabarito-comentado\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Quest\u00e3o<\/th><th>Resposta<\/th><th>Explica\u00e7\u00e3o<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td><strong>B<\/strong><\/td><td>O controlador realiza consultas, adapta dados e prepara a resposta.<\/td><\/tr><tr><td>2<\/td><td><strong>B<\/strong><\/td><td>Express encontra a rota e chama a fun\u00e7\u00e3o associada.<\/td><\/tr><tr><td>3<\/td><td><strong>B<\/strong><\/td><td>Normalizar dados permite tratar diferentes plataformas de maneira uniforme.<\/td><\/tr><tr><td>4<\/td><td><strong>C<\/strong><\/td><td>Decodifica\u00e7\u00e3o n\u00e3o \u00e9 verifica\u00e7\u00e3o criptogr\u00e1fica.<\/td><\/tr><tr><td>5<\/td><td><strong>B<\/strong><\/td><td>O cron pesquisado associa links existentes, n\u00e3o publica v\u00eddeos.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"17_Checklist_de_aprendizagem\"><\/span>17. Checklist de aprendizagem<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-17-checklist-de-aprendizagem\" class=\"anchor\" aria-label=\"Permalink: 17. Checklist de aprendizagem\" href=\"#17-checklist-de-aprendizagem\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Antes de avan\u00e7ar, verifique se consegue:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>[ ] Explicar em uma frase a finalidade do projeto.<\/li>\n\n\n\n<li>[ ] Diferenciar frontend, backend e banco de dados.<\/li>\n\n\n\n<li>[ ] Identificar o papel do React, do Express e do MongoDB.<\/li>\n\n\n\n<li>[ ] Encontrar o arquivo <code>backend\/src\/index.ts<\/code>.<\/li>\n\n\n\n<li>[ ] Localizar o roteador de competi\u00e7\u00f5es.<\/li>\n\n\n\n<li>[ ] Identificar o controlador chamado pelo endpoint de pr\u00f3ximas competi\u00e7\u00f5es.<\/li>\n\n\n\n<li>[ ] Descrever o caminho Home \u2192 hook \u2192 HTTP \u2192 Express \u2192 controlador \u2192 JSON.<\/li>\n\n\n\n<li>[ ] Explicar por que os dados de diferentes plataformas s\u00e3o normalizados.<\/li>\n\n\n\n<li>[ ] Distinguir busca de v\u00eddeos de publica\u00e7\u00e3o de v\u00eddeos no YouTube.<\/li>\n\n\n\n<li>[ ] Explicar por que <code>jwt.decode<\/code> n\u00e3o \u00e9 suficiente para validar identidade.<\/li>\n\n\n\n<li>[ ] Justificar por que n\u00e3o devemos executar um ZIP desconhecido para come\u00e7ar o estudo.<\/li>\n\n\n\n<li>[ ] Responder \u00e0s cinco quest\u00f5es de revis\u00e3o.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Se algum item ficou dif\u00edcil, retorne ao arquivo correspondente no GitHub e siga o fluxo novamente.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"18_O_que_faremos_na_Aula_2\"><\/span>18. O que faremos na Aula 2?<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-18-o-que-faremos-na-aula-2\" class=\"anchor\" aria-label=\"Permalink: 18. O que faremos na Aula 2?\" href=\"#18-o-que-faremos-na-aula-2\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Na pr\u00f3xima etapa, vamos estudar a <strong>prepara\u00e7\u00e3o segura do ambiente de desenvolvimento<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O percurso previsto inclui Git, Node.js, TypeScript, editor de c\u00f3digo, depend\u00eancias do frontend e backend, vari\u00e1veis de ambiente e a execu\u00e7\u00e3o local de servi\u00e7os.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Antes de iniciar a aplica\u00e7\u00e3o, vamos tamb\u00e9m revisar as configura\u00e7\u00f5es e definir corre\u00e7\u00f5es m\u00ednimas para evitar o uso inseguro da autentica\u00e7\u00e3o, do banco e de arquivos n\u00e3o verificados.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">O objetivo n\u00e3o ser\u00e1 apenas fazer a aplica\u00e7\u00e3o <em>subir<\/em>, mas conseguir explicar <strong>o que est\u00e1 sendo executado, quais recursos utiliza e como verificar o comportamento esperado<\/strong>.<\/p>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"19_Conclusao_compreender_antes_de_modificar\"><\/span>19. Conclus\u00e3o: compreender antes de modificar<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-19-conclus\u00e3o-compreender-antes-de-modificar\" class=\"anchor\" aria-label=\"Permalink: 19. Conclus\u00e3o: compreender antes de modificar\" href=\"#19-conclus%C3%A3o-compreender-antes-de-modificar\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Estudar um projeto real exige mais do que reconhecer nomes de bibliotecas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Nesta aula, conhecemos o Assignment Contest Tracker, identificamos suas camadas, percorremos uma requisi\u00e7\u00e3o HTTP e observamos como informa\u00e7\u00f5es externas e dados persistidos participam do funcionamento da aplica\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Tamb\u00e9m encontramos situa\u00e7\u00f5es que mostram por que revis\u00e3o de c\u00f3digo, seguran\u00e7a e qualidade precisam fazer parte da forma\u00e7\u00e3o de um desenvolvedor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A principal ideia \u00e9 simples: <strong>antes de corrigir ou ampliar uma aplica\u00e7\u00e3o, precisamos construir um mapa confi\u00e1vel de suas responsabilidades e de seus fluxos<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Com esse mapa, os pr\u00f3ximos passos se tornam mais seguros e mais f\u00e1ceis de justificar.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<div class=\"markdown-heading\"><h2 class=\"heading-element\"><span class=\"ez-toc-section\" id=\"Fontes_e_materiais_de_estudo\"><\/span>Fontes e materiais de estudo<span class=\"ez-toc-section-end\"><\/span><\/h2><a id=\"user-content-fontes-e-materiais-de-estudo\" class=\"anchor\" aria-label=\"Permalink: Fontes e materiais de estudo\" href=\"#fontes-e-materiais-de-estudo\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"><\/span><\/a><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Projeto-base:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\" target=\"_blank\" rel=\"noopener\">dgvijaytorg\/assignment \u2014 reposit\u00f3rio original<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/readme.md\" target=\"_blank\" rel=\"noopener\">README do projeto<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Arquivos analisados:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/index.ts\" target=\"_blank\" rel=\"noopener\">Inicializa\u00e7\u00e3o do backend \u2014 <code>src\/index.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/contest_router.ts\" target=\"_blank\" rel=\"noopener\">Rotas de competi\u00e7\u00f5es \u2014 <code>contest_router.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/controllers\/contests.ts\" target=\"_blank\" rel=\"noopener\">Controlador de competi\u00e7\u00f5es \u2014 <code>contests.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/user_router.ts\" target=\"_blank\" rel=\"noopener\">Rotas de usu\u00e1rios \u2014 <code>user_router.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/controllers\/user.ts\" target=\"_blank\" rel=\"noopener\">Controlador de usu\u00e1rios \u2014 <code>user.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/routers\/auth_router.ts\" target=\"_blank\" rel=\"noopener\">Autentica\u00e7\u00e3o \u2014 <code>auth_router.ts<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/middleware\/middleware.ts\" target=\"_blank\" rel=\"noopener\">Middleware de autentica\u00e7\u00e3o<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/src\/cron\/video_link_fetcher.ts\" target=\"_blank\" rel=\"noopener\">Agendamento do YouTube<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/App.tsx\" target=\"_blank\" rel=\"noopener\">Aplica\u00e7\u00e3o React \u2014 <code>App.tsx<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/pages\/Home.tsx\" target=\"_blank\" rel=\"noopener\">P\u00e1gina inicial \u2014 <code>Home.tsx<\/code><\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/frontend\/src\/hooks\/UseUpcommingContests.tsx\" target=\"_blank\" rel=\"noopener\">Hook de pr\u00f3ximas competi\u00e7\u00f5es<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/github.com\/dgvijaytorg\/assignment\/blob\/main\/backend\/docker-compose.yml\" target=\"_blank\" rel=\"noopener\">Configura\u00e7\u00e3o Docker<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Refer\u00eancias complementares:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/react.dev\/\" target=\"_blank\" rel=\"noopener\">React \u2014 documenta\u00e7\u00e3o<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/expressjs.com\/\" target=\"_blank\" rel=\"noopener\">Express \u2014 documenta\u00e7\u00e3o<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.typescriptlang.org\/docs\/\" target=\"_blank\" rel=\"noopener\">TypeScript \u2014 documenta\u00e7\u00e3o<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.mongodb.com\/docs\/\" target=\"_blank\" rel=\"noopener\">MongoDB \u2014 documenta\u00e7\u00e3o<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/developers.google.com\/identity\/gsi\/web\/guides\/verify-google-id-token\" target=\"_blank\" rel=\"noopener\">Google Identity \u2014 verifica\u00e7\u00e3o de ID tokens<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/owasp.org\/API-Security\/\" target=\"_blank\" rel=\"noopener\">OWASP \u2014 API Security<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Nota de escopo: a an\u00e1lise corresponde ao c\u00f3digo observado no ramo principal do reposit\u00f3rio durante a prepara\u00e7\u00e3o desta aula. Altera\u00e7\u00f5es futuras do projeto original podem modificar comportamentos, nomes de rotas e configura\u00e7\u00f5es aqui descritos. Nenhum c\u00f3digo do reposit\u00f3rio original foi executado como parte desta revis\u00e3o.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Metadescri\u00e7\u00e3o:<\/strong> Estude a arquitetura de um projeto full stack real com React, TypeScript, Express e MongoDB. Entenda as rotas REST, o fluxo HTTP e os riscos do c\u00f3digo.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tags:<\/strong> React, TypeScript, Node.js, Express, MongoDB, Mongoose, API REST, Arquitetura de Software, GitHub, Seguran\u00e7a, Aprendizado Pr\u00e1tico.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Veja tamb\u00e9m: <a href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/category\/desenvolvimento-full-stack\/\">mais conte\u00fados sobre Desenvolvimento Full Stack<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-embed aligncenter is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Aula 1 \u2014 Arquitetura e Reconhecimento do C\u00f3digo | React, Node.js, Express e MongoDB\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/ZnIsAvYnqpw?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Na Aula 1, vamos ler o c\u00f3digo real do Assignment Contest Tracker, mapear frontend, backend, rotas e integra\u00e7\u00f5es, acompanhar uma requisi\u00e7\u00e3o HTTP e identificar problemas antes de executar o projeto.<\/p>\n","protected":false},"author":1,"featured_media":1688,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[732],"tags":[206,731,227,535,73,210,735,540,733,736,734],"class_list":["post-1686","post","type-post","status-publish","format-standard","has-post-thumbnail","category-desenvolvimento-full-stack","tag-api-rest","tag-aprendizado-pratico","tag-arquitetura-de-software","tag-express","tag-github","tag-mongodb","tag-mongoose","tag-node-js","tag-react","tag-seguranca","tag-typescript"],"_links":{"self":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1686","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/comments?post=1686"}],"version-history":[{"count":3,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1686\/revisions"}],"predecessor-version":[{"id":1690,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/1686\/revisions\/1690"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media\/1688"}],"wp:attachment":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media?parent=1686"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/categories?post=1686"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/tags?post=1686"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}