Documentation

Overview content is shown below. Use the menu to open other pages.

Web Dashboard

The IEC ships with a lightweight web dashboard for visibility and basic operations. It focuses on observability and safe actions; heavyweight operations (e.g., bulk imports) stay in CLI.

Navigation

  • Dashboard: `/` — Overview, live job status, recent jobs, entity counts, per-integration sync stats.
  • Activity: `/activity` — Activity feed with filters; shows mutation creation, job queued/processed, errors; allows bulk delete of old entries.
  • Entities: `/entities` — Browse local entities; drill down into a specific entity to view data, mappings, activity, and for products an Attributes tab.
  • Mutations: `/mutations` — Search and inspect mutations; open a mutation to see payload, previous, changed fields, jobs.
  • Jobs: `/jobs` — Filterable queue view; supports per-job retry, retry visible page, and global retry.

Dashboard Widgets

  • Job Status Donut — Counts by `pending`, `queued`, `processing`, `success`, `failed` (AJAX: `/dashboard/data/jobs-status`).
  • Recent Jobs — 10 latest by `updated_at` with entity type, identifier, status, and quick links to details (AJAX: `/dashboard/data/recent-jobs`).
  • Entity Counts — Total counts for products, categories, families, and attributes (AJAX: `/dashboard/data/entities-counts`).
  • Integration Sync — Select an integration to see per-type buckets: `synced`, `outdated` (mapped with outstanding jobs), `not_synced` (AJAX: `/dashboard/data/integration-sync`).

Entities View

  • Index — Filter by type and free text; links to details.
  • Details — Tabs: Data, Mappings, Activity, and for Product additionally Attributes.
  • - Mappings tab — Shows per-integration external IDs; “Force” button triggers a re-sync for a specific integration.

    - Attributes tab (Product only) — Lists EAV rows (code, channel, locale, unit, value):

    - Select rows and “Clear selected attribute and re-import the product”.

    - “Force full sync” removes all attribute rows and re-imports the product from Akeneo.

    - Filter box for quick narrowing; pagination support for large sets.

Mutations

  • Index — Filters for text, entity type, operation; prefers generated/indexed columns to avoid scanning JSON where possible.
  • Show — Displays mutation payload and previous state, changed fields, and linked jobs.

Jobs

  • Index — Filter by status, integration, updated window; actions to retry a single job, retry current page, or retry all.
  • Status — Per-job mini API to poll live status for UI updates (`/jobs/{uuid}/status`).

Activity

  • Index — Paginated activity feed with lightweight tooltips; delete selected entries in bulk.

Notes

  • The UI is designed for operations: quickly answering “what’s happening?”, “what failed?”, and providing a safe way to retry work.
  • Heavy operations (imports, cleanup) are exposed via CLI and/or Ofelia-scheduled jobs.

Docs Index

Current file: docs/iec/11-dashboard.md