v1.2.0 - PDF support for AI summaries and trend filtering

Features:
- AI summaries now use PDF when available (Claude), with fallback to HTML/abstract
- AI chat also prioritizes PDF input for better context
- PDF viewer embedded in paper card for papers with pdf_url
- Trend summaries can be filtered by tags
- Trend summary history with ability to view past summaries
- Summary history button only shows when 2+ summaries exist
- Fixed summary created_at timestamp

Technical changes:
- Added pdf_url column to papers table
- Added user_id and tag_ids to trend_summaries for history tracking
- AiSummaryService: callClaudeWithPdf(), callClaudeChatWithPdf() methods
- TrendController: tag filtering and history API
- New API endpoint: GET /api/trends/history

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: dbym4820

.env.example

@@ -42,5 +42,10 @@ DEFAULT_JOURNALS=
 ADMIN_CLAUDE_API_KEY=
 ADMIN_OPENAI_API_KEY=
 
+# Unpaywall API（本文取得用）
+# DOIがある論文のPDF/本文を自動取得するために必要
+# メールアドレスはAPI利用の識別に使用（認証ではない）
+UNPAYWALL_EMAIL=
+
 # デフォルト要約テンプレート・調査観点設定
 # config/generative_ai_settings/*.txt で管理しています（Git管理可能）

app/Console/Commands/FetchFullText.php

@@ -68,6 +68,7 @@ public function handle(): int
                 $paper->update([
                     'full_text' => $result['text'],
                     'full_text_source' => $result['source'],
+                    'pdf_url' => $result['pdf_url'],
                     'full_text_fetched_at' => now(),
                 ]);
                 $success++;

app/Http/Controllers/PaperController.php

@@ -115,6 +115,7 @@ public function getFullText(Request $request, int $id): JsonResponse
             'title' => $paper->title,
             'full_text' => $paper->full_text,
             'full_text_source' => $paper->full_text_source,
+            'pdf_url' => $paper->pdf_url,
             'full_text_fetched_at' => $paper->full_text_fetched_at?->toISOString(),
         ]);
     }
@@ -145,6 +146,7 @@ private function formatPaper(Paper $paper, bool $detailed = false): array
             'has_summary' => $paper->summaries->count() > 0 ? 1 : 0,
             'has_full_text' => $paper->hasFullText(),
             'full_text_source' => $paper->full_text_source,
