# daniever6/tfg architecture

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

- Interactive diagram: https://gitdiagram.com/daniever6/tfg
- Repository: https://github.com/daniever6/tfg

## Overview

Based on an analysis of the provided file tree and the brief README (“TFG”), it appears that this project is a final degree work (Trabajo Fin de Grado) that focuses on laboratory safety in a virtual or simulated environment. The project contains a variety of asset types – including PDFs with safety information, image references (e.g., lab photos in the Referencias directory), interface sketches or designs (in the “interfaz” folder), 3D models for lab objects (in “objetos” and possibly “objs”), and character assets (in “personajes”). There isn’t an obvious codebase or backend/logic component visible here, so the emphasis is most likely on assembling and organizing visual and interactive assets to form a comprehensive simulation or presentation related to lab safety.

##### Major Components
- Asset Libraries: Separate asset types should be represented. For example:
- Reference Materials: PDFs and photographs (e.g., “Preguntas seguridad laboratorios.pdf”, “Píldoras de seguridad - VirtualLabs (1).pdf”, photos in “Referencias”).
- Visual and Design Elements: Sketches and interface designs found under the “interfaz” directory.
- 3D Models and Simulation Objects: The “objetos” directory houses .blend files for lab equipment (e.g., Armario ácidos + bases, BotellaPlastico, etc.) and “objs” may contain additional object files.
- Characters: Present within the “personajes” directory.
- Supplementary Media: “carteles” (likely posters or signage graphics).

##### Relationships and Interactions
- How these components interact to create the final experience. For example:
- The interface (UI screens designed in “interfaz”) likely serves as the entry point or control hub for navigating the simulation.
- The UI connects to and displays 3D models from the “objetos” and “objs” directories, orchestrating the lab environment.
- Reference PDFs and images provide context and safety information that may be either displayed in the simulation or used to validate design decisions.
- Character assets (in “personajes”) give life to the simulation through avatars or instructional representations.
- “carteles” complement the simulation with safety posters and signage, reinforcing safety messages.

##### Architectural Patterns and Principles
- Design iterations: The “bocetos” within the interfaz folder suggest an evolution from sketches to a final UI design.

##### Technologies and Tools
- That the project makes use of 3D modeling software (Blender files with the .blend extension) and digital design software (e.g., the .sai2 file likely comes from a digital painting/sketching tool).
- Mention any external dependencies implied by the assets (e.g., if the simulation is eventually brought into an engine, that engine would be an important component, though it isn’t explicitly in the file tree).

##### Final Touches
- Given that “TFG” implies a final year project, include a notation for iterative design stages if applicable (evolution from “bocetos” to finalized “NewCanvas1.sai2”, etc.).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User Interface Layer
    subgraph "User Interface Layer"
        UI["Interfaz"]:::ui
        NewCanvas["NewCanvas1.sai2"]:::ui
        Bocetos["Bocetos"]:::ui
    end

    %% Simulation Engine (Processing Layer)
    subgraph "Simulation Engine"
        SE["Simulation Engine"]:::engine
    end

    %% 3D Models & Characters Layer
    subgraph "3D Models & Characters"
        Objetos["Objetos (3D models)"]:::asset
        Objs["Objs (Additional objects)"]:::asset
        Personajes["Personajes (Characters)"]:::asset
    end

    %% Reference Materials Module
    subgraph "Reference Materials"
        RefPDF1["Preguntas seguridad laboratorios.pdf"]:::ref
        RefPDF2["Píldoras de seguridad - VirtualLabs (1).pdf"]:::ref
        RefImages["Referencias (Images)"]:::ref
        RefPhotos["FotosMariaLaboratorio"]:::ref
    end

    %% Supplementary Media Module
    subgraph "Supplementary Media"
        Carteles["Carteles"]:::supp
    end

    %% Connections between layers
    UI -->|"launches"| SE
    SE -->|"renders"| Objetos
    SE -->|"renders"| Objs
    SE -->|"renders"| Personajes

    UI -->|"displays"| RefPDF1
    UI -->|"displays"| RefPDF2
    UI -->|"displays"| RefImages
    RefImages -->|"contains"| RefPhotos

    UI -->|"shows"| Carteles

    %% Internal UI Structure Connections
    UI -->|"composes"| NewCanvas
    Bocetos -->|"refines"| NewCanvas

    %% Click Events
    click UI "https://github.com/daniever6/tfg/tree/main/interfaz"
    click NewCanvas "https://github.com/daniever6/tfg/blob/main/interfaz/NewCanvas1.sai2"
    click Bocetos "https://github.com/daniever6/tfg/tree/main/interfaz/bocetos"
    click Objetos "https://github.com/daniever6/tfg/tree/main/objetos"
    click Objs "https://github.com/daniever6/tfg/tree/main/objs"
    click Personajes "https://github.com/daniever6/tfg/tree/main/personajes"
    click RefPDF1 "https://github.com/daniever6/tfg/blob/main/Preguntas seguridad laboratorios.pdf"
    click RefPDF2 "https://github.com/daniever6/tfg/blob/main/Píldoras de seguridad - VirtualLabs (1).pdf"
    click RefImages "https://github.com/daniever6/tfg/tree/main/Referencias"
    click RefPhotos "https://github.com/daniever6/tfg/tree/main/Referencias/FotosMariaLaboratorio"
    click Carteles "https://github.com/daniever6/tfg/tree/main/carteles"

    %% Styles
    classDef ui fill:#AEDFF7,stroke:#333,stroke-width:2px;
    classDef engine fill:#D8BFD8,stroke:#333,stroke-width:2px;
    classDef asset fill:#FFDEAD,stroke:#333,stroke-width:2px;
    classDef ref fill:#98FB98,stroke:#333,stroke-width:2px;
    classDef supp fill:#FFFACD,stroke:#333,stroke-width:2px;
```
