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/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
         );
     }