init

docs/architecture.md

@@ -0,0 +1,41 @@
+# Architecture Overview
+
+The ASF Infrastructure Monitor is a lightweight, real-time monitoring solution designed to track the health of local servers and web services.
+
+## System Components
+
+```mermaid
+graph TD
+    User((User Browser))
+    Caddy[Caddy Proxy]
+    MonitorApp[Monitor App Container]
+    
+    subgraph "Local Network / Internet"
+        PC[Ubuntu Server PC]
+        PI[Raspberry Pi]
+        WebServices[Web Services]
+    end
+
+    User -->|HTTPS| Caddy
+    Caddy -->|HTTP| MonitorApp
+    
+    MonitorApp -->|SSH| PC
+    MonitorApp -->|SSH| PI
+    MonitorApp -->|HTTP/Ping| WebServices
+```
+
+### 1. Frontend (Client-Side)
+- **Technology**: HTML5, Vanilla CSS, JavaScript (ES6+).
+- **Libraries**: Chart.js for gauges, FontAwesome for icons.
+- **Functionality**: Fetches data from the backend every 60 seconds and updates the UI dynamically without page reloads.
+
+### 2. Backend (Server-Side)
+- **Technology**: Python 3.11, FastAPI.
+- **Monitoring Logic**:
+    - **SSH**: Uses `paramiko` to execute remote commands on the PC and Raspberry Pi.
+    - **Web**: Uses `requests` to check the status and latency of web services.
+- **Concurrency**: Uses `asyncio` to perform all monitoring checks in parallel, ensuring fast response times.
+
+### 3. Deployment
+- **Containerization**: Docker & Docker Compose.
+- **Proxy**: Caddy handles SSL termination and routes traffic to the container.