CodeQuest

CodeQuest es una aplicacion de escritorio para Windows, desarrollada en C# y .NET, que permite administrar y jugar un cuestionario enfocado en conocimiento de desarrollo. La solucion utiliza patrones de diseno modernos (repositorio, servicios y factory) y una base de datos SQL local.

Tabla de contenido

• Descripcion general
• Tecnologias
• Requisitos
• Instalacion y ejecucion
• Base de datos
• Arquitectura y componentes principales
• Estructura del proyecto

Descripcion general

CodeQuest permite gestionar jugadores, administradores, preguntas y rondas, y tocar la logica.

A continuacion se describen los componentes principales y la estructura del proyecto.

Tecnologias

• Lenguaje: C#
• Plataforma: .NET 8.0 para Windows
• Interfaz: Windows Forms
• Almacenamiento: SQL Server LocalDB (archivo CodeQuest.sql)
• Patrones: Repositorio, Servicios y Factory (DI)

Requisitos

• .NET SDK 8.0 o superior (Windows)
• Windows 10/11
• SQL Server LocalDB o SQL Server Express

Instalacion y ejecucion

• Opcion 1: Abrir la solucion en Visual Studio y sincronizar paquetes, luego ejecutar.
• Opcion 2: Siguientes comandos:
  • dotnet restore
  • dotnet build CodeQuest.sln
  • dotnet run --project CodeQuest.csproj

Base de datos

• El esquema se encuentra en Database/CodeQuest.sql
• Inicializar la base de datos ejecutando ese archivo en su servidor
• La cadena de conexion se define en Database/DbConnection.cs

Arquitectura y componentes principales

CodeQuest implementa:

• Repositorios para el acceso a datos: Repositories/QuestionRepository.cs y Repositories/AdministratorRepository.cs
• Servicios de negocio: Services/GameService.cs, Services/AdministratorService.cs y Services/IGameService.cs
• Interfaces de repositorio y servicio: Repositories/IQuestionRepository.cs, Services/IGameService.cs
• Fábrica de servicios (inyeccion de dependencias): Factories/ServiceFactory.cs
• Interfaz y logicas de la UI: FormLogin.cs, FormStart.cs, FormQuestionManagement.cs, FormQuestions.cs, FormFinalResults.cs, FormRanking.cs, FormInformation.cs, FormAdminManagement.cs, FormAdminLocker.cs, FormManageOptions.cs
• Punto de entrada y proyecto: Program.cs y CodeQuest.csproj

Estructura del proyecto

• Carpeta Database: Database/CodeQuest.sql
• Carpeta Models: Models/Administrator.cs, Models/Question.cs, Models/User.cs, Models/Round.cs
• Carpeta Repositories: Repositories/IQuestionRepository.cs, Repositories/QuestionRepository.cs, Repositories/IAdministratorRepository.cs, Repositories/AdministratorRepository.cs
• Carpeta Services: Services/IGameService.cs, Services/GameService.cs, Services/IAdministratorService.cs, Services/AdministratorService.cs
• Carpeta Factories: Factories/ServiceFactory.cs
• Formas de UI: FormLogin.cs, FormStart.cs, FormQuestionManagement.cs, FormQuestions.cs, FormFinalResults.cs, FormRanking.cs, FormInformation.cs, FormAdminManagement.cs, FormAdminLocker.cs, FormManageOptions.cs, FormQuestionManagement.cs
• Archivo de entrada: Program.cs
• Solucion: ProyectoFinalHerramientasII.sln

Guía paso a paso (tour visual)

Pre:

Modos de Inicio del software:

A. Modo 1

Screenshots/iniciaropcion1.png

B. Modo 2

Screenshots/iniciaropcion2.png

1. Inicio — Pantalla principal Una vista rápida del inicio de la aplicación y navegación principal.

   
   Screenshots/inicio.png

2. Inicio de sesión — Acceso de usuarios y administradores Verifica credenciales y accede a las opciones.

   
   Screenshots/login.png

3. Panel de administración — Control central Desde aquí se gestiona el acceso a módulos de administración.

   
   Screenshots/paneladmin.png

4. Gestión de administradores y opciones Crear/editar administradores y configurar opciones del sistema.

   
   Screenshots/gestoradmin.png

5. Gestión de preguntas Añade, edita y organiza preguntas y categorías.

   
   Screenshots/gestorpreguntas.png

6. Juego — Inicio y desarrollo de una ronda Muestra del flujo de juego (opciones de inicio y pantalla de ronda).

   
   Screenshots/iniciaropcion1.png

7. Resultados finales y pantalla de ronda Resumen de puntajes y detalles de la ronda finalizada.

   
   Screenshots/resultados.png

8. Base de datos y carga de scripts Visual del esquema y la herramienta de carga de scripts.

   
   Screenshots/scriptDB.png
Screenshots/cargascript.png

   Normalización de la base de datos — explicación paso a paso Las siguientes imágenes muestran cómo se aplicaron las formas normales al esquema. Cada paso incluye una breve explicación y el enlace al archivo original en la carpeta Screenshots.

   1. Primera forma normal (1FN) — separar valores repetidos y multivaluados
      Screenshots/1FN1.png
Screenshots/1FN2.png

   2. Segunda forma normal (2FN) — eliminar dependencias parciales
      Screenshots/2FN.png

   3. Tercera forma normal (3FN) — eliminar dependencias transitivas y refinar claves
      Screenshots/3FN.png

9. Información y Ranking Páginas informativas y listado de ranking de usuarios.

   
   Screenshots/informacion.png

   
   Screenshots/rankingusuario.png