# ofkira/tex_informes architecture

> Architecture diagram of the GitHub repository ofkira/tex_informes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ofkira/tex_informes
- Repository: https://github.com/ofkira/tex_informes

## Overview

1. **Repo purpose**
   This repository is a **versioned LaTeX report workspace**, not an application codebase. Its primary product is a set of compiled PDFs for academic reports, organized by subject and assignment moment.

2. **Top-level structure**
   The root contains a reusable IEEE LaTeX template (`IEEE-conference-template-062824.tex`), a `README.md` with workflow guidance, and GitHub issue templates for contribution requests and compilation bugs. The rest of the repository is split into subject-specific report folders.

3. **Core document-generation boundary**
   Each report is authored as a standalone `.tex` file inside its subject/moment folder and is expected to compile with `pdflatex` using the shared IEEE template as the base. The repo’s main boundary is therefore **source LaTeX + assets in Git** versus **generated PDFs outside version control**.

4. **Subject subsystem: Automatas**
   `automatas/` contains reports for automata coursework. It is divided by “momento”:
   - `momento2/` with `grupo1.tex`
   - `momento3/` with `grupo12_m3.tex`
   These are independent report units, each with their own local supporting materials.

5. **Embedded implementation artifacts in Automatas**
   The automata reports include code-related subfolders such as `sketch_grupo1`, `tinkercad_grupo1`, and `sketch_grupo12_m3`. This indicates the report is not purely narrative: it also packages **Arduino/Wokwi/Tinkercad simulation code** used as evidence or demonstration material in the report.

6. **Simulation-centric files in Automatas moment 3**
   `automatas/momento3/sketch_grupo12_m3/` contains:
   - `sketch_grupo12_m3.ino` for Arduino code
   - `diagram.json` for the circuit/topology definition
   - `wokwi.toml` for Wokwi project configuration
   - a local `README.md`
   
   This folder acts as a self-contained simulation artifact set that complements the LaTeX write-up.

7. **Subject subsystem: Física**
   `fisica/` follows the same pattern, with `momento2/grupo7.tex` as the report root and a `simulaciones/` directory holding experiment/simulation files. This keeps the report text separate from the simulation artifacts it describes.

8. **Physics simulation artifact formats**
   The physics simulations use domain-specific file types such as `.sch` and `.sim1`, which suggests circuit or technical simulation tools rather than generic source code. These files are likely referenced as supporting evidence in the LaTeX report and are treated as first-class project artifacts.

9. **Assets and visual inputs**
   Each report folder has an `assets/` directory. This is the likely boundary for images, diagrams, figures, or exported screenshots that the `.tex` files include. In architecture terms, the `.tex` documents consume these assets to generate the final PDF.

10. **Collaboration and workflow**
    The repository is optimized for collaborative academic editing through GitHub:
    - issue templates for content requests and compilation errors
    - guidance to clone, edit, diff, and propose changes via issue if needed
    - local compilation verification via `pdflatex` under TeXLive  
    The workflow is: **edit report source and supporting artifacts → compile locally → submit changes via Git**.

11. **Operational model**
    There is no centralized application runtime, backend, or deployment layer. The repo is a **document-centric monorepo** where each subject/moment folder is an isolated report package composed of LaTeX, figures/assets, and any embedded simulation/code artifacts needed to justify the report content.

12. **What an architecture diagram should show**
    A correct diagram would have:
    - a shared template layer at the root
    - multiple independent report packages under `automatas/` and `fisica/`
    - per-package supporting artifact directories (`assets/`, `simulaciones/`, `sketch_*`, `tinkercad_*`)
    - LaTeX compilation as the main transformation from source materials to PDF output
    - GitHub issue templates as the collaboration entry point for changes and bug reports

