# lfy090926/startonlyone architecture

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

- Interactive diagram: https://gitdiagram.com/lfy090926/startonlyone
- Repository: https://github.com/lfy090926/startonlyone

## Overview

StartOnlyOne is a Windows utility for creating managed launchers that prevent repeated starts, with configurable cooldowns, shortcut backup and restore, and batch conversion. The documented user flow is to open the wizard, select a program and settings, and create a managed shortcut or SOO file; running the app directly also offers batch conversion. The README does not identify which C++ modules implement these features, so paths below are best-effort matches to filenames, and edges are limited to documented behavior.

Main entry points: [`UI.cpp`](https://github.com/lfy090926/startonlyone/blob/main/UI.cpp) (Creation wizard), [`Main.cpp`](https://github.com/lfy090926/startonlyone/blob/main/Main.cpp) (Application entry), [`Proc.cpp`](https://github.com/lfy090926/startonlyone/blob/main/Proc.cpp) (Batch conversion), [`SOO_Kernel.cpp`](https://github.com/lfy090926/startonlyone/blob/main/SOO_Kernel.cpp) (Managed launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["Application entry<br/>[Main.cpp]"]
  node_wizard["Creation wizard<br/>[UI.cpp]"]
  node_init["First-run setup<br/>[Init.cpp]"]
  node_batch["Batch conversion<br/>[Proc.cpp]"]
  node_paths["Shortcut locations<br/>[GetPaths.cpp]"]
end

subgraph group_launch["Managed Launch"]
  node_launcher["Managed launcher<br/>[SOO_Kernel.cpp]"]
  node_soo_file["SOO file handling<br/>[SOO_Ex.cpp]"]
  node_cooldown["Cooldown settings<br/>[Time.cpp]"]
end

subgraph group_backup["Backup And Restore"]
  node_file_ops["File operations<br/>[FileOperation.cpp]"]
end

subgraph group_support["System Support"]
  node_char_convert["Character conversion<br/>[CharConvert.cpp]"]
end

node_user(("Windows user"))
node_target["Target program"]
node_shortcuts["Desktop and taskbar shortcuts"]

node_user -->|"opens"| node_wizard
node_wizard -->|"creates shortcut"| node_launcher
node_wizard -->|"creates SOO file"| node_soo_file
node_user -->|"runs directly"| node_entry
node_entry -->|"offers conversion"| node_batch
node_user -->|"selects program"| node_target
node_wizard -->|"sets cooldown"| node_cooldown
node_launcher -->|"prevents repeat starts"| node_target
node_batch -->|"converts shortcuts"| node_shortcuts
node_user -->|"backs up or restores"| node_shortcuts
node_init -->|"registers context menu"| node_user

click node_entry "https://github.com/lfy090926/startonlyone/blob/main/Main.cpp"
click node_wizard "https://github.com/lfy090926/startonlyone/blob/main/UI.cpp"
click node_init "https://github.com/lfy090926/startonlyone/blob/main/Init.cpp"
click node_batch "https://github.com/lfy090926/startonlyone/blob/main/Proc.cpp"
click node_paths "https://github.com/lfy090926/startonlyone/blob/main/GetPaths.cpp"
click node_launcher "https://github.com/lfy090926/startonlyone/blob/main/SOO_Kernel.cpp"
click node_soo_file "https://github.com/lfy090926/startonlyone/blob/main/SOO_Ex.cpp"
click node_cooldown "https://github.com/lfy090926/startonlyone/blob/main/Time.cpp"
click node_file_ops "https://github.com/lfy090926/startonlyone/blob/main/FileOperation.cpp"
click node_char_convert "https://github.com/lfy090926/startonlyone/blob/main/CharConvert.cpp"

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_entry,node_wizard,node_init,node_batch,node_paths,node_user toneBlue
class node_launcher,node_soo_file,node_cooldown toneAmber
class node_file_ops toneMint
class node_char_convert,node_shortcuts toneRose
class node_target toneIndigo
```

## Components

### Application

- [Application entry](https://github.com/lfy090926/startonlyone/blob/main/Main.cpp): `Main.cpp`
- [Creation wizard](https://github.com/lfy090926/startonlyone/blob/main/UI.cpp): `UI.cpp`
- [First-run setup](https://github.com/lfy090926/startonlyone/blob/main/Init.cpp): `Init.cpp`
- [Batch conversion](https://github.com/lfy090926/startonlyone/blob/main/Proc.cpp): `Proc.cpp`
- [Shortcut locations](https://github.com/lfy090926/startonlyone/blob/main/GetPaths.cpp): `GetPaths.cpp`

### Managed Launch

- [Managed launcher](https://github.com/lfy090926/startonlyone/blob/main/SOO_Kernel.cpp): `SOO_Kernel.cpp`
- [SOO file handling](https://github.com/lfy090926/startonlyone/blob/main/SOO_Ex.cpp): `SOO_Ex.cpp`
- [Cooldown settings](https://github.com/lfy090926/startonlyone/blob/main/Time.cpp): `Time.cpp`

### Backup And Restore

- [File operations](https://github.com/lfy090926/startonlyone/blob/main/FileOperation.cpp): `FileOperation.cpp`

### System Support

- [Character conversion](https://github.com/lfy090926/startonlyone/blob/main/CharConvert.cpp): `CharConvert.cpp`

### Other components

- **Windows user**
- **Target program**
- **Desktop and taskbar shortcuts**

## Connections

- Windows user → Creation wizard: opens (evidence: `README.md`)
- Creation wizard → Managed launcher: creates shortcut (evidence: `README.md`)
- Creation wizard → SOO file handling: creates SOO file (evidence: `README.md`)
- Windows user → Application entry: runs directly (evidence: `README.md`)
- Application entry → Batch conversion: offers conversion (evidence: `README.md`)
- Windows user → Target program: selects program (evidence: `README.md`)
- Creation wizard → Cooldown settings: sets cooldown (evidence: `README.md`)
- Managed launcher → Target program: prevents repeat starts (evidence: `README.md`)
- Batch conversion → Desktop and taskbar shortcuts: converts shortcuts (evidence: `README.md`)
- Windows user → Desktop and taskbar shortcuts: backs up or restores (evidence: `README.md`)
- First-run setup → Windows user: registers context menu (evidence: `README.md`)
