Update documentation for new features and add practical scenarios

Documentation updates:
- Updated Server README with new endpoints and features
- Updated Client README with task receiver mode
- Updated Bot README with task commands
- Added comprehensive logging and security sections

New scenario guides:
- Math calculation bots example
- Distributed build system
- Monitoring and alerting system
- File synchronization and backup
- Quick start guide for math bots
- Scenarios overview page

Updated main README with:
- Links to new scenarios
- Feature highlights (task system, logging, duplicate prevention)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: stho32

README.md

@@ -42,12 +42,22 @@ Usage Scenarios include:
 
 -   [CI/CD-Pipeline](./docs/usage-cicd-pipeline.md)
 -   [Central Log](./docs/usage-central-log.md)
+-   [Math Calculation Bots](./docs/scenarios/math-calculation-bots.md)
+-   [Distributed Build System](./docs/scenarios/distributed-build-system.md)
+-   [Monitoring & Alerting](./docs/scenarios/monitoring-alerting-system.md)
+-   [File Sync & Backup](./docs/scenarios/file-sync-backup.md)
+-   [More Scenarios...](./docs/scenarios/README.md)
 
 ## Features
 
 -   Available for Windows, Linux and macOS
 -   Easy to use
--   Adds a few simple entry points / command line tools that enable network communication between a group of hosts and sub applications.
+-   Adds a few simple entry points / command line tools that enable network communication between a group of hosts and sub applications
+-   **Task System**: Distribute work across multiple clients with tag-based routing
+-   **Duplicate Prevention**: Messages with same ID are rejected within 1 hour
+-   **Comprehensive Logging**: Daily rotating logs with Serilog integration
+-   **Direct Messaging**: Send messages to specific clients using `/msg ClientName`
+-   **File Storage**: Central file repository accessible by all clients
 -   Ability to execute and run tasks between your local apps through command line over the network
 -   Encrypted communication
 -   and more

docs/Bot/README.md

@@ -9,10 +9,18 @@ The LNAC Bot only reacts to messages that are sent directly to it. It's main pur
 
 ## Commands
 
-- `exec filename parameter1 parameter2 parameter 3` will execute an existing script on the given path
-- `help filename` is a special command for powershell scripts only. It parses the Parameters that are defined at the top of the powershell script
-- `listcommands` will return a list of all existing scripts on the given path.
-- `/ping` well, just another ping pong command :)
+### Default Commands
+- `/ping` - Simple ping pong command to test bot connectivity
+
+### Script Execution Commands (Private Messages Only)
+- `exec filename parameter1 parameter2 parameter 3` - Execute an existing script on the given path
+- `help filename` - Special command for PowerShell scripts only. Parses the parameters defined at the top of the script
+- `listcommands` - Returns a list of all existing scripts on the given path
+
+### Task Commands
+- `/task "description" tags:tag1,tag2 params:{"key":"value"}` - Create a new task with optional tags and parameters
+- `/tasklist tags:tag1,tag2` - List pending tasks (optional tag filter)
+- `/taskstatus <task-id>` - Check the status of a specific task
 
 ## Bot CLI
 

docs/Client/README.md

@@ -4,7 +4,7 @@ The LNAC Client allows you to communicate with the server as well as with other
 
 ## Features
 
-- 7 different modes which perform different tasks
+- 8 different modes which perform different tasks
 
 ### Client Modes
 
@@ -37,6 +37,14 @@ The File operation mode allows the client to upload, download, delete and get a
 - filedelete // Will delete the given file from the server.
 - listfiles // Will return a list of all existing files on the server.
 