+            'pdf_url' => $paper->pdf_url,
             // Always include summaries for frontend to show existing summaries
             'summaries' => $paper->summaries->map(function ($s) {
                 return [

app/Http/Controllers/SummaryController.php

@@ -96,6 +96,7 @@ public function generate(Request $request): JsonResponse
                 'implications' => $result['implications'] ?? null,
                 'tokens_used' => $result['tokens_used'] ?? null,
                 'generation_time_ms' => $result['generation_time_ms'] ?? null,
+                'created_at' => now(),
             ]);
 
             return response()->json([

app/Http/Controllers/TrendController.php

@@ -74,11 +74,24 @@ public function generate(Request $request, string $period): JsonResponse
             return response()->json(['error' => '無効な期間です'], 400);
         }
 
-        $papers = Paper::with('journal:id,name')
+        // Get tag IDs from request (optional)
+        $tagIds = $request->input('tagIds', []);
+        if (!is_array($tagIds)) {
+            $tagIds = [];
+        }
+
+        $papersQuery = Paper::with(['journal:id,name', 'tags:id,name'])
             ->forUser($user->id)
-            ->whereBetween('published_date', [$dateRange['from'], $dateRange['to']])
-            ->orderBy('published_date', 'desc')
-            ->get();
+            ->whereBetween('published_date', [$dateRange['from'], $dateRange['to']]);
+
+        // Filter by tags if specified
+        if (!empty($tagIds)) {
+            $papersQuery->whereHas('tags', function ($query) use ($tagIds) {
+                $query->whereIn('tags.id', $tagIds);
+            });
+        }
+
+        $papers = $papersQuery->orderBy('published_date', 'desc')->get();
 
         if ($papers->isEmpty()) {
             return response()->json([
@@ -98,7 +111,7 @@ public function generate(Request $request, string $period): JsonResponse
         $provider = $request->input('provider', config('services.ai.provider', 'claude'));
 
         try {
-            $summary = $this->generateTrendSummary($papers, $period, $dateRange, $provider);
+            $summary = $this->generateTrendSummary($user->id, $papers, $period, $dateRange, $provider, $tagIds);
 
             return response()->json([
                 'success' => true,
@@ -109,6 +122,7 @@ public function generate(Request $request, string $period): JsonResponse
                 ],
                 'paperCount' => $papers->count(),
                 'provider' => $provider,
+                'tagIds' => $tagIds,
                 'summary' => $summary,
             ]);
         } catch (\Exception $e) {
@@ -123,6 +137,8 @@ public function generate(Request $request, string $period): JsonResponse
      */
     public function summary(Request $request, string $period): JsonResponse
     {
+        $user = $request->attributes->get('user');
+
         $dateRange = $this->getDateRange($period);
 
         if (!$dateRange) {
@@ -132,8 +148,14 @@ public function summary(Request $request, string $period): JsonResponse
         $dateFrom = $dateRange['from']->format('Y-m-d');
         $dateTo = $dateRange['to']->format('Y-m-d');
 
-        // Try to get from database
-        $savedSummary = TrendSummary::findByPeriodAndDate($period, $dateFrom, $dateTo);
+        // Get tag IDs from query string (optional)
+        $tagIds = $request->query('tagIds', []);
+        if (is_string($tagIds)) {
+            $tagIds = $tagIds ? array_map('intval', explode(',', $tagIds)) : [];
+        }
+
+        // Try to get latest summary for user with matching tags
+        $savedSummary = TrendSummary::findLatestForUser($user->id, $period, $tagIds ?: null);
 
         if ($savedSummary) {
             return response()->json([
@@ -147,6 +169,7 @@ public function summary(Request $request, string $period): JsonResponse
                 'provider' => $savedSummary->ai_provider,
                 'model' => $savedSummary->ai_model,
                 'paperCount' => $savedSummary->paper_count,
+                'tagIds' => $savedSummary->tag_ids ?? [],
                 'summary' => $savedSummary->toApiResponse(),
             ]);
         }
@@ -163,6 +186,22 @@ public function summary(Request $request, string $period): JsonResponse
         ]);
     }
 
+    /**
+     * Get trend summary history for a user
+     */
+    public function history(Request $request): JsonResponse
+    {
+        $user = $request->attributes->get('user');
+        $limit = (int) $request->query('limit', 20);
+
+        $summaries = TrendSummary::getHistoryForUser($user->id, $limit);
+
+        return response()->json([
+            'success' => true,
+            'summaries' => $summaries->map(fn($s) => $s->toApiResponse()),
+        ]);
+    }
+
     /**
      * Get statistics for all periods
      */
@@ -225,7 +264,7 @@ private function getDateRange(string $period): ?array
     /**
      * Generate trend summary using AI
      */
-    private function generateTrendSummary($papers, string $period, array $dateRange, string $provider = 'claude'): array
+    private function generateTrendSummary(int $userId, $papers, string $period, array $dateRange, string $provider = 'claude', array $tagIds = []): array
     {
         $periodLabels = [
             'day' => '今日',
@@ -254,11 +293,12 @@ private function generateTrendSummary($papers, string $period, array $dateRange,
 
         $result = $this->aiService->generateCustomSummary($prompt, $provider);
 
-        // Save to database
+        // Save to database (always create new record for history)
         $dateFrom = $dateRange['from']->format('Y-m-d');
         $dateTo = $dateRange['to']->format('Y-m-d');
 
-        TrendSummary::createOrUpdateSummary([
+        TrendSummary::createSummary([
+            'user_id' => $userId,
             'period' => $period,
             'date_from' => $dateFrom,
             'date_to' => $dateTo,
@@ -270,6 +310,7 @@ private function generateTrendSummary($papers, string $period, array $dateRange,
             'journal_insights' => $result['journalInsights'] ?? null,
             'recommendations' => $result['recommendations'] ?? null,
             'paper_count' => $papers->count(),
+            'tag_ids' => !empty($tagIds) ? $tagIds : null,
         ]);
 
         return $result;

app/Models/Paper.php

@@ -17,6 +17,7 @@ class Paper extends Model
         'abstract',
         'full_text',
         'full_text_source',
+        'pdf_url',
         'full_text_fetched_at',
         'url',
         'doi',

app/Models/Summary.php

@@ -20,6 +20,7 @@ class Summary extends Model
         'implications',
         'tokens_used',
         'generation_time_ms',
+        'created_at',
     ];
 
     protected $casts = [

app/Models/TrendSummary.php

@@ -3,10 +3,12 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class TrendSummary extends Model
 {
     protected $fillable = [
+        'user_id',
         'period',
         'date_from',
         'date_to',
@@ -18,6 +20,7 @@ class TrendSummary extends Model
         'journal_insights',
         'recommendations',
         'paper_count',
+        'tag_ids',
     ];
 
     protected $casts = [
@@ -27,10 +30,61 @@ class TrendSummary extends Model
         'emerging_trends' => 'array',
         'journal_insights' => 'array',
         'recommendations' => 'array',
+        'tag_ids' => 'array',
     ];
 
     /**
-     * Find summary by period and date range
+     * Get the user that owns this trend summary
+     */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    /**
+     * Find latest summary by period for a user
+     *
+     * @param int $userId
+     * @param string $period
+     * @param array|null $tagIds
+     * @return TrendSummary|null
+     */
+    public static function findLatestForUser(int $userId, string $period, ?array $tagIds = null)
+    {
+        $query = self::where('user_id', $userId)
+            ->where('period', $period)
+            ->orderBy('created_at', 'desc');
+
+        if ($tagIds !== null && count($tagIds) > 0) {
+            // JSONカラムで完全一致検索
+            $query->whereJsonContains('tag_ids', $tagIds);
+        } else {
+            $query->where(function ($q) {
+                $q->whereNull('tag_ids')
+                  ->orWhere('tag_ids', '[]');
+            });
+        }
+
+        return $query->first();
+    }
+
+    /**
+     * Get history for a user
+     *
+     * @param int $userId
+     * @param int $limit
+     * @return \Illuminate\Database\Eloquent\Collection
+     */
+    public static function getHistoryForUser(int $userId, int $limit = 20)
+    {
+        return self::where('user_id', $userId)
+            ->orderBy('created_at', 'desc')
+            ->limit($limit)
+            ->get();
+    }
+
+    /**
+     * Find summary by period and date range (legacy, for backwards compatibility)
      *
      * @param string $period
      * @param string $dateFrom
@@ -42,34 +96,33 @@ public static function findByPeriodAndDate(string $period, string $dateFrom, str
         return self::where('period', $period)
             ->where('date_from', $dateFrom)
             ->where('date_to', $dateTo)
+            ->orderBy('created_at', 'desc')
             ->first();
     }
 
     /**
-     * Create or update summary
+     * Create a new summary (always creates new record for history)
      *
      * @param array $data
      * @return TrendSummary
      */
-    public static function createOrUpdateSummary(array $data)
+    public static function createSummary(array $data)
     {
-        return self::updateOrCreate(
-            [
-                'period' => $data['period'],
-                'date_from' => $data['date_from'],
-                'date_to' => $data['date_to'],
-            ],
-            [
-                'ai_provider' => $data['ai_provider'],
-                'ai_model' => $data['ai_model'] ?? null,
-                'overview' => $data['overview'] ?? null,
-                'key_topics' => $data['key_topics'] ?? null,
-                'emerging_trends' => $data['emerging_trends'] ?? null,
-                'journal_insights' => $data['journal_insights'] ?? null,
-                'recommendations' => $data['recommendations'] ?? null,
-                'paper_count' => $data['paper_count'] ?? 0,
-            ]
-        );
+        return self::create([
+            'user_id' => $data['user_id'] ?? null,
+            'period' => $data['period'],
+            'date_from' => $data['date_from'],
+            'date_to' => $data['date_to'],
+            'ai_provider' => $data['ai_provider'],
+            'ai_model' => $data['ai_model'] ?? null,
+            'overview' => $data['overview'] ?? null,
+            'key_topics' => $data['key_topics'] ?? null,
+            'emerging_trends' => $data['emerging_trends'] ?? null,
+            'journal_insights' => $data['journal_insights'] ?? null,
+            'recommendations' => $data['recommendations'] ?? null,
+            'paper_count' => $data['paper_count'] ?? 0,
+            'tag_ids' => $data['tag_ids'] ?? null,
+        ]);
     }
 
     /**
@@ -80,11 +133,20 @@ public static function createOrUpdateSummary(array $data)
     public function toApiResponse(): array
     {
         return [
+            'id' => $this->id,
             'overview' => $this->overview,
             'keyTopics' => $this->key_topics ?? [],
             'emergingTrends' => $this->emerging_trends ?? [],
             'journalInsights' => $this->journal_insights ?? [],
             'recommendations' => $this->recommendations ?? [],
+            'period' => $this->period,
+            'dateFrom' => $this->date_from?->format('Y-m-d'),
+            'dateTo' => $this->date_to?->format('Y-m-d'),
+            'paperCount' => $this->paper_count,
+            'tagIds' => $this->tag_ids ?? [],
+            'provider' => $this->ai_provider,
+            'model' => $this->ai_model,
+            'createdAt' => $this->created_at?->toISOString(),
         ];
     }
 }