User Onboarding & Tour

User Onboarding & Guided Tour

The HCG AI application is designed to guide users through the complexities of first-trimester monitoring. To ensure users can effectively navigate the clinical data entry points and analysis tools, the platform includes an interactive guided tour and contextual help mechanisms.

Interactive Guided Tour

For first-time users or those needing a refresher, the application features a built-in interactive tour. This tour highlights key UI elements, explaining how to log blood test results and interpret the AI-generated risk assessments.

• How to Start: Click the Tour button (identified by the help-circle icon) in the main navigation bar.
• What it Covers:
  • Dashboard Overview: Navigating between Home, Entries, Analysis, and AI Chat.
  • Data Entry: How to use the simple vs. advanced HCG input forms.
  • Ultrasound Logging: Documenting gestational age and sac measurements.
  • AI Insights: Where to find the clinical risk level and recommendations.

// The tour is triggered via the global navigation
startGuidedTour();

Navigation & Workspaces

The interface is divided into four primary workspaces. Understanding these is key to the user onboarding experience:

| Tab | Purpose | | :--- | :--- | | Home | The main landing page for entering new β-hCG levels and ultrasound data. | | Entries | A historical log of all submitted data, allowing users to review or delete past records. | | Analysis | Visualizes trends through charts (e.g., HCG doubling rates) and clinical risk assessments. | | AI Chat | A direct interface with the OpenAI-powered medical assistant for pregnancy-related queries. |

Contextual Help & Tooltips

To assist with medical terminology and data requirements, the application provides inline documentation:

• Information Tooltips: Throughout the "Advanced Details" section, blue info icons (ⓘ) provide definitions for terms like "Cycle Length" and "LMP" (Last Menstrual Period).
• Helper Text: Input fields include validation range reminders (e.g., "Valid range: 21-45 days") to prevent data entry errors.
• Advanced Toggle: Users are introduced to the Advanced details? toggle early in the onboarding flow. Enabling this reveals fields for cycle regularity and ovulation dates, which improve the accuracy of the AI analysis.

Authentication Flow for New Users

Access to tracking and analysis features requires a secure account to protect sensitive health data.

1. Registration: New users must click Register to create an account using an email address and password.
2. Session Persistence: The application uses session-based authentication. Once logged in, the user's session remains active for 30 days by default, allowing for quick access during frequent HCG monitoring periods.
3. Profile Management: Once authenticated, the User Profile section in the navigation bar displays the logged-in email and provides a secure Logout option.

Sharing & Support

• Share App: Users can use the Share button in the navigation bar to quickly copy the application URL or share the dashboard via supported system share sheets.
• Feedback/Bug Reporting: The integrated Ybug widget (located at the edge of the screen) allows users to report issues or provide feedback directly to the development team during their onboarding journey.