# devch-tech/java-oop-guide architecture

> Architecture diagram of the GitHub repository devch-tech/java-oop-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devch-tech/java-oop-guide
- Repository: https://github.com/devch-tech/java-oop-guide

## Overview

##### Tipo y propósito del proyecto (según README + árbol)
Este repositorio **no es una aplicación ejecutable** ni un sistema con “runtime architecture” (frontend/backend/DB). Es una **guía/curso modular** (documentación) sobre **POO en Java**, organizada por módulos temáticos, cada uno con su propio `README.md`.

Por lo tanto, el “mejor diagrama de arquitectura” aquí no es un diagrama de componentes desplegados, sino un **diagrama de información/contenido** que represente:
- **Estructura curricular** (módulos como unidades)
- **Relaciones de dependencia conceptual** (qué conceptos se apoyan en otros)
- **Rutas de aprendizaje** (secuencias recomendadas)
- (Opcional) **trazas hacia ejercicios** y refuerzos prácticos

##### Análisis del file tree (qué componentes existen)
Componentes reales del repo:
- `README.md` raíz: índice y descripción global.
- Carpetas por módulo (cada una con `README.md`):
- `Módulo-01-Introducción-POO`
- `Módulo-02-Clases-y-Objetos`
- `Módulo-03-Encapsulamiento`
- `Módulo-04-Herencia`
- `Módulo-05-Polimorfismo`
- `Módulo-06-Abstracción`
- `Módulo-06-Interfaces`
- `Módulo-07-Constructores-y-Sobrecarga-de-Constructores`
- `Módulo-08-Sobrecarga-y-Sobrescritura-de-Métodos`
- `Módulo-09-Métodos-de-Instancia-y-Métodos-Estáticos`
- `Módulo-10-Variables-de-Instancia-y-Variables-de-Clase`
- `Módulo-12-Clases-Internas-y-Anónimas`
- `Módulo-13-Principios-SOLID`
- `Módulo-14-Modificadores-de-Acceso`
- `Módulo-15-Buenas-Prácticas-en-POO`
- `Módulo-16-Ejercicios`
- No hay `src/`, `pom.xml`, `build.gradle`, `tests/`, ni código Java en el árbol mostrado. O sea, **el sistema es contenido** (documentación), no software.

##### Señales en el README útiles para el diagrama
El README raíz define:
- “Guía completa… paso a paso” → sugiere un **grafo de progresión**.
- Lista de módulos con temas → perfecto para un **mapa de módulos**.
- Recursos externos (links, libros, comunidades) → se pueden representar como **sistemas externos** conectados al “curso”.
- Créditos/licencia implícita → opcional como “restricciones/uso”.

##### Identifica los componentes principales (bloques)
Para este repo, separa en componentes como si fuera un sistema de conocimiento:

##### Portal/Índice
- `README.md` (raíz)
- Rol: navegación, tabla de contenidos, visión global.

##### Módulos de teoría base
- M01 Introducción POO
- M02 Clases y Objetos
- M03 Encapsulamiento
- M04 Herencia
- M05 Polimorfismo
- M06 Abstracción
- M06 Interfaces

##### Módulos de mecanismos del lenguaje
- M07 Constructores + sobrecarga de constructores
- M08 Sobrecarga vs sobrescritura
- M09 Métodos instancia vs estáticos
- M10 Variables instancia vs clase
- M12 Clases internas y anónimas
- M14 Modificadores de acceso (aunque es “concepto”, actúa como mecánica del lenguaje)

##### Módulos de diseño/práctica profesional
- M13 SOLID
- M15 Buenas prácticas

##### Práctica
- M16 Ejercicios

##### Ecosistema externo
- Oracle Java Docs
- Java Design Patterns
- YouTube Píldoras Informáticas
- GeeksForGeeks
- Libros
- Comunidades/foros

##### Determina relaciones e interacciones (flechas)
Aquí no hay “llamadas API”, pero sí relaciones que tu diagrama debe reflejar explícitamente:

##### Relación de navegación (estructura del repo)
- `README.md (raíz)` → enlaza a → cada `Módulo-XX/README.md`

