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
Flow Architecture
Primary User Journey (Dossier-First)
- 1. Upload: User uploads dating app profile screenshot
- 2. Processing: OCR extraction and AI analysis generate dossier
- 3. Intelligence: User reviews comprehensive dossier with personality, compatibility, red/green flags
- 4. Decision: User decides whether match is worth pursuing
- 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