# ergrato-dev/bc-oop-java architecture

> Architecture diagram of the GitHub repository ergrato-dev/bc-oop-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ergrato-dev/bc-oop-java
- Repository: https://github.com/ergrato-dev/bc-oop-java

## Overview

##### Project Type and Purpose
- This is neither a traditional web service nor a micro-service suite, but an **open-source educational content repository** (“Bootcamp POO Java”) aimed at delivering a 10-week Java/OOP training.
- Key indicators:
- Massive folder hierarchy under `bootcamp/` (weeks 0–9, each with theory/practice/resources/evaluation).
- `_docs/` for instructor guides and policies.
- `.github/` scripts for automation (auto-commit, cron).
- No running server code; it’s Markdown + Java examples + shell scripts.

##### File Structure Analysis
- Top-level directories:
- `bootcamp/` → weekly modules (theory, practice, resources, rubrics).
- `_docs/` → internal documentation (IDE setup, anti-plagiarism policy, tutorial scripts).
- `scripts/` & `.github/scripts/` → automation (auto-commit service, cron installation).
- Key patterns:
- Modular content per week (reusable structure).
- CI/automation separate from content.
- No backend/frontend code; Java examples live inside each module’s practice folder.

##### Insights from README
- Purpose: deliver 40-hour intensive bootcamp covering AOO, UML, Java best practices.
- Tech stack: JDK 17+, any Java IDE, Git/GitHub, no dedicated runtime or server.
- Contributions: via GitHub PRs, issues, discussions—hence integration with GitHub workflows.

a. Main Components
1. **Users** (Students / Instructors)
2. **Local Dev Environment** (IDE + Java JDK)
3. **Content Repository** (GitHub repo hosting Markdown + Java samples)
4. **Automation Layer** (.github/scripts + `scripts/` for auto-commit & cron jobs)
5. **Collaboration Platform** (GitHub Issues, PRs, Discussions)
6. **External Resources** (Oracle Docs, GeeksforGeeks, Replit)
b. Relationships / Data Flows
- Users clone/fork the **Content Repository** → open in **IDE/Java** → read theory, run code samples.
- **Automation Layer** runs on GitHub (cron timers, auto-commit service) to keep materials updated.
- Users submit PRs/issues back into **Collaboration Platform** → integrated into the **Content Repository**.
- **External Resources** linked from content; users follow these outwards for deeper study.
c. Architectural Patterns
- **Modular content delivery**: weekly modules are self-contained sub-components.
- **Separation of concerns**: content (Markdown/Java) vs. automation (shell scripts).
- **Open-source collaboration**: git-driven workflow, contribution guidelines.
d. Key Technologies
- Markdown docs for theory & practice.
- Java 17+ examples in each module.
- Shell scripts for auto-commit and cron jobs.
- GitHub Actions/cron integration for repository maintenance.

