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/neu	Static draft form	/auftrag/neu
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
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.
• 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.