From 06bf414f41e7292cf0d55e1359451b07dd26d30b Mon Sep 17 00:00:00 2001
From: Yasen Pramatarov <yasen@lindeas.com>
Date: Tue, 26 Nov 2024 16:22:27 +0200
Subject: [PATCH] Adds phpdoc comments

---
 app/pages/status.php | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/app/pages/status.php b/app/pages/status.php
index 5e88044..162a9d5 100644
--- a/app/pages/status.php
+++ b/app/pages/status.php
@@ -1,17 +1,24 @@
 <?php
 
-// Jilo components status checks
-//
+/**
+ * Jilo Components Status Checks
+ *
+ * This page ("status") checks the status of various Jilo platform components
+ * by fetching data from agents and determining their availability.
+ * It generates output for each platform and agent.
+ */
 
 require '../app/classes/agent.php';
 $agentObject = new Agent($dbWeb);
 
 include '../app/templates/status-server.php';
 
+// loop through all platforms to check their agents
 foreach ($platformsAll as $platform) {
 
     include '../app/templates/status-platform.php';
 
+    // fetch agent details for the current platform
     $agentDetails = $agentObject->getAgentDetails($platform['id']);
     foreach ($agentDetails as $agent) {
         $agent_url = parse_url($agent['url']);
@@ -23,6 +30,7 @@ foreach ($platformsAll as $platform) {
         $agent_response = $agentObject->fetchAgent($agent['id'], true);
         $agent_data = json_decode($agent_response);
 
+        // determine agent availability based on response data
         if (json_last_error() === JSON_ERROR_NONE) {
             $agent_availability = '<span class="text-warning">unknown</span>';
             foreach ($agent_data as $key => $value) {