Add structured headers to the PHP include layer, fix monitor state paths

All 16 include/ files now carry PURPOSE / DESIGN PRINCIPLES / OPERATIONAL
SAFEGUARDS / EXPORTS / CONFIGURATION, keeping the first three section names
identical to the bash headers so retrieval can route across both languages.

monitor.php read six watchdog state files from /tmp while the watchdogs write
to STATE_DIR, so every strike set came back empty and the summary reported
healthy unconditionally. docs.php gained path containment before it is wired
to a page.
This commit is contained in:
Gmer4Lfe
2026-08-02 00:38:22 -04:00
parent 76c4ca5ccf
commit 43b5443b30
16 changed files with 811 additions and 21 deletions
+25
View File
@@ -1,4 +1,29 @@
<?php
// ═══════════════════════════════════════════════════════════════════════════════════════════════
// PURPOSE
// Small compatibility layer over docker.php — resolves a container's WebUI URL and returns
// the folder grouping in the shape older callers expect.
//
// DESIGN PRINCIPLES
// Thin by intent. The folder store and inventory live in docker.php; this file only adapts
// their output. New work belongs there, not here.
//
// WebUI resolution reads the dockerMan template, which is where Unraid records the port and
// path a container's UI actually lives on — not guessed from the published ports.
//
// OPERATIONAL SAFEGUARDS
// A container with no template, or no WebUI declared, returns empty and simply renders
// without a link. Absence is normal, not an error.
//
// Read-only. Resolves and reshapes; the store is written only through docker.php.
//
// EXPORTS
// vv_container_webui() WebUI URL for one container, or empty
// vv_get_docker_folders() folder grouping in the legacy shape
//
// CONFIGURATION
// Inherits everything from docker.php — see that file's CONFIGURATION block.
// ═══════════════════════════════════════════════════════════════════════════════════════════════
require_once __DIR__ . '/config.php';
require_once __DIR__ . '/docker.php';