From 74c622bd034a1fb866865aaffa3ed282429c501d Mon Sep 17 00:00:00 2001
From: cschantz <admin@server.local>
Date: Thu, 20 Nov 2025 16:26:17 -0500
Subject: [PATCH] Documentation fixes: Update Plesk database prefix and
 validator test counts
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CRITICAL DOCUMENTATION FIXES:
1. Fixed Plesk database prefix pattern (line 766)
   - Was: "no prefix (TBD - needs verification)"
   - Now: "appname_RANDOM  # e.g., wp_i75pa (VERIFIED: real server 2025-11-20)"
   - This was WRONG and contradicted real server findings

2. Updated InterWorx validator documentation (lines 997-1013)
   - Corrected test count: 10 → 13 tests
   - Added missing tests: Virtual host config, WordPress permissions, Directory viz
   - Updated status to "TESTED on real server - all assumptions verified"

3. Updated Plesk validator documentation (lines 1017-1035)
   - Corrected test count: 12 → 15 tests
   - Added missing tests: File permissions, wp-config access, Directory viz
   - Updated Cron description to include "actual write/restore testing"
   - Updated status to "TESTED on real server - all assumptions verified"

IMPACT:
- Documentation now accurately reflects validator capabilities
- Plesk database prefix pattern correctly documented
- No code changes needed - validators already implement all tests

CONTEXT:
These fixes ensure REFDB_FORMAT.txt accurately represents:
- Real server test results from 2025-11-20
- Actual validator test counts (13 for InterWorx, 15 for Plesk)
- Correct Plesk database naming pattern
---
 REFDB_FORMAT.txt | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/REFDB_FORMAT.txt b/REFDB_FORMAT.txt
index ea4c50f..9c47293 100644
--- a/REFDB_FORMAT.txt
+++ b/REFDB_FORMAT.txt
@@ -763,7 +763,7 @@ paths:
 database_prefixes:
   cpanel: username_dbname
   interworx: username_dbname  # SAME AS CPANEL! (verified from official docs)
-  plesk: no prefix (TBD - needs verification)
+  plesk: appname_RANDOM  # e.g., wp_i75pa (VERIFIED: real server 2025-11-20)
 
 # Module Classification System
 classes:
@@ -994,11 +994,11 @@ validation_scripts:
 
   interworx_validator:
     script: "validate-interworx.sh"
-    tests: 10
+    tests: 13
     validates:
       - Control panel detection
       - File system structure (/home/USER/DOMAIN/html/)
-      - Log locations (/home/USER/var/DOMAIN/logs/)
+      - Virtual host configuration
       - Domain→User lookup (vhost configs)
       - User→Domains lookup (2 methods)
       - Database prefix (username_)
@@ -1006,27 +1006,33 @@ validation_scripts:
       - PHP configuration
       - WordPress detection
       - InterWorx CLI tools
+      - WordPress file permissions & cron user testing
+      - Directory structure visualization
+      - Comprehensive system documentation
     output: "/tmp/interworx-validation-results.txt"
-    status: "Ready for testing on real server"
+    status: "TESTED on real server - all assumptions verified"
 
   plesk_validator:
     script: "validate-plesk.sh"
-    tests: 12
+    tests: 15
     validates:
       - Control panel detection
       - File system structure (/var/www/vhosts/DOMAIN/httpdocs/)
-      - Log locations (/var/www/vhosts/system/DOMAIN/logs/)
+      - Log file locations (/var/www/vhosts/system/DOMAIN/logs/)
       - plesk bin commands
       - Domain→User lookup (plesk bin subscription --info)
       - User→Domains lookup (plesk bin subscription --list)
       - Database prefix pattern
       - System user for web processes (CRITICAL!)
-      - Cron system (standard vs plesk bin cron)
+      - Cron system with actual write/restore testing (CRITICAL!)
       - PHP configuration
       - WordPress detection
       - Apache/nginx configuration
+      - WordPress file permissions & wp-config.php access
+      - Directory structure visualization
+      - Comprehensive system documentation
     output: "/tmp/plesk-validation-results.txt"
-    status: "Ready for testing on real server"
+    status: "TESTED on real server - all assumptions verified"
 
   documentation:
     file: "testing/README.md"