Feature Gemeenschappelijke parkeerruimten

README.md

@@ -1199,3 +1199,11 @@ De VERA-referentiedata biedt nog geen mogelijkheid om aan te geven dat een eenhe
 ### Installaties
 
 Installaties zouden toegevoegd moeten worden aan het VERA model `EenhedenRuimte`. Het attribuut `installaties` bestaat al in de wiki, maar nog niet in de `vera-openapi` repository: https://github.com/Aedes-datastandaarden/vera-openapi/issues/70
+
+### Aantal
+
+Het attribuut `Eenhedenruimte.aantal` is als uitbreiding op het VERA-model toegevoegd. Hierdoor is het mogelijk om aan te geven hoeveel van deze specifieke ruimte er zijn. Dit attribuut wordt uitsluitend gebruikt in het berekenen van de punten voor Gemeenschappelijke Parkeerruimten. Hier door is het niet nodig om elk parkeervak van een parkeergarage of parkeerterrein mee te geven aan een eenheid.
+
+### Parkeergelegenheden
+
+Als uitbreiding op de referentiedata is de `Ruimtesoort.Parkeergelegenheid` toegevoegd. Daarnaast zijn er verschillende parkerruimten (`Ruimtedetailsoort`) toegevoegd. Deze uitbreidingen zijn overgenomen vanuit de github issue https://github.com/Aedes-datastandaarden/vera-referentiedata/issues/110#issuecomment-2190641829.

docs/implementatietoelichting-beleidsboeken/zelfstandige_woonruimten.md

@@ -760,6 +760,9 @@ Voorbeeld
 
 ### 10.1 Puntentoekenning
 
+> Bij het rekenvoorbeeld aan het einde van deze rubriek wordt uitgelegd hoe de woningwaardering package te gebruiken is om een eenheid te waarderen op de rubriek gemeenschappelijke parkeerruimten.
+
+
 Voor verschillende typen gemeenschappelijke parkeerplekken, afhankelijk van afdekking van de buitenlucht, worden punten toegekend:
 
 *   Type I: parkeerplek in afgesloten parkeergarage behorende tot het complex krijgt 9 punten, gedeeld door het aantal adressen dat toegang en gebruiksrecht heeft.
@@ -768,6 +771,11 @@ Voor verschillende typen gemeenschappelijke parkeerplekken, afhankelijk van afde
 
 2 extra punten worden toegekend, gedeeld door het aantal adressen dat toegang en gebruiksrecht heeft, als de parkeerplek beschikt over een laadpaal voor elektrisch rijden, en exclusief is voor gebruik door bewoners.
 
+> Onderstaande `Ruimtedetailsoorten` corresponderen met bovenstaande parkeerplek types:
+> - Type I: `Ruimtedetailsoort.parkeervak_auto_binnen` met code `VAI`
+> - Type II: `Ruimtedetailsoort.carport` met code `CAR`
+> - Type III: `Ruimtedetailsoort.parkeervak_auto_buiten_niet_overdekt` met code `VAU`
+
 ### 10.2 Definitie gemeenschappelijke parkeerruimte en laadpaal
 
 Een gemeenschappelijke parkeerruimte is een ruimte die toegankelijk is voor bewoners van tenminste twee adressen die daar exclusief gebruiksrecht op hebben, waarin zich tenminste één parkeerplek bevindt (zoals een gemeenschappelijke parkeergarage onder een wooncomplex of een gemeenschappelijke parkeerplaats buiten met één of meerdere parkeerplekken). De parkeerplek mag niet openbaar te gebruiken zijn, maar moet bij een complex of adres horen en in de huurovereenkomst moet exclusief gebruiksrecht zijn toegekend.
@@ -799,6 +807,67 @@ Tien adressen delen vijf type II-parkeerplekken met laadpaal en twee type III-pa
 2.  48 / 10 adressen = 4,8 per adres.
 3.  Afronden geschiedt op een kwart punt per adres, in dit voorbeeld dus op 4,75.
 
