# lancercrack25/agenda_alumnos architecture

> Architecture diagram of the GitHub repository lancercrack25/agenda_alumnos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lancercrack25/agenda_alumnos
- Repository: https://github.com/lancercrack25/agenda_alumnos

## Overview

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.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Main user interaction
    User["User"]:::external
    CLI["CLI Interface"]:::frontend
    Auth["Auth Module\n(3 attempts, key '123')"]:::security
    Controller["Student Controller"]:::business
    Persistence["Persistence Layer"]:::persistence
    FS["File System\n(flat files)"]:::persistence

    %% Application monolith
    subgraph "Academic Registration System"
        direction TB
        CLI --> Auth
        CLI --> Controller
        Controller --> Persistence
        Persistence --> FS
    end

    User --> CLI

    %% Build & Deployment artifacts
    subgraph "Build & Deployment"
        direction TB
        CBP["Code::Blocks Config\nAgenda_alumnos.cbp"]:::artifacts
        LAY["Code::Blocks Layout\nAgenda_alumnos.layout"]:::artifacts
        OBJ["Compiled Obj\nobj/Debug/main.o"]:::artifacts
        EXE["Executable\nbin/Debug/Agenda_alumnos.exe"]:::artifacts
        README["Documentation\nREADME.md"]:::artifacts

        CBP --> OBJ
        OBJ --> EXE
    end

    %% Click Events
    click CLI "https://github.com/lancercrack25/agenda_alumnos/blob/master/main.c"
    click Auth "https://github.com/lancercrack25/agenda_alumnos/blob/master/main.c"
    click Controller "https://github.com/lancercrack25/agenda_alumnos/blob/master/main.c"
    click Persistence "https://github.com/lancercrack25/agenda_alumnos/blob/master/main.c"
    click CBP "https://github.com/lancercrack25/agenda_alumnos/blob/master/Agenda_alumnos.cbp"
    click LAY "https://github.com/lancercrack25/agenda_alumnos/blob/master/Agenda_alumnos.layout"
    click OBJ "https://github.com/lancercrack25/agenda_alumnos/blob/master/obj/Debug/main.o"
    click EXE "https://github.com/lancercrack25/agenda_alumnos/blob/master/bin/Debug/Agenda_alumnos.exe"
    click README "https://github.com/lancercrack25/agenda_alumnos/blob/master/README.md"

    %% Styles
    classDef external fill:#bbbbbb,stroke:#333,stroke-width:1px;
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px;
    classDef security fill:#F08080,stroke:#333,stroke-width:1px;
    classDef business fill:#90EE90,stroke:#333,stroke-width:1px;
    classDef persistence fill:#FFA500,stroke:#333,stroke-width:1px;
    classDef artifacts fill:#D3D3D3,stroke:#333,stroke-width:1px;
```
