How lancercrack25/agenda_alumnos works
Para orientar al principal software engineer en la creación de un diagrama de arquitectura/sistema para el proyecto “Sistema de Registro Académico (Agenda de Alumnos)”, siga estos pasos adaptados a la estructura y propósito específicos:
Identificar el tipo de proyecto y su propósito
• Es una aplicación de consola monolítica escrita en C, orientada a la gestión de registros académicos (alta, búsqueda, modificación, eliminación y despliegue de datos de alumnos).
• Se construye y ejecuta desde Code::Blocks, sin separación frontend/backend ni servicios externos.
Analizar la estructura de archivos
• Archivos clave en raíz:
• main.c (punto de entrada)
• Agenda_alumnos.cbp/.layout (proyecto de Code::Blocks)
• Directorios de build:
• bin/Debug/Agenda_alumnos.exe (ejecutable)
• obj/Debug/main.o (objeto compilado)
• No hay carpetas src/, lib/ ni tests/. Todo el código fuente reside en main.c y potencialmente otros .c/.h si existieran.
Extraer insights del README
• Funciones de negocio: gestión de alumnos y autenticación básica (clave “123” con 3 intentos).
• No hay mención de base de datos externa; presumiblemente usa estructuras en memoria o ficheros planos.
Componentes principales y sus interacciones
a. Interfaz de Usuario (CLI)
• Módulo que lee la clave y presenta el menú de opciones.
b. Módulo de Seguridad
• Valida la clave de acceso, cuenta intentos, aborta al tercer fallo.
c. Controlador de Alumnos
• Funciones: registrar, buscar, modificar, eliminar, mostrar.
• Recibe peticiones desde la interfaz y coordina con la capa de persistencia.
d. Capa de Persistencia
• Estructuras en memoria (arrays, listas) y/o ficheros planos para guardar registros.
• Funciones de carga y guardado (si existen).
e. Build & Deployment
• Code::Blocks: .cbp y .layout, genera .o en obj/ y .exe en bin/.
Relaciones:
• Usuario → CLI
• CLI → Seguridad (al inicio)
• CLI → Controlador de Alumnos
• Controlador ↔ Persistencia
Patrón arquitectónico y principios
• Arquitectura monolítica en capas lógicas:
• Capa de presentación (CLI)
• Capa de negocio (Controlador de Alumnos + Seguridad)
• Capa de datos (Persistencia)
• Principio de separación de responsabilidades: cada módulo hace sólo su tarea.
Guía para dibujar el diagrama
• Colocar bloques rectangulares para cada componente:
[Usuario/CLI], [Seguridad], [Controlador Alumnos], [Persistencia], [Sistema de archivos]
• Dibujar flechas direccionadas:
• Usuario → CLI → Seguridad
• CLI → Controlador Alumnos → Persistencia
• Persistencia → Sistema de archivos (si aplica)
• Añadir build artifacts en un rincón:
• Code::Blocks (.cbp/.layout) → compilación → obj/ → bin/
Elementos recomendados en el diagrama
• Etiquetas claras en cada bloque (“CLI”, “Auth Module”, “Student Controller”, “Storage”).
• Flechas gruesas para flujos de datos y finas para dependencias (build).
• Azul para interfaz (CLI)
• Rojo para seguridad
• Verde para lógica de negocio
• Naranja para persistencia
• Formas distintas (rectángulos para módulos, cilindro para capa de datos).
Nivel de detalle
• Incluir anotaciones sobre la clave de acceso y límite de 3 intentos.
• Indicar que la persistencia es en memoria o ficheros planos (según código).
• Señalar que todo corre sobre una sola máquina sin servicios externos.
Con esta guía, el diagrama capturará fielmente la arquitectura monolítica y sus componentes lógicos, con flujos claros y separación de responsabilidades.