{"id":23681631,"url":"https://github.com/vilhalva/questoes","last_synced_at":"2026-04-18T10:35:01.464Z","repository":{"id":213613023,"uuid":"734501548","full_name":"VILHALVA/QUESTOES","owner":"VILHALVA","description":"👨‍💻QUESTÕES É UM BOT DE SIMULADOR DE ENEM QUE RODA NO CONSOLE DA IDE.","archived":false,"fork":false,"pushed_at":"2025-06-23T19:23:45.000Z","size":17051,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-25T20:41:23.085Z","etag":null,"topics":["bot","chatbot","projeto","python","terminal","txt","update"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VILHALVA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-12-21T21:08:41.000Z","updated_at":"2025-06-23T19:23:49.000Z","dependencies_parsed_at":"2024-03-22T17:47:21.329Z","dependency_job_id":"fe89ce7b-c645-438a-b2e3-ca7aedbd6372","html_url":"https://github.com/VILHALVA/QUESTOES","commit_stats":null,"previous_names":["vilhalva/questoes"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/VILHALVA/QUESTOES","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FQUESTOES","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FQUESTOES/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FQUESTOES/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FQUESTOES/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VILHALVA","download_url":"https://codeload.github.com/VILHALVA/QUESTOES/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VILHALVA%2FQUESTOES/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31966045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","chatbot","projeto","python","terminal","txt","update"],"created_at":"2024-12-29T18:40:55.187Z","updated_at":"2026-04-18T10:35:01.446Z","avatar_url":"https://github.com/VILHALVA.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QUESTOES\r\n👨‍💻QUESTÕES É UM BOT DE SIMULADOR DE ENEM QUE RODA NO CONSOLE DA IDE.\r\n\r\n\u003cimg src=\"./IMAGENS/FOTO_01.png\" align=\"center\" width=\"500\"\u003e \u003cbr\u003e\r\n\u003cimg src=\"./IMAGENS/FOTO_02.png\" align=\"center\" width=\"500\"\u003e \u003cbr\u003e\r\n\u003cimg src=\"./IMAGENS/FOTO_03.png\" align=\"center\" width=\"500\"\u003e \u003cbr\u003e\r\n\r\n## DESCRIÇÃO:\r\nO Bot é um quiz interativo que apresenta perguntas sobre uma matéria específica. A seguir, uma descrição resumida de suas funcionalidades:\r\n\r\n1. **Menu Principal:** O usuário pode escolher entre mais de 50 matérias disponíveis.\r\n\r\n2. **Boas-Vindas:** O bot saúda o jogador e informa sobre a matéria em questão.\r\n\r\n3. **Perguntas:** O usuário recebe uma série de perguntas relacionadas à matéria selecionada.\r\n\r\n4. **Respostas:** O bot aceita respostas (A, B, C ou D) para cada pergunta.\r\n\r\n5. **Feedback:** Fornece retorno imediato sobre a correção das respostas.\r\n\r\n6. **Cores no terminal:** As mensagens são destacadas com Vermelho, Verde, Azul e Ciano! Algumas seções mantêm o padrão sem cores para facilitar a leitura.\r\n\r\n7. **Resultado Final:** Ao término do quiz, são exibidas estatísticas que incluem o nome da matéria, a data e a hora, respostas corretas, respostas respondidas, questões que você acertou, questões que você errou, quantidade de acertos, quantidade de erros, média de acertos, e a aprovação ou reprovação do jogador com base em uma porcentagem mínima de acertos.\r\n\r\n8. **Salvar Resultado Final:** O sistema perguntará se o usuário deseja salvar as informações. Se afirmativo, o resultado será salvo em um arquivo `.txt` no diretório `./CODIGO/files`, com o nome `QUESTOES_{MATERIA}_{TIME}.txt`, contendo os mesmos dados exibidos no console.\r\n\r\n## O QUE É O RESULTADO FINAL?\r\nO **\"RESULTADO FINAL\"** é uma **compilação dos dados gerados ao longo de uma simulação de perguntas e respostas**, destinada a fornecer uma visão geral do desempenho do usuário. Ele é apresentado em um formato bem estruturado e organizado, com as seguintes informações:\r\n\r\n### SUA ESTRUTURA:\r\n1. **DATA E HORA**:\r\n   - Indica o momento exato em que o resultado foi gerado, com formato `DD/MM/AAAA HH:MM:SS`.\r\n\r\n2. **MATÉRIA**:\r\n   - Identifica o tema ou disciplina das questões respondidas.\r\n\r\n3. **RESPOSTAS CORRETAS**:\r\n   - Um dicionário que mostra quais eram as respostas certas para cada pergunta.  \r\n   - Exemplo: `{1: 'D', 2: 'B', ...}` (onde o número da questão é associado à resposta correta).\r\n\r\n4. **RESPOSTAS RESPONDIDAS**:\r\n   - Um dicionário que exibe as respostas fornecidas pelo usuário para cada pergunta.  \r\n   - Exemplo: `{1: 'D', 2: 'A', ...}`.\r\n\r\n5. **QUESTÕES QUE VOCÊ ACERTOU**:\r\n   - Lista de números das questões respondidas corretamente pelo usuário.  \r\n   - Exemplo: `[1, 2, 4, 5]`.\r\n\r\n6. **QUESTÕES QUE VOCÊ ERROU**:\r\n   - Lista de números das questões que o usuário errou.  \r\n   - Exemplo: `[3, 6, 7]`.\r\n\r\n7. **VOCÊ ACERTOU**:\r\n   - A quantidade total de questões respondidas corretamente.  \r\n   - Exemplo: `7 QUESTÕES`.\r\n\r\n8. **VOCÊ ERROU**:\r\n   - A quantidade total de questões respondidas incorretamente.  \r\n   - Exemplo: `3 QUESTÕES`.\r\n\r\n9. **SUA MÉDIA FOI**:\r\n   - Percentual de acertos em relação ao total de questões respondidas. \r\n   - Calculado como: `Média (%) = (Número de acertos / Total de questões) × 100`\r\n   - Exemplo: `70%`.\r\n\r\n10. **SITUAÇÃO**:\r\n    - Determina se o usuário foi aprovado ou reprovado, baseado em um critério de acertos mínimo (70% no caso):\r\n      - 👍 APROVADO (se a média for maior ou igual a 70%).\r\n      - 👎 REPROVADO (se a média for inferior a 70%).\r\n\r\n### PROPÓSITO:\r\n- O **RESULTADO FINAL** serve como um relatório detalhado e objetivo para que o usuário possa:\r\n   1. **Feedback Educacional**: Pode ser utilizado para práticas de estudo, simulando provas e avaliando o progresso.\r\n   2. **Registro Histórico**: Ao salvar os resultados, o usuário pode acompanhar sua evolução ao longo do tempo.\r\n   3. **Geração de Relatórios**: Facilita a criação de relatórios para análises ou compartilhamento de dados com professores ou colegas.\r\n\r\n## EXECUTANDO O PROJETO:\r\n1. **Instalar as dependências**:\r\n   - Antes de rodar o bot, é essencial garantir que todas as dependências estejam instaladas. No terminal, navegue até o diretório `CODIGO` e execute o seguinte comando para instalar os pacotes listados no arquivo `requirements.txt`:\r\n     ```bash\r\n     pip install -r requirements.txt\r\n     ```\r\n\r\n2. **Execute o programa:**\r\n   - Para iniciar o programa, execute o comando abaixo:\r\n   ```bash\r\n   python main.py\r\n   ```\r\n\r\n3. **Escolha da Matéria:**\r\n   - Assim que o bot iniciar, você verá um menu principal no console com várias matérias numeradas.\r\n   - Leia as matérias disponíveis e digite o número correspondente à matéria que deseja responder.\r\n\r\n4. **Responda às perguntas:**\r\n   - O bot executará a matéria que você selecionou.\r\n   - Responda às perguntas corretamente, enviando apenas uma das opções: `A`, `B`, `C` ou `D`.\r\n   - Após apresentar o `RESULTADO FINAL`, o bot perguntará se você deseja salvar as informações. Envie `S` para confirmar ou qualquer outro caractere para recusar.\r\n\r\n5. **Retorno ao menu principal:**\r\n   - Após a execução de cada materia, o bot retornará automaticamente ao menu principal, permitindo que você escolha outra materia ou opte por sair.\r\n\r\n6. **Saindo do programa:**\r\n   - Quando desejar encerrar o programa, digite `0` no menu principal. Isso encerrará o bot de forma segura.\r\n\r\n## NÃO SABE?\r\n- Entendemos que para manipular arquivos em muitas linguagens e tecnologias, é necessário possuir conhecimento nessas áreas. Para auxiliar nesse aprendizado, oferecemos cursos gratuitos disponíveis:\r\n* [CURSO DE PYTHON](https://github.com/VILHALVA/CURSO-DE-PYTHON)\r\n* [CONFIRA MAIS CURSOS](https://github.com/VILHALVA?tab=repositories\u0026q=+topic:CURSO)\r\n\r\n## CREDITOS E MAIS:\r\n- [PROJETO CRIADO PELO VILHALVA](https://github.com/VILHALVA)\r\n- [CLIQUE AQUI PARA VER O HISTÓRICO DE ATUALIZAÇÕES](./UPDATES.md)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvilhalva%2Fquestoes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvilhalva%2Fquestoes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvilhalva%2Fquestoes/lists"}