# htomash/proyecto-1 architecture

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

- Interactive diagram: https://gitdiagram.com/htomash/proyecto-1
- Repository: https://github.com/htomash/proyecto-1

## Overview

##### Project type and purpose
- This “Proyecto-1” is not a full-stack application but a simple Git-repository structure used to test Git operations.
- It contains three key directories: “Troncal” (the main branch’s working files), “Ramas” (branch snapshots), and “Etiquetas” (tag snapshots), plus a few SQL and INI files.

##### File structure
- Top level:
- .gitignore
- README.md
- Etiquetas/
- Ramas/
- Troncal/
- “Troncal” holds the primary SQL scripts (exercises, tasks, solutions).
- “Ramas” and “Etiquetas” mirror the INI file to represent branch and tag states.

##### README
- Confirms the repo’s sole purpose: a Git functionality test.

a. Main components:
- Local Working Directory
- Git Staging Area (Index)
- Local Repository (.git folder)
- Remote Repository (e.g., origin)
- Branches (Troncal, any feature branch in Ramas)
- Tags (snapshots in Etiquetas)
b. Relationships & interactions:
- Edits in Working Directory → stage to Index → commit to Local Repo
- push/pull between Local Repo ↔ Remote Repo
- Branch creation: Local Repo → Ramas folder
- Tag creation: Local Repo → Etiquetas folder
c. Architectural patterns/principles:
- Version-control workflow (Git DVCS model)
- Separation of concerns: working files vs. commits vs. remote sync
d. Key technologies:
- Git CLI or GUI client
- SQL files in “Troncal” as sample artifacts
- INI files to mark snapshots

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Working Directory and contents
    subgraph "Proyecto-1 Working Directory"
        WD["Proyecto-1/"]:::working
        GI[".gitignore"]:::working
        RM["README.md"]:::working
        subgraph "Troncal Folder"
            TF_SQL["*.sql"]:::branch
            TF_INI["FicheroINI.txt"]:::branch
        end
    end

    %% Git components
    Index["Staging Area (Index)"]:::staging
    LocalRepo["Local Repository (.git)"]:::local
    RemoteRepo["Remote Repository (origin)"]:::remote

    %% Branch and Tag folders
    subgraph "Branch Snapshots (Ramas)"
        BS_INI["FicheroINI.txt"]:::branch
    end
    subgraph "Tag Snapshots (Etiquetas)"
        TS_INI["FicheroINI.txt"]:::branch
    end
    BranchTroncal["Branch: Troncal"]:::branch

    %% Workflow connections
    WD -->|"git add"| Index
    GI --> Index
    RM --> Index
    TF_SQL --> Index
    TF_INI --> Index

    Index -->|"git commit"| LocalRepo
    LocalRepo -->|"git push/pull"| RemoteRepo

    LocalRepo -->|"create branch"| BranchTroncal
    LocalRepo -->|"branch snapshot"| BS_INI
    LocalRepo -->|"create tag"| TS_INI

    %% Click Events
    click WD "https://github.com/htomash/proyecto-1/tree/master/Proyecto-1/"
    click GI "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/.gitignore"
    click RM "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/README.md"
    click TF_SQL "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/Troncal/*.sql"
    click TF_INI "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/Troncal/FicheroINI.txt"
    click Index "https://github.com/htomash/proyecto-1/tree/master/Proyecto-1/.git/index"
    click LocalRepo "https://github.com/htomash/proyecto-1/tree/master/Proyecto-1/.git/"
    click BranchTroncal "https://github.com/htomash/proyecto-1/tree/master/Proyecto-1/Troncal/"
    click BS_INI "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/Ramas/FicheroINI.txt"
    click TS_INI "https://github.com/htomash/proyecto-1/blob/master/Proyecto-1/Etiquetas/FicheroINI.txt"

    %% Styles
    classDef working fill:#add8e6,stroke:#333,stroke-width:1px
    classDef staging fill:#90ee90,stroke:#333,stroke-width:1px
    classDef local fill:#ffff99,stroke:#333,stroke-width:1px
    classDef remote fill:#ffcc99,stroke:#333,stroke-width:1px
    classDef branch fill:#d3d3d3,stroke:#333,stroke-width:1px
```