##### Relación de prerrequisitos conceptuales (grafo de dependencias)
Una propuesta razonable (ajústala si dentro de cada módulo hay otra recomendación):
- M01 → M02
- M02 → M03 (encapsulación depende de clase/objeto)
- M03 → M14 (o M14 → M03, según cómo lo expliques; normalmente acceso/modificadores habilitan encapsulación)
- M02 → M07 (constructores son parte de clases)
- M02 → M10 (variables de instancia/clase)
- M02 → M09 (métodos de instancia/estáticos)
- M04 (herencia) depende de M02 y suele ir después de M03
- M05 (polimorfismo) depende de M04 y M08 (sobrescritura)
- M06 Abstracción depende de M04/M05 (o al menos de clases/interfaces)
- M06 Interfaces se conecta fuerte con:
- M05 (polimorfismo vía interface)
- M06 Abstracción (contratos)
- M08 (sobrecarga/sobrescritura) depende de M02; sobrescritura depende de M04.
- M12 (internas/anónimas) depende de M02 y se conecta con Interfaces (clases anónimas implementando interfaces)
- M13 SOLID depende de tener claros: encapsulación, herencia, polimorfismo, abstracción e interfaces
- M15 Buenas prácticas depende de todo lo anterior
- M16 Ejercicios consume/refuerza todos (flechas desde teoría → ejercicios)

##### Relación “refuerzo”
- Cada módulo teórico → “aplica en” → M16 Ejercicios
- M13/M15 → “guía el diseño” de soluciones de ejercicios

##### Relación con recursos externos
- `Guía` (o `README raíz`) → “referencia” → recursos externos
- O, si lo quieres más útil: conecta recursos a los módulos donde son más relevantes (ej. Oracle Docs ↔ módulos de lenguaje; Design Patterns ↔ SOLID/buenas prácticas)

##### Patrones / principios importantes a resaltar (en el diagrama)
En vez de patrones de microservicios, aquí destacas “arquitectura pedagógica”:
- **Modularización**: cada tema aislado en un módulo/carpeta.
- **Progresión incremental**: base → mecanismos → diseño → práctica.
- **Separación de concerns**: teoría vs ejercicios vs recursos externos.
- **Grafo de dependencias**: no todo es lineal; algunas unidades dependen de varias anteriores (p.ej. SOLID).

##### Tecnologías / “stack”
Tecnología principal: **Java (POO)** como dominio.
Formato: **Markdown** (`README.md`) como medio.
Plataforma: **Git/GitHub** como distribución (implícito).

##### Guías para adaptar el diagrama al “tipo de proyecto” (doc/curso)
Para este tipo (guía educativa/documentación), prioriza:

##### Diagrama 1: “Mapa de módulos” (vista estructural del repositorio)
- Un nodo “Repositorio / Guía POO en Java”
- Hijo: `README.md (índice)`
- Hijos: Módulo-01…Módulo-16
- Esto representa la arquitectura “física” del contenido.

##### Diagrama 2: “Grafo de dependencias conceptuales” (vista lógica)
- Nodos = módulos
- Flechas = “prerrequisito” o “depende de”
- Esto es lo más valioso para entender el “sistema” como producto pedagógico.

##### Diagrama 3 (opcional): “Ruta de aprendizaje”
- Un flujo principal (happy path) numerado
- Ramas opcionales (p.ej. M12 puede ir después; recursos externos como laterales)

Si solo puedes hacer **un** diagrama: haz el **grafo conceptual**, porque captura estructura + intención.

##### Elementos que debe incluir el diagrama (concretos y detallados)
Para que sea “muy detallado” sin sobrepensar:

- **Etiquetas claras**: usa exactamente los nombres de carpeta/módulo (tal cual el repo).
- **Tipos de flechas** (con leyenda):
- Flecha sólida: “prerrequisito”
- Flecha punteada: “referencia / complementa”
- Flecha gruesa: “ruta recomendada”
- Azul: fundamentos (M01–M06)
- Morado: mecanismos del lenguaje (M07–M12, M14)
- Verde: diseño/calidad (M13, M15)
- Naranja: práctica (M16)
- Gris: recursos externos
- **Nivel de detalle recomendado**:
- No agrupar demasiado pronto: incluye cada módulo como nodo individual.

##### Plantilla sugerida (qué dibujar literalmente)
Dibuja 3 clusters horizontales:

##### Estructura del repo
- `README raíz` → (links) → cada `Módulo-XX/README`

##### Dependencias conceptuales
- Cadena principal: M01 → M02 → M03 → M04 → M05 → (M06 Abstracción + M06 Interfaces) → M13 → M15 → M16
- Conexiones laterales:
- M02 → M07, M08, M09, M10
- M04 → M08 (sobrescritura)
- Interfaces ↔ M12 (anónimas)
- M14 ↔ M03 (encapsulamiento) y también afecta M04 (protected)
- Todos → M16

##### Ecosistema
- `Guía` → recursos (Oracle Docs, patrones, etc.)

