ITEP-92735: Mapping service should communicate with outside world over proxy

[saratpoluri]

📝 Description

This PR updates SceneScape’s mapping service exposure so external clients access it through the manager’s Apache reverse proxy (instead of directly via :8444), aligning service-to-outside-world communication with the existing proxy pattern used for autocalibration.

✨ Type of Change

Select the type of change your PR introduces:

• 🐞 Bug fix – Non-breaking change which fixes an issue
• 🚀 New feature – Non-breaking change which adds functionality
• 🔨 Refactor – Non-breaking change which refactors the code base
• 💥 Breaking change – Changes that break existing functionality
• 📚 Documentation update
• 🔒 Security update
• 🧪 Tests
• 🚂 CI

🧪 Testing Scenarios

Describe how the changes were tested and how reviewers can test them too:

• ✅ Tested manually
• 🤖 Ran automated end-to-end tests

Manual tests run:
Upload a polycam zip. Successful registration. Auto calibrate a camera. Successful localization and pose returned to UI.
Mapping service called via UI using "Generate Mesh". Mesh looks correct and the camera pose is accurate wrt Mesh.

✅ Checklist

Before submitting the PR, ensure the following:

• 🔍 PR title is clear and descriptive
• 📝 For internal contributors: If applicable, include the JIRA ticket number (e.g., ITEP-123456) in the PR title. Do not include full URLs
• 💬 I have commented my code, especially in hard-to-understand areas
• 📄 I have made corresponding changes to the documentation
• ✅ I have added tests that prove my fix is effective or my feature works

[Copilot]

Pull request overview

This PR updates SceneScape’s mapping service exposure so external clients access it through the manager’s Apache reverse proxy (instead of directly via :8444), aligning service-to-outside-world communication with the existing proxy pattern used for autocalibration.

Changes:

• Added Apache reverse-proxy routing for the mapping service under /api/mapping/.
• Updated tests, examples, and OpenAPI docs to use proxied URLs (e.g., https://localhost/api/mapping/...) and stopped publishing mapping/autocalibration service ports in compose examples.
• Adjusted mapping unit test dependencies to include runtime imports needed by mapping modules under test.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/functional/test_auto_calibration.py	Switch autocalibration functional test base URL to go through the web proxy.
tests/functional/test_apriltag_registration_update.py	Switch autocalibration registration tests to use the web proxy base URL.
tests/compose/mapping.yml	Stop publishing mapping service port to the host (proxy-only access).
tests/compose/autocalibration.yml	Stop publishing autocalibration service port to the host (proxy-only access).
tests/api/conftest.py	Point MappingClient at the proxied mapping API path.
sample_data/docker-compose-dl-streamer-example.yml	Stop publishing mapping service port (proxy-only access).
mapping/tools/client_example.py	Update default CLI URL to the proxied mapping endpoint.
mapping/tests/requirements-test.txt	Add mapping runtime deps needed for importing modules in tests.
manager/config/default-ssl.conf	Add Apache ProxyPass rules for /api/mapping/ to the mapping backend.
docs/user-guide/microservices/mapping-service/mapping-service.md	Update mapping API usage URLs to the proxied path.
docs/user-guide/microservices/mapping-service/build-from-source.md	Update validation curl URLs to the proxied path.
docs/user-guide/microservices/mapping-service/api-docs/mapping-api.yaml	Update OpenAPI servers to reflect proxy access as recommended.
docs/user-guide/microservices/auto-calibration/api-reference.md	Update autocalibration base URL to the proxied path.
docs/user-guide/microservices/auto-calibration/_assets/autocalibration-api.yaml	Update OpenAPI server URL for proxied autocalibration access.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 14 changed files in this pull request and generated 7 comments.

Comments suppressed due to low confidence (1)

tests/functional/test_auto_calibration.py:217

• This request URL is built from a module-level constant, so it ignores the functional test CLI option --weburl (wired into FunctionalTest.params). Build the URL from self.params['weburl'] to allow running tests against custom endpoints.

  def start_calibration(self, image_b64, intrinsics=None):
    url = f"{AUTOCALIB_BASE}/cameras/{self.camera_id}/calibration"
    payload = {"image": image_b64}
    if intrinsics is not None:
      payload["intrinsics"] = intrinsics
    try:
      r = requests.post(url, json=payload, verify=self.rootcert)

[Copilot]

Pull request overview

Copilot reviewed 14 out of 14 changed files in this pull request and generated 4 comments.

[ltalarcz]

LGTM, assuming Autocalibration and Mapping services were manually sanity checked.

[saratpoluri]

Manual tests run:
Upload a polycam zip. Successful registration. Auto calibrate a camera. Successful localization and pose returned to UI.
Mapping service called via UI using "Generate Mesh". Mesh looks correct and the camera pose is accurate wrt Mesh.

[saratpoluri]

@sbelhaik : if RC3 is definitely getting created, then I would like to merge this one.

[sbelhaik]

@saratpoluri MODEL_TYPE=vggt doesn't overwrite mapanything

$ docker image inspect scenescape-mapping-vggt:2026.1.0-rc2 --format '{{range .Config.Env}}{{println .}}{{end}}' | grep MODEL_TYPE
MODEL_TYPE=mapanything

3f5e36e & ba56a57 fix the issue.

Addressed all comments