Enhance FaceAI integration with live checks and metadata handling

- Added optional live FaceAI checks in README.md
- Implemented relative storage segment parsing in race-storage.js
- Updated server.js to include relative directory in race storage
- Refactored legacyAssets.js to resolve asset base URL dynamically
- Expanded live race tests to validate FaceAI app launch and metadata
- Introduced portrait image handling for live upload flow
- Updated faceai_handoff.php to process race storage relative directory

www/_js/rus-ecom-240621.js

@@ -258,6 +258,7 @@ function buildFaceAiLaunchUrl() {
 	var raceYear = getFaceAiStorageValue("faceAiRaceYear", "year");
 	var raceMonthFolder = getFaceAiStorageValue("faceAiRaceMonthFolder", "monthFolder");
 	var raceFolder = getFaceAiStorageValue("faceAiRaceFolder", "raceFolder");
+	var raceStorageRelativeDir = $("#faceAiRaceStorageRelativeDir").val() || [raceYear, raceMonthFolder, raceFolder].filter(Boolean).join("/");
 	var lang = getCurrentLangValue();
 	var handoffUrl = (window.faceAiSimulator && window.faceAiSimulator.handoffUrl) || "faceai_handoff.php";
 	var returnUrl = (window.faceAiSimulator && window.faceAiSimulator.returnUrl) || window.location.href;
@@ -268,6 +269,7 @@ function buildFaceAiLaunchUrl() {
 		"raceYear=" + encodeURIComponent(raceYear),
 		"raceMonthFolder=" + encodeURIComponent(raceMonthFolder),
 		"raceFolder=" + encodeURIComponent(raceFolder),
+		"raceStorageRelativeDir=" + encodeURIComponent(raceStorageRelativeDir),
 		"lang=" + encodeURIComponent(lang),
 		"returnUrl=" + encodeURIComponent(returnUrl)
 	];

www/faceai_handoff.php

@@ -11,6 +11,7 @@ try {
     $raceYear = faceai_request_value('raceYear');
     $raceMonthFolder = faceai_request_value('raceMonthFolder');
     $raceFolder = faceai_request_value('raceFolder');
+    $raceStorageRelativeDir = faceai_request_value('raceStorageRelativeDir');
     $lang = faceai_request_value('lang', 'it');
     $returnUrl = faceai_request_value('returnUrl');
 
@@ -45,11 +46,12 @@ try {
         'name' => $raceName !== '' ? $raceName : $raceId
     );
 
-    if ($raceYear !== '' && $raceMonthFolder !== '' && $raceFolder !== '') {
+    if ($raceYear !== '' || $raceMonthFolder !== '' || $raceFolder !== '' || $raceStorageRelativeDir !== '') {
         $racePayload['storage'] = array(
             'year' => $raceYear,
             'monthFolder' => $raceMonthFolder,
-            'raceFolder' => strtoupper(trim($raceFolder))
+            'raceFolder' => strtoupper(trim($raceFolder)),
+            'relativeDir' => $raceStorageRelativeDir
         );
     }