# troggoman/rhcsa-simulator architecture

> Architecture diagram of the GitHub repository troggoman/rhcsa-simulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/troggoman/rhcsa-simulator
- Repository: https://github.com/troggoman/rhcsa-simulator

## Overview

RHCSA Mock Exam Simulator is a root-run command-line practice environment for RHCSA EX200. The main loop presents generated tasks, prepares real system state, lets the candidate perform the work, validates the result, and records scores for later review. Exam, practice, adaptive learning, boot rescue, troubleshooting, reboot checks, and lab-device/NFS support are distinct capabilities. The graph follows documented and indexed relationships; several task modules and subsystem implementations were not excerpted, so their internal calls are not inferred.

Main entry points: [`core/exam.py`](https://github.com/troggoman/rhcsa-simulator/blob/master/core/exam.py) (Mock exam), [`rhcsa_simulator.py`](https://github.com/troggoman/rhcsa-simulator/blob/master/rhcsa_simulator.py) (CLI entry), [`tasks`](https://github.com/troggoman/rhcsa-simulator/tree/master/tasks) (Task scenarios), [`core/menu.py`](https://github.com/troggoman/rhcsa-simulator/blob/master/core/menu.py) (Main menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate experience"]
  node_cli["CLI entry<br/>[rhcsa_simulator.py]"]
  node_menu["Main menu<br/>[menu.py]"]
  node_exam["Mock exam<br/>[exam.py]"]
  node_practice["Practice rounds<br/>[practice.py]"]
  node_adaptive["Adaptive learning<br/>[adaptive.py]"]
  node_learn["Learning mode<br/>[learn.py]"]
  node_panel["Task panel<br/>[task_gui.py]"]
end

subgraph group_tasks["Task lifecycle"]
  node_registry["Task registry<br/>[registry.py]"]
  node_objectives["Exam objectives"]
  node_taskbase["Task model<br/>[base.py]"]
  node_tasksets["Task scenarios"]
end

subgraph group_lab["Lab and scenarios"]
  node_setup["Task setup<br/>[env_setup.py]"]
  node_troubleshooting["Fault scenarios<br/>[troubleshooting.py]"]
  node_bootrescue["Boot rescue lab<br/>[boot_rescue.py]"]
  node_labmachine["Lab machine<br/>[lab_machine.py]"]
  node_nfs["NFS provisioning<br/>[nfs_server.py]"]
  node_devices["Practice devices<br/>[device_manager.py]"]
end

subgraph group_records["Validation and progress"]
  node_validator["Validation engine<br/>[validator.py]"]
  node_safeexec["Safe execution<br/>[safe_executor.py]"]
  node_results[("Results database<br/>[results_db.py]")]
  node_reboot["Reboot checks<br/>[reboot_engine.py]"]
  node_dispute["Review and disputes<br/>[dispute.py]"]
end

node_candidate(("Candidate"))

node_candidate -->|"starts"| node_cli
node_cli -->|"launches"| node_exam
node_cli -->|"opens"| node_menu
node_cli -->|"launches"| node_practice
node_cli -->|"launches"| node_learn
node_cli -->|"launches"| node_adaptive
node_exam -->|"draws tasks"| node_registry
node_exam -->|"validates tasks"| node_validator
node_exam -->|"records results"| node_results
node_exam -->|"opens panel"| node_panel
node_exam -->|"prepares tasks"| node_setup
node_exam -->|"checks reboot"| node_reboot
node_registry -->|"discovers modules"| node_tasksets
node_registry -->|"filters by scope"| node_objectives
node_tasksets -->|"extends"| node_taskbase
node_tasksets -->|"implements checks"| node_validator
node_setup -->|"prepares scenarios"| node_troubleshooting
node_exam -->|"uses lab machine"| node_labmachine
node_exam -->|"provisions NFS"| node_nfs
node_tasksets -->|"uses server"| node_nfs
node_tasksets -->|"configures networking"| node_devices
node_validator -.->|"checks safely"| node_safeexec
node_menu -->|"offers rescue lab"| node_bootrescue
node_menu -->|"shows history"| node_results
node_menu -->|"opens disputes"| node_dispute
node_reboot -->|"revalidates"| node_validator

click node_cli "https://github.com/troggoman/rhcsa-simulator/blob/master/rhcsa_simulator.py"
click node_menu "https://github.com/troggoman/rhcsa-simulator/blob/master/core/menu.py"
click node_exam "https://github.com/troggoman/rhcsa-simulator/blob/master/core/exam.py"
click node_practice "https://github.com/troggoman/rhcsa-simulator/blob/master/core/practice.py"
click node_adaptive "https://github.com/troggoman/rhcsa-simulator/blob/master/core/adaptive.py"
click node_learn "https://github.com/troggoman/rhcsa-simulator/blob/master/core/learn.py"
click node_panel "https://github.com/troggoman/rhcsa-simulator/blob/master/core/task_gui.py"
click node_registry "https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/registry.py"
click node_objectives "https://github.com/troggoman/rhcsa-simulator/tree/master/core/content"
click node_taskbase "https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/base.py"
click node_tasksets "https://github.com/troggoman/rhcsa-simulator/tree/master/tasks"
click node_setup "https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/env_setup.py"
click node_troubleshooting "https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/troubleshooting.py"
click node_bootrescue "https://github.com/troggoman/rhcsa-simulator/blob/master/core/boot_rescue.py"
click node_labmachine "https://github.com/troggoman/rhcsa-simulator/blob/master/core/lab_machine.py"
click node_nfs "https://github.com/troggoman/rhcsa-simulator/blob/master/core/nfs_server.py"
click node_devices "https://github.com/troggoman/rhcsa-simulator/blob/master/device/device_manager.py"
click node_validator "https://github.com/troggoman/rhcsa-simulator/blob/master/core/validator.py"
click node_safeexec "https://github.com/troggoman/rhcsa-simulator/blob/master/validators/safe_executor.py"
click node_results "https://github.com/troggoman/rhcsa-simulator/blob/master/core/results_db.py"
click node_reboot "https://github.com/troggoman/rhcsa-simulator/blob/master/core/reboot_engine.py"
click node_dispute "https://github.com/troggoman/rhcsa-simulator/blob/master/core/dispute.py"

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_cli,node_menu,node_exam,node_practice,node_adaptive,node_learn,node_panel toneBlue
class node_registry,node_objectives,node_taskbase,node_tasksets toneAmber
class node_setup,node_troubleshooting,node_bootrescue,node_labmachine,node_nfs,node_devices toneMint
class node_validator,node_safeexec,node_results,node_reboot,node_dispute toneRose
class node_candidate toneIndigo
```

## Components

### Candidate experience

- [CLI entry](https://github.com/troggoman/rhcsa-simulator/blob/master/rhcsa_simulator.py): `rhcsa_simulator.py`
- [Main menu](https://github.com/troggoman/rhcsa-simulator/blob/master/core/menu.py): `core/menu.py`
- [Mock exam](https://github.com/troggoman/rhcsa-simulator/blob/master/core/exam.py): `core/exam.py`
- [Practice rounds](https://github.com/troggoman/rhcsa-simulator/blob/master/core/practice.py): `core/practice.py`
- [Adaptive learning](https://github.com/troggoman/rhcsa-simulator/blob/master/core/adaptive.py): `core/adaptive.py`
- [Learning mode](https://github.com/troggoman/rhcsa-simulator/blob/master/core/learn.py): `core/learn.py`
- [Task panel](https://github.com/troggoman/rhcsa-simulator/blob/master/core/task_gui.py): `core/task_gui.py`

### Task lifecycle

- [Task registry](https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/registry.py): `tasks/registry.py`
- [Exam objectives](https://github.com/troggoman/rhcsa-simulator/tree/master/core/content): `core/content`
- [Task model](https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/base.py): `tasks/base.py`
- [Task scenarios](https://github.com/troggoman/rhcsa-simulator/tree/master/tasks): `tasks`

### Lab and scenarios

- [Task setup](https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/env_setup.py): `tasks/env_setup.py`
- [Fault scenarios](https://github.com/troggoman/rhcsa-simulator/blob/master/tasks/troubleshooting.py): `tasks/troubleshooting.py`
- [Boot rescue lab](https://github.com/troggoman/rhcsa-simulator/blob/master/core/boot_rescue.py): `core/boot_rescue.py`
- [Lab machine](https://github.com/troggoman/rhcsa-simulator/blob/master/core/lab_machine.py): `core/lab_machine.py`
- [NFS provisioning](https://github.com/troggoman/rhcsa-simulator/blob/master/core/nfs_server.py): `core/nfs_server.py`
- [Practice devices](https://github.com/troggoman/rhcsa-simulator/blob/master/device/device_manager.py): `device/device_manager.py`

### Validation and progress

- [Validation engine](https://github.com/troggoman/rhcsa-simulator/blob/master/core/validator.py): `core/validator.py`
- [Safe execution](https://github.com/troggoman/rhcsa-simulator/blob/master/validators/safe_executor.py): `validators/safe_executor.py`
- [Results database](https://github.com/troggoman/rhcsa-simulator/blob/master/core/results_db.py): `core/results_db.py`
- [Reboot checks](https://github.com/troggoman/rhcsa-simulator/blob/master/core/reboot_engine.py): `core/reboot_engine.py`
- [Review and disputes](https://github.com/troggoman/rhcsa-simulator/blob/master/core/dispute.py): `core/dispute.py`

### Other components

- **Candidate**

## Connections

- Candidate → CLI entry: starts (evidence: `README.md`)
- CLI entry → Mock exam: launches (evidence: `rhcsa_simulator.py`)
- CLI entry → Main menu: opens (evidence: `rhcsa_simulator.py`)
- CLI entry → Practice rounds: launches (evidence: `rhcsa_simulator.py`)
- CLI entry → Learning mode: launches (evidence: `rhcsa_simulator.py`)
- CLI entry → Adaptive learning: launches (evidence: `rhcsa_simulator.py`)
- Mock exam → Task registry: draws tasks (evidence: `core/exam.py`)
- Mock exam → Validation engine: validates tasks (evidence: `core/exam.py`)
- Mock exam → Results database: records results (evidence: `core/exam.py`)
- Mock exam → Task panel: opens panel (evidence: `core/exam.py`)
- Mock exam → Task setup: prepares tasks (evidence: `README.md`)
- Mock exam → Reboot checks: checks reboot (evidence: `core/exam.py`)
- Task registry → Task scenarios: discovers modules (evidence: `tasks/registry.py`)
- Task registry → Exam objectives: filters by scope (evidence: `tasks/registry.py`)
- Task scenarios → Task model: extends (evidence: `tasks/base.py`)
- Task scenarios → Validation engine: implements checks (evidence: `tasks/base.py`)
- Task setup → Fault scenarios: prepares scenarios (evidence: `tasks/troubleshooting.py`)
- Mock exam → Lab machine: uses lab machine (evidence: `core/exam.py`)
- Mock exam → NFS provisioning: provisions NFS (evidence: `core/exam.py`)
- Task scenarios → NFS provisioning: uses server (evidence: `tasks/network_storage.py`)
- Task scenarios → Practice devices: configures networking (evidence: `tasks/networking.py`)
- Validation engine → Safe execution: checks safely
- Main menu → Boot rescue lab: offers rescue lab (evidence: `core/menu.py`)
- Main menu → Results database: shows history (evidence: `core/menu.py`)
- Main menu → Review and disputes: opens disputes (evidence: `core/menu.py`)
- Reboot checks → Validation engine: revalidates (evidence: `core/reboot_engine.py`)
