Mapt Platform - Recent Development Report

Overview:

Complete direct messaging system enabling employers to communicate with candidates without leaving the platform. Protects candidates from spam by restricting conversation initiation to employers only.

Technical Implementation:

• Database Entities: Conversation & Message entities with proper relationships
• Backend Functions: startConversation (creates new threads), sendMessageNotification (email alerts)
• Frontend Components: MessageInbox (conversation list + chat interface), StartConversationButton (employer action)
• Protected Route: Messages page accessible from both user type navigation menus

Key Features:

• Employer-initiated conversations only (anti-spam protection)
• Email notifications for offline recipients with "login to respond" CTAs
• Real-time message polling (3-5 second intervals)
• Read receipts and unread message badges
• Bi-directional communication after employer initiates
• Conversation history with message timestamps

Overview:

Users can now maintain both Job Seeker and Employer profiles simultaneously, with seamless switching between roles. This addresses the reality that many battery industry professionals wear multiple hats.

Technical Implementation:

• Role Detection: System checks for both JobSeekerProfile entity AND Org membership
• Onboarding Flow: "Become X Too" buttons in AccountSettings with force parameter
• RoleSwitcher Component: Appears only when user has both profiles configured
• Navigation Updates: Dynamic menu switching based on active role
• Data Separation: Complete isolation between job seeker and employer data

User Journey:

• Employer clicks "Become a Job Seeker Too" in Settings
• Completes JobSeekerOnboarding flow with userType set to 'job_seeker'
• RoleSwitcher button appears in navigation automatically
• One-click switching between Employer Dashboard and Job Seeker Dashboard
• Process works in reverse for job seekers becoming employers

Debugging & Fixes:

• Issue: Onboarding redirects prevented form completion for existing users
• Fix: Added ?force=true parameter to skip redirect checks
• Issue: userType not being set after onboarding completion
• Fix: Ensured both onboarding flows explicitly set userType field
• Issue: RoleSwitcher appearing when user only had one profile
• Fix: Improved detection logic to require both profiles before showing switcher

Feature Description:

Job seekers can create custom lists of companies they're interested in and receive notifications when those companies post new jobs.

Implementation Details:

• Entity: SavedCompanyList (list_name, company_ids array, notification settings)
• Component: SavedCompaniesManager with searchable company selector
• Notification Frequencies: Instant (hourly check), Daily, Weekly
• Backend: checkNewJobsForAlerts scheduled function (runs hourly)

Debugging & Fixes:

• Issue: Dropdown menu hidden behind dialog overlay (z-index conflict)
• Fix: Set DialogContent z-index to 10000, SelectContent to 10001
• Issue: "Create List" button stuck on "Creating..." with no error
• Fix: Added missing user_id field to mutation, improved error handling

Feature Description:

Job seekers can create alerts for specific geographic locations and receive notifications when new jobs are posted in those areas.

Implementation Details:

• Entity: SavedLocationAlert (city, state, country, radius_km, include_remote)
• Component: LocationAlertsManager with location input fields
• Notification Options: Same as company lists (instant/daily/weekly)
• Location Matching: Integrates with existing geocoding system

Feature Description:

Premium job promotion system allowing employers to boost job visibility with featured placement, highlighted styling, and priority in search results.

Implementation Details:

• Frontend: MaptPlusModal explaining benefits, Stripe checkout integration
• Backend: createMaptPlusCheckout function with proper metadata
• UI: Orange gradient promotional banner on job cards
• Success Flow: Dedicated success page after payment completion

Debugging & Fixes:

• Issue: "Promote Job" button incorrectly linked to pricing page
• Fix: Implemented proper modal → checkout → success page flow
• Issue: Banner styling inconsistency
• Fix: Standardized orange gradient across all Mapt+ elements

Changes Made:

• Added "Messages" to both Job Seeker and Employer navigation menus
• Standardized menu structure across user types
• Improved mobile navigation responsiveness
• Added proper routing for new features

Improvements:

• Removed job-seeker-specific components from employer view of job postings
• Maintained clean separation of concerns between user types
• Consistent glassmorphism styling across new features
• Improved loading states and error messaging
• Better mobile responsiveness for new components

Symptom:

Clicking "Become X Too" button showed "Checking..." then immediately redirected to map without showing onboarding form. Role switcher never appeared.

Root Cause:

Onboarding pages checked if profile existed at load time. For users with existing profiles, it immediately redirected before rendering the form. Additionally, userType field wasn't being set after completion.

Solution:

• Added ?force=true parameter to bypass redirect check
• Modified onboarding pages to skip redirect when force=true
• Ensured userType field is explicitly set after onboarding completion
• Updated RoleSwitcher detection logic to verify both profiles exist

Symptom:

Dropdown menus hidden behind modal, "Create List" button stuck on "Creating..." with no error or success message. Lists not appearing after submission.

Root Cause:

• UI Issue: SelectContent z-index lower than Dialog overlay (z-index conflict)
• Data Issue: user_id field missing from create mutation payload, causing silent failure on backend

Solution:

• Set DialogContent z-index to 10000
• Set SelectContent z-index to 10001 (above dialog)
• Added user_id to mutation payload using await base44.auth.me()
• Improved error handling with try/catch and user-friendly error messages

Symptom:

"Promote Job" button linked directly to pricing page instead of showing promotion modal with checkout flow.

Root Cause:

Button onClick handler incorrectly navigating to pricing page rather than opening MaptPlusModal.

Solution:

Updated button to open MaptPlusModal → Stripe Checkout → RecruitMaptPlusSuccess page flow with proper job ID passing through metadata.