Skill Definition Schema
Felder
Skill Definition Schema
Schema for validating skill definition entities (Skill-Katalog)
name
Display name of the skill (e.g. "Windows Server", "Netzwerktechnik")
slug
URL-safe slug, also used as tag value for dispatch compatibility
parentId
Parent skill UUID for tree nesting. Null = root node. Arbitrary depth allowed.
category
Legacy flat category. Prefer parentId hierarchy. Auto-computed from root ancestor name.
description
Detailed description of the skill
isActive
Whether this skill is currently active and selectable
schedulingCategory
Category for scheduling qualification matching
TECHNICALSOFTCERTIFICATIONLANGUAGEOTHERnullrequiresCertification
If true, valid employee_certifications entry required for scheduling
requiredForScheduling
If true, this skill can be required in shift template position slots
minimumLevelForScheduling
Minimum proficiency level required when used in scheduling
BEGINNERINTERMEDIATEADVANCEDEXPERTnullisBinary
If true, skill is presence-only (have it or not) — e.g. formal qualifications like Rettungssanitäter. No XP/level tracked; auto-XP awards skip this skill.
impliedSkillIds
Skills that are automatically covered when an employee holds this skill. Example: Notfallsanitäter implies Rettungssanitäter. Only meaningful for isBinary=true; targets must also be isBinary. Cycles are rejected. Resolved transitively by the solver and replacement search.
aiManaged
If true, automatic XP awards from ticket/task completion and survey-driven level steps are applied to this skill. If false, the skill level is curated manually only (certifications, manager assignment, self-assessment). Ignored when isBinary is true.
assetMatchRules
Rules that auto-derive this skill as a ticket requirement from a customer's assets (CMDB). When a ticket is dispatched, the customer's assets are matched against these rules; each match adds this skill to the ticket's requiredSkills (source ASSET_DERIVED), so dispatch prefers technicians who hold it. Empty = the skill is never asset-derived. Example: a "WatchGuard" skill with a rule { manufacturers: ["WatchGuard"], assetSchemaPatterns: ["asset.network.firewall"] }.
manufacturers
Manufacturer names matched case-insensitively (substring) against the asset manufacturer (or its asset_template manufacturer). Empty = any manufacturer.
assetSchemaPatterns
Asset schema prefixes matched via prefix against the asset schema, e.g. "asset.network.firewall" or "asset.network" (all network assets). Empty = any asset type.
minimumLevel
Minimum proficiency the derived requirement demands when this rule matches. Null = any level.
BEGINNERINTERMEDIATEADVANCEDEXPERTnullKeine Felder passen zum Filter.
Standard-Endpoints
Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:
GET /api/v1/skill_definitions— Liste, paginiert + filterbarGET /api/v1/skill_definitions/<id>— Einzelne EntityPOST /api/v1/skill_definitions— AnlegenPATCH /api/v1/skill_definitions/<id>— Teil-UpdateDELETE /api/v1/skill_definitions/<id>— Soft-DeleteGET /api/v1/skill_definitions/<id>/timeline— Audit + Aktivitäten