Skip to content

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.

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.

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