feat: Weekly Report — Spotify Wrapped-style emotional summary with mood arc, AI narrative, emotion breakdown, and one-click image export

backend/main.py

@@ -15,6 +15,7 @@ from routes.trends import router as trends_router
 from routes.alerts import router as alerts_router
 from routes.chat import router as chat_router
 from routes.auth import router as auth_router
+from routes.weekly_report import router as weekly_report_router
 
 app = FastAPI(
     title="InnerVoice API",
@@ -56,6 +57,7 @@ app.include_router(trends_router, prefix="/api")
 app.include_router(alerts_router, prefix="/api")
 app.include_router(chat_router, prefix="/api")
 app.include_router(auth_router, prefix="/api")
+app.include_router(weekly_report_router, prefix="/api")
 
 
 @app.get("/api/health")

backend/routes/weekly_report.py

@@ -0,0 +1,164 @@
+"""
+GET /api/weekly-report — generate a rich weekly emotional summary
+"""
+from fastapi import APIRouter, Depends
+from sqlalchemy.orm import Session
+from models.database import get_db, VoiceEntry, User
+from routes.auth import get_current_user
+from services.gpt_service import generate_weekly_narrative
+from datetime import datetime, timedelta
+from statistics import mean
+from collections import Counter, defaultdict
+
+router = APIRouter()
+
+EMOTION_EMOJI = {
+    "happy": "😊", "sad": "😢", "angry": "😤", "fearful": "😰",
+    "neutral": "😐", "disgust": "😒", "surprised": "😲", "calm": "😌",
+}
+
+EMOTION_COLOR = {
+    "happy": "#f59e0b", "sad": "#60a5fa", "angry": "#ef4444", "fearful": "#a78bfa",
+    "neutral": "#6b7280", "disgust": "#10b981", "surprised": "#f97316", "calm": "#34d399",
+}
+
+def safe_mean(values):
+    clean = [v for v in values if v is not None]
+    return round(mean(clean), 1) if clean else None
+
+
+@router.get("/weekly-report")
+def get_weekly_report(
+    current_user: User = Depends(get_current_user),
+    db: Session = Depends(get_db),
+):
+    now = datetime.utcnow()
+    week_start = now - timedelta(days=7)
+
+    week_entries = (
+        db.query(VoiceEntry)
+        .filter(
+            VoiceEntry.user_id == current_user.id,
+            VoiceEntry.created_at >= week_start,
+        )
+        .order_by(VoiceEntry.created_at.asc())
+        .all()
+    )
+
+    if not week_entries:
+        return {"has_data": False}
+
+    # ── Core stats ────────────────────────────────────────────────────────────
+    mood_scores   = [e.mood_score for e in week_entries if e.mood_score is not None]
+    energy_scores = [e.energy_score for e in week_entries if e.energy_score is not None]
+    calm_scores   = [e.calmness_score for e in week_entries if e.calmness_score is not None]
+    clarity_scores = [e.clarity_score for e in week_entries if e.clarity_score is not None]
+
+    avg_mood    = safe_mean(mood_scores)
+    avg_energy  = safe_mean(energy_scores)
+    avg_calm    = safe_mean(calm_scores)
+    avg_clarity = safe_mean(clarity_scores)
+
+    # ── Best & worst day ─────────────────────────────────────────────────────
+    best_entry  = max(week_entries, key=lambda e: e.mood_score or 0)
+    worst_entry = min(week_entries, key=lambda e: e.mood_score or 100)
+
+    # ── Dominant emotion ─────────────────────────────────────────────────────
+    emotion_counts = Counter(e.primary_emotion for e in week_entries if e.primary_emotion)
+    top_emotion = emotion_counts.most_common(1)[0][0] if emotion_counts else "neutral"
+    top_emotion_pct = round(emotion_counts[top_emotion] / len(week_entries) * 100) if emotion_counts else 0
+
+    # ── Mood arc for sparkline (daily avg) ────────────────────────────────────
+    day_buckets = defaultdict(list)
+    for e in week_entries:
+        day_key = e.created_at.strftime("%a")
+        if e.mood_score is not None:
+            day_buckets[day_key].append(e.mood_score)
+
+    # Build ordered 7-day array
+    days_ordered = []
+    for i in range(6, -1, -1):
+        d = now - timedelta(days=i)
+        key = d.strftime("%a")
+        days_ordered.append({
+            "day": key,
+            "date": d.strftime("%b %d"),
+            "avg_mood": round(mean(day_buckets[key]), 1) if day_buckets.get(key) else None,
+        })
+
+    # ── Mood delta vs previous week ───────────────────────────────────────────
+    prev_week_start = week_start - timedelta(days=7)
+    prev_entries = (
+        db.query(VoiceEntry)
+        .filter(
+            VoiceEntry.user_id == current_user.id,
+            VoiceEntry.created_at >= prev_week_start,
+            VoiceEntry.created_at < week_start,
+        )
+        .all()
+    )
+    prev_mood_avg = safe_mean([e.mood_score for e in prev_entries if e.mood_score is not None])
+    mood_delta = round(avg_mood - prev_mood_avg, 1) if avg_mood and prev_mood_avg else None
+
+    # ── Streak ────────────────────────────────────────────────────────────────
+    all_dates = {e.created_at.date() for e in db.query(VoiceEntry)
+                 .filter(VoiceEntry.user_id == current_user.id).all()}
+    streak = 0
+    check = now.date()
+    while check in all_dates:
+        streak += 1
+        check -= timedelta(days=1)
+
+    # ── Most expressive moment ────────────────────────────────────���───────────
+    most_expressive = max(
+        (e for e in week_entries if e.transcription),
+        key=lambda e: len(e.transcription or ""),
+        default=None,
+    )
+
+    # ── LLM narrative ─────────────────────────────────────────────────────────
+    narrative = generate_weekly_narrative(
+        top_emotion=top_emotion,
+        avg_mood=avg_mood,
+        avg_energy=avg_energy,
+        avg_calm=avg_calm,
+        mood_delta=mood_delta,
+        entry_count=len(week_entries),
+        streak=streak,
+        best_day=best_entry.created_at.strftime("%A") if best_entry else None,
+        worst_day=worst_entry.created_at.strftime("%A") if worst_entry else None,
+        transcriptions=[e.transcription for e in week_entries if e.transcription][:5],
+    )
+
+    return {
+        "has_data": True,
+        "week_label": f"{week_start.strftime('%b %d')} – {now.strftime('%b %d, %Y')}",
+        "entry_count": len(week_entries),
+        "streak": streak,
+        "top_emotion": top_emotion,
+        "top_emotion_emoji": EMOTION_EMOJI.get(top_emotion, "💭"),
+        "top_emotion_color": EMOTION_COLOR.get(top_emotion, "#6b7280"),
+        "top_emotion_pct": top_emotion_pct,
+        "avg_mood": avg_mood,
+        "avg_energy": avg_energy,
+        "avg_calm": avg_calm,
+        "avg_clarity": avg_clarity,
+        "mood_delta": mood_delta,
+        "best_day": {
+            "date": best_entry.created_at.strftime("%A, %b %d"),
+            "mood": best_entry.mood_score,
+            "emotion": best_entry.primary_emotion,
+        } if best_entry else None,
+        "worst_day": {
+            "date": worst_entry.created_at.strftime("%A, %b %d"),
+            "mood": worst_entry.mood_score,
+            "emotion": worst_entry.primary_emotion,
+        } if worst_entry else None,
+        "mood_arc": days_ordered,
+        "most_expressive_moment": most_expressive.transcription[:200] if most_expressive else None,
+        "narrative": narrative,
+        "emotion_breakdown": [
+            {"emotion": k, "count": v, "pct": round(v / len(week_entries) * 100), "color": EMOTION_COLOR.get(k, "#6b7280")}
+            for k, v in emotion_counts.most_common()
+        ],
+    }

backend/services/gpt_service.py

@@ -79,6 +79,60 @@ Write a warm 2-3 sentence insight about their emotional state right now. Be empa
         return _fallback_insight(emotion, mood_scores)
 
 
+def generate_weekly_narrative(
+    top_emotion: str,
+    avg_mood: float,
+    avg_energy: float,
+    avg_calm: float,
+    mood_delta: Optional[float],
+    entry_count: int,
+    streak: int,
+    best_day: Optional[str],
+    worst_day: Optional[str],
+    transcriptions: list,
+) -> str:
+    """Generate a warm, personalised weekly summary narrative."""
+    client = _get_client()
+
+    delta_str = ""
+    if mood_delta is not None:
+        direction = "up" if mood_delta > 0 else "down"
+        delta_str = f"Your average mood is {direction} {abs(mood_delta)} points vs last week."
+
+    excerpts = " | ".join(f'"{t[:80]}"' for t in transcriptions if t) if transcriptions else ""
+
+    prompt = f"""Generate a warm, empathetic 3-sentence weekly emotional summary for a user.
+
+Data:
+- Check-ins: {entry_count}, Streak: {streak} days
+- Top emotion: {top_emotion}, Avg mood: {avg_mood}/100, Energy: {avg_energy}/100, Calm: {avg_calm}/100
+- {delta_str}
+- Best day: {best_day or 'N/A'}, Lowest day: {worst_day or 'N/A'}
+- Voice excerpts: {excerpts}
+
+Write in second person. Be warm and specific. End with one gentle insight about the week. No clinical language. Don't start with "I"."""
+
+    try:
+        response = client.chat.completions.create(
+            model=OPENROUTER_MODEL,
+            messages=[
+                {"role": "system", "content": "You are a warm emotional wellness companion writing a personalised weekly summary."},
+                {"role": "user", "content": prompt},
+            ],
+            max_tokens=200,
+            temperature=0.85,
+        )
+        return response.choices[0].message.content.strip()
+    except Exception as e:
+        print(f"[GPTService] generate_weekly_narrative error: {e}")
+        direction = "higher" if (mood_delta or 0) > 0 else "lower"
+        return (
+            f"This week you showed up {entry_count} time{'s' if entry_count != 1 else ''} — and that consistency matters. "
+            f"Your dominant emotion was {top_emotion}, with an average mood of {avg_mood}/100. "
+            f"{'Your mood trended ' + direction + ' compared to last week.' if mood_delta else 'Keep building — every check-in is a small act of self-care.'}"
+        )
+
+
 def chat_response(
     user_message: str,
     recent_entries: list,

frontend/app/report/page.tsx

@@ -0,0 +1,353 @@
+"use client";
+import { useEffect, useState, useRef } from "react";
+import { api } from "@/lib/api";
+import { useDemoMode } from "@/hooks/useDemoMode";
+import { motion } from "framer-motion";
+import { Download, Share2, TrendingUp, TrendingDown, Flame, Calendar, Mic } from "lucide-react";
+
+interface WeeklyReport {
+  has_data: boolean;
+  week_label: string;
+  entry_count: number;
+  streak: number;
+  top_emotion: string;
+  top_emotion_emoji: string;
+  top_emotion_color: string;
+  top_emotion_pct: number;
+  avg_mood: number;
+  avg_energy: number;
+  avg_calm: number;
+  avg_clarity: number;
+  mood_delta: number | null;
+  best_day: { date: string; mood: number; emotion: string } | null;
+  worst_day: { date: string; mood: number; emotion: string } | null;
+  mood_arc: Array<{ day: string; date: string; avg_mood: number | null }>;
+  most_expressive_moment: string | null;
+  narrative: string;
+  emotion_breakdown: Array<{ emotion: string; count: number; pct: number; color: string }>;
+}
+
+const DEMO_REPORT: WeeklyReport = {
+  has_data: true,
+  week_label: "Apr 4 – Apr 11, 2025",
+  entry_count: 6,
+  streak: 4,
+  top_emotion: "neutral",
+  top_emotion_emoji: "😐",
+  top_emotion_color: "#6b7280",
+  top_emotion_pct: 50,
+  avg_mood: 57,
+  avg_energy: 61,
+  avg_calm: 54,
+  avg_clarity: 60,
+  mood_delta: +4.2,
+  best_day: { date: "Tuesday, Apr 8", mood: 72, emotion: "happy" },
+  worst_day: { date: "Thursday, Apr 10", mood: 41, emotion: "sad" },
+  mood_arc: [
+    { day: "Fri", date: "Apr 5", avg_mood: 55 },
+    { day: "Sat", date: "Apr 6", avg_mood: null },
+    { day: "Sun", date: "Apr 7", avg_mood: 60 },
+    { day: "Mon", date: "Apr 8", avg_mood: 72 },
+    { day: "Tue", date: "Apr 9", avg_mood: 58 },
+    { day: "Wed", date: "Apr 10", avg_mood: 41 },
+    { day: "Thu", date: "Apr 11", avg_mood: 56 },
+  ],
+  most_expressive_moment: "I'm feeling really sad nowadays. I don't know what's up with me, to be honest, but there is something different.",
+  narrative: "This week you showed real resilience, checking in 6 times even through some emotionally heavy moments. Your mood peaked on Tuesday, and while Thursday brought a dip, you kept coming back — and that matters more than any single score. The steady rhythm you're building is quietly becoming your emotional anchor.",
+  emotion_breakdown: [
+    { emotion: "neutral", count: 3, pct: 50, color: "#6b7280" },
+    { emotion: "sad", count: 2, pct: 33, color: "#60a5fa" },
+    { emotion: "happy", count: 1, pct: 17, color: "#f59e0b" },
+  ],
+};
+
+function Sparkline({ arc }: { arc: WeeklyReport["mood_arc"] }) {
+  const w = 420, h = 80, pad = 10;
+  const values = arc.map(d => d.avg_mood);
+  const filled = values.filter(v => v !== null) as number[];
+  if (filled.length === 0) return null;
+
+  const min = Math.min(...filled) - 5;
+  const max = Math.max(...filled) + 5;
+  const xStep = (w - pad * 2) / (arc.length - 1);
+
+  const points = arc
+    .map((d, i) => d.avg_mood !== null
+      ? `${pad + i * xStep},${h - pad - ((d.avg_mood - min) / (max - min)) * (h - pad * 2)}`
+      : null)
+    .filter(Boolean) as string[];
+
+  const pathD = points.length > 1
+    ? `M ${points.join(" L ")}`
+    : "";
+
+  return (
+    <svg viewBox={`0 0 ${w} ${h}`} className="w-full h-16" preserveAspectRatio="none">
+      <defs>
+        <linearGradient id="sparkGrad" x1="0" y1="0" x2="1" y2="0">
+          <stop offset="0%" stopColor="#7c3aed" />
+          <stop offset="100%" stopColor="#06b6d4" />
+        </linearGradient>
+      </defs>
+      <path d={pathD} stroke="url(#sparkGrad)" strokeWidth="2.5" fill="none" strokeLinecap="round" strokeLinejoin="round" />
+      {arc.map((d, i) => d.avg_mood !== null && (
+        <circle
+          key={i}
+          cx={pad + i * xStep}
+          cy={h - pad - ((d.avg_mood! - min) / (max - min)) * (h - pad * 2)}
+          r="3.5"
+          fill="url(#sparkGrad)"
+        />
+      ))}
+    </svg>
+  );
+}
+
+function ScorePill({ label, value, color }: { label: string; value: number; color: string }) {
+  return (
+    <div className="flex flex-col items-center gap-1">
+      <div className="text-2xl font-bold" style={{ color }}>{value}</div>
+      <div className="text-[10px] uppercase tracking-wider text-white/40">{label}</div>
+    </div>
+  );
+}
+
+export default function WeeklyReportPage() {
+  const { isDemoMode, userId } = useDemoMode();
+  const [report, setReport] = useState<WeeklyReport | null>(null);
+  const [loading, setLoading] = useState(true);
+  const cardRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    async function load() {
+      if (!userId) return;
+      try {
+        if (isDemoMode) {
+          await new Promise(r => setTimeout(r, 800));
+          setReport(DEMO_REPORT);
+        } else {
+          const data = await api.getWeeklyReport() as WeeklyReport;
+          setReport(data);
+        }
+      } catch (e) {
+        console.error(e);
+      } finally {
+        setLoading(false);
+      }
+    }
+    load();
+  }, [userId, isDemoMode]);
+
+  const handleShare = async () => {
+    if (!cardRef.current) return;
+    try {
+      // Use html-to-image if available, otherwise fall back to clipboard
+      const { toPng } = await import("html-to-image");
+      const dataUrl = await toPng(cardRef.current, { quality: 0.95, pixelRatio: 2 });
+      const link = document.createElement("a");
+      link.download = "my-week-in-feelings.png";
+      link.href = dataUrl;
+      link.click();
+    } catch {
+      // Fallback: share via Web Share API
+      if (navigator.share) {
+        await navigator.share({ title: "My Week In Feelings — InnerVoice", text: report?.narrative ?? "" });
+      }
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="flex items-center justify-center min-h-screen">
+        <div className="text-center space-y-4">
+          <div className="w-12 h-12 rounded-full border-2 border-purple-500 border-t-transparent animate-spin mx-auto" />
+          <p className="text-white/40 text-sm">Generating your week in feelings...</p>
+        </div>
+      </div>
+    );
+  }
+
+  if (!report?.has_data) {
+    return (
+      <div className="flex items-center justify-center min-h-screen p-8">
+        <div className="text-center space-y-4 max-w-sm">
+          <div className="text-6xl">📭</div>
+          <h2 className="text-2xl font-bold">No data yet this week</h2>
+          <p className="text-white/40">Complete at least one voice check-in to generate your weekly report.</p>
+        </div>
+      </div>
+    );
+  }
+
+  const moodDeltaPositive = (report.mood_delta ?? 0) > 0;
+
+  return (
+    <div className="min-h-screen p-6 md:p-10 flex flex-col items-center gap-8">
+      {/* Page Header */}
+      <motion.div
+        initial={{ opacity: 0, y: -20 }}
+        animate={{ opacity: 1, y: 0 }}
+        className="text-center space-y-2 w-full max-w-2xl"
+      >
+        <h1 className="text-4xl font-bold bg-gradient-to-r from-purple-400 via-pink-400 to-cyan-400 bg-clip-text text-transparent">
+          Your Week In Feelings
+        </h1>
+        <p className="text-white/40">{report.week_label}</p>
+      </motion.div>
+
+      {/* Share / Download buttons */}
+      <div className="flex gap-3">
+        <button
+          onClick={handleShare}
+          className="flex items-center gap-2 px-5 py-2.5 rounded-xl bg-gradient-to-r from-purple-600 to-cyan-600 text-white text-sm font-semibold hover:opacity-90 transition-opacity shadow-lg shadow-purple-500/20"
+        >
+          <Download className="w-4 h-4" />
+          Save as Image
+        </button>
+        <button
+          onClick={() => navigator.share?.({ title: "My Week In Feelings", text: report.narrative })}
+          className="flex items-center gap-2 px-5 py-2.5 rounded-xl bg-white/5 border border-white/10 text-white/70 text-sm font-medium hover:bg-white/10 transition-colors"
+        >
+          <Share2 className="w-4 h-4" />
+          Share
+        </button>
+      </div>
+
+      {/* === THE SHAREABLE CARD === */}
+      <motion.div
+        ref={cardRef}
+        initial={{ opacity: 0, scale: 0.97 }}
+        animate={{ opacity: 1, scale: 1 }}
+        transition={{ delay: 0.1 }}
+        className="w-full max-w-2xl rounded-3xl overflow-hidden bg-[#0a0a0f] border border-white/10 shadow-2xl"
+        style={{ background: "linear-gradient(135deg, #0d0d1a 0%, #0a0a0f 50%, #0d101a 100%)" }}
+      >
+        {/* Header stripe */}
+        <div className="h-1.5 w-full" style={{ background: `linear-gradient(90deg, #7c3aed, ${report.top_emotion_color}, #06b6d4)` }} />
+
+        <div className="p-8 space-y-8">
+          {/* Top row: emotion hero + quick stats */}
+          <div className="flex items-center justify-between">
+            <div className="space-y-1">
+              <div className="text-xs uppercase tracking-widest text-white/30 font-semibold">Dominant Feeling</div>
+              <div className="flex items-center gap-3">
+                <span className="text-5xl">{report.top_emotion_emoji}</span>
+                <div>
+                  <div className="text-2xl font-bold capitalize">{report.top_emotion}</div>
+                  <div className="text-sm text-white/40">{report.top_emotion_pct}% of the week</div>
+                </div>
+              </div>
+            </div>
+
+            <div className="flex gap-6 text-right">
+              <div>
+                <div className="flex items-center gap-1 justify-end text-sm font-semibold">
+                  <Flame className="w-4 h-4 text-orange-400" />
+                  <span>{report.streak}</span>
+                </div>
+                <div className="text-[10px] text-white/30 uppercase tracking-wider">Day Streak</div>
+              </div>
+              <div>
+                <div className="flex items-center gap-1 justify-end text-sm font-semibold">
+                  <Mic className="w-4 h-4 text-cyan-400" />
+                  <span>{report.entry_count}</span>
+                </div>
+                <div className="text-[10px] text-white/30 uppercase tracking-wider">Check-ins</div>
+              </div>
+            </div>
+          </div>
+
+          {/* Mood Arc sparkline */}
+          <div>
+            <div className="flex justify-between items-center mb-3">
+              <div className="text-xs uppercase tracking-widest text-white/30 font-semibold">Mood Arc This Week</div>
+              {report.mood_delta !== null && (
+                <div className={`flex items-center gap-1 text-sm font-semibold ${moodDeltaPositive ? "text-emerald-400" : "text-red-400"}`}>
+                  {moodDeltaPositive ? <TrendingUp className="w-4 h-4" /> : <TrendingDown className="w-4 h-4" />}
+                  {moodDeltaPositive ? "+" : ""}{report.mood_delta} vs last week
+                </div>
+              )}
+            </div>
+            <Sparkline arc={report.mood_arc} />
+            <div className="flex justify-between mt-1">
+              {report.mood_arc.map(d => (
+                <span key={d.day} className="text-[10px] text-white/20">{d.day}</span>
+              ))}
+            </div>
+          </div>
+
+          {/* Avg Scores */}
+          <div>
+            <div className="text-xs uppercase tracking-widest text-white/30 font-semibold mb-4">Weekly Averages</div>
+            <div className="grid grid-cols-4 gap-4 bg-white/[0.03] rounded-2xl p-5 border border-white/5">
+              <ScorePill label="Mood" value={report.avg_mood} color="#a78bfa" />
+              <ScorePill label="Energy" value={report.avg_energy} color="#34d399" />
+              <ScorePill label="Calm" value={report.avg_calm} color="#60a5fa" />
+              <ScorePill label="Clarity" value={report.avg_clarity} color="#f59e0b" />
+            </div>
+          </div>
+
+          {/* Best & Worst Day */}
+          <div className="grid grid-cols-2 gap-4">
+            {report.best_day && (
+              <div className="bg-emerald-500/5 border border-emerald-500/20 rounded-2xl p-4">
+                <div className="text-[10px] uppercase tracking-wider text-emerald-400 font-semibold mb-1">✦ Best Moment</div>
+                <div className="font-semibold text-sm">{report.best_day.date}</div>
+                <div className="text-emerald-300 text-lg font-bold">{report.best_day.mood}<span className="text-xs font-normal text-white/30">/100</span></div>
+              </div>
+            )}
+            {report.worst_day && (
+              <div className="bg-blue-500/5 border border-blue-500/20 rounded-2xl p-4">
+                <div className="text-[10px] uppercase tracking-wider text-blue-400 font-semibold mb-1">↓ Lowest Point</div>
+                <div className="font-semibold text-sm">{report.worst_day.date}</div>
+                <div className="text-blue-300 text-lg font-bold">{report.worst_day.mood}<span className="text-xs font-normal text-white/30">/100</span></div>
+              </div>
+            )}
+          </div>
+
+          {/* Emotion Breakdown */}
+          <div>
+            <div className="text-xs uppercase tracking-widest text-white/30 font-semibold mb-3">Emotion Breakdown</div>
+            <div className="space-y-2">
+              {report.emotion_breakdown.map(e => (
+                <div key={e.emotion} className="flex items-center gap-3">
+                  <div className="w-20 text-xs capitalize text-white/60">{e.emotion}</div>
+                  <div className="flex-1 h-2 bg-white/5 rounded-full overflow-hidden">
+                    <motion.div
+                      initial={{ width: 0 }}
+                      animate={{ width: `${e.pct}%` }}
+                      transition={{ delay: 0.5, duration: 0.8, ease: "easeOut" }}
+                      className="h-full rounded-full"
+                      style={{ backgroundColor: e.color }}
+                    />
+                  </div>
+                  <div className="text-xs text-white/30 w-8 text-right">{e.pct}%</div>
+                </div>
+              ))}
+            </div>
+          </div>
+
+          {/* AI Narrative */}
+          <div className="bg-gradient-to-br from-purple-500/10 to-cyan-500/10 border border-purple-500/20 rounded-2xl p-6">
+            <div className="text-xs uppercase tracking-widest text-purple-400 font-semibold mb-3">InnerVoice's Take</div>
+            <p className="text-white/80 text-sm leading-relaxed italic">"{report.narrative}"</p>
+          </div>
+
+          {/* Most expressive moment */}
+          {report.most_expressive_moment && (
+            <div className="border-l-2 border-cyan-500/40 pl-4">
+              <div className="text-[10px] uppercase tracking-wider text-white/30 font-semibold mb-1">Most Expressive Moment</div>
+              <p className="text-white/50 text-sm italic">"{report.most_expressive_moment}"</p>
+            </div>
+          )}
+
+          {/* Footer branding */}
+          <div className="flex items-center justify-between pt-2 border-t border-white/5">
+            <div className="text-xs text-white/20">InnerVoice — Emotional Wellness Tracker</div>
+            <div className="text-xs text-white/20">Not a medical tool</div>
+          </div>
+        </div>
+      </motion.div>
+    </div>
+  );
+}

