# abubakrpm/rocketdevops-mobile architecture

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

- Interactive diagram: https://gitdiagram.com/abubakrpm/rocketdevops-mobile
- Repository: https://github.com/abubakrpm/rocketdevops-mobile

## Overview

RocketDevOps Mobile is an offline Android learning app for Linux, Git, and Docker. Learners browse tracks and lessons, take quizzes, and practice in labs; the lab terminal interprets commands against simulated in-memory systems, then completion updates persistent progress. Cheat sheets, profile/progress, onboarding, and settings are additional user-facing capabilities. The README documents the main MVVM and terminal flows; source excerpts confirm selected repository and simulator behavior, while unsampled UI wiring is not inferred beyond those documented relationships.

Main entry points: [`app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt) (Terminal engine), [`app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt`](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt) (Content repository), [`app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt`](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt) (Progress repository), [`app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt`](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt) (Lab experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Learning experience"]
  node_navigation["Navigation<br/>[AppNavHost.kt]"]
  node_home["Home and tracks<br/>[HomeScreen.kt]"]
  node_lesson["Lessons<br/>[LessonScreen.kt]"]
  node_quiz["Live quizzes<br/>[QuizSession.kt]"]
  node_labui["Lab experience<br/>[LabController.kt]"]
  node_cheats["Cheat sheet"]
  node_profile["Profile and progress<br/>[ProfileScreen.kt]"]
  node_settings["Onboarding and settings<br/>[SettingsScreen.kt]"]
end

subgraph group_content["Learning content"]
  node_contentrepo["Content repository"]
  node_catalog["Content catalog<br/>[ContentCatalog.kt]"]
  node_contentfiles["Offline JSON content"]
end

subgraph group_simulation["Lab simulation"]
  node_labsession["Lab session<br/>[LabSession.kt]"]
  node_engine["Terminal engine<br/>[TerminalEngine.kt]"]
  node_parser["Command parser<br/>[CommandParser.kt]"]
  node_linux["Linux commands<br/>[LinuxCommands.kt]"]
  node_process["Process commands<br/>[ProcessCommands.kt]"]
  node_git["Git simulator<br/>[GitRepository.kt]"]
  node_docker["Docker simulator<br/>[DockerDaemon.kt]"]
  node_filesystem["Virtual filesystem"]
end

subgraph group_state["User state"]
  node_progressrepo["Progress repository"]
  node_progressdb[("Progress database")]
  node_preferences["Preferences repository"]
  node_datastore[("Preferences store<br/>[UserPreferences.kt]")]
end

node_learner(("Learner"))

node_learner -->|"opens screens"| node_navigation
node_navigation -.->|"routes to"| node_home
node_home -.->|"requests content"| node_contentrepo
node_lesson -.->|"requests content"| node_contentrepo
node_quiz -.->|"loads quiz content"| node_contentrepo
node_labui -->|"loads lab"| node_contentrepo
node_cheats -.->|"loads entries"| node_contentrepo
node_contentrepo -->|"loads JSON"| node_contentfiles
node_contentrepo -->|"caches catalog"| node_catalog
node_labui -->|"runs lab"| node_labsession
node_labsession -->|"runs commands"| node_engine
node_engine -->|"parses input"| node_parser
node_engine -->|"registers handlers"| node_linux
node_engine -->|"registers handlers"| node_process
node_engine -->|"dispatches Git"| node_git
node_engine -->|"dispatches Docker"| node_docker
node_engine -->|"seeds filesystem"| node_filesystem
node_git -->|"uses filesystem"| node_filesystem
node_labui -.->|"records completion"| node_progressrepo
node_quiz -.->|"records attempts"| node_progressrepo
node_progressrepo -->|"reads and writes"| node_progressdb
node_progressrepo -->|"streams snapshot"| node_profile
node_settings -->|"changes settings"| node_preferences
node_preferences -->|"persists preferences"| node_datastore

click node_navigation "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/navigation/AppNavHost.kt"
click node_home "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/home/HomeScreen.kt"
click node_lesson "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/lesson/LessonScreen.kt"
click node_quiz "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/quiz/QuizSession.kt"
click node_labui "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt"
click node_cheats "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/cheats/CheatSheetScreen.kt"
click node_profile "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/profile/ProfileScreen.kt"
click node_settings "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/settings/SettingsScreen.kt"
click node_contentrepo "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt"
click node_catalog "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/content/ContentCatalog.kt"
click node_contentfiles "https://github.com/abubakrpm/rocketdevops-mobile/tree/main/app/src/main/assets/content"
click node_labsession "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/LabSession.kt"
click node_engine "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt"
click node_parser "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/CommandParser.kt"
click node_linux "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/LinuxCommands.kt"
click node_process "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/ProcessCommands.kt"
click node_git "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/GitRepository.kt"
click node_docker "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/DockerDaemon.kt"
click node_filesystem "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/VirtualFileSystem.kt"
click node_progressrepo "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt"
click node_progressdb "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/progress/db/ProgressDatabase.kt"
click node_preferences "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferencesRepository.kt"
click node_datastore "https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferences.kt"

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_navigation,node_home,node_lesson,node_quiz,node_labui,node_cheats,node_profile,node_settings toneBlue
class node_contentrepo,node_catalog,node_contentfiles toneAmber
class node_labsession,node_engine,node_parser,node_linux,node_process,node_git,node_docker,node_filesystem toneMint
class node_progressrepo,node_progressdb,node_preferences,node_datastore toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [Navigation](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/navigation/AppNavHost.kt): `app/src/main/java/com/rocketdevops/mobile/navigation/AppNavHost.kt`
- [Home and tracks](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/home/HomeScreen.kt): `app/src/main/java/com/rocketdevops/mobile/ui/home/HomeScreen.kt`
- [Lessons](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/lesson/LessonScreen.kt): `app/src/main/java/com/rocketdevops/mobile/ui/lesson/LessonScreen.kt`
- [Live quizzes](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/quiz/QuizSession.kt): `app/src/main/java/com/rocketdevops/mobile/ui/quiz/QuizSession.kt`
- [Lab experience](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt): `app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt`
- [Cheat sheet](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/cheats/CheatSheetScreen.kt): `app/src/main/java/com/rocketdevops/mobile/ui/cheats/CheatSheetScreen.kt`
- [Profile and progress](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/profile/ProfileScreen.kt): `app/src/main/java/com/rocketdevops/mobile/ui/profile/ProfileScreen.kt`
- [Onboarding and settings](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/ui/settings/SettingsScreen.kt): `app/src/main/java/com/rocketdevops/mobile/ui/settings/SettingsScreen.kt`

### Learning content

- [Content repository](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt): `app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt`
- [Content catalog](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/content/ContentCatalog.kt): `app/src/main/java/com/rocketdevops/mobile/data/content/ContentCatalog.kt`
- [Offline JSON content](https://github.com/abubakrpm/rocketdevops-mobile/tree/main/app/src/main/assets/content): `app/src/main/assets/content`

### Lab simulation

- [Lab session](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/LabSession.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/LabSession.kt`
- [Terminal engine](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`
- [Command parser](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/CommandParser.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/CommandParser.kt`
- [Linux commands](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/LinuxCommands.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/LinuxCommands.kt`
- [Process commands](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/ProcessCommands.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/ProcessCommands.kt`
- [Git simulator](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/GitRepository.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/GitRepository.kt`
- [Docker simulator](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/DockerDaemon.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/DockerDaemon.kt`
- [Virtual filesystem](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/terminal/VirtualFileSystem.kt): `app/src/main/java/com/rocketdevops/mobile/terminal/VirtualFileSystem.kt`

### User state

- [Progress repository](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt): `app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt`
- [Progress database](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/progress/db/ProgressDatabase.kt): `app/src/main/java/com/rocketdevops/mobile/data/progress/db/ProgressDatabase.kt`
- [Preferences repository](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferencesRepository.kt): `app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferencesRepository.kt`
- [Preferences store](https://github.com/abubakrpm/rocketdevops-mobile/blob/main/app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferences.kt): `app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferences.kt`

### Other components

- **Learner**

## Connections

- Learner → Navigation: opens screens
- Navigation → Home and tracks: routes to
- Home and tracks → Content repository: requests content
- Lessons → Content repository: requests content
- Live quizzes → Content repository: loads quiz content
- Lab experience → Content repository: loads lab (evidence: `app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt`)
- Cheat sheet → Content repository: loads entries
- Content repository → Offline JSON content: loads JSON
- Content repository → Content catalog: caches catalog (evidence: `app/src/main/java/com/rocketdevops/mobile/data/content/ContentRepository.kt`)
- Lab experience → Lab session: runs lab (evidence: `app/src/main/java/com/rocketdevops/mobile/ui/lab/LabController.kt`)
- Lab session → Terminal engine: runs commands (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/LabSession.kt`)
- Terminal engine → Command parser: parses input (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Terminal engine → Linux commands: registers handlers (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Terminal engine → Process commands: registers handlers (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Terminal engine → Git simulator: dispatches Git (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Terminal engine → Docker simulator: dispatches Docker (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Terminal engine → Virtual filesystem: seeds filesystem (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/TerminalEngine.kt`)
- Git simulator → Virtual filesystem: uses filesystem (evidence: `app/src/main/java/com/rocketdevops/mobile/terminal/GitRepository.kt`)
- Lab experience → Progress repository: records completion
- Live quizzes → Progress repository: records attempts
- Progress repository → Progress database: reads and writes (evidence: `app/src/main/java/com/rocketdevops/mobile/data/progress/ProgressRepository.kt`)
- Progress repository → Profile and progress: streams snapshot
- Onboarding and settings → Preferences repository: changes settings
- Preferences repository → Preferences store: persists preferences (evidence: `app/src/main/java/com/rocketdevops/mobile/data/prefs/UserPreferencesRepository.kt`)