+> Omdat de woningwaardering package op eenheidniveau de punten voor het woningwaarderingstelsel berekent, is het niet mogelijk om `Ruimtedetailsoort.parkeergarage` en `Ruimtedetailsoort.parkeerterrein` te waarderen. Deze twee ruimtedetailsoorten maken bovenstaande berekening, waarbij de verschillende types geteld worden, met het huidige VERA-model te complex. Om punten te krijgen voor deze rubriek moeten de type parkeervakken los worden ingeschoten. Daartoe is het attribuut `Eenhedenruimte.aantal` als uitbreiding op het VERA-model toegevoegd. Hierdoor is het mogelijk om aan te geven hoeveel van bovenstaande parkertypes de eenheid toegang heeft zonder dat elk parkeervak van een parkeergarage of parkeerterrein meegegeven dient te worden. Daarnaast is ook `Eenhedenruimte.gedeeld_met_aantal_eenheden` als uitbreiding toegevoegd. Dit attribuut dient ook op elk type parkeerplek meegegeven te worden. Om bovenstaand rekenvoorbeeld door de woningwaardering package te laten berekenen, kunnen de gemeenschappelijke parkeerplekken als volgt (in JSON-formaat) meegegeven worden.
+
+
+```json
+{
+  "id": "12006000004",
+  "ruimten": [
+    {
+      "id": "1",
+      "gedeeld_met_aantal_eenheden": 10,
+      "aantal": 5,
+      "soort": {
+        "code": "PAR",
+        "naam": "Parkeergelegenheid"
+      },
+      "detailSoort": {
+        "code": "CAR",
+        "naam": "Carport"
+      },
+      "naam": "Carport",
+      "oppervlakte": 12,
+      "breedte": 3,
+      "lengte": 4,
+      "bouwkundigeElementen": [
+        {
+          "id": "laadpaal_1",
+          "naam": "Laadpaal",
+          "soort": {
+            "code": "Voo",
+            "naam": "Voorziening"
+          },
+          "detailSoort": {
+            "code": "LAA",
+            "naam": "Laadpaal"
+          }
+        }
+      ]
+    },
+    {
+      "id": "2",
+      "gedeeld_met_aantal_eenheden": 10,
+      "aantal": 2,
+      "soort": {
+        "code": "PAR",
+        "naam": "Parkeergelegenheid"
+      },
+      "detailSoort": {
+        "code": "VAU",
+        "naam": "Parkeervak auto (buiten, niet overdekt)"
+      },
+      "naam": "Parkeervak buiten",
+      "oppervlakte": 12,
+      "breedte": 3,
+      "lengte": 4
+    }
+  ]
+}
+```
+> Let op: in bovenstaand voorbeeld, wanneer een laadpaal als bouwkundig element wordt meegegeven, wordt deze bij de ruimte ook keer het `Eenhedenruimte.aantal` meegeteld voor het berekenen van de punten. In bovenstaand voorbeeld wordt de laadpaal dus vijf (5) keer meegeteld.
+
+
 ## Rubriek 11 Punten voor de WOZ-waarde
 
 Een groot deel van het totale puntenaantal wordt bepaald door de punten die een woonruimte krijgt voor de WOZ-waarde van het gehuurde. WOZ staat voor Wet waardering onroerende zaken. De WOZ-waarde geeft de geschatte marktwaarde van de woning weer zoals volgt uit de Wet waardering onroerende zaken. Deze waarde wordt in principe ieder kalenderjaar door de gemeente vastgesteld, die in de WOZ-beschikking van de desbetreffende woning wordt weergegeven. De waardepeildatum van de WOZ-waarde ligt op 1 januari van het voorafgaande kalenderjaar. Ter illustratie: de WOZ-waarde in de WOZ-beschikking van 2024 heeft een waardepeildatum van 1 januari 2023.

scripts/genereer_vera_referentiedata.py

@@ -5,7 +5,7 @@
 import time
 from typing import Any, Callable, Pattern, Match
 import unidecode
-from jinja2 import Environment
+from jinja2 import Environment, select_autoescape
 from itertools import groupby
 from operator import itemgetter
 import os
@@ -56,39 +56,89 @@
     key=itemgetter("soort"),
 )
 
-# Count the occurrences of each combination of "soort" and "naam"
-counts = Counter((item["soort"], item["naam"]) for item in active_data)
+
+def resolve_duplicate(
+    duplicate_items: list[dict[str | Any, str | Any]],
+) -> dict[str | Any, str | Any]:
+    print(f"Er zijn {len(duplicate_items)} dezelfde items gevonden:")
+    for idx, item in enumerate(duplicate_items):
+        print("")
+        print(f"{idx + 1}: {item}")
+        print("")
+
+    while True:
+        try:
+            choice = int(
+                input("Geef het nummer van het item dat behouden moet blijven: ")
+            )
+            if 1 <= choice <= len(duplicate_items):
+                return duplicate_items[choice - 1]
+            else:
+                print("Geen geldige keuze. Kies een geldig nummer.")
+        except ValueError:
+            print("Voer een nummer in.")
+
+
+# Count the occurrences of each combination of "soort"/"naam" and "soort"/"code"
+counts_code = Counter((item["soort"], item["code"]) for item in active_data)
+counts_soort_naam = Counter((item["soort"], item["naam"]) for item in active_data)
 
 resolved_parents: dict[str, dict[str | Any, str | Any]] = dict()
 
 # Update the original list by suffixing duplicate names with the corresponding item code
 for item in active_data:
     item["variabele"] = item["naam"]
