Initial version of end-to-end monitoring system

.git-blame-ignore-revs

@@ -0,0 +1,6 @@
+# Mass reformatting - introducing CI Agent (Issue #14)
+433cd2b661a88b143fae6e215a487280a5dedf05
+
+189ff3dffca02d8824919060b24ef0a084c609af
+a91de65471c7ad4145a5b509b06a1d08ca1dfd6f
+821770ad1742a746b373d2bd0cf081f2eaebedd9

.github/workflows/agent_ci.yml

@@ -0,0 +1,66 @@
+name: Agent CI
+
+on:
+  push:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/agent/**'
+      - '.github/workflows/agent_ci.yml'
+  pull_request:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/agent/**'
+      - '.github/workflows/agent_ci.yml'
+
+jobs:
+  build-and-test:
+    name: Build & Format Check
+    runs-on: ubuntu-latest
+
+    env:
+      VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup C++ tools
+      uses: aminya/setup-cpp@v1
+      with:
+        clang-format: true
+        cppcheck: true
+
+    - name: Cache vcpkg
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cache/vcpkg
+          sources/agent/build/vcpkg_installed
+        key: vcpkg-${{ runner.os }}-${{ hashFiles('sources/agent/vcpkg.json') }}
+
+    - name: Setup vcpkg
+      uses: lukka/run-vcpkg@v11
+      with:
+        vcpkgJsonGlob: 'sources/agent/vcpkg.json'
+
+    - name: Check Code Formatting
+      run: |
+        find sources/agent/src -name "*.cc" -o -name "*.h" | xargs clang-format --dry-run --Werror -style=Google
+
+    - name: CMake Configure
+      working-directory: sources/agent
+      run: cmake --preset default -DCMAKE_BUILD_TYPE=Release
+
+    - name: Build
+      working-directory: sources/agent
+      run: cmake --build --preset default -j$(nproc)
+
+    - name: Analyze Logic
+      run: |
+        cppcheck --enable=warning,performance,portability \
+        --error-exitcode=1 \
+        --suppress=missingIncludeSystem \
+        --inline-suppr \
+        --force \
+        -i sources/agent/build \
+        -i sources/agent/gen \
+        sources/agent

.github/workflows/dashboard_ci.yml

@@ -0,0 +1,78 @@
+name: Dashboard CI
+
+on:
+  push:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/dashboard/**'
+      - '.github/workflows/dashboard_ci.yml'
+  pull_request:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/dashboard/**'
+      - '.github/workflows/dashboard_ci.yml'
+
+jobs:
+  check-and-build:
+    name: Lint, Format & Build
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: sources/dashboard
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - uses: voidzero-dev/setup-vp@v1
+      with:
+        node-version: '24'
+        working-directory: sources/dashboard
+        cache: true
+        run-install: true
+
+    - name: Format, lint & typecheck
+      run: vp check
+
+    - name: Build
+      run: vp run build
+      env:
+        GITHUB_PAGES: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' && 'true' || '' }}
+
+    - name: Upload build artifact
+      if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+      uses: actions/upload-artifact@v7
+      with:
+        name: dashboard-dist
+        path: sources/dashboard/dist
+        retention-days: 7
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: check-and-build
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    concurrency:
+      group: pages
+      cancel-in-progress: false
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dashboard-dist
+          path: dist
+
+      - uses: actions/configure-pages@v6
+
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: dist
+
+      - id: deployment
+        uses: actions/deploy-pages@v5

.github/workflows/server_ci.yml

@@ -0,0 +1,63 @@
+name: Server CI
+
+on:
+  push:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/server/**'
+      - '.github/workflows/server_ci.yml'
+  pull_request:
+    branches: [ "main", "devel" ]
+    paths:
+      - 'sources/server/**'
+      - '.github/workflows/server_ci.yml'
+
+jobs:
+  build-and-test:
+    name: Server Lint, Build & Test
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: sources/server
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Setup Go
+      uses: actions/setup-go@v5
+      with:
+        go-version-file: sources/server/go.mod
+        cache: true
+        cache-dependency-path: sources/server/go.sum
+
+    - name: Install protoc
+      uses: arduino/setup-protoc@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Install Go protoc plugins
+      run: |
+        go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
+        go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
+
+    - name: Generate protobuf
+      run: make proto
+
+    - name: Verify formatting
+      run: |
+        unformatted=$(gofmt -l .)
+        if [ -n "$unformatted" ]; then
+          echo "The following files are not gofmt-formatted:"
+          echo "$unformatted"
+          exit 1
+        fi
+
+    - name: Go vet
+      run: go vet ./...
+
+    - name: Build
+      run: go build ./...
+
+    - name: Test
+      run: go test -v ./...

.gitignore

@@ -1,3 +1,16 @@
+# --- Shared ---
 .vscode/
-build/
-cmake-build-*/
+*.code-workspace
+sources/**/logs
+
+# --- Agent ---
+.cache/
+compile_commands.json
+sources/agent/agent.conf
+.clang-format
+*.uuid
+out/
+
+# --- Server ---
+sources/server/pb/
+sources/server/server

