# utnfrrodsw/desarrollo-de-software architecture

> Architecture diagram of the GitHub repository utnfrrodsw/desarrollo-de-software, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/utnfrrodsw/desarrollo-de-software
- Repository: https://github.com/utnfrrodsw/desarrollo-de-software

## Overview

##### Project type and purpose
- This “DSW: Desarrollo de Software” repository is not a typical codebase but an information‐hub (static documentation) for a university software‐development course.
- Its purpose is to aggregate links to media channels (YouTube, Telegram) and related GitHub repos (TP, PoC, material‐BE, clases) and to provide scheduling and grading-policy details for students and faculty.

##### File structure
- Top level contains only LICENSE and README.md.
- No source code or build scripts—this is a static documentation site hosted on GitHub (often via GitHub Pages).
- The README acts as the sole “content” component, linking out to other services and repositories.

##### README for additional insights
- Sections: Media links, repos, faculty list, grading rules, timelines.

a. Main components
- Documentation Hub (the README + GitHub Pages static site)
- External Code Repositories (TP, PoC, material-BE, clases)
- Media Platforms (YouTube channel & playlists, Telegram group)
- Users (Students, Professors)
b. Relationships & interactions
- Users → access Documentation Hub (GitHub Pages)
- Documentation Hub → links out to External Code Repos
- Documentation Hub → links out to YouTube & Telegram
- Users ↔ interact directly with External Code Repos (clone, issues, PRs)
- Users ↔ consume media on YouTube & Telegram
c. Architectural patterns & principles
- Static site hosting (no backend logic): all content is client-side.
- Link‐aggregation pattern: a central portal that redirects/links to specialized subsystems.
- Separation of concerns: documentation vs. code repos vs. media platforms.
d. Key technologies & services
- GitHub Pages (static host), Markdown (README)
- GitHub Repositories (TP, PoC, material-BE, clases)
- YouTube Data API (implicit integration)
- Telegram Bots/API (for group integration)
- Web browsers and Git clients as user interfaces

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User groups
    Students(["Students"]):::userGroup
    Professors(["Professors"]):::userGroup

    %% Documentation Hub
    DocsHub["Documentation Hub\n(GitHub Pages)"]:::staticComponent

    %% Course Repositories group
    subgraph "Course Repos"
        direction TB
        TP["TP Repo"]:::staticComponent
        PoC["PoC Repo"]:::staticComponent
        MaterialBE["material-BE Repo"]:::staticComponent
        Clases["clases Repo"]:::staticComponent
    end

    %% External Platforms
    YouTube["YouTube Channel"]:::externalPlatform
    Telegram["Telegram Group"]:::externalPlatform

    %% CI/CD
    CI["GitHub Actions CI/CD"]:::staticComponent

    %% Relationships: Users to Docs Hub
    Students -->|"HTTP GET"| DocsHub
    Professors -->|"HTTP GET"| DocsHub

    %% Docs Hub to external services
    DocsHub -->|"redirect/link"| TP
    DocsHub -->|"redirect/link"| PoC
    DocsHub -->|"redirect/link"| MaterialBE
    DocsHub -->|"redirect/link"| Clases
    DocsHub -->|"link"| YouTube
    DocsHub -->|"link"| Telegram

    %% Users direct interactions with repos
    Students -->|"clone/issue/PR"| TP
    Students -->|"clone/issue/PR"| PoC
    Students -->|"clone/issue/PR"| MaterialBE
    Students -->|"clone/issue/PR"| Clases
    Professors -->|"clone/issue/PR"| TP
    Professors -->|"clone/issue/PR"| PoC
    Professors -->|"clone/issue/PR"| MaterialBE
    Professors -->|"clone/issue/PR"| Clases

    %% Users interactions with media
    Students -->|"watch playlist"| YouTube
    Professors -->|"watch playlist"| YouTube
    Students -->|"join chat"| Telegram
    Professors -->|"join chat"| Telegram

    %% CI/CD to Docs Hub
    CI -->|"deploy static site"| DocsHub

    %% Click events
    click DocsHub "https://github.com/utnfrrodsw/desarrollo-de-software/blob/main/README.md"

    %% Styles
    classDef staticComponent fill:#D0E6FF,stroke:#003399,color:#000
    classDef externalPlatform fill:#D0FFD6,stroke:#006600,color:#000
    classDef userGroup fill:#FFF5CC,stroke:#CC9900,color:#000
```
