Reference & Data Model
Overview
Three entities, all attached to a project, program or portfolio; the system derives traffic lights, trends and visibility across levels from them.
What defines this data type
Section titled “What defines this data type”Knowledge data are judgments, not plan values. A status report (state_report) is a dated snapshot with six assessments (state_assessment) in the traffic-light scheme green/yellow/red. A key takeaway (key_takeaway) is a lesson, organized by category (category_of_takeaway) and type (type_of_takeaway).
All three entities carry three optional references – project, program, portfolio – of which exactly one is set. It determines the level („Ursprung“, origin) of the entry. None of this is generated by the system; every traffic light is a human assessment.
Entities and relations
Section titled “Entities and relations”Portfolio ──┐Program ──┼─ belongs to (exactly one level) ──┬─ state_report ──< state_assessment (6 per report)Project ──┘ └─ key_takeaway ──> type_of_takeaway ──> category_of_takeaway
Visibility across levels: Traffic lights (last report) Project → Program → Portfolio (upwards, display only) Key takeaways Project → Program → Portfolio (upwards, read only)| Entity | Purpose | Where in the app |
|---|---|---|
Status report (state_report) |
Dated snapshot with title and six traffic lights | Project/Program › tab „Statusberichte“ – Guides › Status reports, Guides › Status report editor |
Assessment (state_assessment) |
Traffic-light value plus comment per area of a report | in the report, dialog „Bewertungsdetails öffnen“ |
Key takeaway (key_takeaway) |
Lesson with category and type | Insights tabs › „Erkenntnisse“, own page /takeaways/<id> – Guides › Portfolio insights |
Category / type (category_of_takeaway, type_of_takeaway) |
Selection lists for key takeaways | Selection field in the key takeaway, can also be created there |
Connections to other chapters
Section titled “Connections to other chapters”- Carriers are the planning objects from Project, Program and Portfolio. Archiving or deleting a carrier takes all knowledge data with it (
cascade). - The traffic lights of the last report feed the status KPIs in Status & traffic lights.
- Key takeaways can carry files, see File link.
- Measures and initiatives in the insights tab „Maßnahmen & Initiativen“ are not knowledge data but risk measures and opportunity initiatives.