Activity hub — Gommo platform (preview)

Coming to Gommo platform

The Activity hub aggregates Gommo usage via gateway wrappers. The portal UX is a preview of analytics Gommo will ship on platform.

→ Gommo platform roadmap

Open Activity in the portal for usage analytics (same Gommo usage-history data as Profile preview).

Tabs

Tab	Purpose
Overview	KPIs, charts, top models, recent jobs
Trends	Credits/outcome charts + daily summary table
Explore	Searchable job log; click a row for details
Billing	Top-up orders and quick links to Credits

URL query params

Share or bookmark a view with query parameters:

Param	Values	Default
tab	trends, explore, billing	Overview (omit param)
period	7d, 30d, 90d	30d
model	Model slug	Explore only; filters job list
job	Job id_base	Explore only; opens job detail modal
type	image, video, audio, music	Explore only; filters by job type
q	Search text	Explore only; filters model/prompt (client-side, scans up to 30 log pages)

Examples:

• Overview, 30 days: /app/activity/
• Trends, 90 days: /app/activity/?tab=trends&period=90d
• Explore one model: /app/activity/?tab=explore&model=imagegen_2_0&period=30d
• Explore video jobs: /app/activity/?tab=explore&type=video&period=30d
• Search + type: /app/activity/?tab=explore&type=video&q=cat
• Open job detail: /app/activity/?tab=explore&job=JOB_ID_BASE

Click Top models on Overview to jump to Explore with the model filter applied. Use Copy link in the job modal to share a ?job= URL. Export CSV on Overview downloads up to 1,000 jobs for the selected period.

On Explore, active filters show as chips (model, type, search). Search (q) paginates through loaded log pages automatically (up to 30 pages) before showing “no matches”.

API

Portal charts call gateway wrappers documented in Usage history:

• POST /gateway/usage/stats — aggregates and chart series
• POST /gateway/usage/logs — paginated job list
• POST /gateway/usage/aggregate — server-side top models (groupBy=model)

See also Billing & credits and Authentication.

Smoke test checklist

Run after changes to Activity hub UI or usage APIs:

npm run theme:test
npm run test:aggregate

Manual (logged in, npm run docs:stack):

• [ ] Overview → change period → KPI/charts update; Refresh bypasses top-models cache (from_cache absent in Network → usage/aggregate)
• [ ] Export CSV with type filter → file name includes type when not “All”
• [ ] Usage by type row (label →) → Explore with ?type=
• [ ] Top models cached hint shows tooltip on hover; Refresh rescans
• [ ] Explore Load more loads next page; meta shows loaded count
• [ ] Top models row → Explore with ?model=
• [ ] Billing tab → links keep ?period=; Observability link works
• [ ] Explore filters → chips + ?type= / ?q=; Clear all filters on empty state
• [ ] Job row → modal; Copy link with distinct ?job= per row
• [ ] npm run theme:test — all pass