# universidade-livre/ciencia-da-computacao architecture

> Architecture diagram of the GitHub repository universidade-livre/ciencia-da-computacao, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/universidade-livre/ciencia-da-computacao
- Repository: https://github.com/universidade-livre/ciencia-da-computacao

## Overview

##### Project type and purpose
- This is not a runnable application but a structured **documentation repository** (an “awesome‐curriculum” list) for self-taught Computer Science in Portuguese.
- Its primary function is to present a **hierarchical curriculum**: a README with a table of contents, supported by Markdown files in `extras/` (bibliographies, courses, books, softskills) and `specializations/` (domain-specific curriculum extensions).

##### File structure
- Top-level:
- Root markdowns and meta-files (`README.md`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, license, GitHub config in `.github/`).
- `extras/` directory holds subfolders for bibliographies, plus aggregated `books.md`, `courses.md`, `softskills.md`.
- `specializations/` holds one Markdown per specialized track (graphics, data science, web dev, etc.).
- No source code, CI, or build scripts—this is static content, versioned via Git.

##### README for additional insights
- The README defines the **curricular structure** (phases, prerequisites, recommended readings), community links (Discord, issues), contribution process, and acknowledged contributors.
- There’s mention of guidelines, external video/course providers (YouTube, Coursera).

##### Elements
- Clear labels: “Repository”, “README (Index)”, “extras/”, “specializations/”, “Community (Issues/PRs)”, “External Providers”.
- From Contributors → PR → Repository → Content → Users
- Blue rectangles for content (Markdown folders/files)
- Green for processes (PR workflow)
- Orange for external systems (YouTube, Coursera)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    Contributor["Contributor"]:::actor
    User["User / Student"]:::actor

    %% Repository and Content
    subgraph "GitHub Repository"
        Repo["Repository"]:::repo
        subgraph "Root Documentation"
            Readme["README.md"]:::content
            Contrib["CONTRIBUTING.md"]:::governance
            CodeConduct["CODE_OF_CONDUCT.md"]:::governance
            Funding[".github/FUNDING.yml"]:::config
            License["LICENSE"]:::governance
        end
        subgraph "Curriculum Content"
            Phases["Phases & Modules (in README)"]:::content
            subgraph "Extras"
                ExtrasDir["extras/"]:::content
                BibDir["extras/bibliography/"]:::content
                Books["books.md"]:::content
                Courses["courses.md"]:::content
                SoftSkills["softskills.md"]:::content
            end
            subgraph "Specializations"
                SpecDir["specializations/"]:::content
                CG["computer_graphics.md"]:::content
                Cyber["cybersecurity.md"]:::content
                DataSci["data_science.md"]:::content
                DBAdmin["database_administration.md"]:::content
                DevOps["devops.md"]:::content
                Embedded["embedded_systems.md"]:::content
                Mobile["mobile_development.md"]:::content
                WebDev["web_development.md"]:::content
            end
        end
    end

    %% Workflow Process
    PR["Pull Request"]:::process
    Review["Review"]:::process
    Merge["Merge"]:::process
    GitHubPages["GitHub Pages"]:::external

    %% External Resources
    YouTube["YouTube"]:::external
    Coursera["Coursera"]:::external
    BibliographyExt["Bibliographic Sources"]:::external

    %% Connections
    Contributor -->|"fork/clone & edit"| Repo
    Contributor -->|"create PR"| PR
    PR -->|"review"| Review
    Review -->|"merge"| Merge
    Merge -->|"update"| Repo
    Repo -->|"serve static site"| GitHubPages
    GitHubPages -->|"view content"| User
    User -->|"browse / clone"| Repo

    %% Content Links to External
    Readme -->|"links to"| YouTube
    Courses -->|"links to"| Coursera
    BibDir -->|"references"| BibliographyExt

    %% Click Events
    click Repo "https://github.com/universidade-livre/ciencia-da-computacao/tree/main//"
    click Readme "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/README.md"
    click Contrib "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/CONTRIBUTING.md"
    click CodeConduct "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/CODE_OF_CONDUCT.md"
    click Funding "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/.github/FUNDING.yml"
    click License "https://github.com/universidade-livre/ciencia-da-computacao/tree/main/LICENSE"
    click ExtrasDir "https://github.com/universidade-livre/ciencia-da-computacao/tree/main/extras/"
    click BibDir "https://github.com/universidade-livre/ciencia-da-computacao/tree/main/extras/bibliography/"
    click Books "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/extras/books.md"
    click Courses "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/extras/courses.md"
    click SoftSkills "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/extras/softskills.md"
    click SpecDir "https://github.com/universidade-livre/ciencia-da-computacao/tree/main/specializations/"
    click CG "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/computer_graphics.md"
    click Cyber "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/cybersecurity.md"
    click DataSci "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/data_science.md"
    click DBAdmin "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/database_administration.md"
    click DevOps "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/devops.md"
    click Embedded "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/embedded_systems.md"
    click Mobile "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/mobile_development.md"
    click WebDev "https://github.com/universidade-livre/ciencia-da-computacao/blob/main/specializations/web_development.md"

    %% Styles
    classDef repo fill:#D0E8FF,stroke:#3399FF,stroke-width:2px
    classDef content fill:#E8F4FF,stroke:#66B2FF,stroke-width:1px
    classDef governance fill:#F3E5F5,stroke:#9C27B0,stroke-width:1px
    classDef config fill:#EDE7F6,stroke:#7E57C2,stroke-width:1px
    classDef process fill:#E8F5E9,stroke:#43A047,stroke-width:1px
    classDef actor fill:#ECEFF1,stroke:#607D8B,stroke-width:1px
    classDef external fill:#FFF3E0,stroke:#FB8C00,stroke-width:1px
```
