Compare legislators
+Up to 4 legislators · up to 8 issue axes · each polygon = one legislator's full issue profile
+diff --git a/pipelines/web/__init__.py b/pipelines/web/__init__.py new file mode 100644 index 0000000..3e59862 --- /dev/null +++ b/pipelines/web/__init__.py @@ -0,0 +1 @@ +"""FastAPI HTMX front end for the legislative database.""" diff --git a/pipelines/web/db.py b/pipelines/web/db.py new file mode 100644 index 0000000..4687d03 --- /dev/null +++ b/pipelines/web/db.py @@ -0,0 +1,31 @@ +"""Database access for the FastAPI web app.""" + +from __future__ import annotations + +from collections.abc import Iterator +from contextlib import contextmanager +from functools import lru_cache + +from sqlalchemy.engine import Engine +from sqlalchemy.orm import Session + +from pipelines.orm.common import get_postgres_engine + + +@lru_cache(maxsize=1) +def get_engine() -> Engine: + """Return the lazily-created DATA_SCIENCE_DEV SQLAlchemy engine.""" + return get_postgres_engine(name="DATA_SCIENCE_DEV") + + +def validate_database_connection() -> None: + """Fail fast if the configured DATA_SCIENCE_DEV database is unavailable.""" + with get_engine().connect(): + pass + + +@contextmanager +def session_scope() -> Iterator[Session]: + """Yield a SQLAlchemy session for a read-only request.""" + with Session(get_engine()) as session: + yield session diff --git a/pipelines/web/main.py b/pipelines/web/main.py new file mode 100644 index 0000000..1944a54 --- /dev/null +++ b/pipelines/web/main.py @@ -0,0 +1,589 @@ +"""FastAPI app for the HTMX legislative dashboard.""" + +from __future__ import annotations + +from contextlib import asynccontextmanager +from dataclasses import dataclass +import hashlib +import hmac +from os import getenv +from pathlib import Path +import secrets +from typing import Any +from urllib.parse import parse_qs + +from fastapi import Depends, FastAPI, HTTPException, Request, Response, status +from fastapi.responses import HTMLResponse, PlainTextResponse, RedirectResponse +from fastapi.staticfiles import StaticFiles +from fastapi.templating import Jinja2Templates + +from pipelines.web import repository +from pipelines.web.db import session_scope, validate_database_connection +from pipelines.web.repository import Chamber, RankingResult +from pipelines.web.scoring import normalize_issues +from pipelines.web.svg import render_compare_radar_svg, render_score_history_svg + +BASE_DIR = Path(__file__).resolve().parent +TEMPLATES_DIR = BASE_DIR / "templates" +STATIC_DIR = BASE_DIR / "static" + +templates = Jinja2Templates(directory=TEMPLATES_DIR) +ADMIN_USERNAME = "admin" +ADMIN_PASSWORD = "admin" +SESSION_COOKIE = "nornsight_admin" +SESSION_SECRET = "nornsight-local-dev-session-secret" + + +@asynccontextmanager +async def lifespan(_: FastAPI): + """Validate database access when the CLI starts the web server.""" + if getenv("PYTEST_CURRENT_TEST") is None: + validate_database_connection() + yield + + +app = FastAPI(title="Nornsight Legislative Dashboard", lifespan=lifespan) +app.mount("/static", StaticFiles(directory=STATIC_DIR), name="static") + + +@dataclass(frozen=True) +class DashboardState: + """Dashboard query-string state.""" + + issues: list[str] + chamber: Chamber + congress: int | None + compare: list[int] + + +@app.get("/healthz", response_class=PlainTextResponse) +def healthz() -> str: + """Return a simple liveness response.""" + return "ok" + + +@app.get("/login", response_class=HTMLResponse) +def login(request: Request) -> Response: + """Render the integrated login page.""" + next_path = _safe_next_path(request.query_params.get("next")) + if _authenticated_user(request) is not None: + return RedirectResponse(next_path, status_code=status.HTTP_303_SEE_OTHER) + return templates.TemplateResponse( + request, + "login.html", + { + "error": "", + "is_authenticated": False, + "show_primary_nav": False, + "next_path": next_path, + "username": "", + }, + ) + + +@app.post("/login", response_class=HTMLResponse) +async def login_submit(request: Request) -> Response: + """Authenticate the hard-coded admin user and set a session cookie.""" + form = parse_qs((await request.body()).decode()) + username = form.get("username", [""])[0] + password = form.get("password", [""])[0] + next_path = _safe_next_path(form.get("next", [request.query_params.get("next")])[0]) + + username_ok = secrets.compare_digest(username, ADMIN_USERNAME) + password_ok = secrets.compare_digest(password, ADMIN_PASSWORD) + if not (username_ok and password_ok): + return templates.TemplateResponse( + request, + "login.html", + { + "error": "Invalid username or password.", + "is_authenticated": False, + "show_primary_nav": False, + "next_path": next_path, + "username": username, + }, + status_code=status.HTTP_401_UNAUTHORIZED, + ) + + response = RedirectResponse(next_path, status_code=status.HTTP_303_SEE_OTHER) + response.set_cookie( + SESSION_COOKIE, + _sign_session(username), + httponly=True, + samesite="lax", + ) + return response + + +@app.get("/logout") +def logout() -> Response: + """Clear the local admin session.""" + response = RedirectResponse("/login", status_code=status.HTTP_303_SEE_OTHER) + response.delete_cookie(SESSION_COOKIE) + return response + + +def require_admin(request: Request) -> str: + """Redirect unauthenticated users to the in-site login page.""" + username = _authenticated_user(request) + if username is not None: + return username + next_path = request.url.path + if request.url.query: + next_path = f"{next_path}?{request.url.query}" + login_url = request.url_for("login").include_query_params(next=next_path) + raise HTTPException( + status_code=status.HTTP_303_SEE_OTHER, + headers={"Location": str(login_url)}, + ) + + +def _authenticated_user(request: Request) -> str | None: + token = request.cookies.get(SESSION_COOKIE) + if token is None: + return None + try: + username, signature = token.split(":", 1) + except ValueError: + return None + if username != ADMIN_USERNAME: + return None + expected = _session_signature(username) + if secrets.compare_digest(signature, expected): + return username + return None + + +def _sign_session(username: str) -> str: + return f"{username}:{_session_signature(username)}" + + +def _session_signature(username: str) -> str: + return hmac.new( + SESSION_SECRET.encode(), + username.encode(), + hashlib.sha256, + ).hexdigest() + + +def _safe_next_path(value: str | None) -> str: + if value and value.startswith("/") and not value.startswith("//"): + return value + return "/" + + +@app.get("/", response_class=HTMLResponse) +def dashboard(request: Request, _: str = Depends(require_admin)) -> Response: + """Render the full dashboard page.""" + context = _dashboard_context(request) + if request.headers.get("hx-request") == "true": + return templates.TemplateResponse(request, "partials/_dashboard.html", context) + return templates.TemplateResponse(request, "dashboard.html", context) + + +@app.get("/partials/dashboard", response_class=HTMLResponse) +def dashboard_partial(request: Request, _: str = Depends(require_admin)) -> Response: + """Render the filter-dependent dashboard body.""" + context = _dashboard_context(request) + return templates.TemplateResponse(request, "partials/_dashboard.html", context) + + +@app.get("/partials/issues", response_class=HTMLResponse) +def issues_partial(request: Request, _: str = Depends(require_admin)) -> Response: + """Render only issue filters.""" + context = _dashboard_context(request) + return templates.TemplateResponse(request, "partials/_issue_filters.html", context) + + +@app.get("/partials/rankings", response_class=HTMLResponse) +def rankings_partial(request: Request, _: str = Depends(require_admin)) -> Response: + """Render only ranking panels.""" + context = _dashboard_context(request) + return templates.TemplateResponse(request, "partials/_rankings.html", context) + + +@app.get("/partials/chart", response_class=HTMLResponse) +def chart_partial(request: Request, _: str = Depends(require_admin)) -> Response: + """Render only the SVG chart panel.""" + context = _dashboard_context(request) + return templates.TemplateResponse(request, "partials/_chart.html", context) + + +@app.get("/legislators", response_class=HTMLResponse) +def legislators(request: Request, _: str = Depends(require_admin)) -> Response: + """Render the legislator profile/search page.""" + context = _legislators_context(request) + return templates.TemplateResponse(request, "legislators.html", context) + + +@app.get("/partials/legislator-suggestions", response_class=HTMLResponse) +def legislator_suggestions_partial( + request: Request, _: str = Depends(require_admin) +) -> Response: + """Render legislator search suggestions for the HTMX typeahead.""" + query = request.query_params.get("q", "").strip() + context: dict[str, Any] = { + "q": query if len(query) >= 2 else "", + "matches": [], + "build_legislator_url": _build_legislator_url, + } + if len(query) >= 2: + with session_scope() as session: + context["matches"] = repository.search_legislators( + session, query=query, limit=8 + ) + return templates.TemplateResponse( + request, "partials/_legislator_suggestions.html", context + ) + + +@app.get("/compare", response_class=HTMLResponse) +def compare(request: Request, _: str = Depends(require_admin)) -> Response: + """Render the legislator radar comparison page.""" + context = _compare_context(request) + return templates.TemplateResponse(request, "compare.html", context) + + +def _dashboard_context(request: Request) -> dict[str, Any]: + state = _parse_state(request) + base_context: dict[str, Any] = { + "state": state, + "issues": state.issues, + "selected_issue_label": " + ".join(state.issues) if state.issues else "", + "chamber": state.chamber, + "congress": state.congress, + "latest_score_year": None, + "last_updated": None, + "suggestions": [], + "rankings": RankingResult(supportive=[], opposed=[]), + "compare": [], + "chart_svg": render_score_history_svg([]), + "chart_series": [], + "has_votes": False, + "has_scores": False, + "empty_message": "", + "build_url": _build_url, + "toggle_compare": _toggle_compare, + } + with session_scope() as session: + congress = state.congress or repository.latest_congress(session) + base_context["congress"] = congress + base_context["has_scores"] = repository.has_scores(session) + base_context["latest_score_year"] = repository.latest_score_year(session) + base_context["last_updated"] = repository.latest_vote_date(session, congress) + base_context["suggestions"] = repository.issue_suggestions( + session, congress=congress + ) + + if not base_context["has_scores"]: + base_context["empty_message"] = ( + "No legislator scores are loaded yet. Run the score calculator first." + ) + return base_context + + if congress is None: + base_context["congress"] = "Computed" + + if not state.issues: + base_context["empty_message"] = ( + "Choose one or more issue areas to calculate roll-call support scores." + ) + return base_context + + rankings = repository.get_rankings( + session, + issues=state.issues, + chamber=state.chamber, + congress=congress, + ) + base_context["rankings"] = rankings + compare = state.compare or [row.legislator_id for row in rankings.supportive[:2]] + base_context["compare"] = compare + if not rankings.supportive and not rankings.opposed: + base_context["empty_message"] = "No matching roll-call votes." + return base_context + + history = repository.get_score_history( + session, + issues=state.issues, + chamber=state.chamber, + congress=congress, + legislator_ids=compare, + ) + base_context["chart_series"] = history + base_context["chart_svg"] = render_score_history_svg(history) + return base_context + + +def _parse_state(request: Request) -> DashboardState: + query = request.query_params + chamber = query.get("chamber", "senate").lower() + if chamber not in {"house", "senate", "all"}: + chamber = "senate" + congress = _parse_int(query.get("congress")) + compare = [ + value + for value in (_parse_int(raw) for raw in query.getlist("compare")) + if value is not None + ] + return DashboardState( + issues=normalize_issues(query.getlist("issues")), + chamber=chamber, # type: ignore[arg-type] + congress=congress, + compare=compare, + ) + + +def _legislators_context(request: Request) -> dict[str, Any]: + query = request.query_params.get("q", "").strip() + legislator_id = _parse_int(request.query_params.get("legislator_id")) + selected_topic = request.query_params.get("topic", "").strip() + per_page = _parse_per_page(request.query_params.get("per_page")) + page = max(_parse_int(request.query_params.get("page")) or 1, 1) + base_context: dict[str, Any] = { + "q": query, + "profile": None, + "matches": [], + "result_count": 0, + "page": page, + "per_page": per_page, + "per_page_options": [10, 25, 50], + "total_pages": 1, + "previous_page": None, + "next_page": None, + "selected_topic": selected_topic, + "history_svg": render_score_history_svg([]), + "history_series": [], + "build_legislator_url": _build_legislator_url, + "build_legislator_search_url": _build_legislator_search_url, + } + with session_scope() as session: + result_count = repository.count_legislators(session, query=query) if query else 0 + total_pages = max((result_count + per_page - 1) // per_page, 1) + if page > total_pages: + page = total_pages + base_context["page"] = page + matches = ( + repository.search_legislators( + session, + query=query, + limit=per_page, + offset=(page - 1) * per_page, + ) + if query + else [] + ) + profile = repository.get_legislator_profile( + session, legislator_id=legislator_id, query=None + ) + base_context["profile"] = profile + base_context["matches"] = matches + base_context["result_count"] = result_count + base_context["total_pages"] = total_pages + base_context["previous_page"] = page - 1 if page > 1 else None + base_context["next_page"] = page + 1 if page < total_pages else None + if profile is None: + return base_context + if not selected_topic: + if profile.bottom_topics: + selected_topic = profile.bottom_topics[0].topic + elif profile.top_topics: + selected_topic = profile.top_topics[0].topic + base_context["selected_topic"] = selected_topic + if selected_topic: + history = repository.get_single_legislator_history( + session, + legislator_id=profile.legislator.legislator_id, + topic=selected_topic, + ) + base_context["history_series"] = history + base_context["history_svg"] = render_score_history_svg(history) + return base_context + + +def _compare_context(request: Request) -> dict[str, Any]: + selected_legislators = _parse_int_list( + request.query_params.getlist("legislator_id") + or request.query_params.getlist("compare") + )[:4] + topics = normalize_issues( + request.query_params.getlist("topic") or request.query_params.getlist("issues") + )[:8] + query = request.query_params.get("q", "").strip() + base_context: dict[str, Any] = { + "selected_legislators": selected_legislators, + "selected_legislator_options": [], + "topics": topics, + "q": query, + "series": [], + "radar_svg": render_compare_radar_svg([], []), + "legislator_options": [], + "topic_options": [], + "build_compare_url": _build_compare_url, + } + with session_scope() as session: + default_legislators, default_topics = repository.get_compare_defaults(session) + if not selected_legislators and not query: + selected_legislators = default_legislators[:3] + if not topics: + topics = default_topics[:6] + selected_legislator_options = repository.get_legislator_options( + session, selected_legislators + ) + series = repository.get_compare_radar_series( + session, legislator_ids=selected_legislators, topics=topics + ) + base_context.update( + { + "selected_legislators": selected_legislators, + "selected_legislator_options": selected_legislator_options, + "topics": topics, + "q": query, + "series": series, + "radar_svg": render_compare_radar_svg(topics, series), + "legislator_options": repository.search_legislators( + session, query=query or None, limit=12 + ), + "topic_options": repository.issue_suggestions( + session, congress=None, limit=12 + ), + } + ) + return base_context + + +def _parse_int(value: str | None) -> int | None: + if value is None or value == "": + return None + try: + return int(value) + except ValueError: + return None + + +def _parse_int_list(values: list[str]) -> list[int]: + parsed: list[int] = [] + seen: set[int] = set() + for value in values: + integer = _parse_int(value) + if integer is not None and integer not in seen: + parsed.append(integer) + seen.add(integer) + return parsed + + +def _parse_per_page(value: str | None) -> int: + parsed = _parse_int(value) + return parsed if parsed in {10, 25, 50} else 10 + + +def _build_url( + request: Request, + *, + issues: list[str] | None = None, + chamber: str | None = None, + congress: int | None = None, + compare: list[int] | None = None, +) -> str: + params: list[tuple[str, str]] = [] + chosen_issues = ( + issues + if issues is not None + else normalize_issues(request.query_params.getlist("issues")) + ) + chosen_chamber = ( + chamber + if chamber is not None + else request.query_params.get("chamber", "senate") + ) + chosen_congress = ( + congress + if congress is not None + else _parse_int(request.query_params.get("congress")) + ) + chosen_compare = ( + compare + if compare is not None + else [ + value + for value in ( + _parse_int(raw) for raw in request.query_params.getlist("compare") + ) + if value is not None + ] + ) + for issue in chosen_issues: + params.append(("issues", issue)) + params.append(("chamber", chosen_chamber)) + if chosen_congress is not None: + params.append(("congress", str(chosen_congress))) + for legislator_id in chosen_compare: + params.append(("compare", str(legislator_id))) + if not params: + return "/" + from urllib.parse import urlencode + + return f"/?{urlencode(params, doseq=True)}" + + +def _toggle_compare(compare: list[int], legislator_id: int) -> list[int]: + """Return compare IDs with the legislator added or removed.""" + if legislator_id in compare: + return [value for value in compare if value != legislator_id] + return [*compare, legislator_id] + + +def _build_legislator_url( + *, + legislator_id: int | None = None, + q: str | None = None, + topic: str | None = None, + per_page: int | None = None, +) -> str: + from urllib.parse import urlencode + + params: list[tuple[str, str]] = [] + if legislator_id is not None: + params.append(("legislator_id", str(legislator_id))) + if q: + params.append(("q", q)) + if topic: + params.append(("topic", topic)) + if per_page in {10, 25, 50} and per_page != 10: + params.append(("per_page", str(per_page))) + return f"/legislators?{urlencode(params)}" if params else "/legislators" + + +def _build_legislator_search_url( + *, + q: str, + per_page: int, + page: int = 1, +) -> str: + from urllib.parse import urlencode + + params: list[tuple[str, str]] = [] + if q: + params.append(("q", q)) + params.append(("per_page", str(per_page))) + if page > 1: + params.append(("page", str(page))) + return f"/legislators?{urlencode(params)}" if params else "/legislators" + + +def _build_compare_url( + *, + legislator_ids: list[int], + topics: list[str], + q: str | None = None, +) -> str: + from urllib.parse import urlencode + + params: list[tuple[str, str]] = [] + for legislator_id in legislator_ids[:4]: + params.append(("legislator_id", str(legislator_id))) + for topic in topics[:8]: + params.append(("topic", topic)) + if q: + params.append(("q", q)) + return f"/compare?{urlencode(params, doseq=True)}" if params else "/compare" diff --git a/pipelines/web/repository.py b/pipelines/web/repository.py new file mode 100644 index 0000000..919f2b6 --- /dev/null +++ b/pipelines/web/repository.py @@ -0,0 +1,670 @@ +"""Congress database queries for the web dashboard.""" + +from __future__ import annotations + +from dataclasses import dataclass +from datetime import date +from typing import Literal + +from sqlalchemy import ColumnElement, Select, case, desc, false, func, or_, select, true +from sqlalchemy.orm import Session + +from pipelines.orm.data_science_dev.congress import ( + BillTopic, + Legislator, + LegislatorScore, + Vote, +) +from pipelines.web.scoring import normalize_issues + +Chamber = Literal["house", "senate", "all"] + +STATE_ALIASES = { + "alabama": "AL", + "alaska": "AK", + "arizona": "AZ", + "arkansas": "AR", + "california": "CA", + "colorado": "CO", + "connecticut": "CT", + "delaware": "DE", + "florida": "FL", + "georgia": "GA", + "hawaii": "HI", + "idaho": "ID", + "illinois": "IL", + "indiana": "IN", + "iowa": "IA", + "kansas": "KS", + "kentucky": "KY", + "louisiana": "LA", + "maine": "ME", + "maryland": "MD", + "massachusetts": "MA", + "michigan": "MI", + "minnesota": "MN", + "mississippi": "MS", + "missouri": "MO", + "montana": "MT", + "nebraska": "NE", + "nevada": "NV", + "new hampshire": "NH", + "new jersey": "NJ", + "new mexico": "NM", + "new york": "NY", + "north carolina": "NC", + "north dakota": "ND", + "ohio": "OH", + "oklahoma": "OK", + "oregon": "OR", + "pennsylvania": "PA", + "rhode island": "RI", + "south carolina": "SC", + "south dakota": "SD", + "tennessee": "TN", + "texas": "TX", + "utah": "UT", + "vermont": "VT", + "virginia": "VA", + "washington": "WA", + "west virginia": "WV", + "wisconsin": "WI", + "wyoming": "WY", + "district of columbia": "DC", +} + + +@dataclass(frozen=True) +class RankingRow: + """A legislator support score row.""" + + legislator_id: int + display_name: str + party: str | None + state: str | None + chamber: str | None + score: float | None + supportive: int + opposed: int + + @property + def total(self) -> int: + return self.supportive + self.opposed + + +@dataclass(frozen=True) +class RankingResult: + """Supportive and opposed ranking lists.""" + + supportive: list[RankingRow] + opposed: list[RankingRow] + + +@dataclass(frozen=True) +class TimePoint: + """One yearly chart point.""" + + year: int + score: float + + +@dataclass(frozen=True) +class ChartSeries: + """One legislator score-history series.""" + + legislator_id: int + label: str + party: str | None + state: str | None + points: list[TimePoint] + + +@dataclass(frozen=True) +class TopicScore: + """Average score for one topic.""" + + topic: str + score: float + count: int + + +@dataclass(frozen=True) +class LegislatorOption: + """Compact legislator metadata for search and comparison controls.""" + + legislator_id: int + display_name: str + party: str | None + state: str | None + chamber: str | None + + +@dataclass(frozen=True) +class LegislatorProfile: + """Legislator metadata plus issue score summary.""" + + legislator: LegislatorOption + overall_score: float | None + serving_since: int | None + top_topics: list[TopicScore] + bottom_topics: list[TopicScore] + + +@dataclass(frozen=True) +class RadarSeries: + """One legislator polygon for the compare radar chart.""" + + legislator: LegislatorOption + average_score: float | None + scores_by_topic: dict[str, float] + + +def latest_congress(session: Session) -> int | None: + """Return the latest congress number in the vote table.""" + return session.scalar(select(func.max(Vote.congress))) + + +def latest_vote_date(session: Session, congress: int | None = None) -> date | None: + """Return the most recent vote date, optionally scoped to a congress.""" + stmt = select(func.max(Vote.vote_date)) + if congress is not None: + stmt = stmt.where(Vote.congress == congress) + return session.scalar(stmt) + + +def latest_score_year(session: Session) -> int | None: + """Return the latest year in the precomputed legislator score table.""" + return session.scalar(select(func.max(LegislatorScore.year))) + + +def has_scores(session: Session) -> bool: + """Return True when the database has at least one precomputed score.""" + return session.scalar(select(LegislatorScore.id).limit(1)) is not None + + +def issue_suggestions( + session: Session, + *, + congress: int | None, + limit: int = 12, +) -> list[str]: + """Return common precomputed score topics for issue filter suggestions.""" + stmt = ( + select(LegislatorScore.topic, func.count(LegislatorScore.id).label("score_count")) + .where(LegislatorScore.topic != "") + .group_by(LegislatorScore.topic) + .order_by(desc("score_count"), LegislatorScore.topic) + .limit(limit) + ) + suggestions = [row[0] for row in session.execute(stmt).all()] + if suggestions: + return suggestions + + fallback = ( + select(BillTopic.topic, func.count(BillTopic.id).label("topic_count")) + .where(BillTopic.topic != "") + .group_by(BillTopic.topic) + .order_by(desc("topic_count"), BillTopic.topic) + .limit(limit) + ) + return [row[0] for row in session.execute(fallback).all()] + + +def ranking_query( + *, + issues: list[str], + chamber: Chamber, + congress: int, +) -> Select: + """Build the aggregate ranking query from precomputed scores.""" + average_score = func.avg(LegislatorScore.score).label("score") + supportive = func.sum(case((LegislatorScore.score >= 50, 1), else_=0)).label( + "supportive" + ) + opposed = func.sum(case((LegislatorScore.score < 50, 1), else_=0)).label("opposed") + + stmt = ( + select( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + Legislator.current_chamber, + average_score, + supportive, + opposed, + ) + .join(LegislatorScore, LegislatorScore.legislator_id == Legislator.id) + .where(_score_topic_match_condition(issues)) + .group_by( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + Legislator.current_chamber, + ) + ) + if chamber != "all": + stmt = stmt.where(Legislator.current_chamber == _db_chamber(chamber)) + return stmt + + +def get_rankings( + session: Session, + *, + issues: list[str], + chamber: Chamber, + congress: int, + limit: int = 10, +) -> RankingResult: + """Return top supportive and opposed legislators from precomputed scores.""" + rows = [ + _ranking_row(row) + for row in session.execute( + ranking_query(issues=issues, chamber=chamber, congress=congress) + ) + ] + scored = [row for row in rows if row.score is not None] + supportive = sorted( + scored, key=lambda row: (-float(row.score), -row.total, row.display_name) + )[:limit] + opposed = sorted( + scored, key=lambda row: (float(row.score), -row.total, row.display_name) + )[:limit] + return RankingResult(supportive=supportive, opposed=opposed) + + +def get_score_history( + session: Session, + *, + issues: list[str], + chamber: Chamber, + congress: int, + legislator_ids: list[int], +) -> list[ChartSeries]: + """Return yearly score history from precomputed scores.""" + if not legislator_ids: + return [] + + average_score = func.avg(LegislatorScore.score).label("score") + stmt = ( + select( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + LegislatorScore.year, + average_score, + ) + .join(LegislatorScore, LegislatorScore.legislator_id == Legislator.id) + .where( + Legislator.id.in_(legislator_ids), + _score_topic_match_condition(issues), + ) + .group_by( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + LegislatorScore.year, + ) + .order_by(Legislator.id, LegislatorScore.year) + ) + if chamber != "all": + stmt = stmt.where(Legislator.current_chamber == _db_chamber(chamber)) + + by_legislator: dict[int, ChartSeries] = {} + for row in session.execute(stmt): + if row.score is None: + continue + series = by_legislator.setdefault( + row.id, + ChartSeries( + legislator_id=row.id, + label=_display_name(row.official_full_name, row.last_name), + party=row.current_party, + state=row.current_state, + points=[], + ), + ) + series.points.append(TimePoint(year=int(row.year), score=float(row.score))) + return list(by_legislator.values()) + + +def _ranking_row(row: object) -> RankingRow: + return RankingRow( + legislator_id=row.id, + display_name=_display_name(row.official_full_name, row.last_name), + party=row.current_party, + state=row.current_state, + chamber=row.current_chamber, + score=float(row.score) if row.score is not None else None, + supportive=row.supportive or 0, + opposed=row.opposed or 0, + ) + + +def _score_topic_match_condition( + issues: list[str] | tuple[str, ...], +) -> ColumnElement[bool]: + normalized = normalize_issues(list(issues)) + if not normalized: + return false() + return or_(*(LegislatorScore.topic.ilike(f"%{issue}%") for issue in normalized)) + + +def search_legislators( + session: Session, + *, + query: str | None = None, + limit: int = 12, + offset: int = 0, +) -> list[LegislatorOption]: + """Search ingested legislators, preferring those with computed scores.""" + return [ + _legislator_option(row) + for row in session.execute( + legislator_search_query(query=query, limit=limit, offset=offset) + ) + ] + + +def count_legislators(session: Session, *, query: str | None = None) -> int: + """Return the total number of legislators matching a search query.""" + return int( + session.scalar( + select(func.count(Legislator.id)).where(_legislator_search_condition(query)) + ) + or 0 + ) + + +def get_legislator_options( + session: Session, legislator_ids: list[int] +) -> list[LegislatorOption]: + """Return legislator options in the same order as the selected IDs.""" + options = { + option.legislator_id: option + for option in ( + _get_legislator_option(session, legislator_id) + for legislator_id in legislator_ids + ) + if option is not None + } + return [ + options[legislator_id] + for legislator_id in legislator_ids + if legislator_id in options + ] + + +def legislator_search_query( + *, + query: str | None = None, + limit: int = 12, + offset: int = 0, +) -> Select: + """Build the legislator search query used by profile and compare controls.""" + score_count = func.count(LegislatorScore.id).label("score_count") + stmt = ( + select( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + Legislator.current_chamber, + score_count, + ) + .outerjoin(LegislatorScore, LegislatorScore.legislator_id == Legislator.id) + .group_by( + Legislator.id, + Legislator.official_full_name, + Legislator.first_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + Legislator.current_chamber, + Legislator.bioguide_id, + ) + .order_by(desc("score_count"), Legislator.last_name, Legislator.first_name) + .limit(limit) + .offset(offset) + ) + return stmt.where(_legislator_search_condition(query)) + + +def _legislator_search_condition(query: str | None) -> ColumnElement[bool]: + cleaned_query = query.strip() if query else "" + if not cleaned_query: + return true() + + pattern = f"%{cleaned_query}%" + state_alias = _state_alias(cleaned_query) + conditions: list[ColumnElement[bool]] = [ + Legislator.official_full_name.ilike(pattern), + Legislator.first_name.ilike(pattern), + Legislator.last_name.ilike(pattern), + Legislator.current_state.ilike(pattern), + Legislator.bioguide_id.ilike(pattern), + ] + if state_alias is not None: + conditions.append(Legislator.current_state == state_alias) + return or_(*conditions) + + +def _state_alias(query: str) -> str | None: + normalized = " ".join(query.lower().replace(".", "").split()) + if len(normalized) == 2 and normalized.isalpha(): + return normalized.upper() + return STATE_ALIASES.get(normalized) + + +def get_legislator_profile( + session: Session, + *, + legislator_id: int | None = None, + query: str | None = None, +) -> LegislatorProfile | None: + """Return the selected legislator profile and top/bottom topic scores.""" + selected = _get_legislator_option(session, legislator_id) + cleaned_query = query.strip() if query else "" + if selected is None and cleaned_query: + matches = search_legislators(session, query=query, limit=1) + selected = matches[0] if matches else None + if selected is None: + return None + + topic_scores = get_legislator_topic_scores( + session, legislator_id=selected.legislator_id + ) + top_topics = sorted(topic_scores, key=lambda item: (-item.score, item.topic))[:3] + bottom_topics = sorted(topic_scores, key=lambda item: (item.score, item.topic))[:3] + overall_score = session.scalar( + select(func.avg(LegislatorScore.score)).where( + LegislatorScore.legislator_id == selected.legislator_id + ) + ) + serving_since = session.scalar( + select(func.min(LegislatorScore.year)).where( + LegislatorScore.legislator_id == selected.legislator_id + ) + ) + return LegislatorProfile( + legislator=selected, + overall_score=float(overall_score) if overall_score is not None else None, + serving_since=int(serving_since) if serving_since is not None else None, + top_topics=top_topics, + bottom_topics=bottom_topics, + ) + + +def get_legislator_topic_scores( + session: Session, + *, + legislator_id: int, +) -> list[TopicScore]: + """Return all average topic scores for one legislator.""" + rows = session.execute( + select( + LegislatorScore.topic, + func.avg(LegislatorScore.score).label("score"), + func.count(LegislatorScore.id).label("count"), + ) + .where(LegislatorScore.legislator_id == legislator_id) + .group_by(LegislatorScore.topic) + .order_by(LegislatorScore.topic) + ) + return [ + TopicScore(topic=row.topic, score=float(row.score), count=row.count) + for row in rows + if row.score is not None + ] + + +def get_single_legislator_history( + session: Session, + *, + legislator_id: int, + topic: str, +) -> list[ChartSeries]: + """Return score history for one legislator/topic pair.""" + option = _get_legislator_option(session, legislator_id) + if option is None: + return [] + + rows = session.execute( + select( + LegislatorScore.year, + func.avg(LegislatorScore.score).label("score"), + ) + .where( + LegislatorScore.legislator_id == legislator_id, + LegislatorScore.topic == topic, + ) + .group_by(LegislatorScore.year) + .order_by(LegislatorScore.year) + ) + points = [ + TimePoint(year=int(row.year), score=float(row.score)) + for row in rows + if row.score is not None + ] + return [ + ChartSeries( + legislator_id=option.legislator_id, + label=option.display_name, + party=option.party, + state=option.state, + points=points, + ) + ] + + +def get_compare_defaults(session: Session) -> tuple[list[int], list[str]]: + """Return default compare legislators and topics.""" + legislators = search_legislators(session, limit=3) + topics = issue_suggestions(session, congress=None, limit=6) + return [item.legislator_id for item in legislators], topics + + +def get_compare_radar_series( + session: Session, + *, + legislator_ids: list[int], + topics: list[str], +) -> list[RadarSeries]: + """Return radar chart scores for selected legislators and topics.""" + if not legislator_ids: + return [] + + options = { + option.legislator_id: option + for option in ( + _get_legislator_option(session, legislator_id) + for legislator_id in legislator_ids + ) + if option is not None + } + if not options: + return [] + + scores: dict[int, dict[str, float]] = { + legislator_id: {} for legislator_id in options + } + if topics: + rows = session.execute( + select( + LegislatorScore.legislator_id, + LegislatorScore.topic, + func.avg(LegislatorScore.score).label("score"), + ) + .where( + LegislatorScore.legislator_id.in_(list(options)), + LegislatorScore.topic.in_(topics), + ) + .group_by(LegislatorScore.legislator_id, LegislatorScore.topic) + ) + for row in rows: + scores[row.legislator_id][row.topic] = float(row.score) + + series: list[RadarSeries] = [] + for legislator_id in legislator_ids: + option = options.get(legislator_id) + if option is None: + continue + topic_scores = scores.get(legislator_id, {}) + values = list(topic_scores.values()) + series.append( + RadarSeries( + legislator=option, + average_score=sum(values) / len(values) if values else None, + scores_by_topic=topic_scores, + ) + ) + return series + + +def _display_name(official_full_name: str | None, last_name: str | None) -> str: + if official_full_name: + parts = official_full_name.split() + if len(parts) > 1: + return f"{parts[-1]}, {' '.join(parts[:-1])}" + return official_full_name + return last_name or "Unknown" + + +def _legislator_option(row: object) -> LegislatorOption: + return LegislatorOption( + legislator_id=row.id, + display_name=_display_name(row.official_full_name, row.last_name), + party=row.current_party, + state=row.current_state, + chamber=row.current_chamber, + ) + + +def _get_legislator_option( + session: Session, legislator_id: int | None +) -> LegislatorOption | None: + if legislator_id is None: + return None + row = session.execute( + select( + Legislator.id, + Legislator.official_full_name, + Legislator.last_name, + Legislator.current_party, + Legislator.current_state, + Legislator.current_chamber, + ).where(Legislator.id == legislator_id) + ).first() + return _legislator_option(row) if row is not None else None + + +def _db_chamber(chamber: Chamber) -> str: + return {"house": "House", "senate": "Senate", "all": "all"}[chamber] diff --git a/pipelines/web/scoring.py b/pipelines/web/scoring.py new file mode 100644 index 0000000..be615a8 --- /dev/null +++ b/pipelines/web/scoring.py @@ -0,0 +1,100 @@ +"""Issue matching and voting score helpers.""" + +from __future__ import annotations + +from dataclasses import dataclass + +from sqlalchemy import ColumnElement, false, func, or_ +from sqlalchemy.sql.elements import BinaryExpression + +from pipelines.orm.data_science_dev.congress import Bill, BillTopicPosition, Vote + +SUPPORT_POSITIONS = frozenset({"yea", "aye", "yes"}) +OPPOSE_POSITIONS = frozenset({"nay", "no"}) + + +@dataclass(frozen=True) +class ScoreCounts: + """Support/opposition counts for one legislator or time bucket.""" + + supportive: int + opposed: int + + @property + def total(self) -> int: + return self.supportive + self.opposed + + +def normalize_position(position: str | None) -> str | None: + """Normalize a raw roll-call position into support/oppose/ignore buckets.""" + if position is None: + return None + value = position.strip().lower() + if value in SUPPORT_POSITIONS: + return "support" + if value in OPPOSE_POSITIONS: + return "oppose" + return None + + +def score_vote_position( + position: str | None, + support_position: BillTopicPosition | str, +) -> str | None: + """Score a raw vote as support/opposition for an extracted bill topic.""" + normalized_vote = normalize_position(position) + if normalized_vote is None: + return None + + topic_position = BillTopicPosition(support_position) + if topic_position is BillTopicPosition.FOR: + return normalized_vote + if normalized_vote == "support": + return "oppose" + return "support" + + +def calculate_score(counts: ScoreCounts) -> int | None: + """Calculate the 0-100 support score, or None when there are no scored votes.""" + if counts.total == 0: + return None + return round(100 * counts.supportive / counts.total) + + +def normalize_issues(issues: list[str] | tuple[str, ...]) -> list[str]: + """Trim, de-duplicate, and preserve issue order for display and queries.""" + normalized: list[str] = [] + seen: set[str] = set() + for issue in issues: + value = issue.strip() + key = value.casefold() + if value and key not in seen: + normalized.append(value) + seen.add(key) + return normalized + + +def issue_match_condition(issues: list[str] | tuple[str, ...]) -> ColumnElement[bool]: + """Build the SQLAlchemy condition for issue text matching.""" + normalized = normalize_issues(list(issues)) + if not normalized: + return false() + + fields: tuple[ColumnElement[str | None], ...] = ( + Bill.subjects_top_term, + Bill.title, + Bill.title_short, + Bill.official_title, + Vote.question, + Vote.result_text, + ) + terms: list[BinaryExpression[bool]] = [] + for issue in normalized: + pattern = f"%{issue}%" + terms.extend(field.ilike(pattern) for field in fields) + return or_(*terms) + + +def normalized_position_expression(column: ColumnElement[str]) -> ColumnElement[str | None]: + """Lowercase and trim a SQL column containing raw vote positions.""" + return func.lower(func.trim(column)) diff --git a/pipelines/web/static/styles.css b/pipelines/web/static/styles.css new file mode 100644 index 0000000..a41d6f5 --- /dev/null +++ b/pipelines/web/static/styles.css @@ -0,0 +1,1215 @@ +:root { + color-scheme: dark; + --bg: #061614; + --panel: #0a201d; + --panel-2: #0f2824; + --line: #1c4a43; + --line-bright: #2c7b6d; + --text: #e7f0ed; + --muted: #91a39e; + --teal: #2fbd9f; + --teal-dark: #0e5f53; + --amber: #d8892d; + --purple: #8f6ff0; +} + +* { + box-sizing: border-box; +} + +body { + margin: 0; + min-height: 100vh; + background: radial-gradient(circle at 40% -20%, #10352f 0, #061614 38rem); + color: var(--text); + font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; +} + +a { + color: inherit; + text-decoration: none; +} + +.topbar { + align-items: center; + background: #041411; + border-bottom: 1px solid #12362f; + display: flex; + justify-content: space-between; + padding: 0.75rem 1.5rem; +} + +.brand, +.primary-nav, +.account-nav, +.heading-actions, +.controls-grid, +.rankings-grid, +.chart-card header { + display: flex; +} + +.brand { + align-items: center; + font-size: 1.1rem; + font-weight: 760; + gap: 0.75rem; +} + +.brand-mark { + color: var(--teal); + font-size: 1.7rem; + line-height: 1; +} + +.primary-nav { + gap: 0.25rem; + margin-right: auto; + margin-left: 1rem; +} + +.primary-nav a { + border: 1px solid #173f38; + border-radius: 8px; + color: #d9e7e3; + font-weight: 720; + min-width: 8.5rem; + padding: 0.9rem 1.2rem; + text-align: center; +} + +.primary-nav a:hover, +.result-chips a:hover, +.axis-chips a:hover { + border-color: var(--line-bright); + color: white; +} + +.account-nav { + align-items: center; + gap: 0.75rem; +} + +.account-nav a, +.account-menu summary, +.heading-actions a, +.heading-actions span, +.chart-card header a, +.issue-form button { + background: #0a201d; + border: 1px solid #173f38; + border-radius: 7px; + color: #c2d1cc; + font-size: 0.88rem; + padding: 0.55rem 0.8rem; +} + +.account-menu { + position: relative; +} + +.account-menu summary { + cursor: pointer; + list-style: none; +} + +.account-menu summary::-webkit-details-marker { + display: none; +} + +.account-menu summary::after { + color: var(--muted); + content: "▾"; + font-size: 0.75rem; + margin-left: 0.45rem; +} + +.account-menu[open] summary { + border-color: var(--line-bright); + color: white; +} + +.account-menu[open] summary::after { + content: "▴"; +} + +.account-menu-panel { + background: #061614; + border: 1px solid var(--line); + border-radius: 8px; + box-shadow: 0 18px 40px rgba(0, 0, 0, 0.3); + min-width: 12rem; + padding: 0.45rem; + position: absolute; + right: 0; + top: calc(100% + 0.45rem); + z-index: 20; +} + +.account-menu-panel a { + display: block; + margin: 0.2rem 0; + text-align: left; +} + +.account-menu-panel .sign-out { + background: #0d5f53; + border-color: #16806f; + color: white; +} + +.account-nav .sign-in { + background: #0d5f53; + border-color: #16806f; + color: white; +} + +.shell { + margin: 0 auto; + max-width: 1180px; + padding: 1.25rem 1.5rem 2rem; +} + +.login-shell { + align-items: center; + display: flex; + justify-content: center; + min-height: calc(100vh - 4.25rem); + padding: 2rem 1.5rem; +} + +.login-panel { + background: color-mix(in srgb, var(--panel) 88%, transparent); + border: 1px solid var(--line); + border-radius: 8px; + display: grid; + gap: 1.5rem; + grid-template-columns: minmax(0, 0.9fr) minmax(18rem, 1fr); + max-width: 56rem; + padding: 1.4rem; + width: 100%; +} + +.login-copy { + border-right: 1px solid rgba(44, 123, 109, 0.45); + padding: 0.6rem 1.5rem 0.6rem 0.2rem; +} + +.login-copy .eyebrow { + color: var(--teal); + font-size: 0.82rem; + font-weight: 800; + letter-spacing: 0.08em; + margin: 0 0 0.8rem; + text-transform: uppercase; +} + +.login-copy h1 { + font-size: 2rem; + line-height: 1.1; + margin: 0; +} + +.login-copy p:last-child { + color: var(--muted); + margin-bottom: 0; +} + +.login-form { + display: grid; + gap: 0.65rem; +} + +.login-form label { + color: #cfe0dc; + font-size: 0.9rem; + font-weight: 700; +} + +.login-form input { + background: #132923; + border: 1px solid #2a4b43; + border-radius: 6px; + color: var(--text); + font: inherit; + min-height: 2.7rem; + padding: 0.6rem 0.75rem; + width: 100%; +} + +.login-form input:focus { + border-color: var(--line-bright); + outline: 2px solid rgba(47, 189, 159, 0.22); +} + +.login-form button { + background: var(--teal-dark); + border: 1px solid #16806f; + border-radius: 7px; + color: white; + cursor: pointer; + font: inherit; + font-weight: 800; + margin-top: 0.35rem; + min-height: 2.8rem; +} + +.form-error { + background: rgba(216, 137, 45, 0.14); + border: 1px solid rgba(216, 137, 45, 0.45); + border-radius: 6px; + color: #f4c27d; + margin: 0 0 0.25rem; + padding: 0.7rem 0.75rem; +} + +.page-heading { + align-items: end; + display: flex; + gap: 1rem; + justify-content: space-between; +} + +.stacked-heading { + align-items: start; + display: block; +} + +.page-heading h1 { + font-size: clamp(1.7rem, 2vw, 2.3rem); + line-height: 1.1; + margin: 0; +} + +.page-heading p, +.score-note, +.footer, +.empty-state, +.setup-error p { + color: var(--muted); +} + +.page-heading p { + margin: 0.4rem 0 0; +} + +.heading-actions { + flex-wrap: wrap; + gap: 0.65rem; + justify-content: end; +} + +.notice, +.filter-card, +.chamber-card, +.ranking-card, +.chart-card, +.setup-error { + background: color-mix(in srgb, var(--panel) 88%, transparent); + border: 1px solid var(--line); + border-radius: 8px; +} + +.notice { + color: #b8cbc5; + margin: 1rem 0; + padding: 0.75rem 1rem; +} + +.controls-grid { + gap: 1.25rem; + margin-top: 1.1rem; +} + +.filter-card { + flex: 1 1 auto; + padding: 1rem; +} + +h2 { + font-size: 1.1rem; + margin: 0 0 0.75rem; +} + +.issue-form { + align-items: center; + display: flex; + flex-wrap: wrap; + gap: 0.7rem; +} + +.chip, +.suggestions a { + align-items: center; + background: #123a34; + border: 1px solid #1f6b5f; + border-radius: 6px; + color: #d9f4ee; + display: inline-flex; + min-height: 2.35rem; + padding: 0.45rem 0.75rem; +} + +.chip a { + color: #bedbd5; + font-size: 1.2rem; + margin-left: 0.5rem; +} + +.search-box { + flex: 1 1 14rem; +} + +.search-box input { + background: #132923; + border: 1px solid #2a4b43; + border-radius: 6px; + color: var(--text); + min-height: 2.35rem; + padding: 0.45rem 0.75rem; + width: 100%; +} + +.wide-search { + align-items: center; + border: 1px solid var(--line); + border-radius: 8px; + display: flex; + gap: 0.75rem; + margin: 1.4rem 0 1rem; + padding: 0.65rem; +} + +.wide-search input { + background: transparent; + border: 0; + color: var(--text); + flex: 1; + font-size: 1rem; + outline: 0; + padding: 0.55rem 0.7rem; +} + +.wide-search button { + background: var(--teal-dark); + border: 1px solid #16806f; + border-radius: 7px; + color: white; + padding: 0.65rem 1rem; +} + +.wide-search select { + background: #102722; + border: 1px solid #2a4b43; + border-radius: 7px; + color: var(--text); + font: inherit; + min-height: 2.55rem; + padding: 0.45rem 0.65rem; +} + +.issue-form button { + cursor: pointer; +} + +.suggestions { + display: flex; + flex-wrap: wrap; + gap: 0.55rem; + margin-top: 0.8rem; +} + +.suggestions a { + background: transparent; + color: #a8c6c0; + font-size: 0.84rem; + min-height: 1.9rem; +} + +.suggestion-empty { + color: var(--muted); + margin: 0.4rem 0 1rem; +} + +.result-chips, +.axis-chips { + display: flex; + flex-wrap: wrap; + gap: 0.65rem; + margin: 0.8rem 0 1.3rem; +} + +.result-chips a, +.axis-chips a { + align-items: center; + border: 1px solid #1d554c; + border-radius: 999px; + color: #c9dcd7; + display: inline-flex; + gap: 0.45rem; + min-height: 2.15rem; + padding: 0.4rem 0.85rem; +} + +.result-chips .dashed-chip { + border-style: dashed; + color: #79a99d; +} + +.phonebook-results { + background: color-mix(in srgb, var(--panel) 88%, transparent); + border: 1px solid var(--line); + border-radius: 8px; + margin: 1rem 0 1.25rem; + overflow: hidden; +} + +.phonebook-results header, +.pagination { + align-items: center; + display: flex; + justify-content: space-between; +} + +.phonebook-results header { + border-bottom: 1px solid rgba(44, 123, 109, 0.36); + padding: 0.9rem 1rem; +} + +.phonebook-results header h2 { + margin: 0; +} + +.phonebook-results header span, +.phonebook-meta, +.pagination span, +.pagination strong { + color: var(--muted); +} + +.phonebook-list { + list-style-position: inside; + margin: 0; + padding: 0; +} + +.phonebook-list li { + border-bottom: 1px solid rgba(44, 123, 109, 0.22); + color: var(--muted); +} + +.phonebook-list li:last-child { + border-bottom: 0; +} + +.phonebook-list a { + align-items: center; + display: grid; + gap: 0.75rem; + grid-template-columns: minmax(0, 1fr) auto; + margin-left: 1.1rem; + min-height: 3.1rem; + padding: 0.55rem 1rem 0.55rem 0; +} + +.phonebook-list a:hover { + color: white; +} + +.phonebook-name { + color: var(--text); + font-weight: 760; + min-width: 0; +} + +.phonebook-meta { + font-size: 0.86rem; + white-space: nowrap; +} + +.pagination { + border-top: 1px solid rgba(44, 123, 109, 0.36); + gap: 0.8rem; + padding: 0.8rem 1rem; +} + +.pagination a, +.pagination span { + border: 1px solid #1d554c; + border-radius: 7px; + min-width: 5.8rem; + padding: 0.48rem 0.75rem; + text-align: center; +} + +.pagination span { + opacity: 0.55; +} + +.chamber-card { + align-items: stretch; + display: grid; + flex: 0 0 28rem; + grid-template-columns: repeat(3, 1fr); + overflow: hidden; + padding: 0.75rem; +} + +.segment { + align-items: center; + border-radius: 7px; + color: var(--muted); + display: flex; + font-weight: 700; + justify-content: center; + min-height: 4.4rem; +} + +.segment.active { + background: #105f54; + color: white; + outline: 1px solid #258778; +} + +.score-note { + font-size: 0.86rem; + margin: 0.8rem 0; +} + +.rankings-grid { + gap: 1.25rem; +} + +.ranking-card { + flex: 1 1 0; + overflow: hidden; +} + +.ranking-card header, +.chart-card header { + align-items: center; + justify-content: space-between; + padding: 1rem 1rem 0.65rem; +} + +.ranking-card header span { + color: var(--muted); + font-size: 0.86rem; +} + +.ranking-list { + list-style: none; + margin: 0; + padding: 0; +} + +.ranking-list li { + border-top: 1px solid rgba(44, 123, 109, 0.22); +} + +.ranking-list li.selected { + background: rgba(47, 189, 159, 0.16); + box-shadow: inset 0 0 0 1px rgba(47, 189, 159, 0.55); +} + +.ranking-list a { + align-items: center; + display: grid; + gap: 0.7rem; + grid-template-columns: 2.2rem 3.2rem minmax(0, 1fr) 4rem; + min-height: 3.2rem; + padding: 0.45rem 0.9rem; +} + +.rank, +.votes { + color: var(--muted); + font-variant-numeric: tabular-nums; + text-align: right; +} + +.score { + border-radius: 5px; + color: white; + font-variant-numeric: tabular-nums; + padding: 0.42rem 0.2rem; + text-align: center; +} + +.score.positive { + background: linear-gradient(90deg, #0e6d5e, #2fbd9f); +} + +.score.negative { + background: linear-gradient(90deg, #76420e, var(--amber)); +} + +.profile-card, +.compare-card, +.compare-controls { + background: color-mix(in srgb, var(--panel) 88%, transparent); + border: 1px solid var(--line); + border-radius: 18px; + overflow: hidden; +} + +.profile-header { + align-items: center; + display: flex; + justify-content: space-between; + padding: 1.55rem 1.75rem; +} + +.profile-identity { + align-items: center; + display: flex; + gap: 1.2rem; +} + +.avatar { + align-items: center; + background: #0d372f; + border: 1px solid #1d554c; + border-radius: 999px; + color: #8fe2d0; + display: inline-flex; + font-weight: 800; + height: 4.4rem; + justify-content: center; + width: 4.4rem; +} + +.profile-header h2 { + font-size: 1.65rem; + margin: 0; +} + +.profile-header p, +.overall-score span, +.overall-score small, +.compare-legend small, +.compare-legend p { + color: var(--muted); +} + +.party-pill { + background: #0b2a3b; + border-radius: 5px; + color: #83b9e7; + font-size: 0.8rem; + padding: 0.2rem 0.45rem; +} + +.overall-score { + text-align: right; +} + +.overall-score strong { + display: inline-block; + font-size: 2rem; + margin-top: 0.3rem; +} + +.topic-panels { + border-top: 1px solid var(--line); + border-bottom: 1px solid var(--line); + display: grid; + grid-template-columns: 1fr 1fr; +} + +.topic-panels article { + padding: 1.35rem 1.6rem; +} + +.topic-panels article + article { + border-left: 1px solid var(--line); +} + +.topic-panels h3, +.profile-history h3 { + color: var(--teal); + margin: 0 0 0.9rem; +} + +.topic-panels .opposed-heading { + color: var(--amber); +} + +.topic-row { + align-items: center; + border-left: 3px solid transparent; + border-radius: 6px; + display: grid; + gap: 0.75rem; + grid-template-columns: 3.4rem minmax(0, 1fr) 9rem; + margin: 0.65rem 0; + padding: 0.35rem 0.5rem; +} + +.topic-row.active { + background: rgba(216, 137, 45, 0.12); + border-left-color: var(--amber); +} + +.topic-row span { + font-weight: 650; +} + +.topic-row i { + background: currentColor; + border-radius: 999px; + color: #75c9b8; + display: block; + height: 0.3rem; + max-width: 100%; +} + +.profile-history { + padding: 1.2rem 1.6rem 1.4rem; +} + +.compare-controls { + border-radius: 8px; + margin-top: 1.4rem; + padding: 1.1rem 1.25rem 0.4rem; +} + +.compare-controls h2 { + color: #6fa89b; + font-size: 0.9rem; + letter-spacing: 0.08em; + margin-top: 0.4rem; + text-transform: uppercase; +} + +.axis-chips a { + border-radius: 6px; +} + +.compare-card { + align-items: stretch; + display: grid; + grid-template-columns: minmax(0, 1.25fr) minmax(18rem, 0.75fr); + margin-top: 1.4rem; + padding: 1.6rem; +} + +.radar-frame { + min-height: 31rem; +} + +.radar-chart { + display: block; + height: auto; + width: 100%; +} + +.radar-ring { + fill: transparent; + stroke: rgba(55, 105, 94, 0.55); +} + +.radar-axis { + stroke: rgba(70, 116, 106, 0.4); +} + +.radar-label { + fill: #72a99c; + font-size: 15px; + font-weight: 650; +} + +.compare-legend { + padding: 1rem 0 1rem 1.5rem; +} + +.legend-row { + align-items: center; + display: flex; + gap: 0.8rem; + margin: 1rem 0; +} + +.legend-line { + border-radius: 999px; + display: inline-block; + height: 0.25rem; + width: 2.2rem; +} + +.legend-dot { + border-radius: 999px; + display: inline-block; + height: 0.7rem; + width: 0.7rem; +} + +.line-0, +.dot-0 { background: #2fbd9f; } +.line-1, +.dot-1 { background: #8f6ff0; } +.line-2, +.dot-2 { background: #f4b860; } +.line-3, +.dot-3 { background: #7bdff2; } + +.member { + min-width: 0; +} + +.member strong, +.member small { + display: block; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} + +.member small { + color: var(--muted); + font-size: 0.78rem; +} + +.empty-state { + border-top: 1px solid rgba(44, 123, 109, 0.22); + margin: 0; + min-height: 10rem; + padding: 2.2rem 1rem; + text-align: center; +} + +.chart-card { + margin-top: 1.25rem; +} + +.chart-frame { + padding: 0.5rem 1rem 0.85rem; +} + +.chart-legend { + display: grid; + gap: 0.65rem; + grid-template-columns: repeat(auto-fit, minmax(14rem, 1fr)); + padding: 0 1rem 0.85rem; +} + +.chart-legend.compact { + grid-template-columns: minmax(0, 1fr); + padding-top: 0.15rem; +} + +.chart-legend.compact .chart-legend-row { + align-items: flex-start; + display: flex; + gap: 0.65rem; +} + +.chart-legend.compact .chart-legend-line, +.chart-legend.compact .chart-legend-marker { + flex: 0 0 auto; + margin-top: 0.3rem; +} + +.chart-legend.compact .chart-legend-copy { + flex: 1 1 auto; +} + +.chart-legend-row { + align-items: flex-start; + background: rgba(12, 38, 33, 0.78); + border: 1px solid rgba(44, 123, 109, 0.28); + border-radius: 8px; + box-shadow: inset 0 0 0 1px rgba(8, 54, 47, 0.22); + display: flex; + gap: 0.7rem; + min-height: 3.4rem; + padding: 0.65rem 0.8rem; +} + +.chart-legend-line, +.chart-legend-marker { + display: inline-block; + flex: 0 0 auto; +} + +.chart-legend-line { + align-self: flex-start; + border-top: 4px solid currentColor; + color: inherit; + margin-top: 0.6rem; + width: 2.25rem; +} + +.chart-legend-marker { + background: currentColor; + color: inherit; + height: 0.85rem; + margin-top: 0.2rem; + width: 0.85rem; +} + +.chart-legend-copy, +.chart-legend-label, +.chart-legend-meta { + min-width: 0; +} + +.chart-legend-copy { + display: grid; + gap: 0.2rem; +} + +.chart-legend-label { + color: var(--text); + display: block; + font-size: 1.08rem; + font-weight: 760; + letter-spacing: -0.01em; + overflow-wrap: anywhere; +} + +.chart-legend-meta { + color: var(--muted); + display: block; + font-size: 0.82rem; + text-align: left; + text-transform: uppercase; + letter-spacing: 0.04em; +} + +.score-chart { + display: block; + height: auto; + min-height: 18rem; + width: 100%; +} + +.chart-grid { + stroke: #33544d; + stroke-dasharray: 4 5; +} + +.chart-year-line { + stroke: rgba(51, 84, 77, 0.45); + stroke-dasharray: 3 8; +} + +.chart-axis { + stroke: #48635d; +} + +.chart-axis-label, +.chart-series-label, +.chart-empty { + fill: #9fb0ac; + font-size: 13px; +} + +.chart-empty { + font-size: 16px; +} + +.line-0, +.marker-0 { + color: #009e73; +} + +.line-1, +.marker-1 { + color: #0072b2; +} + +.line-2, +.marker-2 { + color: #e69f00; +} + +.line-3, +.marker-3 { + color: #cc79a7; +} + +.line-1 { + border-top-style: dashed; +} + +.line-2 { + border-top-style: dotted; +} + +.line-3 { + background-image: linear-gradient( + to right, + currentColor 0 45%, + transparent 45% 60%, + currentColor 60% 75%, + transparent 75% 90%, + currentColor 90% 100% + ); + background-repeat: repeat-x; + background-size: 1.8rem 100%; + border-top: 0; + height: 4px; +} + +.marker-0 { + border-radius: 999px; +} + +.marker-1 { + border-radius: 2px; +} + +.marker-2 { + transform: rotate(45deg); +} + +.marker-3 { + background: transparent; + border-bottom: 0.9rem solid currentColor; + border-left: 0.45rem solid transparent; + border-right: 0.45rem solid transparent; + height: 0; + width: 0; +} + +.footer { + border-top: 1px solid #12362f; + display: flex; + flex-wrap: wrap; + gap: 1rem; + justify-content: center; + padding: 1.1rem; +} + +.footer span { + border-right: 1px solid #31514a; + padding-right: 1rem; +} + +.footer span:last-child { + border-right: 0; +} + +.setup-error { + margin-top: 3rem; + padding: 1.25rem; +} + +.setup-error pre { + background: #020c0a; + border: 1px solid #284b44; + border-radius: 6px; + color: #d3e5e0; + overflow: auto; + padding: 1rem; +} + +.sr-only { + clip: rect(0, 0, 0, 0); + border: 0; + height: 1px; + margin: -1px; + overflow: hidden; + padding: 0; + position: absolute; + width: 1px; +} + +@media (max-width: 860px) { + .page-heading, + .controls-grid, + .rankings-grid, + .topic-panels, + .compare-card, + .login-panel { + display: block; + } + + .heading-actions, + .chamber-card { + margin-top: 1rem; + } + + .ranking-card + .ranking-card { + margin-top: 1rem; + } + + .topbar { + align-items: flex-start; + gap: 0.8rem; + } + + .account-nav { + flex-wrap: wrap; + justify-content: flex-end; + } + + .primary-nav { + order: 3; + margin: 0.7rem 0 0; + width: 100%; + } + + .primary-nav a { + flex: 1; + min-width: 0; + } + + .topic-panels article + article { + border-left: 0; + border-top: 1px solid var(--line); + } + + .profile-header { + align-items: flex-start; + display: block; + } + + .overall-score { + margin-top: 1rem; + text-align: left; + } + + .compare-legend { + padding-left: 0; + } + + .chart-legend-row { + grid-template-columns: 2.25rem 1rem minmax(0, 1fr); + } + + .chart-legend-meta { + justify-self: start; + text-align: left; + } + + .wide-search { + align-items: stretch; + display: grid; + grid-template-columns: 1fr auto; + } + + .wide-search input { + grid-column: 1 / -1; + } + + .phonebook-results header, + .pagination, + .phonebook-list a { + align-items: flex-start; + display: grid; + grid-template-columns: 1fr; + } + + .phonebook-meta { + white-space: normal; + } + + .login-copy { + border-right: 0; + border-bottom: 1px solid rgba(44, 123, 109, 0.45); + margin-bottom: 1rem; + padding: 0 0 1rem; + } +} diff --git a/pipelines/web/static/vendor/htmx.min.js b/pipelines/web/static/vendor/htmx.min.js new file mode 100644 index 0000000..faafa3e --- /dev/null +++ b/pipelines/web/static/vendor/htmx.min.js @@ -0,0 +1 @@ +var htmx=function(){"use strict";const Q={onLoad:null,process:null,on:null,off:null,trigger:null,ajax:null,find:null,findAll:null,closest:null,values:function(e,t){const n=dn(e,t||"post");return n.values},remove:null,addClass:null,removeClass:null,toggleClass:null,takeClass:null,swap:null,defineExtension:null,removeExtension:null,logAll:null,logNone:null,logger:null,config:{historyEnabled:true,historyCacheSize:10,refreshOnHistoryMiss:false,defaultSwapStyle:"innerHTML",defaultSwapDelay:0,defaultSettleDelay:20,includeIndicatorStyles:true,indicatorClass:"htmx-indicator",requestClass:"htmx-request",addedClass:"htmx-added",settlingClass:"htmx-settling",swappingClass:"htmx-swapping",allowEval:true,allowScriptTags:true,inlineScriptNonce:"",inlineStyleNonce:"",attributesToSettle:["class","style","width","height"],withCredentials:false,timeout:0,wsReconnectDelay:"full-jitter",wsBinaryType:"blob",disableSelector:"[hx-disable], [data-hx-disable]",scrollBehavior:"instant",defaultFocusScroll:false,getCacheBusterParam:false,globalViewTransitions:false,methodsThatUseUrlParams:["get","delete"],selfRequestsOnly:true,ignoreTitle:false,scrollIntoViewOnBoost:true,triggerSpecsCache:null,disableInheritance:false,responseHandling:[{code:"204",swap:false},{code:"[23]..",swap:true},{code:"[45]..",swap:false,error:true}],allowNestedOobSwaps:true,historyRestoreAsHxRequest:true,reportValidityOfForms:false},parseInterval:null,location:location,_:null,version:"2.0.8"};Q.onLoad=V;Q.process=Ft;Q.on=xe;Q.off=be;Q.trigger=ae;Q.ajax=Ln;Q.find=f;Q.findAll=x;Q.closest=g;Q.remove=_;Q.addClass=K;Q.removeClass=G;Q.toggleClass=W;Q.takeClass=Z;Q.swap=ze;Q.defineExtension=_n;Q.removeExtension=zn;Q.logAll=j;Q.logNone=$;Q.parseInterval=d;Q._=e;const n={addTriggerHandler:St,bodyContains:se,canAccessLocalStorage:X,findThisElement:Se,filterValues:yn,swap:ze,hasAttribute:s,getAttributeValue:a,getClosestAttributeValue:ne,getClosestMatch:q,getExpressionVars:Rn,getHeaders:mn,getInputValues:dn,getInternalData:oe,getSwapSpecification:bn,getTriggerSpecs:st,getTarget:Ee,makeFragment:D,mergeObjects:le,makeSettleInfo:Sn,oobSwap:Te,querySelectorExt:ue,settleImmediately:Yt,shouldCancel:ht,triggerEvent:ae,triggerErrorEvent:fe,withExtensions:Vt};const de=["get","post","put","delete","patch"];const R=de.map(function(e){return"[hx-"+e+"], [data-hx-"+e+"]"}).join(", ");function d(e){if(e==undefined){return undefined}let t=NaN;if(e.slice(-2)=="ms"){t=parseFloat(e.slice(0,-2))}else if(e.slice(-1)=="s"){t=parseFloat(e.slice(0,-1))*1e3}else if(e.slice(-1)=="m"){t=parseFloat(e.slice(0,-1))*1e3*60}else{t=parseFloat(e)}return isNaN(t)?undefined:t}function ee(e,t){return e instanceof Element&&e.getAttribute(t)}function s(e,t){return!!e.hasAttribute&&(e.hasAttribute(t)||e.hasAttribute("data-"+t))}function a(e,t){return ee(e,t)||ee(e,"data-"+t)}function u(e){const t=e.parentElement;if(!t&&e.parentNode instanceof ShadowRoot)return e.parentNode;return t}function te(){return document}function y(e,t){return e.getRootNode?e.getRootNode({composed:t}):te()}function q(e,t){while(e&&!t(e)){e=u(e)}return e||null}function o(e,t,n){const r=a(t,n);const o=a(t,"hx-disinherit");var i=a(t,"hx-inherit");if(e!==t){if(Q.config.disableInheritance){if(i&&(i==="*"||i.split(" ").indexOf(n)>=0)){return r}else{return null}}if(o&&(o==="*"||o.split(" ").indexOf(n)>=0)){return"unset"}}return r}function ne(t,n){let r=null;q(t,function(e){return!!(r=o(t,ce(e),n))});if(r!=="unset"){return r}}function h(e,t){return e instanceof Element&&e.matches(t)}function A(e){const t=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i;const n=t.exec(e);if(n){return n[1].toLowerCase()}else{return""}}function L(e){if("parseHTMLUnsafe"in Document){return Document.parseHTMLUnsafe(e)}const t=new DOMParser;return t.parseFromString(e,"text/html")}function N(e,t){while(t.childNodes.length>0){e.append(t.childNodes[0])}}function r(e){const t=te().createElement("script");ie(e.attributes,function(e){t.setAttribute(e.name,e.value)});t.textContent=e.textContent;t.async=false;if(Q.config.inlineScriptNonce){t.nonce=Q.config.inlineScriptNonce}return t}function i(e){return e.matches("script")&&(e.type==="text/javascript"||e.type==="module"||e.type==="")}function I(e){Array.from(e.querySelectorAll("script")).forEach(e=>{if(i(e)){const t=r(e);const n=e.parentNode;try{n.insertBefore(t,e)}catch(e){H(e)}finally{e.remove()}}})}function D(e){const t=e.replace(/
]*)?>[\s\S]*?<\/head>/i,"");const n=A(t);let r;if(n==="html"){r=new DocumentFragment;const i=L(e);N(r,i.body);r.title=i.title}else if(n==="body"){r=new DocumentFragment;const i=L(t);N(r,i.body);r.title=i.title}else{const i=L(''+t+"");r=i.querySelector("template").content;r.title=i.title;var o=r.querySelector("title");if(o&&o.parentNode===r){o.remove();r.title=o.innerText}}if(r){if(Q.config.allowScriptTags){I(r)}else{r.querySelectorAll("script").forEach(e=>e.remove())}}return r}function re(e){if(e){e()}}function t(e,t){return Object.prototype.toString.call(e)==="[object "+t+"]"}function P(e){return typeof e==="function"}function k(e){return t(e,"Object")}function oe(e){const t="htmx-internal-data";let n=e[t];if(!n){n=e[t]={}}return n}function M(t){const n=[];if(t){for(let e=0;eUp to 4 legislators · up to 8 issue axes · each polygon = one legislator's full issue profile
+US legislative accountability · precomputed legislator topic scores{% if latest_score_year %} through {{ latest_score_year }}{% endif %}
+Full issue taxonomy · search any current legislator
+No legislators matched this search.
+ {% endif %} +{{ profile.legislator.state or "US" }} · {{ profile.legislator.party or "Unaffiliated" }}{% if profile.serving_since %} · Serving since {{ profile.serving_since }}{% endif %}
+No issue scores are available for this legislator yet.
+ {% endif %} +Admin access
+Use the dashboard account to review rankings, profiles, and legislator comparisons.
+Scores reflect averaged precomputed topic rows per year. Sparse years are omitted rather than plotted as zero.
+Support score: 1-100 precomputed from bill topic stance and roll-call votes. Higher means more aligned with the topic.
+ +{% include "partials/_rankings.html" %} +{% include "partials/_chart.html" %} diff --git a/pipelines/web/templates/partials/_issue_filters.html b/pipelines/web/templates/partials/_issue_filters.html new file mode 100644 index 0000000..037b617 --- /dev/null +++ b/pipelines/web/templates/partials/_issue_filters.html @@ -0,0 +1,46 @@ +No matches
+{% endif %} diff --git a/pipelines/web/templates/partials/_rankings.html b/pipelines/web/templates/partials/_rankings.html new file mode 100644 index 0000000..ef6b857 --- /dev/null +++ b/pipelines/web/templates/partials/_rankings.html @@ -0,0 +1,61 @@ +{{ empty_message }}
+ {% endif %} +{{ empty_message }}
+ {% endif %} +Configure DATA_SCIENCE_DEV before opening the dashboard.
+{{ error }}
+