Table of Contents

1. Cover
2. Table of Contents (this page)
3. Overview & Business Goal
4. Architecture
5. User Journey & First Login Flow
6. Backend Modules
7. Database Tables
8. API Reference
   • 8.1 GET /api/v1/onboarding/status
   • 8.2 GET /api/v1/onboarding/survey
   • 8.3 POST /api/v1/onboarding/answers
   • 8.4 POST /api/v1/onboarding/recommendation
   • 8.5 POST /api/v1/onboarding/apply
   • 8.6 POST /api/v1/onboarding/skip
9. Authentication & Authorization
10. Internal Apply Bridge
11. Settings Patch Engine & Supported/Unsupported Groups
12. Runtime Configuration
13. Angular Integration Guide
    • 13.1 Integration guidance
    • 13.2 Claude Code prompt for the Angular team
14. Postman Testing Guide
15. Security Notes
16. Operational Notes
17. Known Limitations
18. Phase History / Implementation Status
19. Angular Developer Brief — Arabic / English
    • Bilingual companion brief for the Angular developer, with downloadable Word/PDF versions and a ready-to-use Claude Code prompt
20. Business Onboarding Survey Options
    • 20.1–20.3 Full question list and every answer option, verified against source
    • 20.4 Recommendation rules — base profile rules and global conditional rules
    • 20.5 Supported settings groups (11 total)
    • 20.6 Localization of survey text
    • 20.7 Latest Update — Phase 8
    • 20.8 Known Remaining Gaps / Not Blockers
    • 20.9 Developer guidance — adding a new onboarding option / a new settings group
21. Onboarding Apply Bridge — Local Setup & Live Verification
    • 21.1 Is the reported 501 a bug? (no — live-reproduced and confirmed by design)
    • 21.2 Why Shumoul.Api calling itself is the correct local setup
    • 21.3 Turning the bridge on locally (dev-only environment variables)
    • 21.4 Staging/production configuration and rollback
    • 21.5 The four reported warnings explained (master-data vs. entitlement)
    • 21.6 A latency note from live verification
    • 21.7 Troubleshooting quick-reference