+#### Task Receiver
+
+The task receiver mode allows the client to process tasks from the server. The client polls for new tasks with matching tags, claims them, executes a configured processor script, and reports results back to the server.
+
+```
+$ LocalNetAppChat.ConsoleClient taskreceiver --server "localhost" --port 51234 --key 1234 --tags "build,test" --processor "./run-task.ps1"
+```
+
 ## Client CLI
 
 ```console
@@ -51,6 +59,7 @@ LocalNetAppChat.ConsoleClient [options]
     filedelete           Deletes an existing file from the server
     listfiles            Returns a list of all existing files on the server
     chat                 Runs the client essentially in a listener mode, but when you start typing you are delivered a prompt and with    enter you will send the message
+    taskreceiver         Run the client in task receiver mode to process tasks
     --file               Path of the file you want to delete, download or upload from/to the server
     --targetPath         Path where you want the requested File to be saved at after downloading it
     --text               The text message to send to the server. (only when in message mode!)
@@ -60,6 +69,8 @@ LocalNetAppChat.ConsoleClient [options]
     --port               The port the server should connect to (default: 5000)
     --https              Whether to start the server as HTTPS or HTTP server
     --key                An Authentication password that the server requires to allow incoming requests from the client!
+    --tags               Comma-separated list of tags for task filtering in task receiver mode
+    --processor          Path to the script/executable to process tasks in task receiver mode
 
   Examples:
 
@@ -77,5 +88,7 @@ LocalNetAppChat.ConsoleClient [options]
     $ LocalNetAppChat.ConsoleClient filedelete --server "localhost" --port 51234 --key 1234 --file "README.md"
   - List all files existing on the server
     $ LocalNetAppChat.ConsoleClient listfiles --server "localhost" --port 51234 --key 1234
+  - Run the client in task receiver mode
+    $ LocalNetAppChat.ConsoleClient taskreceiver --server "localhost" --port 51234 --key 1234 --tags "build,test" --processor "./run-task.ps1"
 
 ```

docs/Server/README.md

@@ -9,6 +9,9 @@ The LNAC Server is responsible for almost everything:
 - Basic communication handling (Sending and Receiving messages to/from clients)
 - Basic Storage API (Can receive, upload and delete Files existing in the script folder on the folder)
 - Parsing and Handling `Direct Messages` between clients
+- Duplicate message prevention (1 hour retention)
+- Task management system for distributed work
+- Comprehensive logging with daily rotation (14-day retention)
 
 ## Server CLI
 
