{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Competency Matrix","description":"Skills matrix mapping employees to required competencies with current and target proficiency levels on a 1–4 Dreyfus-inspired scale (novice / developing / proficient / expert). Supports L&D gap analysis and succession planning; aligns with ISO 30414:2018 human-capital reporting for skills indicators.","type":"object","additionalProperties":false,"required":["entity","period","competencies","employees","summary_stats","reviewed_by"],"$defs":{"competency":{"type":"object","additionalProperties":false,"required":["id","name","description","proficiency_scale","required_level_for_role"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"proficiency_scale":{"enum":["1_novice","2_developing","3_proficient","4_expert"],"description":"Scale anchor — the minimum level considered meaningful on this scale."},"required_level_for_role":{"type":"integer","minimum":1,"maximum":4}}},"competency_rating":{"type":"object","additionalProperties":false,"required":["competency_id","current_level","target_level","gap"],"properties":{"competency_id":{"type":"string"},"current_level":{"type":"integer","minimum":0,"maximum":4},"target_level":{"type":"integer","minimum":1,"maximum":4},"gap":{"type":"integer","description":"target_level - current_level (derived, persisted for display)."},"development_action_optional":{"type":"string"}}},"employee":{"type":"object","additionalProperties":false,"required":["id","name","role","competency_ratings"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"competency_ratings":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/competency_rating"}}}},"summary_row":{"type":"object","additionalProperties":false,"required":["competency_id","pct_meeting_target","gap_count"],"properties":{"competency_id":{"type":"string"},"pct_meeting_target":{"type":"number","minimum":0,"maximum":100},"gap_count":{"type":"integer","minimum":0}}}},"properties":{"entity":{"type":"object","additionalProperties":false,"required":["name","legal_form","registration_number","address"],"properties":{"name":{"type":"string"},"legal_form":{"type":"string"},"registration_number":{"type":"string"},"address":{"type":"string"}}},"department":{"type":"string"},"period":{"type":"object","additionalProperties":false,"required":["label","start_date","end_date"],"properties":{"label":{"type":"string"},"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"}}},"competencies":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/competency"}},"employees":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/employee"}},"summary_stats":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/summary_row"}},"reviewed_by":{"type":"object","additionalProperties":false,"required":["name","title","date"],"properties":{"name":{"type":"string"},"title":{"type":"string"},"date":{"type":"string","format":"date"}}}}}