Revisão de projeto de portfólioTreinamento em programação

Revisão de código de um projeto de portfólio antes de se candidatar a vagas

Normalmente fica pronto em 15 minutosAjustes incluídosControle de qualidade
Pacotes
Pagamento protegidoDetalhes
  • Os ajustes previstos no pacote são gratuitos.
  • Se você não responder em 3 dias após a entrega, o trabalho é aprovado automaticamente.

O dinheiro fica reservado no pagamento e só é liberado quando você aprova o trabalho.

Revisão de código de um projeto de portfólio antes de se candidatar a vagas

Exemplo de resultado

Exemplo do pacote Padrão

Revisão de código: script em Python para importar pedidos de uma loja virtual

O que o código faz

  1. Lê o orders.csv exportado da loja.
  2. Para cada item do pedido, procura o produto pelo SKU no stock.xlsx e subtrai a quantidade.
  3. Grava o estoque atualizado e registra os totais em import_log.txt.

A estrutura é clara e as funções têm bons nomes. A maioria dos problemas vem de dados de entrada que não chegam no formato que o script espera.

Bugs e pontos fracos

#LinhaGravidadeProblema
148AltaO mesmo CSV pode ser importado duas vezes; não há checagem dos IDs de pedido já processados. É a causa mais provável do estoque negativo.
272Altaint(row["qty"]) quebra com valores vazios ou "2.0" de pedidos reembolsados.
395MédiaA busca por SKU diferencia maiúsculas: "gt-101" e "GT-101" viram produtos diferentes.
4130MédiaO arquivo é aberto sem encoding="utf-8", então nomes com acento quebram no Windows.
5201BaixaUm except: genérico esconde os erros reais e deixa o log inútil.

Trechos corrigidos

Problema 1: pular pedidos já importados

processed = load_processed_ids("processed_orders.txt")
for row in reader:
    if row["order_id"] in processed:
        continue
    # ... lógica existente ...
    processed.add(row["order_id"])
save_processed_ids("processed_orders.txt", processed)

Por quê: cada pedido é aplicado uma única vez, mesmo que você rode o script de novo com o mesmo arquivo.

Problema 2: ler a quantidade com segurança

raw = (row.get("qty") or "").strip()
try:
    qty = int(float(raw))
except ValueError:
    log.warning("Pedido %s: quantidade inválida %r, ignorado", row["order_id"], raw)
    continue

Por quê: itens reembolsados ou parciais são pulados com um aviso claro, em vez de interromper toda a importação.

Problema 3: padronizar os SKUs

sku = row["sku"].strip().upper()

Aplique o mesmo .strip().upper() ao montar o dicionário de estoque.

Estilo e legibilidade

  • process() tem 90 linhas; divida em read_orders, apply_to_stock e write_report.
  • Troque os números de coluna "mágicos" (row[7]) pelos nomes dos cabeçalhos.

Teste cada correção em uma cópia dos seus arquivos: lemos o código, mas não o executamos.

Cliente: dona de uma loja de chás que escreveu um script em Python de 310 linhas para importar os pedidos de um CSV exportado para a planilha de estoque Problema relatado: "Às vezes o estoque fica negativo, e o script trava com alguns arquivos."

O cliente e todos os dados são fictícios.

Sobre este serviço

Quando uma equipe de contratação abre o projeto de portfólio de um júnior, ela procura rapidamente alguns sinais: nomes claros, funções pequenas, tratamento de erros, alguns testes e um README que diz o que o projeto faz e como rodá-lo. Cole os arquivos principais do seu projeto e revisamos como um avaliador faria, marcando o que parece inacabado, o que parece cópia de tutorial e o que mostra habilidade de verdade. Você recebe fragmentos corrigidos e uma lista curta das mudanças que mais melhoram a primeira impressão.

O que está incluído

  • O que você recebeUma revisão escrita na página do pedido: notas de primeira impressão, problemas no código por importância, fragmentos corrigidos e uma sugestão de estrutura para o README. O Premium inclui um plano de estudos para as lacunas que um avaliador notaria.
  • Primeira impressãoO que um avaliador nota em minutos
  • Qualidade do códigoNomes, funções e tratamento de erros
  • TestesOnde alguns testes ajudariam mais
  • Estrutura do READMEO que ele faz e como rodá-lo
  • Lista de prioridadesMudanças ordenadas por impacto

Como funciona

  1. 1
    BriefingVocê cola os arquivos principais e a vaga que busca
  2. 2
    LeituraRevisamos como um avaliador de contratação faria
  3. 3
    RevisãoVocê recebe correções e uma lista de prioridades

O que precisamos de você

Os arquivos principais do seu projeto colados como texto ou em capturas de tela, o seu README atual, a stack, a vaga a que você está se candidatando e o que você quer que o projeto mostre.

Vamos perguntar:

  • A qual vaga você está se candidatando?
  • O que o projeto faz e qual stack ele usa?
  • É uma ideia sua ou baseada num curso?
  • Quais arquivos mostram o seu melhor trabalho?

Compare os pacotes

PacotesBásicoR$ 84PadrãoR$ 195PremiumR$ 384
O que está incluídoArquivos principais de até 100 linhasCódigo do projeto de até 400 linhasAté 1.000 linhas com plano de estudos
Prazo1 dia2 dias3 dias
Ajustes123
Linhas de códigoaté 100até 400até 1.000
Fragmentos corrigidosSimSimSim
Plano de estudoNãoNãoSim
Fazer pedido BásicoFazer pedido PadrãoFazer pedido Premium

Pagamento protegido

Você paga ao fazer o pedido, mas o dinheiro só é liberado pelo trabalho aprovado.

  • Preço fixoO preço do pacote não muda depois que você paga.
  • O dinheiro fica reservadoAo pagar, o valor fica apenas reservado. Ele só é repassado quando você aprova o trabalho.
  • Verificado antes da entregaCada resultado passa por um controle de qualidade antes de chegar até você, e você o vê na página do pedido antes de aprovar.
  • Ajustes gratuitosPeça ajustes dentro do seu briefing quantas vezes o pacote permitir.
  • Aprovação após 3 diasSe em 3 dias após a entrega você não aprovar o trabalho nem pedir ajustes, ele é aprovado automaticamente. Se você escrever no chat do pedido após a entrega, o pedido fica em espera; depois que respondermos, podemos reiniciar a contagem de 3 dias e avisaremos no chat.
  • Refazer ou reembolso totalSe o resultado não corresponder ao seu briefing e os ajustes não resolverem, ou se o trabalho levar mais que o dobro do prazo, escreva no chat do pedido: refazemos o trabalho ou reembolsamos o pagamento integralmente.
Como funciona →

Perguntas e respostas

Vocês podem olhar o meu perfil do GitHub?

Revisamos o código e o README que você colar aqui. Não navegamos pelos seus repositórios, então inclua os arquivos que você quer que sejam revisados.

Isso vai me fazer ser contratado?

Deixa o projeto mais fácil de ler e mais próximo do que os avaliadores esperam, mas as decisões de contratação dependem de muito mais do que um projeto.

Vocês podem fazer o projeto por mim?

Não. O projeto deve ser trabalho seu; nós o revisamos e mostramos como melhorá-lo.

Não encontrou a resposta?

Pacotes