Projeto_jedai

Formulário de Controle de saída de produtos

Olá e bem-vindo ao meu portfólio!

Documentação para o Código de Geração de Questões e Prova de Geografia

Introdução

Este documento descreve o funcionamento de dois códigos Python relacionados à geração e apresentação de questões de geografia, bem como a realização de uma prova interativa baseada nessas questões. Os códigos utilizam bibliotecas como PyODBC, requests, pandas e Streamlit.

Geração de Questões de Geografia

Funções Principais

1. `generate_questions()`

Esta função utiliza a API do OpenAI para gerar automaticamente questões de geografia em português (pt-br), com alternativas de A a D e uma explicação associada à resposta correta. O texto de entrada é um prompt definido pelo usuário que indica a intenção de gerar uma questão de geografia. A função retorna uma lista de dicionários, cada um contendo o texto da questão e sua explicação.

2. `main()`

A função principal do código é responsável por orquestrar o processo de geração de questões e sua inserção em um banco de dados SQL Server. Ela chama a função generate_questions() para obter as questões, verifica se cada questão já existe no banco de dados e, se não existir, a adiciona ao banco por meio da função add_question_to_database().

Banco de Dados SQL Server

Configuração da Conexão

A função create_connection() é responsável por criar uma conexão com o banco de dados SQL Server, utilizando a biblioteca PyODBC. Os parâmetros do servidor e do banco de dados devem ser configurados de acordo com o ambiente de execução.

Operações no Banco de Dados

fetch_max_question_id(): Obtém o maior ID de questão presente na tabela do banco de dados.
question_exists(): Verifica se uma determinada questão já existe no banco de dados.
add_question_to_database(): Adiciona uma nova questão ao banco de dados.

Aplicativo de Prova de Geografia Interativa

Funções Principais

1. `carregar_dados_prova_geografia()`

Esta função conecta-se ao banco de dados SQL Server e carrega os dados das questões de geografia, incluindo o texto da pergunta, as alternativas, a resposta correta e a explicação associada.

2. `apresentar_pergunta()`

Esta função é responsável por apresentar uma pergunta ao usuário, exibindo o texto da pergunta e suas alternativas (A, B, C, D) em um formato interativo. O usuário pode selecionar uma opção e confirmar sua resposta.

Interface do Usuário

Iniciar Prova: Botão para iniciar a prova de geografia.
Questão Atual: Mostra a pergunta atual e suas opções de resposta.
Confirmação de Resposta: Após selecionar uma opção, o usuário deve confirmar sua resposta.
Feedback da Resposta: Após confirmar a resposta, o sistema fornece feedback indicando se a resposta está correta ou não, juntamente com uma explicação associada à resposta correta.
Próxima Pergunta: Botão para avançar para a próxima pergunta após submeter a resposta.

Conclusão

Este documento fornece uma visão geral das funcionalidades e operações dos códigos relacionados à geração e apresentação de questões de geografia, bem como à realização de uma prova interativa baseada nessas questões. Ele serve como uma guia para entender e utilizar esses códigos de forma eficaz.

Atenciosamente,

Lucas Gomes