frontend/components/Navbar.tsx

@@ -4,13 +4,14 @@ import { usePathname } from "next/navigation";
 import { useDemoMode } from "@/hooks/useDemoMode";
 import { useAuth } from "@/contexts/AuthContext";
 import { motion, AnimatePresence } from "framer-motion";
-import { Home, Mic, TrendingUp, MessageCircle, Settings, LogOut, Lock, Menu, X } from "lucide-react";
+import { Home, Mic, TrendingUp, MessageCircle, Settings, LogOut, BarChart2, Menu, X } from "lucide-react";
 import { useState } from "react";
 
 const navItems = [
   { href: "/dashboard", label: "Dashboard", icon: Home },
   { href: "/record", label: "Check-in", icon: Mic },
   { href: "/timeline", label: "Timeline", icon: TrendingUp },
+  { href: "/report", label: "Weekly Report", icon: BarChart2 },
   { href: "/chat", label: "Companion", icon: MessageCircle },
   { href: "/settings", label: "Settings", icon: Settings },
 ];

frontend/lib/api.ts

@@ -129,6 +129,9 @@ export const api = {
       headers: { ...getAuthHeader() },
     }).then(r => r.json()),
 
+  getWeeklyReport: () =>
+    apiGet<Record<string, unknown>>("/api/weekly-report"),
+
   analyzeAudio: async (audioBlob: Blob): Promise<AnalyzeResult> => {
     const formData = new FormData();
     formData.append("audio", audioBlob, "recording.webm");

frontend/package-lock.json

@@ -19,6 +19,7 @@
         "clsx": "^2.1.1",
         "date-fns": "^4.1.0",
         "framer-motion": "^12.38.0",
+        "html-to-image": "^1.11.13",
         "lucide-react": "^1.8.0",
         "next": "14.2.35",
         "next-auth": "^4.24.13",
@@ -1429,6 +1430,7 @@
       "resolved": "https://registry.npmjs.org/@react-three/fiber/-/fiber-8.15.0.tgz",
       "integrity": "sha512-rYefFqu6ki0iuPlIFhnfZsucJjY+4ZQNTdt+rvQgWo9f2T1Ia+1yotlNMs7jlnNG5nNBLQcq8zcz4pxbWg6rmw==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@babel/runtime": "^7.17.8",
         "@types/react-reconciler": "^0.26.7",
@@ -1679,6 +1681,7 @@
       "resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.28.tgz",
       "integrity": "sha512-z9VXpC7MWrhfWipitjNdgCauoMLRdIILQsAEV+ZesIzBq/oUlxk0m3ApZuMFCXdnS4U7KrI+l3WRUEGQ8K1QKw==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@types/prop-types": "*",
         "csstype": "^3.2.2"
@@ -1688,8 +1691,9 @@
       "version": "18.3.7",
       "resolved": "https://registry.npmjs.org/@types/react-dom/-/react-dom-18.3.7.tgz",
       "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==",
-      "dev": true,
+      "devOptional": true,
       "license": "MIT",
+      "peer": true,
       "peerDependencies": {
         "@types/react": "^18.0.0"
       }
@@ -1714,6 +1718,7 @@
       "resolved": "https://registry.npmjs.org/@types/three/-/three-0.183.1.tgz",
       "integrity": "sha512-f2Pu5Hrepfgavttdye3PsH5RWyY/AvdZQwIVhrc4uNtvF7nOWJacQKcoVJn0S4f0yYbmAE6AR+ve7xDcuYtMGw==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@dimforge/rapier3d-compat": "~0.12.0",
         "@tweenjs/tween.js": "~23.1.3",
@@ -1781,6 +1786,7 @@
       "integrity": "sha512-gGkiNMPqerb2cJSVcruigx9eHBlLG14fSdPdqMoOcBfh+vvn4iCq2C8MzUB89PrxOXk0y3GZ1yIWb9aOzL93bw==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@typescript-eslint/scope-manager": "8.58.1",
         "@typescript-eslint/types": "8.58.1",
@@ -2324,6 +2330,7 @@
       "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -3584,6 +3591,7 @@
       "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.2.0",
         "@eslint-community/regexpp": "^4.6.1",
@@ -3753,6 +3761,7 @@
       "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@rtsao/scc": "^1.1.0",
         "array-includes": "^3.1.9",
@@ -4579,6 +4588,12 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/html-to-image": {
+      "version": "1.11.13",
+      "resolved": "https://registry.npmjs.org/html-to-image/-/html-to-image-1.11.13.tgz",
+      "integrity": "sha512-cuOPoI7WApyhBElTTb9oqsawRvZ0rHhaHwghRLlTuffoD1B2aDemlCruLeZrUIIdvG7gs9xeELEPm6PhuASqrg==",
+      "license": "MIT"
+    },
     "node_modules/ieee754": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
