dashfront/.agents/skills/frontend-routes/SKILL.md

name, description

name	description
frontend-routes	Guide and reference for constructing valid client-side frontend routes in Dashfront. Use this skill whenever an agent needs to navigate the user to specific pages, entities, or views.

Dashfront Frontend Routes

Reference guide for the backend LLM agent when emitting route navigation actions (e.g. redirecting or deep-linking the user).

---

1. Quick Route Construction Matrix

Destination	Path Pattern	Parameters / Construction	Example
Article Search / Index	/artikel	Query params: ?target={query}&filter={filter}&offset={n}	/artikel?target=kabel
Article Detail	/artikel/:sku	Encode SKU: /artikel/${encodeURIComponent(sku)}	/artikel/ART-10042
Warehouse / Stock	/artikel/lager	Static	/artikel/lager
Brands	/artikel/marken	Static	/artikel/marken
Label Templates	/artikel/vorlagen	Static	/artikel/vorlagen
Attributes & Features	/artikel/merkmale	Static	/artikel/merkmale
Category Tree Root	/kategorien	Static	/kategorien
Category Subtree	/kategorien/*	Join encoded slugs: /kategorien/${slug1}/${slug2}	/kategorien/elektronik/kabel
Delivery List	/lieferung	Static	/lieferung
New Delivery Draft	/lieferung/neu	Static (receipt & draft line editor)	/lieferung/neu
Delivery Detail	/lieferung/:deliveryId	Delivery document ID: /lieferung/${deliveryId}	/lieferung/42
Suppliers Directory	/lieferung/lieferanten	Static	/lieferung/lieferanten
Quote List (Angebote)	/auftrag	Static	/auftrag
New Quote	/auftrag/neuesangebot	Static draft form (Neues Angebot)	/auftrag/neuesangebot
Quote Detail	/auftrag/:quoteId	Quote document ID: /auftrag/${quoteId}	/auftrag/1001
Order List (Bestellungen)	/auftrag/bestellung	Static	/auftrag/bestellung
New Order	/auftrag/bestellung/neu	Static draft form	/auftrag/bestellung/neu
Order Detail	/auftrag/bestellung/:orderId	Order document ID: /auftrag/bestellung/${orderId}	/auftrag/bestellung/2005
Shipments (Ausliefern)	/auftrag/ausliefern	Static (shipment manifests & parcels)	/auftrag/ausliefern
Payments (Zahlungen)	/auftrag/zahlungen	Static (order payments ledger)	/auftrag/zahlungen

| Customer List | /kunde | Static | /kunde | | New Customer | /kunde/neu | Static form | /kunde/neu | | Customer Detail | /kunde/:entityId | Customer entity ID: /kunde/${entityId} | /kunde/312 | | Customer Groups | /kunde/gruppen | Static (pricing & customer tiers) | /kunde/gruppen | | Article History | /infos or /infos/articlehistory | Static | /infos/articlehistory | | Global History | /infos/globalhistory | Static audit log | /infos/globalhistory | | Statistics | /infos/statistics | Static KPIs & charts | /infos/statistics |

---

2. Parameter Details & Rules

Articles (/artikel)

• SKU detail: Always use encodeURIComponent(sku) if the SKU contains slashes, spaces, or special characters.
  • Path: /artikel/${encodeURIComponent(sku)}
  • Example: SKU A/123 becomes /artikel/A%2F123
• Search Query:
  • target: Search text (min 3 chars to activate search index).
  • filter: Category or facet filter.
  • offset: Pagination offset (integer).
  • Example: /artikel?target=schrauben&offset=20

Categories (/kategorien)

• The route uses hierarchical URL slugs, not numeric category IDs.
• Format: /kategorien/{parentSlug}/{childSlug}
• Note: Legacy /artikel/kategorien/* is automatically redirected to /kategorien/*.

Inbound Deliveries (/lieferung)

• :deliveryId: ID of the delivery document (manifest).
• To start a new incoming goods intake or receipt reconciliation, route to /lieferung/neu.

Quotes & Orders (/auftrag)

• Distinction:
  • Quotes (Angebote) live at /auftrag and /auftrag/:quoteId.
  • Orders (Bestellungen) live at /auftrag/bestellung and /auftrag/bestellung/:orderId.
  • Shipments (Ausliefern) live at /auftrag/ausliefern (connected to shipment manifests and packages).
  • Payments (Zahlungen) live at /auftrag/zahlungen (payment bookings and payment balances).
• Both IDs (quoteId, orderId) are document IDs.

Customers (/kunde)

• :entityId: Numeric ID of the entity/customer record (e.g. entity.id).
• Opens contact addresses, communications, and customer data tiles.