BolivianRude 2026.1.28.114645

README - Proyecto Bolivian Rude

Descripción del Proyecto

Este proyecto es una aplicación de escritorio desarrollada en C# utilizando Windows Forms (WinForms). Su propósito principal es facilitar la creación del formulario RUDE (Registro Único de Estudiantes) en Bolivia, el cual cambia cada año. La aplicación permite diseñar el esquema del formulario, especificando dónde se deben mostrar los datos, y luego generar un PDF que puede ser impreso.

Características Principales

• Diseño de Formularios: Permite dibujar el esquema del formulario RUDE, especificando la ubicación de los elementos (texto, checkbox, etc.).
• Generación de PDF: Con un diccionario de datos del estudiante, la aplicación puede generar un PDF que puede ser descargado e impreso.
• Interfaz Gráfica: La aplicación cuenta con una interfaz gráfica intuitiva que facilita la creación y edición de los formularios.
• Manejo de Elementos: Los elementos del formulario (como texto, imágenes, etc.) pueden ser agregados, eliminados y modificados fácilmente.

Estructura del Proyecto

El proyecto está organizado en varios archivos y carpetas, incluyendo:

• IViewDocumentBuilder.cs: Define la interfaz IViewDocumentBuilder que gestiona la interacción entre la vista y el controlador para la creación de documentos.
• DocumentBuilderBuilder.cs: Contiene la lógica para manejar eventos de la interfaz de usuario, como la descarga del esquema de elementos en formato JSON.
• DocumentProperties.cs: Implementa la interfaz IViewDocumentProperties para gestionar las propiedades del documento, como el título y el tamaño de la fuente.
• ElementBasic.cs: Implementa la interfaz IElementTypeProperties para gestionar las propiedades básicas de los elementos del formulario, como posición y tamaño.
• Program.cs: Punto de entrada de la aplicación, donde se inicializa y ejecuta la interfaz de usuario.

Requisitos del Sistema

• .NET Framework: El proyecto está desarrollado en C# utilizando .NET Framework.
• Visual Studio: Se recomienda utilizar Visual Studio 2017 o superior para abrir y compilar el proyecto.
• Dependencias: El proyecto depende de varias bibliotecas y componentes de .NET, como System.Drawing y System.Windows.Forms.

Instrucciones de Uso

1. Clonar el Repositorio: Clona el repositorio del proyecto en tu máquina local.
2. Abrir en Visual Studio: Abre el archivo BolivianRude.sln en Visual Studio.
3. Compilar y Ejecutar: Compila el proyecto y ejecuta la aplicación.
4. Diseñar el Formulario: Utiliza la interfaz gráfica para diseñar el esquema del formulario RUDE.
5. Generar PDF: Introduce los datos del estudiante y genera el PDF correspondiente.

Pasos para publicar release

1. Instalar la CLI de nuget.exe. Descargar.
2. (Opcional) Agregar la ubicación de la CLI a la variable de entorno PATH para que se pueda invocar fácilmente.
3. Configurar API key de cuenta pj-sw de Nuget: nuget setApiKey ${apiKey}.
4. Ejecutar scr-publish-release.bat. Este script se encarga de generar un nuevo número de versión, en base a la fecha y hora actual; buildear el proyecto, empaquetarlo y pushearlo a NuGet.
5. ¡Listo! Puede revisar la nueva versión en la página de BolivianRude de NuGet.

Contribuciones

Si deseas contribuir al proyecto, por favor sigue los siguientes pasos:

1. Fork del Repositorio: Haz un fork del repositorio en GitHub.
2. Crear una Rama: Crea una nueva rama para tu contribución.
3. Realizar Cambios: Realiza los cambios necesarios en tu rama.
4. Enviar Pull Request: Envía un pull request para que tus cambios sean revisados e integrados.

Licencia

Este proyecto está bajo la licencia GNU General Public License v3.0. Para más detalles, consulta el archivo LICENSE en el repositorio.

Contacto

Si tienes alguna pregunta o sugerencia, no dudes en contactar al equipo de desarrollo a través de correo electrónico.

Este README proporciona una visión general del proyecto y cómo utilizarlo. Para más detalles, consulta los archivos de código fuente y los tests incluidos en el repositorio.