@@ -5201,6 +5216,7 @@
       "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "bin": {
         "jiti": "bin/jiti.js"
       }
@@ -6129,6 +6145,7 @@
         }
       ],
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -6304,6 +6321,7 @@
       "resolved": "https://registry.npmjs.org/preact/-/preact-10.29.1.tgz",
       "integrity": "sha512-gQCLc/vWroE8lIpleXtdJhTFDogTdZG9AjMUpVkDf2iTCNwYNWA+u16dL41TqUDJO4gm2IgrcMv3uTpjd4Pwmg==",
       "license": "MIT",
+      "peer": true,
       "funding": {
         "type": "opencollective",
         "url": "https://opencollective.com/preact"
@@ -6384,6 +6402,7 @@
       "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
       "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "loose-envify": "^1.1.0"
       },
@@ -6408,6 +6427,7 @@
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
       "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "loose-envify": "^1.1.0",
         "scheduler": "^0.23.2"
@@ -6420,7 +6440,8 @@
       "version": "16.13.1",
       "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz",
       "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
     },
     "node_modules/react-merge-refs": {
       "version": "1.1.0",
@@ -6462,6 +6483,7 @@
       "resolved": "https://registry.npmjs.org/react-redux/-/react-redux-9.2.0.tgz",
       "integrity": "sha512-ROY9fvHhwOD9ySfrF0wmvu//bKCQ6AeZZq1nJNtbDC+kk5DuSuNX/n6YWYF/SYy7bSba4D4FSz8DJeKY/S/r+g==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@types/use-sync-external-store": "^0.0.6",
         "use-sync-external-store": "^1.4.0"
@@ -6621,7 +6643,8 @@
       "version": "5.0.1",
       "resolved": "https://registry.npmjs.org/redux/-/redux-5.0.1.tgz",
       "integrity": "sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
     },
     "node_modules/redux-thunk": {
       "version": "3.1.0",
@@ -7526,7 +7549,8 @@
       "version": "0.160.0",
       "resolved": "https://registry.npmjs.org/three/-/three-0.160.0.tgz",
       "integrity": "sha512-DLU8lc0zNIPkM7rH5/e1Ks1Z8tWCGRq6g8mPowdDJpw1CFBJMU7UoJjC6PefXW7z//SSl0b2+GCw14LB+uDhng==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
     },
     "node_modules/three-mesh-bvh": {
       "version": "0.6.8",
@@ -7607,6 +7631,7 @@
       "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -7806,6 +7831,7 @@
       "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
       "dev": true,
       "license": "Apache-2.0",
+      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"

frontend/package.json

@@ -20,6 +20,7 @@
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "framer-motion": "^12.38.0",
+    "html-to-image": "^1.11.13",
     "lucide-react": "^1.8.0",
     "next": "14.2.35",
     "next-auth": "^4.24.13",

prisma/schema.prisma

@@ -69,16 +69,31 @@ model MoodAlert {
   @@map("mood_alerts")
 }
 
+model ChatChannel {
+  id        String   @id @default(uuid())
+  userId    String   @map("user_id")
+  title     String   @default("New Chat")
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @default(now()) @updatedAt @map("updated_at")
+
+  user     User          @relation(fields: [userId], references: [id], onDelete: Cascade)
+  messages ChatMessage[]
+
+  @@map("chat_channels")
+}
+
 model ChatMessage {
   id           String   @id @default(uuid())
   userId       String   @map("user_id")
+  channelId    String?  @map("channel_id")
   createdAt    DateTime @default(now()) @map("created_at")
   role         String
   content      String
   voiceEntryId String?  @map("voice_entry_id")
 
-  user       User        @relation(fields: [userId], references: [id], onDelete: Cascade)
-  voiceEntry VoiceEntry? @relation(fields: [voiceEntryId], references: [id])
+  user       User         @relation(fields: [userId], references: [id], onDelete: Cascade)
+  channel    ChatChannel? @relation(fields: [channelId], references: [id], onDelete: Cascade)
+  voiceEntry VoiceEntry?  @relation(fields: [voiceEntryId], references: [id])
 
   @@map("chat_messages")
 }