docs: setup Docasaurus site with documentation

.github/workflows/ci.yml

@@ -1,15 +1,17 @@
-name: Java CI with Maven
+name: Project CI & Docs Deploy
 
 on:
   push:
     branches: [ "main" ]
   pull_request:
     branches: [ "main" ]
 
+permissions:
+  contents: write
+
 jobs:
   build-and-test:
     runs-on: ubuntu-latest
-
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -23,3 +25,31 @@ jobs:
 
       - name: Build and Test
         run: ./mvnw -B spotless:check verify
+
+  deploy-docs:
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: npm
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+        working-directory: website
+
+      - name: Build
+        run: npm run build
+        working-directory: website
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: website/build

website/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

website/api_specs/master_agent_API.proto

@@ -0,0 +1,75 @@
+syntax = "proto3";
+
+service AgentService {
+  rpc RunTest(stream MasterCommand) returns (stream AgentResponse);
+}
+
+message MasterCommand {
+  oneof command {
+    StartTestCommand start      = 1;
+    ChangeParamsCommand change  = 2;
+    StopTestCommand stop        = 3;
+  }
+}
+
+message StartTestCommand {
+  string test_id    = 1;
+  TestConfig config = 2;
+}
+
+message ChangeParamsCommand {
+  string test_id            = 1;
+  uint32 requests_per_sec   = 2;
+}
+
+message StopTestCommand {
+  string test_id    = 1;
+  StopReason reason = 2;
+}
+
+enum StopReason {
+  USER        = 0;
+  DURATION    = 1;
+  ERROR       = 2;
+}
+
+message TestConfig {
+  uint32 requests_per_sec   = 1;
+  uint32 duration_sec       = 2;
+  string url                = 3;
+  LoadType load_type        = 4;
+}
+
+enum LoadType {
+  SPIKE     = 0;
+  CONSTANT  = 1;
+  GRADUAL   = 2;
+}
+
+message AgentResponse {
+  oneof response {
+    TestStats   stats   = 1;
+    AgentStatus status  = 2;
+  }
+}
+
+message TestStats {
+  string test_id    = 1;
+  uint64 timestamp  = 2;
+
+  uint32 requests_per_sec = 3;
+  uint32 errors_per_sec   = 4;
+  uint32 latency_ms       = 5;
+  uint32 p50_ms           = 6;
+  uint32 p95_ms           = 7;
+  uint32 p99_ms           = 8;
+}
+
+enum AgentStatus {
+  STARTING         = 0;
+  RUNNING          = 1;
+  PARAMS_APPLIED   = 2;
+  STOPPING         = 3;
+  FINISHED         = 4;
+  ERROR            = 5;
+}