Main entry points: [`automatas/momento2/grupo1.tex`](https://github.com/ofkira/tex_informes/blob/main/automatas/momento2/grupo1.tex) (Grupo 1), [`automatas/momento3/grupo12_m3.tex`](https://github.com/ofkira/tex_informes/blob/main/automatas/momento3/grupo12_m3.tex) (Grupo 12), [`fisica/momento2/grupo7.tex`](https://github.com/ofkira/tex_informes/blob/main/fisica/momento2/grupo7.tex) (Grupo 7), [`IEEE-conference-template-062824.tex`](https://github.com/ofkira/tex_informes/blob/main/IEEE-conference-template-062824.tex) (IEEE Template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_root["Root"]
  node_readme["README<br/>guide<br/>[README.md]"]
  node_template["IEEE Template<br/>latex base"]
  node_issues["Issue Templates<br/>workflow<br/>[ISSUE_TEMPLATE]"]
  node_pdf_build[("PDF Build<br/>pdflatex output")]
end

subgraph group_automatas["Automatas"]
  node_auto_m2_tex["Grupo 1<br/>report tex<br/>[grupo1.tex]"]
  node_auto_m2_assets["M2 Assets<br/>figures"]
  node_auto_m2_sketch["M2 Sketch<br/>arduino sketch"]
  node_auto_m2_tinkercad["Tinkercad<br/>simulation sketch"]
  node_auto_m3_tex["Grupo 12<br/>report tex<br/>[grupo12_m3.tex]"]
  node_auto_m3_assets["M3 Assets<br/>figures"]
  node_auto_m3_sketch["Wokwi Sketch<br/>sim package"]
end

subgraph group_fisica["Física"]
  node_fisica_tex["Grupo 7<br/>report tex<br/>[grupo7.tex]"]
  node_fisica_assets["Assets<br/>figures"]
  node_fisica_sims["Simulations<br/>simulation files"]
end

node_readme -->|"guides"| node_issues
node_template -->|"compiles"| node_pdf_build
node_auto_m2_tex -->|"uses"| node_template
node_auto_m2_tex -->|"includes"| node_auto_m2_assets
node_auto_m2_tex -->|"documents"| node_auto_m2_sketch
node_auto_m2_tex -->|"documents"| node_auto_m2_tinkercad
node_auto_m2_tex -->|"outputs"| node_pdf_build
node_auto_m3_tex -->|"uses"| node_template
node_auto_m3_tex -->|"includes"| node_auto_m3_assets
node_auto_m3_tex -->|"documents"| node_auto_m3_sketch
node_auto_m3_tex -->|"outputs"| node_pdf_build
node_fisica_tex -->|"uses"| node_template
node_fisica_tex -->|"includes"| node_fisica_assets
node_fisica_tex -->|"references"| node_fisica_sims
node_fisica_tex -->|"outputs"| node_pdf_build

click node_readme "https://github.com/ofkira/tex_informes/blob/main/README.md"
click node_template "https://github.com/ofkira/tex_informes/blob/main/IEEE-conference-template-062824.tex"
click node_issues "https://github.com/ofkira/tex_informes/blob/main/.github/ISSUE_TEMPLATE"
click node_auto_m2_tex "https://github.com/ofkira/tex_informes/blob/main/automatas/momento2/grupo1.tex"
click node_auto_m2_assets "https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/assets"
click node_auto_m2_sketch "https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/sketch_grupo1"
click node_auto_m2_tinkercad "https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/tinkercad_grupo1"
click node_auto_m3_tex "https://github.com/ofkira/tex_informes/blob/main/automatas/momento3/grupo12_m3.tex"
click node_auto_m3_assets "https://github.com/ofkira/tex_informes/tree/main/automatas/momento3/assets"
click node_auto_m3_sketch "https://github.com/ofkira/tex_informes/tree/main/automatas/momento3/sketch_grupo12_m3"
click node_fisica_tex "https://github.com/ofkira/tex_informes/blob/main/fisica/momento2/grupo7.tex"
click node_fisica_assets "https://github.com/ofkira/tex_informes/tree/main/fisica/momento2/assets"
click node_fisica_sims "https://github.com/ofkira/tex_informes/tree/main/fisica/momento2/simulaciones"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme,node_template,node_issues,node_pdf_build toneBlue
class node_auto_m2_tex,node_auto_m2_assets,node_auto_m2_sketch,node_auto_m2_tinkercad,node_auto_m3_tex,node_auto_m3_assets,node_auto_m3_sketch toneAmber
class node_fisica_tex,node_fisica_assets,node_fisica_sims toneMint
```

## Components

### Root

Shared template, repo guidance, and collaboration entry points.

- [README](https://github.com/ofkira/tex_informes/blob/main/README.md): guide · Repository workflow and editing guidance. · `README.md`
- [IEEE Template](https://github.com/ofkira/tex_informes/blob/main/IEEE-conference-template-062824.tex): latex base · Shared IEEE conference LaTeX starting point. · `IEEE-conference-template-062824.tex`
- [Issue Templates](https://github.com/ofkira/tex_informes/blob/main/.github/ISSUE_TEMPLATE): workflow · Contribution and compilation issue forms. · `.github/ISSUE_TEMPLATE`
- **PDF Build**: pdflatex output · Compiled report output produced from LaTeX sources.

### Automatas

Automata report packages and their embedded simulation artifacts.

- [Grupo 1](https://github.com/ofkira/tex_informes/blob/main/automatas/momento2/grupo1.tex): report tex · Automatas momento 2 report source. · `automatas/momento2/grupo1.tex`
- [M2 Assets](https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/assets): figures · Images and figures used by the Automatas momento 2 report. · `automatas/momento2/assets`
- [M2 Sketch](https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/sketch_grupo1): arduino sketch · Embedded Arduino evidence for Automatas momento 2. · `automatas/momento2/sketch_grupo1`
- [Tinkercad](https://github.com/ofkira/tex_informes/tree/main/automatas/momento2/tinkercad_grupo1): simulation sketch · Tinkercad-based simulation artifact for Automatas momento 2. · `automatas/momento2/tinkercad_grupo1`
- [Grupo 12](https://github.com/ofkira/tex_informes/blob/main/automatas/momento3/grupo12_m3.tex): report tex · Automatas momento 3 report source. · `automatas/momento3/grupo12_m3.tex`
- [M3 Assets](https://github.com/ofkira/tex_informes/tree/main/automatas/momento3/assets): figures · Images and figures used by the Automatas momento 3 report. · `automatas/momento3/assets`
- [Wokwi Sketch](https://github.com/ofkira/tex_informes/tree/main/automatas/momento3/sketch_grupo12_m3): sim package · Self-contained Wokwi/Arduino simulation bundle. · `automatas/momento3/sketch_grupo12_m3`

### Física

Physics report package and supporting simulation files.

- [Grupo 7](https://github.com/ofkira/tex_informes/blob/main/fisica/momento2/grupo7.tex): report tex · Física momento 2 report source. · `fisica/momento2/grupo7.tex`
- [Assets](https://github.com/ofkira/tex_informes/tree/main/fisica/momento2/assets): figures · Visual assets consumed by the Física report. · `fisica/momento2/assets`
- [Simulations](https://github.com/ofkira/tex_informes/tree/main/fisica/momento2/simulaciones): simulation files · Circuit and experiment artifacts supporting the report. · `fisica/momento2/simulaciones`

## Connections

- README → Issue Templates: guides · Workflow guidance points editors to issue-based collaboration.
- IEEE Template → PDF Build: compiles · Shared IEEE template is the base for final PDF generation.
- Grupo 1 → IEEE Template: uses · Automatas report is built on the shared LaTeX template.
- Grupo 1 → M2 Assets: includes · Report consumes local figures and images.
- Grupo 1 → M2 Sketch: documents · Report references embedded Arduino evidence.
- Grupo 1 → Tinkercad: documents · Report references simulation artifacts.
- Grupo 1 → PDF Build: outputs · LaTeX source is compiled into the report PDF.
- Grupo 12 → IEEE Template: uses · Automatas momento 3 report is built on the shared template.
- Grupo 12 → M3 Assets: includes · Report consumes local figures and images.
- Grupo 12 → Wokwi Sketch: documents · Report references the bundled Wokwi simulation package.
- Grupo 12 → PDF Build: outputs · LaTeX source is compiled into the report PDF.
- Grupo 7 → IEEE Template: uses · Physics report is built on the shared LaTeX template.
- Grupo 7 → Assets: includes · Report consumes local figures and images.
- Grupo 7 → Simulations: references · Report depends on simulation artifacts as supporting evidence.
- Grupo 7 → PDF Build: outputs · LaTeX source is compiled into the report PDF.
