# ricci141/logdaemon architecture

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

- Interactive diagram: https://gitdiagram.com/ricci141/logdaemon
- Repository: https://github.com/ricci141/logdaemon

## Overview

LogDaemon is a background service for backing up a RageMP chat log when the monitored game process changes state. The hosted worker polls the process monitor and invokes the backup service on either transition; although the README describes shutdown, the sampled worker also backs up when the process starts. The backup service hashes the log, skips known hashes, and saves new copies and index entries. The graph reflects sampled calls and documented configuration; filesystem resources are shown as external state.

Main entry points: [`Workers/Services/ChatLogBackupService.cs`](https://github.com/ricci141/logdaemon/blob/main/Workers/Services/ChatLogBackupService.cs) (Chat log backup), [`Workers/Program.cs`](https://github.com/ricci141/logdaemon/blob/main/Workers/Program.cs) (Worker host), [`Workers/RageWorker.cs`](https://github.com/ricci141/logdaemon/blob/main/Workers/RageWorker.cs) (Rage worker), [`Workers/Services/RageProcessMonitor.cs`](https://github.com/ricci141/logdaemon/blob/main/Workers/Services/RageProcessMonitor.cs) (Process monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Worker runtime"]
  node_host["Worker host<br/>[Program.cs]"]
  node_worker["Rage worker<br/>[RageWorker.cs]"]
  node_monitor["Process monitor"]
end

subgraph group_backup["Backup workflow"]
  node_backup_service["Chat log backup"]
end

subgraph group_state["Configuration and storage"]
  node_settings["Rage settings<br/>[AppSettings.cs]"]
  node_configuration["App configuration<br/>[appsettings.json]"]
  node_chat_log["Chat log"]
  node_backup_files["Backup files"]
  node_hash_index[("Hash index")]
end

node_operator(("Game user"))
node_game_process["GTA5 process"]

node_operator -->|"runs game"| node_game_process
node_host -->|"loads settings"| node_configuration
node_host -->|"binds settings"| node_settings
node_host -->|"registers monitor"| node_monitor
node_host -->|"registers service"| node_backup_service
node_host -->|"starts hosted worker"| node_worker
node_worker -->|"checks process"| node_monitor
node_monitor -->|"checks running state"| node_game_process
node_worker -->|"backs up on transition"| node_backup_service
node_backup_service -->|"reads paths"| node_settings
node_backup_service -->|"hashes and reads"| node_chat_log
node_backup_service -->|"checks and updates"| node_hash_index
node_backup_service -->|"writes copy"| node_backup_files

click node_host "https://github.com/ricci141/logdaemon/blob/main/Workers/Program.cs"
click node_settings "https://github.com/ricci141/logdaemon/blob/main/Workers/Models/AppSettings.cs"
click node_configuration "https://github.com/ricci141/logdaemon/blob/main/Workers/appsettings.json"
click node_worker "https://github.com/ricci141/logdaemon/blob/main/Workers/RageWorker.cs"
click node_monitor "https://github.com/ricci141/logdaemon/blob/main/Workers/Services/RageProcessMonitor.cs"
click node_backup_service "https://github.com/ricci141/logdaemon/blob/main/Workers/Services/ChatLogBackupService.cs"

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_host,node_worker,node_monitor,node_operator toneBlue
class node_backup_service toneAmber
class node_settings,node_configuration,node_chat_log,node_backup_files,node_hash_index toneMint
class node_game_process toneIndigo
```

## Components

### Worker runtime

- [Worker host](https://github.com/ricci141/logdaemon/blob/main/Workers/Program.cs): `Workers/Program.cs`
- [Rage worker](https://github.com/ricci141/logdaemon/blob/main/Workers/RageWorker.cs): `Workers/RageWorker.cs`
- [Process monitor](https://github.com/ricci141/logdaemon/blob/main/Workers/Services/RageProcessMonitor.cs): `Workers/Services/RageProcessMonitor.cs`

### Backup workflow

- [Chat log backup](https://github.com/ricci141/logdaemon/blob/main/Workers/Services/ChatLogBackupService.cs): `Workers/Services/ChatLogBackupService.cs`

### Configuration and storage

- [Rage settings](https://github.com/ricci141/logdaemon/blob/main/Workers/Models/AppSettings.cs): `Workers/Models/AppSettings.cs`
- [App configuration](https://github.com/ricci141/logdaemon/blob/main/Workers/appsettings.json): `Workers/appsettings.json`
- **Chat log**
- **Backup files**
- **Hash index**

### Other components

- **Game user**
- **GTA5 process**

## Connections

- Game user → GTA5 process: runs game (evidence: `README.md`)
- Worker host → App configuration: loads settings (evidence: `README.md`)
- Worker host → Rage settings: binds settings (evidence: `Workers/Program.cs`)
- Worker host → Process monitor: registers monitor (evidence: `Workers/Program.cs`)
- Worker host → Chat log backup: registers service (evidence: `Workers/Program.cs`)
- Worker host → Rage worker: starts hosted worker (evidence: `Workers/Program.cs`)
- Rage worker → Process monitor: checks process (evidence: `Workers/RageWorker.cs`)
- Process monitor → GTA5 process: checks running state (evidence: `Workers/Services/RageProcessMonitor.cs`)
- Rage worker → Chat log backup: backs up on transition (evidence: `Workers/RageWorker.cs`)
- Chat log backup → Rage settings: reads paths (evidence: `Workers/Services/ChatLogBackupService.cs`)
- Chat log backup → Chat log: hashes and reads (evidence: `Workers/Services/ChatLogBackupService.cs`)
- Chat log backup → Hash index: checks and updates (evidence: `Workers/Services/ChatLogBackupService.cs`)
- Chat log backup → Backup files: writes copy (evidence: `Workers/Services/ChatLogBackupService.cs`)
