test(smoke): add cross-surface shell smoke coverage

[AAdewunmi]

Summary
Adds seeded cross-surface smoke coverage for the ReturnHub shell flows and verifies that each primary surface can authenticate, land on its console, and load the expected page-one/page-two routes.

Changes

• added a new smoke test module at tests/test_surface_smoke.py
• seeded deterministic demo data with seed_returnhub_demo for repeatable multi-surface coverage
• exercised admin login through /login/admin/ and verified redirect to /console/admin/
• exercised ops login through /login/ops/ and verified redirect to /console/ops/
• exercised customer login through /login/customer/ and verified redirect to /console/customer/
• exercised merchant login through /login/merchant/ and verified redirect to /console/merchant/
• verified admin can load the admin console plus customer portal page 1 and page 2
• verified ops can load the ops console plus ops queue page 1 and page 2
• verified customer can load the customer console plus customer portal page 1 and page 2
• verified merchant can load the merchant console plus merchant portal page 1 and page 2
• asserted seeded pagination copy for customer and merchant page-two coverage

Why
The repository already has targeted tests for individual surfaces, but it did not have a single seeded smoke path that validates the primary product surfaces together from login through console and paginated route access. This adds a lightweight end-to-end confidence check across admin, ops, customer, and merchant flows using the project’s deterministic demo dataset.

Validation

• ran docker compose exec web pytest tests/test_surface_smoke.py
• verified all 4 smoke tests passed
• confirmed seeded data resolves expected page-two pagination text for customer and merchant surfaces
• confirmed live login and console routes used by the tests match the repository’s current surface structure

Result

• cross-surface shell smoke coverage now exists in one seeded integration test module
• admin, ops, customer, and merchant login-to-console flows are covered together
• customer and merchant page-two smoke coverage is explicitly verified
• the suite now provides a fast regression signal for broken surface routing or seeded shell access paths

Notes

• this adds integration smoke coverage rather than changing application behavior
• the tests intentionally use seed_returnhub_demo instead of factories to validate the project’s seeded demo experience
• the new module overlaps with more targeted tests by design to provide a single cross-surface regression check

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!