ad Vitest to CI workflows, Vouchers and Account Mapper API layer with mock fallback

[Flashl3opard]

Summary

Adds automated testing to the CI pipeline and wires the Vouchers and Account Mapper modules to real API calls with mock fallback support. Also includes a Keycloak realm export and quick setup documentation to simplify local onboarding.

Changes

• CI: Added npm test -- --run as a final step in .github/workflows/ci.yml, running Vitest in non-watch mode after the existing install, build, and typecheck steps.
• Vouchers API: Added an API integration layer with mock fallback, with TODO comments marking where real endpoints will replace mocks once available.
• Account Mapper API: Added an API integration layer with mock fallback, following the same pattern as Vouchers.
• Keycloak: Added realm export for local development setup.
• Documentation: Added a quick setup guide for getting the local environment running.

CI Pipeline

The following checks now run on every push and pull request to dev and main:

Step	Purpose
npm ci	Clean dependency install
npm run build	Vite production build
npx tsc --noEmit	TypeScript type check
npm test -- --run	Unit test suite (Vitest, non-watch mode)

Testing

All CI checks pass, including the full unit test suite (18/18 tests passing).

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[DavidH-1]

lgtm