Si me pegas el contenido de 2–3 READMEs de módulos (p.ej. M03, M04, M06), puedo ayudarte a afinar las flechas de prerrequisito (algunas guías enseñan “abstracción” antes de “herencia”, etc.) y a escoger el “happy path” exacto para el diagrama final.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% CONTENEDOR / CONTEXTO
  %% =========================
  subgraph "Repositorio: Guía/Curso de POO en Java (Markdown)"
    Guide["Guía POO en Java\n(Contenido educativo, no ejecutable)"]:::course
    Index["README.md (Portal/Índice)"]:::index
    Guide -->|"navega"| Index
  end

  %% =========================
  %% ESTRUCTURA + DEPENDENCIAS (VERTICAL)
  %% =========================
  subgraph "Mapa curricular (módulos) + dependencias conceptuales"
    direction TB

    %% ---- Fundamentos (Azul) ----
    subgraph "Fundamentos (M01–M06)"
      direction TB
      M01["Módulo-01-Introducción-POO"]:::fund
      M02["Módulo-02-Clases-y-Objetos"]:::fund
      M03["Módulo-03-Encapsulamiento"]:::fund
      M04["Módulo-04-Herencia"]:::fund
      M05["Módulo-05-Polimorfismo"]:::fund
      M06A["Módulo-06-Abstracción"]:::fund
      M06I["Módulo-06-Interfaces"]:::fund
    end

    %% ---- Mecánicas del lenguaje (Morado) ----
    subgraph "Mecánicas del lenguaje (M07–M12, M14)"
      direction TB
      M07["Módulo-07-Constructores-y-Sobrecarga-de-Constructores"]:::mech
      M08["Módulo-08-Sobrecarga-y-Sobrescritura-de-Métodos"]:::mech
      M09["Módulo-09-Métodos-de-Instancia-y-Métodos-Estáticos"]:::mech
      M10["Módulo-10-Variables-de-Instancia-y-Variables-de-Clase"]:::mech
      M12["Módulo-12-Clases-Internas-y-Anónimas"]:::mech
      M14["Módulo-14-Modificadores-de-Acceso"]:::mech
    end

    %% ---- Diseño/Calidad (Verde) ----
    subgraph "Diseño y calidad (profesional)"
      direction TB
      M13["Módulo-13-Principios-SOLID"]:::design
      M15["Módulo-15-Buenas-Prácticas-en-POO"]:::design
    end

    %% ---- Práctica (Naranja) ----
    subgraph "Práctica"
      direction TB
      M16["Módulo-16-Ejercicios"]:::practice
    end
  end

  %% =========================
  %% ECOSISTEMA EXTERNO
  %% =========================
  subgraph "Ecosistema externo (recursos)"
    direction TB
    Ext["Recursos externos\n(docs, patrones, cursos, libros, comunidades)"]:::external
    Oracle["Oracle Java Docs"]:::external
    Patterns["Java Design Patterns"]:::external
    YT["YouTube: Píldoras Informáticas"]:::external
    GFG["GeeksForGeeks"]:::external
    Books["Libros"]:::external
    Forums["Comunidades/foros"]:::external

    Ext -->|"incluye"| Oracle
    Ext -->|"incluye"| Patterns
    Ext -->|"incluye"| YT
    Ext -->|"incluye"| GFG
    Ext -->|"incluye"| Books
    Ext -->|"incluye"| Forums
  end

  %% =========================
  %% NAVEGACIÓN (README RAÍZ -> MÓDULOS)
  %% =========================
  Index -->|"link"| M01
  Index -->|"link"| M02
  Index -->|"link"| M03
  Index -->|"link"| M04
  Index -->|"link"| M05
  Index -->|"link"| M06A
  Index -->|"link"| M06I
  Index -->|"link"| M07
  Index -->|"link"| M08
  Index -->|"link"| M09
  Index -->|"link"| M10
  Index -->|"link"| M12
  Index -->|"link"| M14
  Index -->|"link"| M13
  Index -->|"link"| M15
  Index -->|"link"| M16

  %% =========================
  %% RUTA RECOMENDADA (GRUESA)
  %% =========================
  M01 ==>|"ruta_recomendada"| M02
  M02 ==>|"ruta_recomendada"| M03
  M03 ==>|"ruta_recomendada"| M04
  M04 ==>|"ruta_recomendada"| M05
  M05 ==>|"ruta_recomendada"| M06A
  M06A ==>|"ruta_recomendada"| M06I
  M06I ==>|"ruta_recomendada"| M13
  M13 ==>|"ruta_recomendada"| M15
  M15 ==>|"ruta_recomendada"| M16

  %% =========================
  %% PRERREQUISITOS (SÓLIDA)
  %% =========================
  M02 -->|"prerrequisito"| M07
  M02 -->|"prerrequisito"| M08
  M02 -->|"prerrequisito"| M09
  M02 -->|"prerrequisito"| M10

  M03 -->|"prerrequisito"| M04
  M04 -->|"prerrequisito"| M05
  M08 -->|"prerrequisito"| M05

  M04 -->|"prerrequisito"| M06A
  M05 -->|"prerrequisito"| M06A
  M05 -->|"prerrequisito"| M06I
  M06A -->|"prerrequisito"| M06I

  M02 -->|"prerrequisito"| M12
  M06I -->|"prerrequisito"| M12

  M02 -->|"prerrequisito"| M14
  M14 -->|"prerrequisito"| M03
  M14 -->|"prerrequisito"| M04

  M03 -->|"prerrequisito"| M13
  M04 -->|"prerrequisito"| M13
  M05 -->|"prerrequisito"| M13
  M06A -->|"prerrequisito"| M13
  M06I -->|"prerrequisito"| M13

  %% =========================
  %% REFUERZO (PUNTEADA) -> EJERCICIOS
  %% =========================
  M01 -.->|"aplica_en"| M16
  M02 -.->|"aplica_en"| M16
  M03 -.->|"aplica_en"| M16
  M04 -.->|"aplica_en"| M16
  M05 -.->|"aplica_en"| M16
  M06A -.->|"aplica_en"| M16
  M06I -.->|"aplica_en"| M16
  M07 -.->|"aplica_en"| M16
  M08 -.->|"aplica_en"| M16
  M09 -.->|"aplica_en"| M16
  M10 -.->|"aplica_en"| M16
  M12 -.->|"aplica_en"| M16
  M14 -.->|"aplica_en"| M16
  M13 -.->|"guia_diseno"| M16
  M15 -.->|"guia_diseno"| M16

  %% =========================
  %% RECURSOS EXTERNOS (PUNTEADA)
  %% =========================
  Index -.->|"referencia"| Ext
  Oracle -.->|"apoya"| M07
  Oracle -.->|"apoya"| M08
  Oracle -.->|"apoya"| M09
  Oracle -.->|"apoya"| M10
  Oracle -.->|"apoya"| M12
  Oracle -.->|"apoya"| M14
  Patterns -.->|"complementa"| M13
  Patterns -.->|"complementa"| M15
  YT -.->|"refuerza"| M01
  YT -.->|"refuerza"| M02
  GFG -.->|"refuerza"| M07
  GFG -.->|"refuerza"| M08
  Books -.->|"profundiza"| M13
  Forums -.->|"ayuda"| M16

  %% =========================
  %% CLICK EVENTS (component_mapping)
  %% =========================
  click Index "https://github.com/devch-tech/java-oop-guide/blob/main/README.md"
  click M01 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-01-Introducción-POO/README.md"
  click M02 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-02-Clases-y-Objetos/README.md"
  click M03 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-03-Encapsulamiento/README.md"
  click M04 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-04-Herencia/README.md"
  click M05 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-05-Polimorfismo/README.md"
  click M06A "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-06-Abstracción/README.md"
  click M06I "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-06-Interfaces/README.md"
  click M07 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-07-Constructores-y-Sobrecarga-de-Constructores/README.md"
  click M08 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-08-Sobrecarga-y-Sobrescritura-de-Métodos/README.md"
  click M09 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-09-Métodos-de-Instancia-y-Métodos-Estáticos/README.md"
  click M10 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-10-Variables-de-Instancia-y-Variables-de-Clase/README.md"
  click M12 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-12-Clases-Internas-y-Anónimas/README.md"
  click M14 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-14-Modificadores-de-Acceso/README.md"
  click M13 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-13-Principios-SOLID/README.md"
  click M15 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-15-Buenas-Prácticas-en-POO/README.md"
  click M16 "https://github.com/devch-tech/java-oop-guide/blob/main/Módulo-16-Ejercicios/README.md"

  %% =========================
  %% STYLES (COLOR)
  %% =========================
  classDef course fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#e2e8f0
  classDef index fill:#0b3a6e,stroke:#60a5fa,stroke-width:2px,color:#ffffff
  classDef fund fill:#1d4ed8,stroke:#93c5fd,stroke-width:2px,color:#ffffff
  classDef mech fill:#6d28d9,stroke:#c4b5fd,stroke-width:2px,color:#ffffff
  classDef design fill:#15803d,stroke:#86efac,stroke-width:2px,color:#ffffff
  classDef practice fill:#c2410c,stroke:#fdba74,stroke-width:2px,color:#ffffff
  classDef external fill:#374151,stroke:#9ca3af,stroke-width:2px,color:#f9fafb
```
