Complete User Flow

Dossier-centric architecture showing all user paths through the CLAIR platform. Dossier Intelligence is the core feature, with Conversation Intelligence as supplementary.

Flow Legend

🔴 CORE: Dossier Intelligence (Primary Feature)
🟡 SUPPLEMENTARY: Conversation Intelligence
🟢 ADVANCED: Automation Features
graph TD %% Navigation Container NavContainer{Navigation Container} %% Main Navigation - DOSSIER FIRST subgraph "Main Navigation" NavContainer --> Home["Home Dashboard<br/>/home"] NavContainer --> DossiersLibrary["Dossiers Library<br/>/dossiers<br/>⭐ CORE FEATURE"] NavContainer --> Conversations["Conversations Hub<br/>/conversations<br/>Supplementary"] NavContainer --> Profile["Profile<br/>/profile"] end %% === ONBOARDING FLOW === Home --> OnboardingCheck{First Time?} OnboardingCheck -->|Yes| OnboardingWelcome["Welcome<br/>/onboarding/welcome"] OnboardingWelcome --> OnboardingGoals["Set Your Goals<br/>/onboarding/goals"] OnboardingGoals --> OnboardingStyleQuiz["Communication Style Quiz<br/>/onboarding/style-quiz"] OnboardingStyleQuiz --> OnboardingDealBreakers["Deal-Breakers Selection<br/>/onboarding/dealbreakers"] OnboardingDealBreakers --> OnboardingPreferences["Preferences<br/>/onboarding/preferences"] OnboardingPreferences --> Home %% === CORE DOSSIER INTELLIGENCE FLOWS === subgraph "🔴 CORE: Dossier Intelligence" %% Primary Entry Point Home --> MatchUpload["Match Profile Upload<br/>/dossiers/upload<br/>📸 SCREENSHOT UPLOAD"] DossiersLibrary --> MatchUpload %% Profile Processing MatchUpload --> ProfileExtraction["Profile Extraction Status<br/>/dossiers/processing/:id<br/>OCR & Data Extraction"] ProfileExtraction --> DossierGeneration["Dossier Generation<br/>/dossiers/generating/:id<br/>AI Analysis in Progress"] %% Core Dossier View DossierGeneration --> DossierDetail["Dossier Detail View<br/>/dossiers/:id<br/>⭐ MAIN INTELLIGENCE REPORT"] DossiersLibrary --> DossierDetail %% Dossier Deep Dives DossierDetail --> PersonalityAnalysis["Personality Analysis<br/>/dossiers/:id/personality"] DossierDetail --> CompatibilityDetail["Compatibility Detail<br/>/dossiers/:id/compatibility"] DossierDetail --> RedFlagDetail["Red Flag Detail<br/>/dossiers/:id/red-flags<br/>🚩 WARNING ANALYSIS"] DossierDetail --> GreenFlagHighlights["Green Flag Highlights<br/>/dossiers/:id/green-flags<br/>✨ POSITIVE SIGNALS"] DossierDetail --> ConversationStarters["Conversation Starters<br/>/dossiers/:id/conversation-tips<br/>💬 HOW TO REACH OUT"] DossierDetail --> SocialMediaAnalysis["Social Media Analysis<br/>/dossiers/:id/social"] DossierDetail --> ZodiacCompatibility["Zodiac Compatibility<br/>/dossiers/:id/zodiac"] end %% Dossier Management DossiersLibrary --> DossierComparison["Dossier Comparison<br/>/dossiers/compare<br/>SIDE-BY-SIDE ANALYSIS"] DossiersLibrary --> MatchDiscovery["Match Discovery<br/>/dossiers/discover"] Home --> DailyRecommendations["Daily Recommendations<br/>/dossiers/recommended<br/>TOP MATCHES TODAY"] DailyRecommendations --> DossierDetail %% === SUPPLEMENTARY: CONVERSATION INTELLIGENCE === subgraph "🟡 SUPPLEMENTARY: Conversation Intelligence" %% Conversation Import - LINKED TO DOSSIER Conversations --> ConversationImport["Conversation Import<br/>/conversations/import"] ConversationImport --> ScreenshotUpload["Screenshot Upload<br/>/conversations/import/screenshot"] ConversationImport --> ManualPaste["Manual Paste<br/>/conversations/import/paste"] ScreenshotUpload --> ConversationDetail["Conversation Detail<br/>/conversations/:id"] ManualPaste --> ConversationDetail %% CRITICAL: Link to Dossier ConversationDetail --> DossierLinking["Link to Dossier<br/>/conversations/:id/link-dossier<br/>🔗 CONNECT TO INTELLIGENCE"] DossierLinking -.->|Pulls Intelligence| DossierDetail %% Conversation Analysis with Dossier Context ConversationDetail --> AnalysisResults["Analysis Results<br/>/conversations/:id/analysis<br/>WITH DOSSIER CONTEXT"] %% Response Suggestions - Dossier Informed ConversationDetail --> ResponseSuggestions["Response Suggestions<br/>/conversations/:id/responses<br/>INFORMED BY DOSSIER"] ResponseSuggestions --> RefinementInterface["Refinement Interface<br/>/conversations/:id/refine"] %% Conversation Thread View ConversationDetail --> ConversationThread["Conversation Thread<br/>/conversations/:id/thread"] %% Dossier Quick View During Conversation ConversationDetail --> DossierQuickView["Dossier Quick View<br/>/conversations/:id/dossier-quick<br/>📋 FLOATING REFERENCE"] DossierQuickView -.->|References| DossierDetail end %% Real-Time Coaching ConversationThread -.-> RealtimeCoaching["Real-Time Coaching<br/>/coaching/realtime/:id<br/>WITH DOSSIER CONTEXT"] RealtimeCoaching -.->|References| DossierQuickView %% Template Library ResponseSuggestions --> TemplateLibrary["Template Library<br/>/templates"] TemplateLibrary --> TemplateBrowse["Browse Templates<br/>/templates/browse"] %% === AUTOMATION (ADVANCED SUPPLEMENTARY) === subgraph "🟢 ADVANCED: Conversation Automation" Conversations --> AutomationDashboard["Automation Dashboard<br/>/automation"] AutomationDashboard --> OutcomeDefinition["Outcome Definition<br/>/automation/define-outcome"] OutcomeDefinition --> AutomationSession["Automation Session<br/>/automation/:sessionId<br/>DOSSIER-GUIDED STRATEGY"] AutomationSession --> AutoThreadView["Automated Thread View<br/>/automation/:sessionId/thread"] end %% Cross-Flow: From Dossier to Conversation ConversationStarters -.->|Leads to| Conversations DossierDetail -.->|Start Conversation| ConversationImport %% === ANALYTICS === subgraph "Analytics" Profile --> DossierAnalytics["Dossier Analytics<br/>/analytics/dossiers<br/>PATTERN INSIGHTS"] Profile --> SuccessAnalytics["Success Analytics<br/>/analytics/success"] Profile --> MatchPatterns["Match Patterns<br/>/analytics/patterns"] end %% Analytics Back to Dossiers DossierAnalytics --> DossiersLibrary SuccessAnalytics --> DossierDetail %% === PROFILE & SETTINGS === Profile --> ProfileEdit["Profile Edit<br/>/profile/edit"] Profile --> DossierPreferences["Dossier Preferences<br/>/profile/dossier-preferences<br/>CUSTOMIZE INTELLIGENCE"] Profile --> CoachingPreferences["Coaching Preferences<br/>/profile/coaching-preferences"] Profile --> PrivacyControls["Privacy Controls<br/>/profile/privacy"] Profile --> HelpSupport["Help & Support<br/>/support"] %% Preferences back to Onboarding CoachingPreferences -.-> OnboardingGoals

