Merge pull request #99 from parker-server/insights-phase3

Adds the third Parker insights experience

Author: breenyoung

app/api/insights.py

@@ -290,3 +290,84 @@ async def get_character_collaborations(
         "limit": limit,
         **_serialize_visible_matrix(pairs, limit),
     }
+
+
+@router.get("/creator-character-collaborations", name="creator_character_collaborations")
+async def get_creator_character_collaborations(
+    db: SessionDep,
+    current_user: CurrentUser,
+    role_a: CreatorRole = Query("writer"),
+    library_id: Optional[int] = Query(None, ge=1),
+    min_shared: int = Query(2, ge=1, le=100),
+    limit: int = Query(12, ge=2, le=15, description="Maximum creators and characters shown per axis"),
+):
+    """
+    Aggregates creator-to-character pairings for heatmap-style insights.
+    """
+    if library_id is not None:
+        _ensure_library_access(library_id, current_user)
+
+    credit_a = aliased(ComicCredit)
+    person_a = aliased(Person)
+    char_link_b = comic_characters.alias("char_link_b")
+    character_b = aliased(Character)
+
+    shared_issue_count = func.count(func.distinct(Comic.id))
+    shared_series_count = func.count(func.distinct(Series.id))
+
+    query = (
+        db.query(
+            person_a.id.label("person_a_id"),
+            person_a.name.label("person_a"),
+            character_b.id.label("person_b_id"),
+            character_b.name.label("person_b"),
+            shared_issue_count.label("shared_issues"),
+            shared_series_count.label("shared_series"),
+            func.min(Series.name).label("sample_series"),
+        )
+        .select_from(Comic)
+        .join(Volume, Comic.volume_id == Volume.id)
+        .join(Series, Volume.series_id == Series.id)
+        .join(credit_a, credit_a.comic_id == Comic.id)
+        .join(person_a, person_a.id == credit_a.person_id)
+        .join(char_link_b, char_link_b.c.comic_id == Comic.id)
+        .join(character_b, character_b.id == char_link_b.c.character_id)
+        .filter(credit_a.role == role_a)
+    )
+
+    if not current_user.is_superuser:
+        allowed_ids = [lib.id for lib in current_user.accessible_libraries]
+        query = query.filter(Series.library_id.in_(allowed_ids))
+
+    if library_id is not None:
+        query = query.filter(Series.library_id == library_id)
+
+    age_filter = get_series_age_restriction(current_user)
+    if age_filter is not None:
+        query = query.filter(age_filter)
+
+    pair_cap = max(limit * limit * 2, 50)
+
+    pairs = (
+        query.group_by(person_a.id, person_a.name, character_b.id, character_b.name)
+        .having(shared_issue_count >= min_shared)
+        .order_by(desc("shared_issues"), person_a.name.asc(), character_b.name.asc())
+        .limit(pair_cap)
+        .all()
+    )
+
+    if not pairs:
+        return _empty_matrix_payload(
+            role_a=role_a,
+            library_id=library_id,
+            min_shared=min_shared,
+            limit=limit,
+        )
+
+    return {
+        "role_a": role_a,
+        "library_id": library_id,
+        "min_shared": min_shared,
+        "limit": limit,
+        **_serialize_visible_matrix(pairs, limit),
+    }

app/routers/pages.py

@@ -48,6 +48,12 @@ async def insights_character_chemistry(request: Request, user: CurrentUser):
     """Character co-appearance insights page"""
     return templates.TemplateResponse(request=request, name="insights_character.html")
 
+
+@router.get("/insights/writer-character", response_class=HTMLResponse, name="insights_writer_character")
+async def insights_writer_character(request: Request, user: CurrentUser):
+    """Writer to character insights page"""
+    return templates.TemplateResponse(request=request, name="insights_writer_character.html")
+
 @router.get("/collections", response_class=HTMLResponse, name="collections")
 async def collections_view(request: Request, user: CurrentUser):
     """Collections page"""

app/templates/insights.html

@@ -14,56 +14,40 @@ <h1 class="mt-3 text-4xl md:text-5xl font-black text-white tracking-tight">Metad
         </div>
     </section>
 
-    <section class="grid grid-cols-1 xl:grid-cols-2 gap-6">
+    <section class="grid grid-cols-1 xl:grid-cols-3 gap-6">
         <a href="{{ url('/insights/creator-chemistry') }}" class="group rounded-3xl border border-gray-700 bg-gray-800/80 hover:border-blue-500/60 hover:bg-gray-800 px-6 py-6 shadow-xl transition-all">
