Bewerken: SpaceMaintenanceActivity (Ruimteonderhoudsactiviteit)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel SpaceMaintenanceActivity-properties worden niet handmatig ingevuld maar door workflows berekend en gevuld. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik `lookup_property_usage("SpaceMaintenanceActivity", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **Kosten- en prijsberekening (`Price`, `UnitPrice`, `FixedPrice`, `CalculatedCost`, `CostYear1`…`CostYear15`)** — De kostenprognose per jaar wordt niet statisch opgeslagen maar dynamisch herberekend door `SpaceMaintenanceActivity_UpdateCostYears`. Deze workflow leest `CalculationMethod`, `Quantity`, `UnitPrice` en `FixedPrice` en verdeelt de resulterende `Price` over de jaarkolommen (`CostYear1` t/m `CostYear15`) op basis van de geplande uitvoermomenten. `MaintenancePartActivity_CalculationUpdates` herberekent `UnitPrice` wanneer de onderliggende MaintenancePartActivity wijzigt (bijv. bij een tariefwijziging). Consultanttip: pas je een eenheidsprijs aan op de MaintenancePartActivity, dan werkt `MaintenancePartActivity_CalculationUpdates` de UnitPrice bij, waarna `SpaceMaintenanceActivity_UpdateCostYears` de jaarkolommen opnieuw vult — controleer altijd beide stappen bij massale tariefwijzigingen.

- **Onderhoudsfrequentie en -methode (`MaintenanceFrequency`, `MaintenanceFrequencyMethod`)** — `MaintenanceFrequency` (aantal keer per planningshorizon) wordt bij activatie gevuld door `MaintenancePart_PreActivate_AddAlterSpaceMaintenanceActivity` en na wijzigingen bijgewerkt door `MaintenancePartActivity_CalculationUpdates` en `SpaceMaintenanceActivity_InsertActivityMoments`. `MaintenanceFrequencyMethod` (period-based of condition-based) wordt gelezen door `SpaceMaintenanceActivity_InsertActivityMoments` en `SpaceMaintenanceActivity_UpdateMaintenanceMoments` om te bepalen hoe de uitvoermomenten worden berekend: bij de period-methode resulteert de frequentie in vaste intervallen; bij de condition-methode stuurt de conditiescore de volgende uitvoering aan.

- **Uitvoermomenten en volgend onderhoudsjaar (`NextMaintenanceYear`, `NextMaintenanceYearInspector`, `ActivityMoments`)** — `SpaceMaintenanceActivity_UpdateMaintenanceMoments` is de centrale workflow die op basis van `MaintenanceFrequency`, `MaintenanceFrequencyMethod` en de verstreken uitvoering het `NextMaintenanceYear` herberekent. `SpaceMaintenanceActivity_InsertActivityMoments` maakt de onderliggende `ActivityMoments`-records aan (één per gepland uitvoerjaar). `NextMaintenanceYearInspector` is het veld dat de inspecteur ter plekke kan corrigeren: `Mobile_SpaceMaintenanceActivity_ChangeYearAccordingToInspector` schrijft dit veld vanuit de mobiele app, waarna `YearPlanScenario_PreDefinitive_UpdateYearPlanScenarioLine` de definitieve scenarioregel bijwerkt. Consultanttip: `NextMaintenanceYear` is het systeemjaar; `NextMaintenanceYearInspector` is de handmatige override — bij het definitief maken van een scenario wint de inspecteur-waarde.

- **Gecorrigeerd bouwjaar en levensduur (`AdjustedConstructionYear`)** — Bij de initiële aanmaak of bij een gebouwjaarswijziging berekent `SpaceMaintenanceActivity_CalculateAdjustedConstructionYear` het gecorrigeerde bouwjaar op basis van het gekoppelde `YearPlan`. `LongTermAsset_ChangeBuildingYear` schrijft dit veld ook als het bouwjaar van het langetermijn-asset wordt aangepast. Het gecorrigeerde bouwjaar wordt gebruikt door `YearPlanScenario_CreateLtapLines` en `YearPlanScenario_CreateScenarioLines` bij het opbouwen van scenarioregels, zodat de restlevensduurberekening klopt bij deelrenovaties.

- **Statusbeheer en activering (`Status`, `Active`)** — De activiteit doorloopt de statussen via dedicated workflows: `SpaceMaintenanceActivity_Activate` en `SpaceMaintenanceActivity_Deactivate` schakelen tussen Active (4) en andere statussen; `SpaceMaintenanceActivity_PreTrash` bewaakt de verwijdering. De boolean `Active` (default 0) wordt door `SpaceMaintenanceActivity_PreActivate`, `SpaceMaintenanceActivity_PreExpired` en `SpaceMaintenanceActivity_PreOpen` gezet en bepaalt of de activiteit meedraait in kostenberekeningen en jaarplanopbouw. `SpaceMaintenanceActivity_Reactivate` herstart een inactieve activiteit en filtert op `Active` en `Quantity` om te bepalen of heractivering zinvol is.

- **Jaarplanscenario-koppeling (`YearPlan`, `PreviousYearPlan`, `LastMaintenanceYear`)** — Bij het aanmaken van een concept-scenario schrijft `YearPlanScenario_PostConcept` de velden `YearPlan`, `PreviousYearPlan`, `LastMaintenanceYear`, `NextMaintenanceYear` en de bijbehorende "PreviousYearPlan"-varianten. Bij definitief maken van een scenario (`YearPlanScenario_PreDefinitive` en `YearPlanScenario_PreDefinitive_UpdateYearPlanScenarioLine`) worden deze velden definitief vastgelegd en worden `MaintenanceFrequency` en `NextMaintenanceYearInspector` geüpdatet vanuit de gekozen scenarioregel. `YearPlanScenario_CreateScenarioLines` en `YearPlanScenario_CreateLtapLines` lezen vervolgens `LastMaintenanceYear`, `AdjustedConstructionYear` en `NextMaintenanceYear` om de scenarioregels op te bouwen.

---