# johnsydev/p1-principios-sistemas-operativos-gestor-procesos architecture

> Architecture diagram of the GitHub repository johnsydev/p1-principios-sistemas-operativos-gestor-procesos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos
- Repository: https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos

## Overview

Mini PC Simulator is a Java desktop teaching simulator for an operating-system-like machine. The main workflow is selecting and validating an .asm program, creating a process, loading it into simulated storage and memory, then stepping or running instructions while viewing CPU, memory, and process state. The model also includes scheduling, interrupts, virtual memory, and a simulated file system. Several subsystem links are supported by README descriptions and the source index; unsampled implementation details are not inferred as specific calls.

Main entry points: [`Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java) (System controller), [`Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java) (Program loader), [`Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java) (Scheduler), [`Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java`](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java) (Simulated file system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_window["Simulator window"]
  node_controller["System controller"]
end

subgraph group_execution["Process execution"]
  node_instruction["Instruction model<br/>[Instruction.java]"]
  node_process["Process and PCB<br/>[Process.java]"]
  node_processlist["Process list<br/>[ProcessList.java]"]
  node_scheduler["Scheduler<br/>[Scheduler.java]"]
  node_dispatcher["Dispatcher<br/>[Dispatcher.java]"]
  node_cpu["CPU<br/>[CPU.java]"]
  node_interrupt["Interrupt handler"]
  node_job["Job<br/>[Job.java]"]
  node_joblist["Job list<br/>[JobList.java]"]
  node_clock["System clock<br/>[SystemClock.java]"]
end

subgraph group_storage["Memory and storage"]
  node_loader["Program loader<br/>[Loader.java]"]
  node_memory[("Main memory<br/>[MainMemory.java]")]
  node_disk[("Simulated disk<br/>[Disk.java]")]
  node_filesystem["Simulated file system<br/>[FileSystem.java]"]
  node_fileindex["File index<br/>[FileIndex.java]"]
  node_memregister["Memory register"]
end

subgraph group_services["System services"]
  node_asm["Assembly parser<br/>[AsmParser.java]"]
  node_filemanager["File manager<br/>[FileManager.java]"]
  node_config["System configuration<br/>[SystemConfig.java]"]
end

node_user(("User"))

node_user -->|"operates"| node_window
node_window -->|"requests actions"| node_controller
node_controller -->|"reads program"| node_filemanager
node_controller -->|"validates syntax"| node_asm
node_controller -->|"creates process"| node_process
node_controller -->|"loads program"| node_loader
node_loader -->|"builds instructions"| node_instruction
node_loader -->|"stores instructions"| node_disk
node_loader -->|"loads instructions"| node_memory
node_loader -->|"stores index"| node_fileindex
node_loader -->|"loads process"| node_process
node_controller -->|"drives execution"| node_cpu
node_cpu -->|"fetches instructions"| node_memory
node_cpu -->|"updates state"| node_process
node_cpu -->|"raises interrupts"| node_interrupt
node_controller -->|"manages scheduling"| node_scheduler
node_scheduler -->|"admits jobs"| node_loader
node_scheduler -->|"registers processes"| node_processlist
node_scheduler -->|"takes next job"| node_joblist
node_scheduler -->|"creates process"| node_job
node_scheduler -->|"records start time"| node_clock
node_controller -->|"saves context"| node_dispatcher
node_dispatcher -->|"saves context"| node_process
node_dispatcher -->|"updates memory"| node_memory
node_interrupt -->|"handles file operations"| node_filesystem
node_interrupt -->|"admits waiting jobs"| node_scheduler
node_interrupt -->|"removes process"| node_processlist
node_filesystem -->|"uses disk"| node_disk
node_filesystem -->|"uses loader"| node_loader
node_filesystem -->|"uses index"| node_fileindex
node_memory -->|"stores registers"| node_memregister
node_disk -->|"stores registers"| node_memregister
node_window -->|"sets memory options"| node_config
node_controller -->|"coordinates file system"| node_filesystem

click node_window "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/gui/VentanaPrincipal.java"
click node_controller "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java"
click node_asm "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/services/AsmParser.java"
click node_filemanager "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/services/FileManager.java"
click node_instruction "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Instruction.java"
click node_process "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Process.java"
click node_processlist "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/ProcessList.java"
click node_scheduler "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java"
click node_dispatcher "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Dispatcher.java"
click node_cpu "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java"
click node_interrupt "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java"
click node_loader "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java"
click node_memory "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/MainMemory.java"
click node_disk "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Disk.java"
click node_filesystem "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java"
click node_fileindex "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/FileIndex.java"
click node_memregister "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/MemoryRegister.java"
click node_job "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Job.java"
click node_joblist "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/JobList.java"
click node_clock "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/SystemClock.java"
click node_config "https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/utils/SystemConfig.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_window,node_controller,node_user toneBlue
class node_instruction,node_process,node_processlist,node_scheduler,node_dispatcher,node_cpu,node_interrupt,node_job,node_joblist,node_clock toneAmber
class node_loader,node_memory,node_disk,node_filesystem,node_fileindex,node_memregister toneMint
class node_asm,node_filemanager,node_config toneRose
```

## Components

### User interface

- [Simulator window](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/gui/VentanaPrincipal.java): `Programa/MiniPCSimulator/src/minipcsimulator/gui/VentanaPrincipal.java`
- [System controller](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java): `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`

### Process execution

- [Instruction model](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Instruction.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Instruction.java`
- [Process and PCB](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Process.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Process.java`
- [Process list](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/ProcessList.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/ProcessList.java`
- [Scheduler](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`
- [Dispatcher](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Dispatcher.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Dispatcher.java`
- [CPU](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java`
- [Interrupt handler](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java`
- [Job](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Job.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Job.java`
- [Job list](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/JobList.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/JobList.java`
- [System clock](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/SystemClock.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/SystemClock.java`

### Memory and storage

- [Program loader](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`
- [Main memory](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/MainMemory.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/MainMemory.java`
- [Simulated disk](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/Disk.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/Disk.java`
- [Simulated file system](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java`
- [File index](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/FileIndex.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/FileIndex.java`
- [Memory register](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/model/MemoryRegister.java): `Programa/MiniPCSimulator/src/minipcsimulator/model/MemoryRegister.java`

### System services

- [Assembly parser](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/services/AsmParser.java): `Programa/MiniPCSimulator/src/minipcsimulator/services/AsmParser.java`
- [File manager](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/services/FileManager.java): `Programa/MiniPCSimulator/src/minipcsimulator/services/FileManager.java`
- [System configuration](https://github.com/johnsydev/p1-principios-sistemas-operativos-gestor-procesos/blob/main/Programa/MiniPCSimulator/src/minipcsimulator/utils/SystemConfig.java): `Programa/MiniPCSimulator/src/minipcsimulator/utils/SystemConfig.java`

### Other components

- **User**

## Connections

- User → Simulator window: operates (evidence: `README.md`)
- Simulator window → System controller: requests actions (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- System controller → File manager: reads program (evidence: `README.md`)
- System controller → Assembly parser: validates syntax (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- System controller → Process and PCB: creates process (evidence: `README.md`)
- System controller → Program loader: loads program (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- Program loader → Instruction model: builds instructions (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`)
- Program loader → Simulated disk: stores instructions (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`)
- Program loader → Main memory: loads instructions (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`)
- Program loader → File index: stores index (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`)
- Program loader → Process and PCB: loads process (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Loader.java`)
- System controller → CPU: drives execution (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- CPU → Main memory: fetches instructions (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java`)
- CPU → Process and PCB: updates state (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java`)
- CPU → Interrupt handler: raises interrupts (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/CPU.java`)
- System controller → Scheduler: manages scheduling (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- Scheduler → Program loader: admits jobs (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`)
- Scheduler → Process list: registers processes (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`)
- Scheduler → Job list: takes next job (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`)
- Scheduler → Job: creates process (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`)
- Scheduler → System clock: records start time (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Scheduler.java`)
- System controller → Dispatcher: saves context (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
- Dispatcher → Process and PCB: saves context (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Dispatcher.java`)
- Dispatcher → Main memory: updates memory (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Dispatcher.java`)
- Interrupt handler → Simulated file system: handles file operations (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java`)
- Interrupt handler → Scheduler: admits waiting jobs (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java`)
- Interrupt handler → Process list: removes process (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/InterruptHandler.java`)
- Simulated file system → Simulated disk: uses disk (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java`)
- Simulated file system → Program loader: uses loader (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java`)
- Simulated file system → File index: uses index (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/FileSystem.java`)
- Main memory → Memory register: stores registers (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/MainMemory.java`)
- Simulated disk → Memory register: stores registers (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/model/Disk.java`)
- Simulator window → System configuration: sets memory options (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/gui/VentanaPrincipal.java`)
- System controller → Simulated file system: coordinates file system (evidence: `Programa/MiniPCSimulator/src/minipcsimulator/controller/MiniPCController.java`)