💡 Want a More Interactive Experience?

The static Mermaid diagram above shows the complete user flow. For an immersive, clickable experience with detailed insights, wireframes, and three distinct view modes, explore the Interactive User Journey Canvas.

Flow Architecture

Primary User Journey (Dossier-First)

  1. 1. Upload: User uploads dating app profile screenshot
  2. 2. Processing: OCR extraction and AI analysis generate dossier
  3. 3. Intelligence: User reviews comprehensive dossier with personality, compatibility, red/green flags
  4. 4. Decision: User decides whether match is worth pursuing
  5. 5. Action: If yes, user can leverage conversation coaching (optional)

Dossier Intelligence Features

  • Dossier Library: Central hub for all generated match intelligence
  • Comparison Tool: Side-by-side analysis of multiple matches
  • Daily Recommendations: Top matches based on compatibility
  • Deep Dives: Personality, compatibility, red/green flags, social media analysis

Conversation Intelligence (Supplementary)

All conversation features are dossier-informed, meaning they reference the match's dossier to provide context-aware coaching.

  • Dossier Linking: Conversations must be linked to dossiers for full intelligence
  • Response Suggestions: AI-generated responses informed by match personality
  • Real-Time Coaching: Live guidance during active conversations
  • Dossier Quick View: Floating reference panel during conversations