Skip to content

roadmap.md

Latest commit

 

History

History
124 lines (87 loc) · 5.93 KB

roadmap.md

File metadata and controls

124 lines (87 loc) · 5.93 KB

Roadmap de Melhorias do Servidor

Este documento descreve metas para a evolução deste servidor web em C.

1. Implementar Concorrência com Multi-threading

Objetivo: Permitir que o servidor atenda múltiplos clientes simultaneamente, eliminando o gargalo de uma requisição por vez não escalável.

  • Modificar o loop principal em server.c.
  • Para cada nova conexão (accept), criar uma nova thread (usando pthread_create) para lidar com a requisição.
  • A thread será responsável por chamar http_handler, enviar a resposta e fechar o client_fd.
  • Garantir que a thread principal (main) faça a limpeza adequada das threads filhas para evitar memory leaks (usando pthread_detach ou pthread_join).
  • Compilar com a flag -pthread.

2. Flexibilizar a Configuração

Objetivo: Remover configurações fixas (hardcoded) do código, como a porta e o diretório raiz.

  • Implementar o parsing de argumentos de linha de comando (usando getopt).
  • Permitir a configuração da porta (ex: -p 8080).
  • Permitir a configuração do diretório raiz dos arquivos estáticos (ex: -d /var/www).
  • Usar valores padrão caso nenhum argumento seja fornecido.

3. Melhorar o Tratamento do Protocolo HTTP

Objetivo: Aumentar a conformidade com o padrão HTTP e adicionar funcionalidades úteis.

  • Implementar suporte ao método HEAD.
  • Retornar o código de erro 501 Not Implemented para métodos não suportados (POST, PUT, etc.).
  • Adicionar um sistema de logging para registrar informações sobre as requisições (IP, data, método, URI, status).

4. Daemonização

Objetivo: Permitir que o servidor rode como um processo em segundo plano (daemon).

  • Implementar a lógica de fork, criação de uma nova sessão (setsid), e desvinculação do terminal.

Histórico de Conclusão

Este roadmap foi concluído, servindo como um histórico do desenvolvimento inicial e das melhorias implementadas.

Próximos Passos: Testes Automatizados

Objetivo: Criar uma suíte de testes robusta para garantir a estabilidade do servidor e prevenir regressões.

  • Escolher um Framework de Teste: Pesquisar e selecionar um framework de teste de unidade para C (ex: Check, CUnit ou Unity).
  • Testes de Unidade:
    • Testar as funções de utils (MIME type, regex).
    • Testar a lógica de parsing do http_handler.
  • Testes de Integração/Funcionais:
    • Criar um script (em Bash, Python, etc.) que inicie o servidor.
    • Usar curl ou outra ferramenta para fazer requisições HTTP e validar as respostas.
    • Testar o método GET para arquivos existentes e inexistentes (404).
    • Testar o método HEAD.
    • Testar métodos não suportados (POST, etc.) para a resposta 501.
    • Testar os argumentos de linha de comando (-p, -d).
  • Integração com make: Adicionar um target make test para rodar todos os testes automaticamente.

Futuras Implementações de Tipos de Arquivo

Objetivo: Expandir o suporte a tipos de arquivo para melhor servir conteúdo web.

  • Suporte a Imagens:
    • PNG (image/png)
    • JPEG/JPG (image/jpeg) [ ] WebP (image/webp) - parcialmente implementado - É preciso rever eficiência e ajustar buffer.
    • GIF (image/gif)
    • ICO (image/x-icon)
  • Suporte a Dados:
    • JSON (application/json) - parcialmente implementado
    • XML (application/xml)
  • Suporte a Gráficos Vetoriais:
    • SVG (image/svg+xml)
  • Suporte a Fontes:
    • WOFF/WOFF2 (font/woff, font/woff2)
    • TTF (font/ttf)

Resumo das Melhorias Implementadas

✅ Refatoração e Eliminação de Redundâncias

 * Removida lógica duplicada: Eliminada a transformação "/" → "/index.html" de utils/regex.c, mantendo apenas em utils/path.c
 * Função httpResponse eliminada: Removidos methods/get/response.c e response.h, integrando a lógica diretamente em http_handler.c
 * Tratamento de erro centralizado: Fluxo de erro 404 agora é claro e unificado
 * Makefile atualizado: Removidas referências aos arquivos deletados

✅ Sistema de Logging Melhorado

 * Logs sempre no terminal: Logs aparecem no terminal tanto em modo foreground quanto daemon
 * Arquivo de log correto: server.log criado no diretório atual (não na raiz do sistema)
 * Help informativo: Documentação clara sobre onde os logs são salvos
 * Logs coloridos: Verde para 200 OK, amarelo para 4xx, vermelho para 5xx

✅ Desligamento Seguro

 * Manipulação de sinais: SIGINT (Ctrl+C) e SIGTERM funcionando corretamente
 * Exibição "Stopped": Mensagem clara de encerramento
 * Limpeza de recursos: Socket fechado e arquivo PID removido ao encerrar

✅ Gerenciamento PID Aprimorado

 * PID correto exibido: Agora mostra o PID real do processo daemon
 * Arquivo server.pid: Criado automaticamente em modo daemon
 * Sincronização: PID no terminal e no arquivo são idênticos e funcionais
 * Comando kill funciona: kill $(cat server.log) encerra o daemon corretamente

✅ README.md Atualizado

 * Instruções de encerramento: Documentadas as formas de parar o servidor
 * Gerenciamento PID: Explicado o uso do arquivo server.pid
 * Features atualizadas: Listadas todas as novas funcionalidades

✅ Testes Automatizados Implementados

 * Testes de unidade: Cobertura completa para utils (path, regex, verify)
 * Testes de HTTP handler: Cobertura de todos os cenários principais
 * Testes de integração: Validação end-to-end do servidor
 * Saída otimizada: Logs concisos e coloridos para melhor legibilidade

Resultado: O código agora é mais limpo, eficiente, sem redundâncias, com logging robusto, gerenciamento seguro de processos e uma suíte de testes completa! 🚀