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
- Clonar el Repositorio: Clona el repositorio del proyecto en tu máquina local.
- Abrir en Visual Studio: Abre el archivo
BolivianRude.sln
en Visual Studio.
- Compilar y Ejecutar: Compila el proyecto y ejecuta la aplicación.
- Diseñar el Formulario: Utiliza la interfaz gráfica para diseñar el esquema del formulario RUDE.
- Generar PDF: Introduce los datos del estudiante y genera el PDF correspondiente.
Contribuciones
Si deseas contribuir al proyecto, por favor sigue los siguientes pasos:
- Fork del Repositorio: Haz un fork del repositorio en GitHub.
- Crear una Rama: Crea una nueva rama para tu contribución.
- Realizar Cambios: Realiza los cambios necesarios en tu rama.
- 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.
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.
Diccionario de Datos Estudiantiles - Explicación
Documentación de los campos con valores de ejemplo y descripción
📚 Datos Básicos del Estudiante
Clave |
Valor Ejemplo |
Descripción |
codigo_sie |
81890091 |
Código SIE |
codigo_rude |
123456 |
Código RUDE (Registro Único de Estudiantes) |
apellido_paterno |
Gonzales |
Apellido del padre del estudiante |
apellido_materno |
Perez |
Apellido de la madre del estudiante |
nombres |
Maria Fernanda |
Nombres completos del estudiante |
♀️ Género
Clave |
Valor Ejemplo |
Descripción |
es_genero_masculino |
false |
Indica si el género es masculino |
es_genero_femenino |
true |
Indica si el género es femenino |
🎂 Datos de Nacimiento
Clave |
Valor Ejemplo |
Descripción |
nacimiento_fecha_dia |
15 |
Día de nacimiento (formato 00 ) |
nacimiento_fecha_mes |
05 |
Mes de nacimiento (formato 00 ) |
nacimiento_fecha_anho |
2010 |
Año de nacimiento |
nacimiento_lugar_pais |
BOLIVIA |
País de nacimiento |
nacimiento_lugar_provincia |
Andrés Ibáñez |
Provincia de nacimiento |
nacimiento_lugar_departamento |
Santa Cruz |
Departamento de nacimiento |
nacimiento_lugar_localidad |
Santa Cruz de la Sierra |
Ciudad/Localidad de nacimiento |
🆔 Documento de Identidad
Clave |
Valor Ejemplo |
Descripción |
carnet_de_id_numero |
1234567 |
Número de carnet de identidad |
carnet_de_id_complemento |
01 |
Letra complementaria del carnet |
carnet_de_id_expedido |
SC |
Lugar de expedición (Siglas de departamento) |
🏫 Escolaridad
Clave |
Valor Ejemplo |
Descripción |
anho_de_escolaridad_primaria_3 |
true |
Grado actual (ej: true = 3er año de primaria) |
anho_de_escolaridad_secundaria_2 |
false |
Para otros grados (se desactivan) |
Clave |
Valor Ejemplo |
Descripción |
direccion_zona_o_villa |
Barrio Los Olivos |
Zona/Barrio de residencia |
direccion_avenida_o_calle |
Calle Junín |
Calle principal de domicilio |
direccion_numero_de_vivienda |
1234 |
Número de casa/departamento |
direccion_telefono_fijo |
3344556 |
Teléfono fijo de contacto |
direccion_celular_de_contacto |
77889900 |
Celular de contacto |
👨 Situación Familiar
Clave |
Valor Ejemplo |
Descripción |
estudiante_vive_con_padre_y_madre |
true |
Vive con ambos padres |
estudiante_vive_con_solo_madre |
false |
Vive solo con la madre |
estudiante_vive_con_tutor_o_tutora |
false |
Vive con tutor legal |
📝 Datos del Apoderado
Clave |
Valor Ejemplo |
Descripción |
apoderado_nombres |
Juan Carlos |
Nombres completos del apoderado |
apoderado_carnet_de_id_numero |
9876543 |
Carnet de identidad del apoderado |
apoderado_carnet_de_id_expedido |
SC |
Lugar de expedición del carnet |
📅 Registro
Clave |
Valor Ejemplo |
Descripción |
fecha_de_registro_dia |
15 |
Día de registro actual |
fecha_de_registro_mes |
07 |
Mes de registro actual |
fecha_de_registro_anho |
2024 |
Año de registro actual |
lugar_departamento |
SANTA CRUZ |
Departamento donde se realiza el registro |