# z4no/ajedrezwpf architecture

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

- Interactive diagram: https://gitdiagram.com/z4no/ajedrezwpf
- Repository: https://github.com/z4no/ajedrezwpf

## Overview

Para dibujar un diagrama de arquitectura claro y preciso de AjedrezWPF, sigue estas indicaciones específicas basadas en la estructura de archivos y la descripción del README:

##### Identificación del tipo de proyecto y propósito
- Es una aplicación de escritorio (WPF) en C#/.NET 8.0 para jugar ajedrez.
- No hay servicio web ni base de datos externa: toda la lógica y la UI residen en un solo ejecutable.

##### Análisis de la estructura de archivos
- Carpeta raíz: contiene la solución (`.sln`), el proyecto WPF (`AjedrezWPF.csproj`), README, licencia, imágenes y binarios.
- AjedrezWPF/: proyecto WPF con:
- App.xaml / App.xaml.cs – configuración y arranque de la aplicación.
- MainWindow.xaml / MainWindow.xaml.cs – vista principal y “controller” de la interfaz.
- Casillas.cs – modelo de cada casilla (estado, coordenadas).
- Imgs/ – recursos gráficos de las piezas.
- No hay servicios externos ni base de datos.

##### Componentes principales para el diagrama
a) Capa de Presentación (UI)
- App.xaml
- MainWindow.xaml (vista)
- MainWindow.xaml.cs (manejadores de eventos, renderizado del tablero).
b) Modelo de Dominio
- Casillas (clase que representa el tablero).
- Pieza (clase que representa cada pieza y sus reglas de movimiento).
c) Lógica de Negocio / Motor de Juego
- Dentro de MainWindow.xaml.cs (validación de movimientos, detección de jaque/jaque mate, control de turno).
- Podrías extraer en un componente “GameEngine” para mayor claridad.
d) Recursos
- Imgs/ (íconos de las piezas).
e) Entorno de ejecución
- .NET 8.0 Runtime
- Windows 10+
- setup.exe / AjedrezWPF.exe

##### Relaciones e interacciones
- La UI instancia el modelo `Casillas` para generar el tablero.
- Cada casilla contiene referencias a objetos `Pieza`.
- Cuando el usuario hace clic en la UI, `MainWindow.xaml.cs` recibe el evento, invoca la validación de movimientos (lógica de negocio), actualiza los modelos y refresca la vista.
- Las imágenes se cargan desde `Imgs/` según el tipo de pieza para renderizar.
- La aplicación arranca mediante App.xaml que lanza MainWindow.

##### Patrones y principios arquitectónicos
- MVC/MVVM ligero:
- Modelos puros: `Casillas`, `Pieza`.
- Vista: XAML.
- Controlador / View-Code: MainWindow.xaml.cs (eventos, coordinación).
- Separación de responsabilidades: UI ↔ Modelo ↔ Lógica de reglas.
- En un refinamiento futuro se puede extraer la lógica de reglas a un servicio o clase `GameEngine`.

##### Cómo dibujar el diagrama
- Capa Lógica/Modelo (verde)
- Recursos (amarillo)
- Entorno/Plataforma (gris)
b) Dentro de la capa UI coloca:
- App.xaml → MainWindow.xaml → Controles gráficos (tablero UI)
c) En Capa Lógica/Modelo:
- Casillas ←→ Pieza ←→ GameEngine (reglas de validación)
d) Flechas direccionadas:
- Usuario → UI (clic)
- UI → Lógica de Negocio (validarMovimiento())
- Lógica de Negocio → Modelo (actualizar estado de Casillas/Pieza)
- Modelo → UI (evento de refresco de vista)
- UI → Recursos (carga de imágenes)
- App.xaml → MainWindow (inicio de la aplicación)
e) Al margen o fondo, agrupa:
- .NET 8.0 Runtime
- Windows 10+
- setup.exe / AjedrezWPF.exe

##### Elementos del diagrama
- Etiquetas claras: nombre de cada clase/componente.
- Flechas con direccionalidad: flujo de datos/eventos.
- Colores o formas distintas para distinguir capas.
- Leyenda que explique colores y símbolos.

Con este enfoque, tendrás un diagrama detallado que muestre cómo fluye la lógica desde la UI hasta los modelos de ajedrez, cómo se validan los movimientos y cómo se integran los recursos gráficos, todo enmarcado dentro de la plataforma WPF/.NET.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External actor
    User["Usuario"]:::external

    subgraph "Capa UI"
        direction TB
        App["App.xaml"]:::ui
        AppCS["App.xaml.cs"]:::ui
        MainView["MainWindow.xaml"]:::ui
        MainCode["MainWindow.xaml.cs"]:::ui
        Controls["Controles UI (Tablero)"]:::ui
    end

    subgraph "Lógica/Modelo"
        direction TB
        GameEngine["GameEngine"]:::logic
        Casillas["Casillas"]:::logic
        Pieza["Pieza"]:::logic
    end

    subgraph "Recursos"
        direction TB
        Imgs["Imgs/"]:::resource
    end

    subgraph "Entorno/Plataforma"
        direction TB
        DotNet[".NET 8.0 Runtime"]:::platform
        Win["Windows 10+"]:::platform
        Setup["setup.exe / AjedrezWPF.exe"]:::platform
        CSProj["AjedrezWPF.csproj"]:::platform
        SLN["AjedrezWPF.sln"]:::platform
    end

    %% Connections
    User -->|"clic"| Controls
    Controls -->|"evento Click"| MainCode
    MainCode -->|"validaMovimiento()"| GameEngine
    GameEngine -->|"actualiza modelo"| Casillas
    GameEngine -->|"actualiza modelo"| Pieza
    Casillas -->|"refresca vista"| MainCode
    Pieza -->|"refresca vista"| MainCode
    MainCode -->|"carga imágenes"| Imgs
    App -->|"inicia"| MainView
    AppCS -->|"inicia"| MainView

    %% Click Events
    click App "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/App.xaml"
    click AppCS "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/App.xaml.cs"
    click MainView "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/MainWindow.xaml"
    click MainCode "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/MainWindow.xaml.cs"
    click Casillas "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/Casillas.cs"
    click Pieza "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/Pieza.cs"
    click Imgs "https://github.com/z4no/ajedrezwpf/tree/master/AjedrezWPF/Imgs/"
    click CSProj "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF/AjedrezWPF.csproj"
    click SLN "https://github.com/z4no/ajedrezwpf/blob/master/AjedrezWPF.sln"

    %% Styles
    classDef ui fill:#CFEFFF,stroke:#03689A,stroke-width:1px
    classDef logic fill:#DFFFE0,stroke:#2E7D32,stroke-width:1px
    classDef resource fill:#FFF9C4,stroke:#F9A825,stroke-width:1px
    classDef platform fill:#ECEFF1,stroke:#455A64,stroke-width:1px
    classDef external fill:#FFCCBC,stroke:#BF360C,stroke-width:1px,stroke-dasharray: 5 5
```
