# gk-byte-hub/git-day-to-day architecture

> Architecture diagram of the GitHub repository gk-byte-hub/git-day-to-day, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gk-byte-hub/git-day-to-day
- Repository: https://github.com/gk-byte-hub/git-day-to-day

## Overview

Git Day to Day is a web-based Git learning product combining command reference material, guided missions, interactive practice, progress, and troubleshooting scenarios. Users can study commands, follow mission steps, practice in the lab simulator, and explore scenario fixes. The Java servlets expose command, mission-step, and scenario data backed by DAOs and a relational database. Front-end capabilities are represented by their source modules, but the README is only a title and the sampled evidence does not establish most browser-side links; those relationships are therefore omitted or marked unverified.

Main entry points: [`src/main/java/com/gitdaytoday/util/DBConnectionManager.java`](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/util/DBConnectionManager.java) (Connection manager), [`src/main/java/com/gitdaytoday/dao/CommandDao.java`](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/CommandDao.java) (Command queries), [`src/main/java/com/gitdaytoday/dao/MissionStepDao.java`](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/MissionStepDao.java) (Mission queries), [`src/main/java/com/gitdaytoday/dao/ScenarioDao.java`](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/ScenarioDao.java) (Scenario queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning content"]
  node_home["Home page<br/>[index.jsp]"]
  node_command_reference["Command reference<br/>[learn.js]"]
  node_missions_page["Mission learning<br/>[learning.jsp]"]
  node_mission_client["Mission client<br/>[progress.js]"]
end

subgraph group_practice["Interactive practice"]
  node_lab_page["Practice lab<br/>[lab.jsp]"]
  node_lab_client["Lab interactions<br/>[lab.js]"]
  node_git_engine["Git engine<br/>[gitEngine.js]"]
  node_simulator_state["Simulator state<br/>[simulatorState.js]"]
  node_scenarios_page["Scenario practice<br/>[scenarios.jsp]"]
  node_scenario_client["Scenario client<br/>[scenarios.js]"]
end

subgraph group_api["Content API"]
  node_command_api["Command endpoint"]
  node_mission_api["Mission endpoint"]
  node_scenario_api["Scenario endpoint"]
end

subgraph group_persistence["Persistence"]
  node_command_data["Command records<br/>[Command.java]"]
  node_command_dao["Command queries<br/>[CommandDao.java]"]
  node_mission_step["Mission steps<br/>[MissionStep.java]"]
  node_mission_dao["Mission queries"]
  node_scenario_data["Scenario records<br/>[Scenario.java]"]
  node_scenario_dao["Scenario queries<br/>[ScenarioDao.java]"]
  node_db_manager["Connection manager"]
end

node_learner(("Learner"))
node_database[("Relational database")]

node_learner -.->|"opens"| node_home
node_learner -.->|"studies"| node_missions_page
node_learner -.->|"practices"| node_lab_page
node_learner -.->|"explores"| node_scenarios_page
node_command_api -->|"queries"| node_command_dao
node_command_dao -->|"maps rows"| node_command_data
node_mission_api -->|"queries"| node_mission_dao
node_mission_dao -->|"maps rows"| node_mission_step
node_scenario_api -->|"queries"| node_scenario_dao
node_scenario_dao -->|"maps rows"| node_scenario_data
node_command_dao -->|"gets connection"| node_db_manager
node_mission_dao -->|"gets connection"| node_db_manager
node_scenario_dao -->|"gets connection"| node_db_manager
node_db_manager -->|"connects"| node_database

click node_home "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/index.jsp"
click node_command_reference "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/learn.js"
click node_command_api "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/CommandServlet.java"
click node_command_data "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/Command.java"
click node_command_dao "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/CommandDao.java"
click node_missions_page "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/learning.jsp"
click node_mission_client "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/progress.js"
click node_mission_api "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/MissionServlet.java"
click node_mission_step "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/MissionStep.java"
click node_mission_dao "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/MissionStepDao.java"
click node_lab_page "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/lab.jsp"
click node_lab_client "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/lab.js"
click node_git_engine "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/gitEngine.js"
click node_simulator_state "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/simulatorState.js"
click node_scenarios_page "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/scenarios.jsp"
click node_scenario_client "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/scenarios.js"
click node_scenario_api "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/ScenariosServlet.java"
click node_scenario_data "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/Scenario.java"
click node_scenario_dao "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/ScenarioDao.java"
click node_db_manager "https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/util/DBConnectionManager.java"

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_home,node_command_reference,node_missions_page,node_mission_client toneBlue
class node_lab_page,node_lab_client,node_git_engine,node_simulator_state,node_scenarios_page,node_scenario_client,node_database toneAmber
class node_command_api,node_mission_api,node_scenario_api toneMint
class node_command_data,node_command_dao,node_mission_step,node_mission_dao,node_scenario_data,node_scenario_dao,node_db_manager toneRose
class node_learner toneIndigo
```

## Components

### Learning content

- [Home page](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/index.jsp): `src/main/webapp/index.jsp`
- [Command reference](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/learn.js): `src/main/webapp/js/learn.js`
- [Mission learning](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/learning.jsp): `src/main/webapp/learning.jsp`
- [Mission client](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/progress.js): `src/main/webapp/js/progress.js`

### Interactive practice

- [Practice lab](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/lab.jsp): `src/main/webapp/lab.jsp`
- [Lab interactions](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/lab.js): `src/main/webapp/js/lab.js`
- [Git engine](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/gitEngine.js): `src/main/webapp/js/gitEngine.js`
- [Simulator state](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/simulatorState.js): `src/main/webapp/js/simulatorState.js`
- [Scenario practice](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/scenarios.jsp): `src/main/webapp/scenarios.jsp`
- [Scenario client](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/webapp/js/scenarios.js): `src/main/webapp/js/scenarios.js`

### Content API

- [Command endpoint](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/CommandServlet.java): `src/main/java/com/gitdaytoday/servlet/CommandServlet.java`
- [Mission endpoint](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/MissionServlet.java): `src/main/java/com/gitdaytoday/servlet/MissionServlet.java`
- [Scenario endpoint](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/servlet/ScenariosServlet.java): `src/main/java/com/gitdaytoday/servlet/ScenariosServlet.java`

### Persistence

- [Command records](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/Command.java): `src/main/java/com/gitdaytoday/model/Command.java`
- [Command queries](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/CommandDao.java): `src/main/java/com/gitdaytoday/dao/CommandDao.java`
- [Mission steps](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/MissionStep.java): `src/main/java/com/gitdaytoday/model/MissionStep.java`
- [Mission queries](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/MissionStepDao.java): `src/main/java/com/gitdaytoday/dao/MissionStepDao.java`
- [Scenario records](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/model/Scenario.java): `src/main/java/com/gitdaytoday/model/Scenario.java`
- [Scenario queries](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/dao/ScenarioDao.java): `src/main/java/com/gitdaytoday/dao/ScenarioDao.java`
- [Connection manager](https://github.com/gk-byte-hub/git-day-to-day/blob/main/src/main/java/com/gitdaytoday/util/DBConnectionManager.java): `src/main/java/com/gitdaytoday/util/DBConnectionManager.java`

### Other components

- **Learner**
- **Relational database**

## Connections

- Learner → Home page: opens
- Learner → Mission learning: studies
- Learner → Practice lab: practices
- Learner → Scenario practice: explores
- Command endpoint → Command queries: queries (evidence: `src/main/java/com/gitdaytoday/servlet/CommandServlet.java`)
- Command queries → Command records: maps rows (evidence: `src/main/java/com/gitdaytoday/dao/CommandDao.java`)
- Mission endpoint → Mission queries: queries (evidence: `src/main/java/com/gitdaytoday/servlet/MissionServlet.java`)
- Mission queries → Mission steps: maps rows (evidence: `src/main/java/com/gitdaytoday/dao/MissionStepDao.java`)
- Scenario endpoint → Scenario queries: queries (evidence: `src/main/java/com/gitdaytoday/servlet/ScenariosServlet.java`)
- Scenario queries → Scenario records: maps rows (evidence: `src/main/java/com/gitdaytoday/dao/ScenarioDao.java`)
- Command queries → Connection manager: gets connection (evidence: `src/main/java/com/gitdaytoday/dao/CommandDao.java`)
- Mission queries → Connection manager: gets connection (evidence: `src/main/java/com/gitdaytoday/dao/MissionStepDao.java`)
- Scenario queries → Connection manager: gets connection (evidence: `src/main/java/com/gitdaytoday/dao/ScenarioDao.java`)
- Connection manager → Relational database: connects (evidence: `src/main/java/com/gitdaytoday/util/DBConnectionManager.java`)