-            <div class="flex items-start justify-between gap-4">
-                <div>
-                    <div class="text-[10px] uppercase tracking-[0.25em] text-blue-300">Phase 1</div>
-                    <h2 class="mt-3 text-2xl font-black text-white">Creator Chemistry</h2>
-                    <p class="mt-3 text-sm leading-6 text-gray-400">
-                        See which writers, pencillers, inkers, colorists, and editors show up together most often across your library.
-                    </p>
-                </div>
-                <div class="rounded-full border border-blue-500/30 bg-blue-500/10 px-3 py-1 text-xs font-bold uppercase tracking-wider text-blue-200">
-                    Live
-                </div>
-            </div>
-
-            <div class="mt-6 grid grid-cols-1 md:grid-cols-3 gap-3 text-xs text-gray-400">
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Creator role pair filters</div>
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Matrix drill-down to Search</div>
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Visible collaboration totals</div>
-            </div>
+            <h2 class="text-2xl font-black text-white">Creator Chemistry</h2>
+            <p class="mt-3 text-sm leading-6 text-gray-400">
+                See which writers, pencillers, inkers, colorists, and editors show up together most often across your library.
+            </p>
 
             <div class="mt-6 inline-flex items-center gap-2 text-sm font-bold text-blue-300 group-hover:text-blue-200">
                 Open Creator Chemistry
-                <span aria-hidden="true">→</span>
+                <span aria-hidden="true">&rarr;</span>
             </div>
         </a>
 
         <a href="{{ url('/insights/character-chemistry') }}" class="group rounded-3xl border border-gray-700 bg-gray-800/80 hover:border-emerald-500/60 hover:bg-gray-800 px-6 py-6 shadow-xl transition-all">
-            <div class="flex items-start justify-between gap-4">
-                <div>
-                    <div class="text-[10px] uppercase tracking-[0.25em] text-emerald-300">Phase 2</div>
-                    <h2 class="mt-3 text-2xl font-black text-white">Character Chemistry</h2>
-                    <p class="mt-3 text-sm leading-6 text-gray-400">
-                        Explore which characters co-appear most often, surface recurring team-ups, and jump into the matching issues in one click.
-                    </p>
-                </div>
-                <div class="rounded-full border border-emerald-500/30 bg-emerald-500/10 px-3 py-1 text-xs font-bold uppercase tracking-wider text-emerald-200">
-                    New
-                </div>
-            </div>
-
-            <div class="mt-6 grid grid-cols-1 md:grid-cols-3 gap-3 text-xs text-gray-400">
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Character co-appearance matrix</div>
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Top team-up sidebar</div>
-                <div class="rounded-xl border border-gray-700 bg-gray-900/50 px-4 py-3">Search handoff with dual character rules</div>
-            </div>
+            <h2 class="text-2xl font-black text-white">Character Chemistry</h2>
+            <p class="mt-3 text-sm leading-6 text-gray-400">
+                Explore which characters co-appear most often, surface recurring team-ups, and jump into the matching issues in one click.
+            </p>
 
             <div class="mt-6 inline-flex items-center gap-2 text-sm font-bold text-emerald-300 group-hover:text-emerald-200">
                 Open Character Chemistry
-                <span aria-hidden="true">→</span>
+                <span aria-hidden="true">&rarr;</span>
+            </div>
+        </a>
+
+        <a href="{{ url('/insights/writer-character') }}" class="group rounded-3xl border border-gray-700 bg-gray-800/80 hover:border-amber-500/60 hover:bg-gray-800 px-6 py-6 shadow-xl transition-all">
+            <h2 class="text-2xl font-black text-white">Writer to Character</h2>
+            <p class="mt-3 text-sm leading-6 text-gray-400">
+                See which writers are most closely associated with which characters, then jump straight into the matching books.
+            </p>
+
+            <div class="mt-6 inline-flex items-center gap-2 text-sm font-bold text-amber-300 group-hover:text-amber-200">
+                Open Writer to Character
+                <span aria-hidden="true">&rarr;</span>
             </div>
         </a>
     </section>

app/templates/insights_character.html

@@ -22,6 +22,9 @@ <h1 class="mt-3 text-4xl font-black text-white tracking-tight">Character Chemist
                 <span class="px-3 py-1.5 rounded-full border border-emerald-500/40 bg-emerald-500/10 text-xs font-bold uppercase tracking-wider text-emerald-200">
                     Character Chemistry
                 </span>
+                <a href="{{ url('/insights/writer-character') }}" class="px-3 py-1.5 rounded-full border border-gray-700 text-xs font-bold uppercase tracking-wider text-gray-300 hover:text-white hover:border-amber-500/50 transition-colors">
+                    Writer to Character
+                </a>
             </div>
         </div>
 

app/templates/insights_creator.html

@@ -22,6 +22,9 @@ <h1 class="mt-3 text-4xl font-black text-white tracking-tight">Creator Chemistry
                 <a href="{{ url('/insights/character-chemistry') }}" class="px-3 py-1.5 rounded-full border border-gray-700 text-xs font-bold uppercase tracking-wider text-gray-300 hover:text-white hover:border-emerald-500/50 transition-colors">
                     Character Chemistry
                 </a>
+                <a href="{{ url('/insights/writer-character') }}" class="px-3 py-1.5 rounded-full border border-gray-700 text-xs font-bold uppercase tracking-wider text-gray-300 hover:text-white hover:border-amber-500/50 transition-colors">
+                    Writer to Character
+                </a>
             </div>
         </div>