[25911] Add Waupaca rider categories and SMS consent disclaimer

[MichaelReyes]

Pull Request (PR) Checklist

Thank you for your contribution! Please confirm that you've checked all the boxes below before submitting your PR. Use [x] to check a box, e.g., [x], and make sure there's no space around the brackets.

PR Context

• Type: Feature
• Issue Link: Redmine Issue
• Risk Factor: Medium — Updates account completion, profile editing, authenticated Home cards, client configuration decoding, and user appData persistence. The feature is disabled by default and enabled only for Waupaca.

Changes

• Added server-driven rider-category selection and SMS consent disclaimer support to tripgosdk, guarded by TripGoConfigs.hasRiderCategorySelection().
• Added Waupaca-only configuration, localized client text resolution, rider-category prompting, selection persistence, and safe merging of category fields into the complete existing appData.
• Updated account screens with category display/editing, SMS disclaimer text, profile-image fallback, saved-phone preservation, and a loading indicator during submission.
• Updated authenticated Home-card managers to remove hidden card rows and spacers after sign-out, preventing excessive spacing between Login and Favorites.
• Added decoding, app-data, repository, ordering, prompting, and view-model test coverage.

Checklist for Reviewers

Documentation and Code Quality

• KDocs Documentation: New public configuration behavior and relevant functionality are documented.
• Architectural Patterns: Existing SDK repository, view-model, observable-list, and configuration patterns are followed.

Testing and Reliability

• Unit Testing: Tests cover client decoding, locale fallback, app-data preservation, category ordering, prompting, and update behavior.
• Emulator and Real Device Testing: Real-device Waupaca testing was performed; emulator validation remains optional for reviewers.

Error Handling and Logging

• Error Handling: Failed account saves retain the screen state, dismiss the loader, display an error, and allow retry. Client refresh failures retain cached configuration.
• Logging: Existing repository and application logging behavior is preserved for API and unexpected failures.

Testing Procedure

• Sign in to Waupaca using a user without categories_prompted_at. Verify the account completion screen opens once and displays the configured rider categories and SMS disclaimer.
• Save empty, single, and multiple category selections. Reopen the profile and verify selections persist in configured order and unrelated appData remains intact.
• Verify English and Spanish server translations and confirm the disclaimer and category description are omitted when absent from the selected client configuration.
• Open account editing for a user with an existing phone number. Verify the saved number is populated and a loader appears after selecting Done.
• Sign out and return Home. Verify authenticated-only cards and their spacing are removed, leaving Login, Favorites, and Profile positioned normally.
• Run:
  • ./gradlew :TripKitData:testDebugUnitTest
  • ./gradlew :tripgosdk:testDebugUnitTest
  • ./gradlew :app:compileWaupacaDebugKotlin

Work-in-Progress (WIP)

• No known implementation work remains.
• Ready for review and targeted Waupaca staging validation.

Remember to keep this template updated based on the feedback and evolving project standards.

[github-actions]

✅ Unit tests passed successfully!

Test results are available under the "Artifacts" section of this run in GitHub Actions.

Please ensure the code is reviewed before proceeding with the merge.

[github-actions]

✅ Unit tests passed successfully!

Test results are available under the "Artifacts" section of this run in GitHub Actions.

Please ensure the code is reviewed before proceeding with the merge.