-    if counts[(item["soort"], item["naam"])] > 1:
+
+    if counts_code[(item["soort"], item["code"])] > 1:
+        duplicates = [
+            active_data_item
+            for active_data_item in active_data
+            if active_data_item["soort"] == item["soort"]
+            and active_data_item["code"] == item["code"]
+        ]
+        if len(duplicates) > 1:
+            # Prompt the user to choose one item to keep
+            logger.warning(
+                f"Dubbele soort/code combinatie: {item['soort']}.{item['code']}"
+            )
+            chosen_item = resolve_duplicate(duplicates)
+
+            # Remove the unchosen duplicates from the list
+            active_data = [
+                d for d in active_data if d == chosen_item or d not in duplicates
+            ]
+
+    elif counts_soort_naam[(item["soort"], item["naam"])] > 1:
         logger.warning(
             f"Dubbele soort/naam combinatie: {item['soort']}.{item['code']} {item['naam']}"
         )
         logger.info(
             f"Variabele naam \"{item['variabele']}\" wordt vervangen door \"{item['variabele']} {item['code']}\""
         )
         item["variabele"] += " " + item["code"]
+
+    # Resolve parent information if the parent is not None or an empty string
     if item["parent"] is not None and item["parent"] != "":
         resolved_parent = resolved_parents.get(item["parent"])
+
         if resolved_parent is None:
             parent_soort = item["parent"].split(".")[0]
             parent_code = item["parent"].split(".")[1]
+
             parents = [
                 active_data_item
                 for active_data_item in active_data
                 if active_data_item["soort"] == parent_soort
                 and active_data_item["code"] == parent_code
             ]
+
             if parents is not None and len(parents) == 1:
                 resolved_parent = resolved_parents[item["parent"]] = parents[0]
             else:
                 logger.debug(
                     f"{len(parents)} parents gevonden voor {item['parent']}, verwachtte er 1"
                 )
+
         if resolved_parent is not None:
             item["parentcode"] = resolved_parent["code"]
             item["parentnaam"] = resolved_parent["naam"]
@@ -101,7 +151,7 @@
 # Group items by 'soort'
 grouped_data = [(k, list(g)) for k, g in groupby(active_data, key=itemgetter("soort"))]
 
-environment = Environment(autoescape=True)
+environment = Environment(autoescape=select_autoescape())
 
 
 def regex_replace(
@@ -164,18 +214,18 @@ def normalize_variable_name(item: dict[str | Any, str | Any]) -> str:
 class {{ soort|remove_accents|title }}(Enum):
 {%- for item in items %}
     {{ item|normalize_variable_name }} = Referentiedata(
-        code="{{ item['code'] }}",
-        naam="{{ item['naam'] }}",
-        {%- if item['parent'] %}
+        code="{{ item['code'] | safe }}",
+        naam="{{ item['naam'] | safe }}",
+        {%- if item['parent'] | safe %}
         parent=Referentiedata(
-            code="{{ item['parentcode'] }}",
-            naam="{{ item['parentnaam'] }}",
+            code="{{ item['parentcode'] | safe}}",
+            naam="{{ item['parentnaam'] | safe}}",
         ),
         {%- endif %}
     )
-    {%- if item['omschrijving'] %}
+    {%- if item['omschrijving'] | safe %}
     \"\"\"
-    {{ item['omschrijving']|split_long_line }}
+    {{ item['omschrijving']|split_long_line | safe }}
     \"\"\"
     {%- endif %}
 {% endfor %}

tests/data/zelfstandige_woonruimten/output/12006000004.json

@@ -244,6 +244,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/20002000126.json

@@ -213,6 +213,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/20004000156.json

@@ -236,6 +236,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/23003000050.json

@@ -261,6 +261,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/23109000031.json

@@ -238,6 +238,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/25048000007.json

@@ -243,6 +243,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {

tests/data/zelfstandige_woonruimten/output/28018000044.json

@@ -271,6 +271,20 @@
       "punten": 0.0,
       "woningwaarderingen": []
     },
+    {
+      "criteriumGroep": {
+        "stelsel": {
+          "code": "ZEL",
+          "naam": "Zelfstandige woonruimten"
+        },
+        "stelselgroep": {
+          "code": "GPA",
+          "naam": "Gemeenschappelijke parkeerruimten"
+        }
+      },
+      "punten": 0.0,
+      "woningwaarderingen": []
+    },
     {
       "criteriumGroep": {
         "stelsel": {