[E2E] Functional Validation for Orchestrated Apps (Paperless-ngx)

[BeSovereign]

Summary

Validate that Freeshard successfully orchestrates and proxies functional third-party apps. This goes beyond container Running status and checks actual application usability.

Implementation Details

1. App Installation: Use the shard-api.ts utility (from Issue 1) to trigger an installation of paperless-ngx via a POST request to the management API.
2. Readiness Check: Implement a polling mechanism that waits for the app container to be healthy and the URL https://paperless.{{domain}} to return 200 OK.
3. UI Interaction:
   • Navigate to the Paperless-ngx URL.
   • Bypass/Handle the internal proxy splash screen.
   • Perform a Happy Path test:
     • Login with default credentials (admin/admin).
     • Upload a dummy .pdf file.
     • Assert that the document appears in the document list.

Technical Context

• Use the paperless-ngx template from app-repository/apps/paperless-ngx/.
• Ensure the test cleans up by uninstalling the app after execution.

Acceptance

• Full lifecycle verified: Install -> Access UI -> Upload Doc -> Uninstall.