.helix/languages.toml

@@ -0,0 +1,17 @@
+[[language]]
+name = "c"
+scope = "source.c"
+file-types = []
+
+[[language]]
+name = "cpp"
+scope = "source.cpp"
+file-types = ["cc", "hh", "c++", "cpp", "hpp", "h", "ipp", "tpp", "cxx", "hxx", "ixx", "txx", "ino", "C", "H", "cu", "cuh"]
+language-servers = ["clangd"]
+
+[language-server.clangd]
+command = "clangd"
+args = [
+  "--header-insertion=never",
+  "--compile-commands-dir=build"
+]

Makefile

@@ -0,0 +1,3 @@
+hooks:
+	chmod +x scripts/hooks/pre-commit
+	cd scripts/hooks && ln -sfr ./pre-commit ../../.git/hooks/pre-commit

README.md

@@ -1 +1,63 @@
-# volta
+# Volta
+
+Volta is a lightweight, energy-aware monitoring platform for tracking system and hardware metrics in real time.
+
+It follows a classic **Agent → Server → Dashboard** model:
+
+- One or more **Agents** (C++) run on monitored machines, sample low-level hardware/system metrics and stream them to a single configured server over **gRPC**.
+- The **Server** (Go) aggregates metrics from all connected agents and exposes them to clients over **WebSockets**.
+- The **Dashboard** (React) visualises live and historical metrics served by the Server.
+For the full architecture, deployment models (local vs. remote) and the metric catalogue, see [docs/pl/ARCHITECTURE.md](docs/pl/ARCHITECTURE.md) and [docs/pl/METRICS.md](docs/pl/METRICS.md).
+
+## Repository Structure
+
+| Path | Component | Stack | Description |
+|---|---|---|---|
+| [`sources/agent`](sources/agent) | Agent | C++20, CMake, vcpkg | Collects CPU/GPU power and standard system metrics; streams them to the server. |
+| [`sources/server`](sources/server) | Server | Go | Central aggregation point; gRPC ingest, REST + WebSocket API for the dashboard. |
+| [`sources/dashboard`](sources/dashboard) | Dashboard | TypeScript, React, Vite | Web UI for visualising live and historical agent metrics. |
+| [`sources/proto`](sources/proto) | Proto | Protocol Buffers | Shared gRPC contract between Agent and Server. |
+| [`docs`](docs) | Docs | Markdown | Architecture, metrics and other supporting documentation. |
+
+## Maintainers
+
+- **Agent** — @FW-Nagorko
+- **Server** — @kox13
+- **Dashboard** — @patryk-przybysz
+
+## Development Setup
+
+### 1. Initial Requirements
+
+- **Git**
+- **Make**
+- Component-specific toolchains — see [`sources/agent/README.md`](sources/agent/README.md), [`sources/server/README.md`](sources/server/README.md) and [`sources/dashboard/README.md`](sources/dashboard/README.md)
+
+### 2. Clone the Repository
+
+```bash
+git clone https://github.com/monvit/volta.git
+cd volta
+```
+
+### 3. Run a Component
+
+Follow the dedicated setup steps in respective READMEs.
+
+- [Agent](/sources/agent/README.md)
+- [Server](/sources/server/README.md)
+- [Dashboard](/sources/dashboard/README.md)
+
+### 4. Git Hooks (Optional)
+
+```bash
+make hooks
+```
+
+## Continuous Integration
+
+Each component is linted, built and tested independently and only on relevant changes — see [`.github/workflows`](.github/workflows) (`agent_ci.yml`, `server_ci.yml`, `dashboard_ci.yml`).
+
+## License
+
+Volta is licensed under the [Apache License 2.0](LICENSE).