API: /api/v1/campaigns (paginated list), /api/v1/campaigns/{uuid}
(soft-merge chain follow), /api/v1/campaigns/{uuid}/identities
(member identities), and /api/v1/campaigns/events (SSE under
campaign.> + JWT-via-?token=, snapshot-on-connect). Mirror of the
identity router; same auth, same shape, same OpenAPI tags pattern.
Frontend: CampaignDetail.tsx page (same visual vocabulary as
IdentityDetail), useCampaignStream hook (mirror of
useIdentityStream), /campaigns/:id route, IdentityDetail's
CAMPAIGN badge becomes clickable and navigates to the campaign.
useIdentityStream now listens for identity.campaign.assigned so
the badge appears live without a manual refresh.
36 lines
1.1 KiB
Python
36 lines
1.1 KiB
Python
"""GET /api/v1/campaigns — paginated list of campaigns.
|
|
|
|
Mirror of :mod:`decnet.web.router.identities.api_list_identities` for
|
|
the campaign layer. Returns an empty list while the campaign clusterer
|
|
hasn't run yet (the campaigns table ships empty).
|
|
"""
|
|
from typing import Any
|
|
|
|
from fastapi import APIRouter, Depends, Query
|
|
|
|
from decnet.telemetry import traced as _traced
|
|
from decnet.web.dependencies import repo, require_viewer
|
|
|
|
router = APIRouter()
|
|
|
|
|
|
@router.get(
|
|
"/campaigns",
|
|
tags=["Campaign Clustering"],
|
|
responses={
|
|
401: {"description": "Could not validate credentials"},
|
|
403: {"description": "Insufficient permissions"},
|
|
422: {"description": "Validation error"},
|
|
},
|
|
)
|
|
@_traced("api.list_campaigns")
|
|
async def list_campaigns(
|
|
limit: int = Query(50, ge=1, le=1000),
|
|
offset: int = Query(0, ge=0, le=2147483647),
|
|
user: dict = Depends(require_viewer),
|
|
) -> dict[str, Any]:
|
|
"""Paginated campaign list, newest-updated first."""
|
|
data = await repo.list_campaigns(limit=limit, offset=offset)
|
|
total = await repo.count_campaigns()
|
|
return {"total": total, "limit": limit, "offset": offset, "data": data}
|