##### Essential Details
- Both **static content** (Markdown, SVGs) and **dynamic processes** (scripts, user contributions).
- Don’t over-engineer—focus on showing how educational material flows from repository to student, and how feedback/automation flows back.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Layer
    Users["Users (Students / Instructors)"]:::user

    %% Local Environment
    LocalEnv["Local Dev Environment<br/>(IDE + Java JDK)"]:::user

    %% Content Repository
    ContentRepo["Content Repository<br/>(Markdown + Java samples)"]:::content

    %% Weekly Modules Group
    subgraph "Weekly Modules" 
        direction TB
        W0["semana-00"]:::content
        W1["semana-01"]:::content
        W2["semana-02"]:::content
        W3["semana-03"]:::content
        W4["semana-04"]:::content
        W5["semana-05"]:::content
        W6["semana-06"]:::content
        W7["semana-07"]:::content
        W8["semana-08"]:::content
        W9["semana-09"]:::content
    end

    %% Internal Documentation
    subgraph "Instructor & Internal Docs"
        direction TB
        Doc1["_docs/GUIA-INTELLIJ-IDEA.md"]:::docs
        Doc2["_docs/GUIA-INTELLIJ-SOURCE-ROOTS.md"]:::docs
        Doc3["_docs/POLITICA_ANTICOPIA.md"]:::docs
        Doc4["_docs/GUIA-RUBRICAS-AUTOMATIZACION.md"]:::docs
        Doc5["_docs/README.md"]:::docs
    end

    %% Assets
    Assets["Assets & Diagrams"]:::content

    %% Automation Layer
    subgraph "Automation Layer"
        direction TB
        A1[".github/scripts/auto-commit.sh"]:::automation
        A2[".github/scripts/auto-commit.service"]:::automation
        A3[".github/scripts/auto-commit.timer"]:::automation
        A4[".github/scripts/install-cron.sh"]:::automation
        A5["scripts/autocommit.sh"]:::automation
    end

    %% Collaboration Platform
    subgraph "Collaboration Platform (GitHub)" 
        direction TB
        C1[".github/ISSUE_TEMPLATE/bug_report.md"]:::collab
        C2[".github/ISSUE_TEMPLATE/feature_request.md"]:::collab
        C3[".github/ISSUE_TEMPLATE/question.md"]:::collab
        C4[".github/PULL_REQUEST_TEMPLATE.md"]:::collab
        C5["CONTRIBUTING.md"]:::collab
        C6["CODE_OF_CONDUCT.md"]:::collab
    end

    %% External Resources
    ExtRes["External Resources<br/>(Oracle Docs, GeeksforGeeks, Replit)"]:::external

    %% Arrows / Relationships
    Users -->|clone / fork| ContentRepo
    ContentRepo -->|contains| W0
    ContentRepo -->|contains| W1
    ContentRepo -->|contains| W2
    ContentRepo -->|contains| W3
    ContentRepo -->|contains| W4
    ContentRepo -->|contains| W5
    ContentRepo -->|contains| W6
    ContentRepo -->|contains| W7
    ContentRepo -->|contains| W8
    ContentRepo -->|contains| W9
    ContentRepo -->|contains| Doc1
    ContentRepo -->|contains| Doc2
    ContentRepo -->|contains| Doc3
    ContentRepo -->|contains| Doc4
    ContentRepo -->|contains| Doc5
    ContentRepo -->|contains| Assets
    Users -->|open in IDE| LocalEnv
    LocalEnv -->|run examples| ContentRepo
    A1 -->|auto-update| ContentRepo
    A2 -->|schedule| ContentRepo
    A3 -->|timer| ContentRepo
    A4 -->|install cron| ContentRepo
    A5 -->|auto-commit| ContentRepo
    Users -->|submit PR / issue| C1
    Users -->|submit PR / issue| C2
    Users -->|submit PR / issue| C3
    Users -->|submit PR / issue| C4
    Users -->|submit PR / issue| C5
    Users -->|submit PR / issue| C6
    C1 -->|merged into| ContentRepo
    C2 -->|merged into| ContentRepo
    C3 -->|merged into| ContentRepo
    C4 -->|merged into| ContentRepo
    C5 -->|merged into| ContentRepo
    C6 -->|merged into| ContentRepo
    ContentRepo -.->|links to| ExtRes
    Users -.->|follow links| ExtRes

    %% Click Events
    click ContentRepo "https://github.com/ergrato-dev/bc-oop-java/blob/main/README.md"
    click ContentRepo "https://github.com/ergrato-dev/bc-oop-java/blob/main/bootcamp/BOOTCAMP-COMPLETO.md"
    click W0 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-00"
    click W1 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-01"
    click W2 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-02"
    click W3 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-03"
    click W4 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-04"
    click W5 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-05"
    click W6 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-06"
    click W7 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-07"
    click W8 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-08"
    click W9 "https://github.com/ergrato-dev/bc-oop-java/tree/main/bootcamp/semana-09"
    click Doc1 "https://github.com/ergrato-dev/bc-oop-java/blob/main/_docs/GUIA-INTELLIJ-IDEA.md"
    click Doc2 "https://github.com/ergrato-dev/bc-oop-java/blob/main/_docs/GUIA-INTELLIJ-SOURCE-ROOTS.md"
    click Doc3 "https://github.com/ergrato-dev/bc-oop-java/blob/main/_docs/POLITICA_ANTICOPIA.md"
    click Doc4 "https://github.com/ergrato-dev/bc-oop-java/blob/main/_docs/GUIA-RUBRICAS-AUTOMATIZACION.md"
    click Doc5 "https://github.com/ergrato-dev/bc-oop-java/blob/main/_docs/README.md"
    click A1 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/scripts/auto-commit.sh"
    click A2 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/scripts/auto-commit.service"
    click A3 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/scripts/auto-commit.timer"
    click A4 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/scripts/install-cron.sh"
    click A5 "https://github.com/ergrato-dev/bc-oop-java/blob/main/scripts/autocommit.sh"
    click C1 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/ISSUE_TEMPLATE/bug_report.md"
    click C2 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/ISSUE_TEMPLATE/feature_request.md"
    click C3 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/ISSUE_TEMPLATE/question.md"
    click C4 "https://github.com/ergrato-dev/bc-oop-java/blob/main/.github/PULL_REQUEST_TEMPLATE.md"
    click C5 "https://github.com/ergrato-dev/bc-oop-java/blob/main/CONTRIBUTING.md"
    click C6 "https://github.com/ergrato-dev/bc-oop-java/blob/main/CODE_OF_CONDUCT.md"

    %% Styles
    classDef content fill:#CCE5FF,stroke:#5B9BD5,color:#000
    classDef automation fill:#DFF2BF,stroke:#4F8A10,color:#000
    classDef user fill:#FFE5CC,stroke:#FF9000,color:#000
    classDef external fill:#E0E0E0,stroke:#888,color:#000
    classDef docs fill:#CCE5FF,stroke:#5B9BD5,color:#000
    classDef collab fill:#F0F0F0,stroke:#AAA,color:#000
```
