FOUR-32268: [SPIKE] Add runtime Smart Extract configuration

[eiresendez]

Issue

Smart Extract currently resolves its dashboard URL, API host, OAuth credentials, and HITL flag from deployment-time configuration. FOUR-32268 is a Spike/PoC to validate whether authorized administrators can manage these settings through ProcessMaker Environment Variables and have updates applied on the next request or queue job without a deployment, configuration-cache clear, or worker restart.

Solution

• Add a scoped SmartExtractConfiguration service that lazily loads and decrypts the five Smart Extract settings in one query per request or job lifecycle.
• Use the runtime database values in core task and HITL flows, with missing or invalid HITL configuration failing closed.
• Preserve SMART_EXTRACT_API_HOST loaded from Environment Variables in both local Docker and script microservice runners instead of overwriting it from Laravel configuration.
• Add coverage for configuration loading, lifecycle refreshes, HITL task behavior, and both script-runner paths.
• Keep the PoC free of schema and API response-shape changes.

How to Test

Run:

vendor/bin/phpunit \
  tests/unit/ProcessMaker/Services/SmartExtractConfigurationTest.php \
  tests/unit/ProcessMaker/ScriptRunners/SmartExtractEnvironmentVariablesTest.php \
  tests/unit/ProcessMaker/Http/Controllers/TaskControllerSmartExtractTest.php \
  tests/Feature/TaskControllerTest.php \
  tests/Feature/Api/TaskControllerTest.php \
  tests/Feature/Api/TasksTest.php \
  --no-coverage

Expected result: 53 tests, 504 assertions.

Manual end-to-end validation was completed successfully by updating the Smart Extract Environment Variables, verifying the next web request, and verifying a subsequent job on an already-running worker. The local Docker executor also completed the Smart Extract flow successfully.

Related Tickets & Packages

• https://processmaker.atlassian.net/browse/FOUR-32268
• Package PR: https://github.com/ProcessMaker/package-smart-extract/pull/49

ci:package-smart-extract:spike/FOUR-32268

[processmaker-sonarqube]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarQube