Admin Panel

Admin panel

Full tab reference: docs/admin-guide.md

URL

/admin/login → JWT session (cookie + optional Bearer for API scripts).

Roles (RBAC)

Role	Typical access
viewer	Read-mostly dashboards, pipeline view
operator	Mutations except destructive/super settings
admin	Full factory ops
super_admin	Users, security-sensitive settings

Details: docs/admin-panel-rbac.md

Core tabs (operator)

Tab	Purpose
New product	Submit idea + product type
Pipeline	Stage machine per prod-* id
Dashboard	Aggregate KPIs
LLM Providers	Provider keys, model routing
LLM Logs	Historical calls (filter by product/provider)
Live Monitor	Real-time pipeline + optional demo video
Time Travel	Replay / inspect past pipeline states
Settings	Persisted YAML overlay (quality, discovery, site)
Storefront / Marketing	Themes, vitrine policy
Users	Admin accounts, MFA

Dashboard and Monitor data sources

To avoid stale first paint, admin metrics are layered:

1. GET /api/admin/dashboard/pipeline-summary — canonical pipeline totals (same source as Pipeline catalog_summary)
2. GET /api/admin/dashboard?quick=1 — quick aggregates and system resources
3. GET /api/admin/dashboard — full payload (agent metrics, heavier slices) in background

If numbers disagree, treat Pipeline tab as truth and check quick/full dashboard endpoint responses in browser network logs.

Auth tips

• Stale admin_token cookie → empty tabs; re-login clears state
• CSRF: mutating requests need X-CSRF-Token when using cookie session (UI sends automatically)
• Demo vitrine may open admin with limited viewer role — some write APIs blocked by design

In-app documentation page

Next.js /docs — curated guides + screenshots from web/frontend/public/docs-screenshots/.

Feature	Detail
Locales	Globe switcher EN / RU / ES (syncs with storefront via marketing_locale)
Source packs	web/frontend/language-packs/docs/{en,ru,es}.json
Regenerate	python3 scripts/generate_docs_i18n.py
Capture shots	cd web/frontend && npm run capture-docs-screenshots

Repo Markdown handbooks (docs/USER_GUIDE.md, …) stay versioned separately; /docs is the operator-friendly SPA view.

Demo replay

Pipeline walkthrough video:

• Admin Live Monitor / Settings when published
• GET /api/public/pipeline-demo-replay
• Regenerate: python scripts/record_pipeline_demo_video.py → sync_demo_replay_from_recording.py

Skill: .cursor/skills/pipeline-demo-video/SKILL.md in repo.