Refactor models to implement ValidatableMixin; add validation logic for state management in Area, Brand, Item, Room, and RoomFunction classes

models/areas.py

@@ -7,9 +7,11 @@ from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from . import db
 from ..temp import is_temp_id
+from ..utils.validation import ValidatableMixin
 
-class Area(db.Model):
+class Area(ValidatableMixin, db.Model):
     __tablename__ = 'Areas'
+    VALIDATION_LABEL = "Area"
 
     id: Mapped[int] = mapped_column("ID", Integer, Identity(start=1, increment=1), primary_key=True)
     name: Mapped[Optional[str]] = mapped_column("Area", Unicode(255), nullable=True)
@@ -96,3 +98,26 @@ class Area(db.Model):
             **{str(temp): real for temp, real in temp_id_map.items()}  # "temp-1" → 5
         }
         return id_map
+
+    @classmethod
+    def validate_state(cls, submitted_items: list[dict]) -> list[str]:
+        errors = []
+
+        for index, item in enumerate(submitted_items):
+            if not isinstance(item, dict):
+                errors.append(f"Area entry #{index + 1} is not a valid object.")
+                continue
+
+            name = item.get('name')
+            if not name or not str(name).strip():
+                errors.append(f"Area entry #{index + 1} is missing a name.")
+
+            raw_id = item.get('id')
+            if raw_id is not None:
+                try:
+                    _ = int(raw_id)
+                except (ValueError, TypeError):
+                    if not is_temp_id(raw_id):
+                        errors.append(f"Area entry #{index + 1} has invalid ID: {raw_id}")
+
+        return errors

models/brands.py

@@ -7,9 +7,11 @@ from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from . import db
 from ..temp import is_temp_id
+from ..utils.validation import ValidatableMixin
 
-class Brand(db.Model):
+class Brand(ValidatableMixin, db.Model):
     __tablename__ = 'Brands'
+    VALIDATION_LABEL = 'Brand'
 
     id: Mapped[int] = mapped_column("ID", Integer, Identity(start=1, increment=1), primary_key=True)
     name: Mapped[Optional[str]] = mapped_column("Brand", Unicode(255), nullable=True)
@@ -89,4 +91,25 @@ class Brand(db.Model):
         }
         return id_map
 
+    @classmethod
+    def validate_state(cls, submitted_items: list[dict]) -> list[str]:
+        errors = []
 
+        for index, item in enumerate(submitted_items):
+            if not isinstance(item, dict):
+                errors.append(f"Area entry #{index + 1} is not a valid object.")
+                continue
+            
+            name = item.get('name')
+            if not name or not str(name).strip():
+                errors.append(f"Area entry #{index + 1} is missing a name.")
+
+            raw_id = item.get('id')
+            if raw_id is not None:
+                try:
+                    _ = int(raw_id)
+                except (ValueError, TypeError):
+                    if not is_temp_id(raw_id):
+                        errors.append(f"Area entry #{index + 1} has invalid ID: {raw_id}")
+
+        return errors

models/items.py

@@ -7,9 +7,11 @@ from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from . import db
 from ..temp import is_temp_id
+from ..utils.validation import ValidatableMixin
 
-class Item(db.Model):
+class Item(ValidatableMixin, db.Model):
     __tablename__ = 'Items'
+    VALIDATION_LABEL = 'Item'
 
     id: Mapped[int] = mapped_column("ID", Integer, Identity(start=1, increment=1), primary_key=True)
     description: Mapped[Optional[str]] = mapped_column("Description", Unicode(255), nullable=True)
@@ -89,3 +91,26 @@ class Item(db.Model):
             **{str(temp): real for temp, real in temp_id_map.items()}
         }
         return id_map
+    
+    @classmethod
+    def validate_state(cls, submitted_items: list[dict]) -> list[str]:
+        errors = []
+
+        for index, item in enumerate(submitted_items):
+            if not isinstance(item, dict):
+                errors.append(f"Area entry #{index + 1} is not a valid object.")
+                continue
+            
+            name = item.get('name')
+            if not name or not str(name).strip():
+                errors.append(f"Area entry #{index + 1} is missing a name.")
+
+            raw_id = item.get('id')
+            if raw_id is not None:
+                try:
+                    _ = int(raw_id)
+                except (ValueError, TypeError):
+                    if not is_temp_id(raw_id):
+                        errors.append(f"Area entry #{index + 1} has invalid ID: {raw_id}")
+
+        return errors

models/room_functions.py

@@ -7,9 +7,11 @@ from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from . import db
 from ..temp import is_temp_id
+from ..utils.validation import ValidatableMixin
 
-class RoomFunction(db.Model):
+class RoomFunction(ValidatableMixin, db.Model):
     __tablename__ = 'Room Functions'
+    VALIDATION_LABEL = "Function"
 
     id: Mapped[int] = mapped_column("ID", Integer, Identity(start=1, increment=1), primary_key=True)
     description: Mapped[Optional[str]] = mapped_column("Function", Unicode(255), nullable=True)

models/rooms.py

@@ -10,8 +10,11 @@ from sqlalchemy.orm import Mapped, mapped_column, relationship
 
 from . import db
 
-class Room(db.Model):
+from ..utils.validation import ValidatableMixin
+
+class Room(ValidatableMixin, db.Model):
     __tablename__ = 'Rooms'
+    VALIDATION_LABEL = "Room"
 
     id: Mapped[int] = mapped_column("ID", Integer, Identity(start=1, increment=1), primary_key=True)
     name: Mapped[Optional[str]] = mapped_column("Room", Unicode(255), nullable=True)    
@@ -141,4 +144,38 @@ class Room(db.Model):
             room = existing_by_id[existing_id]
             db.session.delete(room)
             print(f"🗑️ Removing room: {room.name}")
-
+    
+    @classmethod
+    def validate_state(cls, submitted_items: list[dict]) -> list[str]:
+        errors = []
+    
+        for index, item in enumerate(submitted_items):
+            label = f"Room #{index + 1}"
+    
+            if not isinstance(item, dict):
+                errors.append(f"{label} is not a valid object.")
+                continue
+            
+            name = item.get("name")
+            if not name or not str(name).strip():
+                errors.append(f"{label} is missing a name.")
+    
+            raw_id = item.get("id")
+            if raw_id is not None:
+                try:
+                    _ = int(raw_id)
+                except (ValueError, TypeError):
+                    if not str(raw_id).startswith("room-"):
+                        errors.append(f"{label} has an invalid ID: {raw_id}")
+    
+            # These fields are FK IDs, so we're just checking for valid formats here.
+            for fk_field, fk_label in [("section_id", "Section"), ("function_id", "Function")]:
+                fk_val = item.get(fk_field)
+                if fk_val is not None:
+                    try:
+                        _ = int(fk_val)
+                    except (ValueError, TypeError):
+                        if not isinstance(fk_val, str) or not fk_val.startswith("temp-"):
+                            errors.append(f"{label} has invalid {fk_label} ID: {fk_val}")
+    
+        return errors