# sistematicosavbui/el-lado-oscuro-del-carrito architecture

> Architecture diagram of the GitHub repository sistematicosavbui/el-lado-oscuro-del-carrito, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sistematicosavbui/el-lado-oscuro-del-carrito
- Repository: https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito

## Overview

A. Proyecto y propósito
##### Tipo de proyecto
- Biblioteca C++ expuesta a Python mediante pybind11.
- Sistema de compilación con CMake que genera módulos Python (.so/.pyd) en compilados_py/Release.
##### Objetivo
- Compilar código C++ (src/cpp + src/include) y bindings (src/bindings) en extensiones Python.
- Proveer scripts de prueba y aplicación en Python (src/python).

B. Cómo representar el diseño en un mapa mental
- Rama 1: “Código Fuente C++”
- src/cpp (misiones.cpp, personaje.cpp)
- src/include (personaje.h)
- src/bindings (envioper.cpp)
- third_party/pybind11
→ (forma: rectángulos verdes conectados a CMake)
- Rama 2: “Salida de Build”
- compilados_py/Release
→ (forma: rectángulo naranja, flecha desde CMake)
- Rama 3: “Integración Python”
- Nodo “compilados_py” se conecta a un sub-mapa “Python”:
a) src/python/main.py
b) src/python/personaje.py
c) src/python/pruebas_main.py
- Rama 4: “Documentación y Otros”
- docs/documentacion_proyecto.docx
- assets/

C. Relaciones y flujo de datos
1. CMake reúne C++ + pybind11 → produce módulos en compilados_py/Release.
2. Python (main.py, pruebas_main.py) importa esos módulos.
3. Tests y lógica de personaje/ misiones llaman a la capa C++ compilada.

D. Elementos del mapa mental
- Centro: CMake (círculo azul, etiqueta “CMakeLists.txt”).
- Flechas:
- Hacia “Código Fuente C++” (verde).
- Hacia “Salida de Build” (naranja).
- De “Salida de Build” a “Python” (morado).
- Colores/forma:
- Azul – build system (CMake).
- Verde – código fuente nativo.
- Naranja – artefactos compilados.
- Morado – código y pruebas en Python.
- Gris – documentación/assets.
- Etiquetas claras en cada nodo y flecha (p. ej. “compila →”, “importa →”).

E. Pasos para dibujarlo
1. Dibuja un gran círculo central: “CMakeLists.txt”.
2. A su izquierda, agrupa C++: tres rectángulos (cpp, include, bindings) unidos al centro.
3. A su derecha, rectángulo “compilados_py/Release” con flecha desde CMake.
4. Bajo “compilados_py/Release”, crea sub-nodo “Python” y cuelga main.py, personaje.py, pruebas_main.py.
5. Arriba, añade nodos pequeños de “docs/” y “assets/”.
6. Usa colores y flechas direccionales según la sección C.

Con este mapa mental tendrás una visión clara de cómo CMake orquesta el build, cómo fluye el código C++ hacia Python y dónde encajan los tests y la documentación.

## Diagram (Mermaid)

```mermaid
flowchart TB
    CMake["CMakeLists.txt"]:::build
    CMake -->|"gestiona→"| Code["Código Fuente C++"]:::native
    subgraph "Código Fuente C++"
        CPPSRC["src/cpp"]:::native
        INCLUDE["src/include"]:::native
        BINDINGS["src/bindings"]:::native
        PYBIND["third_party/pybind11"]:::native
    end
    Code --> CPPSRC
    Code --> INCLUDE
    Code --> BINDINGS
    Code --> PYBIND

    CMake -->|"compila→"| Build["compilados_py/Release"]:::artifact
    Build -->|"se conecta→"| PythonGroup["Python"]:::python
    subgraph "Python"
        MAIN["src/python/main.py"]:::python
        PERSONAJE["src/python/personaje.py"]:::python
        TEST["src/python/pruebas_main.py"]:::python
    end
    PythonGroup --> MAIN
    PythonGroup --> PERSONAJE
    PythonGroup --> TEST

    CMake --> Doc["docs/documentacion_proyecto.docx"]:::docs
    CMake --> Assets["assets/"]:::docs

    click CMake "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/CMakeLists.txt"
    click CPPSRC "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/tree/master/src/cpp"
    click INCLUDE "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/tree/master/src/include"
    click BINDINGS "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/src/bindings/envioper.cpp"
    click PYBIND "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/tree/master/third_party/pybind11"
    click Build "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/tree/master/compilados_py/Release"
    click MAIN "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/src/python/main.py"
    click PERSONAJE "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/src/python/personaje.py"
    click TEST "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/src/python/pruebas_main.py"
    click Doc "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/blob/master/docs/documentacion_proyecto.docx"
    click Assets "https://github.com/sistematicosavbui/el-lado-oscuro-del-carrito/tree/master/assets/"

    classDef build fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef native fill:#98FB98,stroke:#000,stroke-width:1px
    classDef artifact fill:#FFA500,stroke:#000,stroke-width:1px
    classDef python fill:#9370DB,stroke:#000,stroke-width:1px
    classDef docs fill:#D3D3D3,stroke:#000,stroke-width:1px
```
