Reference & Data Model
Planned cost (planned_cost)
A planned cost is an expected cost position; the system keeps its own planned costs continuously up to date.
Purpose
Section titled “Purpose”Planned costs form the cost forecast of a cost item (project data). They are entered manually or derived by the system from resource planning, procurement requests and risks. Unlike cost events they are not a journal: manual rows can be changed freely, system rows are updated along with their source.
Where in the app
Section titled “Where in the app”Detail view of the cost item › section „Kosten“ (Costs) › list „Plan-Positionen“ (Planned costs) with totals row, „+“ („Plan-Position hinzufügen“, Add planned cost), context menu „Details“ / „Löschen“ (Delete). Double-click opens the dialog „Plan-Position“. See Guides › Financial performance.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Amount | cost_value |
Amount | yes | Expected costs | System rows: locked |
| Occurred on | occurred_at |
Date | yes | Date of the expected costs | cannot be changed after creation |
| Description | description |
Text | yes (may be empty) | Label | System rows: provenance text instead of description |
| Creation kind | generated_from_system |
Yes/No | yes | „Manuell“ (manual, blue) or „Systemgeneriert“ (system-generated, grey) | System |
| Source | rule_key, source_id |
Reference | no | Rule and source row | System; shown as text and link |
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| Cost item | belongs to | yes | archived along | deleted along |
| Project | belongs to | yes | archived along | deleted along |
Rules & automation
Section titled “Rules & automation”- Manual planned costs: amount and description editable, deletion allowed. System rows: immutable for users; the server rejects every change. The creation kind can never be set to „Systemgeneriert“.
- Generating rules (kept in sync: source changed → new amount, source deleted → planned cost gone):
- Employee usage → „Geplante Personalkosten aus Ressourcenplanung“ (planned personnel costs from resource planning) (Rule)
- Purchase request → „Geplante Materialkosten aus Einkaufsaufforderung“ (planned material costs from purchase request); stock request, while „offen“ (open) → „Materialkosten aus Lagerentnahme“ (material costs from stock withdrawal) (Rule)
- Active risk → „Erwartete Risikokosten“ (expected risk costs) = damage value × (probability − prevention reduction) (Rule)
Card „Geplante Kosten“ (Planned costs) = Σ planned costs; column „Geplant“ = max(0, planned − actual) per cost item; forecast costs (portfolio) = actual + planned. See Budget KPIs.