Guardian 1.0 Backbone

This repository provides a starter backbone for the Guardian 1.0 design:

• Blazor-based Control Console (UI)
• .NET 8 Backend Service (worker)
• Shared contracts for configuration and alerting rules

Proposed 1.0 Structure

src/
  Guardian.Contracts/
    ConfigurationV1.cs
  Guardian.ControlConsole/
    README.md
    appsettings.json
  Guardian.BackendService/
    README.md
    appsettings.json
    Program.cs
config-samples/
  guardian-config.v1.sample.json

What is implemented in this backbone

Shared 1.0 Contracts

• SMTP parameters
• Monitored services list
• Disk thresholds (non-critical + critical)
• Refresh interval
• Cooldown policies for:
  • Service stop events (5 min)
  • Disk non-critical events (24 h)
  • Disk critical events (1 h)

Backend Service

• Reads configuration file generated by UI
• Runs timer-based monitoring loop
• Periodic monitoring worker implemented
• Service status checks (Linux systemctl, Windows sc.exe)
• Disk occupancy checks for local machine
• SMTP alert sender with cooldown policy and critical override handling
• Installation scripts for Linux systemd and Windows service

UI Skeleton Expectations

• UI project config file includes path for backend JSON generation target
• Placeholder notes for:
  • Auto-refresh service list
  • Service selection
  • Disk check setup
  • SMTP setup
  • Generate JSON config action

Next step implementation order

1. Build Control Console forms for SMTP/service/disk settings.
2. Implement JSON export to backend config file.
3. Implement backend probes (service + disk).
4. Implement SMTP sender and policy engine.
5. Add integration tests and deployment packaging.
6. Add database monitoring

Visual Studio

Open Guardian.sln in Visual Studio to load the backbone projects:

• Guardian.Contracts (shared contracts)
• Guardian.BackendService (worker skeleton)
• Guardian.ControlConsole (web UI placeholder)