@@ -32,3 +35,36 @@ LocalNetAppChat.Server [options]
     $ LocalNetAppChat.Server --listenOn "54.15.12.1" --port "54822" --https --key "HeythereGithubExample"
 
 ```
+
+## Server API Endpoints
+
+### Messaging
+- `GET /receive?key={key}&clientName={clientName}` - Poll for new messages
+- `POST /send?key={key}` - Send a message (body: LnacMessage JSON)
+
+### File Storage
+- `POST /upload?key={key}` - Upload a file (multipart/form-data)
+- `GET /download?key={key}&filename={filename}` - Download a file
+- `GET /listallfiles?key={key}` - List all files
+- `POST /deletefile?key={key}&filename={filename}` - Delete a file
+
+### Task Management
+- `POST /tasks/create?key={key}` - Create a new task (body: TaskMessage JSON)
+- `GET /tasks/pending?key={key}&tags={tags}` - Get pending tasks (optional tag filter)
+- `POST /tasks/claim?key={key}&taskId={id}&clientName={name}` - Claim a task
+- `POST /tasks/complete?key={key}&taskId={id}&clientName={name}&success={bool}&result={result}` - Complete a task
+- `GET /tasks/status?key={key}&taskId={id}` - Get task status
+
+## Logging
+
+The server uses Serilog for comprehensive logging:
+- Console output with timestamps
+- Daily rotating log files in `logs/` directory
+- 14-day retention policy
+- Log files named: `lnac-server-YYYYMMDD.log`
+
+## Security
+
+- Key-based authentication required for all endpoints
+- Messages are rejected if duplicate ID is detected within 1 hour
+- HTTPS support with `--https` flag

docs/quickstart-math-bots.md

@@ -0,0 +1,117 @@
+# Schnellstart: Mathe-Bots in 5 Minuten
+
+Eine schnelle Anleitung, um das Mathe-Bot-System zum Laufen zu bringen.
+
+## Schritt 1: Scripts vorbereiten
+
+Erstellen Sie einen Ordner `math-scripts` und fügen Sie diese Dateien hinzu:
+
+### math-scripts/generate.ps1
+```powershell
+$a = Get-Random -Minimum 0 -Maximum 11
+$b = Get-Random -Minimum 0 -Maximum 11
+Write-Output "$a + $b = ?"
+```
+
+### math-scripts/calculate.ps1
+```powershell
+param([string]$input)
+if ($input -match "(\d+)\s*\+\s*(\d+)") {
+    $result = [int]$matches[1] + [int]$matches[2]
+    Write-Output "Result: $result"
+    if ($result -gt 10) {
+        Write-Output "WOW! That's more than 10!"
+    }
+}
+```
+
+## Schritt 2: Alles starten
+
+Öffnen Sie 4 Terminal-Fenster:
+
+**Terminal 1 - Server:**
+```bash
+LocalNetAppChat.Server --port 5000 --key "demo"
+```
+
+**Terminal 2 - Generator Bot:**
+```bash
+LocalNetAppChat.Bot --server localhost --port 5000 --key "demo" --clientName "GeneratorBot" --scriptspath "./math-scripts"
+```
+
+**Terminal 3 - Calculator Bot:**
+```bash
+LocalNetAppChat.Bot --server localhost --port 5000 --key "demo" --clientName "CalculatorBot" --scriptspath "./math-scripts"
+```
+
+**Terminal 4 - Observer:**
+```bash
+LocalNetAppChat.ConsoleClient listener --server localhost --port 5000 --key "demo" --clientName "Observer"
+```
+
+## Schritt 3: Die Show starten
+
+Öffnen Sie ein 5. Terminal für den Chat:
+```bash
+LocalNetAppChat.ConsoleClient chat --server localhost --port 5000 --key "demo" --clientName "Controller"
+```
+
+Geben Sie im Chat ein:
+```
+/msg GeneratorBot exec generate.ps1
+```
+
+## Was Sie sehen werden
+
+Im Observer-Fenster erscheint:
+```
+[2024-01-20 15:30:45] GeneratorBot: 7 + 4 = ?
+```
+
+Jetzt können Sie den Calculator triggern:
+```
+/msg CalculatorBot exec calculate.ps1 "7 + 4"
+```
+
+Ausgabe:
+```
+[2024-01-20 15:30:50] CalculatorBot: Result: 11
+[2024-01-20 15:30:50] CalculatorBot: WOW! That's more than 10!
+```
+
+## Automatisierung
+
+Für kontinuierliche Generierung, erstellen Sie `auto-generate.ps1`:
+```powershell
+while($true) {
+    $a = Get-Random -Minimum 0 -Maximum 11
+    $b = Get-Random -Minimum 0 -Maximum 11
+    Write-Output "/msg CalculatorBot exec calculate.ps1 `"$a + $b`""
+    Start-Sleep -Seconds 3
+}
+```
+
+Und starten Sie es:
+```
+/msg GeneratorBot exec auto-generate.ps1
+```
+
+## Troubleshooting
+
+**Problem:** "Access denied"
+- Lösung: Prüfen Sie, ob alle Komponenten denselben Key verwenden
+
+**Problem:** Bot reagiert nicht
+- Lösung: Stellen Sie sicher, dass der Bot läuft und der Name korrekt ist
+
+**Problem:** Scripts werden nicht gefunden
+- Lösung: Prüfen Sie den `--scriptspath` Parameter
+
+## Nächste Schritte
+
+- Fügen Sie mehr Mathematik-Operationen hinzu
+- Erstellen Sie einen Statistik-Bot
+- Implementieren Sie ein Punkte-System
+- Erweitern Sie auf Algebra-Aufgaben
+
+Viel Spaß beim Experimentieren! 🎉