new awesome build

APP_CORE/README.md

@@ -0,0 +1,38 @@
+# Core Monitoring Module (`APP_CORE`)
+
+The **Core Monitoring** module provides the backend logic for collecting, extracting, and serving OpenVPN usage statistics.
+
+## Components
+
+1.  **Mining API (`openvpn_api_v3.py`)**:
+    -   A Flask-based REST API running on port `5001`.
+    -   Serves real-time data, authentication (JWT), and historical statistics.
+    -   Connects to the SQLite database `ovpmon.db`.
+
+2.  **Data Gatherer (`openvpn_gatherer_v3.py`)**:
+    -   A background service/daemon.
+    -   Parses OpenVPN server logs (`status.log`).
+    -   Aggregates bandwidth usage into time-series tables (`usage_history`, `stats_hourly`, etc.).
+
+## Configuration
+
+Configuration is handled via `config.ini` (typically located in the project root or `/etc/openvpn/monitor/`).
+
+## Development
+
+```bash
+# Setup Environment
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+
+# Run API
+python3 openvpn_api_v3.py
+
+# Run Gatherer (in separate terminal)
+python3 openvpn_gatherer_v3.py
+```
+
+## API Documentation
+
+Full API documentation is available in `DOCS/Core_Monitoring/API_Reference.md`.