feat: analytics dashboards & two-tier feedback system (#78)

* docs: add analytics & user feedback design document

Covers team analytics, personal analytics, flow analytics,
step-level thumbs up/down feedback, and flow CSAT ratings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add analytics & feedback implementation plan

12-task TDD plan covering session ratings, step feedback,
team/personal/flow analytics endpoints, and frontend pages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add session_ratings table and analytics indexes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add SessionRating model and analytics schemas

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add session CSAT rating endpoint with tests

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add step thumbs feedback and /ratings alias routes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add team, personal, and flow analytics endpoints

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add recharts, analytics types, and API client

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add inline step thumbs up/down feedback during sessions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add CSAT rating modal after session completion

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add Team Analytics page with charts and leaderboards

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add Flow Analytics panel with step dropoff and CSAT data

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add My Analytics page with personal stats and charts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

frontend/src/types/analytics.ts

@@ -0,0 +1,82 @@
+export interface OutcomeBreakdown {
+  resolved: number
+  escalated: number
+  workaround: number
+  unresolved: number
+}
+
+export interface AnalyticsSummary {
+  total_sessions: number
+  completed_sessions: number
+  completion_rate: number
+  median_duration_minutes: number
+  active_engineers: number
+  outcome_breakdown: OutcomeBreakdown
+}
+
+export interface TimeSeriesPoint {
+  date: string
+  sessions: number
+  resolved: number
+  escalated: number
+  workaround: number
+  unresolved: number
+}
+
+export interface TopFlow {
+  tree_id: string
+  name: string
+  sessions: number
+  completion_rate: number
+  median_duration_minutes: number
+  avg_csat?: number
+}
+
+export interface TopEngineer {
+  user_id: string
+  name: string
+  sessions: number
+  completion_rate: number
+  median_duration_minutes: number
+}
+
+export interface TeamAnalyticsResponse {
+  summary: AnalyticsSummary
+  time_series: TimeSeriesPoint[]
+  top_flows: TopFlow[]
+  top_engineers: TopEngineer[]
+}
+
+export interface PersonalAnalyticsResponse {
+  summary: AnalyticsSummary
+  time_series: TimeSeriesPoint[]
+  top_flows: TopFlow[]
+}
+
+export interface StepFeedbackSummary {
+  node_id: string
+  node_title: string
+  helpful_yes: number
+  helpful_no: number
+  helpful_rate: number
+  visit_count: number
+  dropoff_count: number
+  dropoff_rate: number
+}
+
+export interface FlowRatingItem {
+  rating: number
+  comment?: string
+  created_at: string
+}
+
+export interface FlowAnalyticsResponse {
+  summary: AnalyticsSummary
+  avg_csat?: number
+  total_ratings: number
+  time_series: TimeSeriesPoint[]
+  step_feedback: StepFeedbackSummary[]
+  recent_comments: FlowRatingItem[]
+}
+
+export type AnalyticsPeriod = '7d' | '30d' | '90d'

frontend/src/types/index.ts

@@ -9,6 +9,7 @@ export * from './folder'
 export * from './step'
 export type { Account, Subscription, PlanLimits, SubscriptionDetails, AccountInvite, AccountMember } from './account'
 export * from './admin'
+export * from './analytics'
 
 // API response wrapper types
 export interface PaginatedResponse<T> {