Tell-Me-Mo
diff --git a/‎backend/alembic/versions/6d218df43825_add_item_updates_table.py‎
Lines changed: 49 additions & 0 deletions b/‎backend/alembic/versions/6d218df43825_add_item_updates_table.py‎
Lines changed: 49 additions & 0 deletions
diff --git a/‎backend/alembic/versions/convert_itemupdatetype_enum_to_varchar.py‎
Lines changed: 81 additions & 0 deletions b/‎backend/alembic/versions/convert_itemupdatetype_enum_to_varchar.py‎
Lines changed: 81 additions & 0 deletions
diff --git a/‎backend/alembic/versions/d7d1975698c8_update_itemupdatetype_enum_to_lowercase.py‎
Lines changed: 56 additions & 0 deletions b/‎backend/alembic/versions/d7d1975698c8_update_itemupdatetype_enum_to_lowercase.py‎
Lines changed: 56 additions & 0 deletions
diff --git a/‎backend/models/__init__.py‎
Lines changed: 4 additions & 1 deletion b/‎backend/models/__init__.py‎
Lines changed: 4 additions & 1 deletion
diff --git a/‎backend/models/item_update.py‎
Lines changed: 73 additions & 0 deletions b/‎backend/models/item_update.py‎
Lines changed: 73 additions & 0 deletions
@@ -0,0 +1,49 @@
+"""add_item_updates_table
+
+Revision ID: 6d218df43825
+Revises: dc8704e627ee
+Create Date: 2025-10-14 17:55:39.950950
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import UUID
+
+
+# revision identifiers, used by Alembic.
+revision: str = '6d218df43825'
+down_revision: Union[str, Sequence[str], None] = 'dc8704e627ee'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.create_table(
+        'item_updates',
+        sa.Column('id', UUID(as_uuid=True), primary_key=True),
+        sa.Column('project_id', UUID(as_uuid=True), sa.ForeignKey('projects.id', ondelete='CASCADE'), nullable=False),
+        sa.Column('item_id', UUID(as_uuid=True), nullable=False),
+        sa.Column('item_type', sa.String(50), nullable=False),
+        sa.Column('content', sa.Text(), nullable=False),
+        sa.Column('update_type', sa.Enum('COMMENT', 'STATUS_CHANGE', 'ASSIGNMENT', 'EDIT', 'CREATED', name='itemupdatetype'), nullable=False),
+        sa.Column('author_name', sa.String(100), nullable=False),
+        sa.Column('author_email', sa.String(255), nullable=True),
+        sa.Column('timestamp', sa.DateTime(), nullable=False),
+    )
+
+    # Create indexes for better query performance
+    op.create_index('ix_item_updates_project_id', 'item_updates', ['project_id'])
+    op.create_index('ix_item_updates_item_lookup', 'item_updates', ['project_id', 'item_id', 'item_type'])
+    op.create_index('ix_item_updates_timestamp', 'item_updates', ['timestamp'])
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index('ix_item_updates_timestamp', 'item_updates')
+    op.drop_index('ix_item_updates_item_lookup', 'item_updates')
+    op.drop_index('ix_item_updates_project_id', 'item_updates')
+    op.drop_table('item_updates')
+    op.execute('DROP TYPE itemupdatetype')
@@ -0,0 +1,81 @@
+"""convert_itemupdatetype_enum_to_varchar
+
+Revision ID: convert_enum_to_varchar
+Revises: d7d1975698c8
+Create Date: 2025-10-15 12:00:00.000000
+
+Convert ItemUpdateType enum to VARCHAR for better flexibility and easier migrations
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects.postgresql import ENUM
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'convert_enum_to_varchar'
+down_revision: Union[str, Sequence[str], None] = 'd7d1975698c8'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Convert enum to VARCHAR."""
+
+    # Create a temporary column with VARCHAR type
+    op.add_column('item_updates', sa.Column('update_type_new', sa.String(50), nullable=True))
+
+    # Copy data from enum to varchar, converting to lowercase
+    op.execute("""
+        UPDATE item_updates
+        SET update_type_new = LOWER(update_type::text)
+    """)
+
+    # Make the new column not nullable
+    op.alter_column('item_updates', 'update_type_new', nullable=False)
+
+    # Drop the old enum column
+    op.drop_column('item_updates', 'update_type')
+
+    # Rename the new column to the original name
+    op.alter_column('item_updates', 'update_type_new', new_column_name='update_type')
+
+    # Drop the enum type if it exists
+    op.execute("DROP TYPE IF EXISTS itemupdatetype CASCADE")
+
+    # Add a CHECK constraint to ensure valid values (optional but recommended)
+    op.create_check_constraint(
+        'ck_item_updates_update_type',
+        'item_updates',
+        "update_type IN ('comment', 'status_change', 'assignment', 'edit', 'created')"
+    )
+
+
+def downgrade() -> None:
+    """Convert VARCHAR back to enum."""
+
+    # Remove the check constraint
+    op.drop_constraint('ck_item_updates_update_type', 'item_updates', type_='check')
+
+    # Create the enum type
+    update_type_enum = ENUM('comment', 'status_change', 'assignment', 'edit', 'created', name='itemupdatetype')
+    update_type_enum.create(op.get_bind())
+
+    # Add a temporary enum column
+    op.add_column('item_updates', sa.Column('update_type_old', update_type_enum, nullable=True))
+
+    # Copy data from varchar to enum
+    op.execute("""
+        UPDATE item_updates
+        SET update_type_old = update_type::itemupdatetype
+    """)
+
+    # Make the old column not nullable
+    op.alter_column('item_updates', 'update_type_old', nullable=False)
+
+    # Drop the varchar column
+    op.drop_column('item_updates', 'update_type')
+
+    # Rename the enum column back
+    op.alter_column('item_updates', 'update_type_old', new_column_name='update_type')
@@ -0,0 +1,56 @@
+"""update_itemupdatetype_enum_to_lowercase
+
+Revision ID: d7d1975698c8
+Revises: 6d218df43825
+Create Date: 2025-10-15 09:06:42.854431
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'd7d1975698c8'
+down_revision: Union[str, Sequence[str], None] = '6d218df43825'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema - convert itemupdatetype enum to lowercase values."""
+    # Create new enum with lowercase values
+    op.execute("CREATE TYPE itemupdatetype_new AS ENUM ('comment', 'status_change', 'assignment', 'edit', 'created')")
+
+    # Convert existing data and change column type
+    op.execute("""
+        ALTER TABLE item_updates
+        ALTER COLUMN update_type TYPE itemupdatetype_new
+        USING (LOWER(update_type::text)::itemupdatetype_new)
+    """)
+
+    # Drop old enum type
+    op.execute("DROP TYPE itemupdatetype")
+
+    # Rename new enum to original name
+    op.execute("ALTER TYPE itemupdatetype_new RENAME TO itemupdatetype")
+
+
+def downgrade() -> None:
+    """Downgrade schema - convert itemupdatetype enum back to uppercase values."""
+    # Create old enum with uppercase values
+    op.execute("CREATE TYPE itemupdatetype_old AS ENUM ('COMMENT', 'STATUS_CHANGE', 'ASSIGNMENT', 'EDIT', 'CREATED')")
+
+    # Convert existing data and change column type back
+    op.execute("""
+        ALTER TABLE item_updates
+        ALTER COLUMN update_type TYPE itemupdatetype_old
+        USING (UPPER(update_type::text)::itemupdatetype_old)
+    """)
+
+    # Drop new enum type
+    op.execute("DROP TYPE itemupdatetype")
+
+    # Rename old enum back to original name
+    op.execute("ALTER TYPE itemupdatetype_old RENAME TO itemupdatetype")
@@ -19,6 +19,7 @@
 from .conversation import Conversation
 from .notification import Notification, NotificationType, NotificationPriority, NotificationCategory
 from .support_ticket import SupportTicket, TicketComment, TicketAttachment
+from .item_update import ItemUpdate, ItemUpdateType
 
 __all__ = [
     "Project",
@@ -47,5 +48,7 @@
     "NotificationCategory",
     "SupportTicket",
     "TicketComment",
-    "TicketAttachment"
+    "TicketAttachment",
+    "ItemUpdate",
+    "ItemUpdateType"
 ]
@@ -0,0 +1,73 @@
+from sqlalchemy import Column, String, DateTime, ForeignKey, Text, CheckConstraint
+from sqlalchemy.dialects.postgresql import UUID
+from db.database import Base
+import uuid
+from datetime import datetime
+
+
+# Define valid update types as constants
+class ItemUpdateType:
+    """Update type constants - using strings instead of enum for flexibility."""
+    COMMENT = "comment"
+    STATUS_CHANGE = "status_change"
+    ASSIGNMENT = "assignment"
+    EDIT = "edit"
+    CREATED = "created"
+
+    # List of all valid types for validation
+    ALL_TYPES = [COMMENT, STATUS_CHANGE, ASSIGNMENT, EDIT, CREATED]
+
+    @classmethod
+    def is_valid(cls, update_type: str) -> bool:
+        """Check if an update type is valid."""
+        return update_type in cls.ALL_TYPES
+
+
+class ItemUpdate(Base):
+    __tablename__ = "item_updates"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    project_id = Column(UUID(as_uuid=True), ForeignKey('projects.id', ondelete="CASCADE"), nullable=False)
+
+    # Item reference - polymorphic association
+    item_id = Column(UUID(as_uuid=True), nullable=False)  # ID of the risk/task/blocker/lesson
+    item_type = Column(String(50), nullable=False)  # 'risks', 'tasks', 'blockers', 'lessons'
+
+    # Update content
+    content = Column(Text, nullable=False)
+    # Using String instead of Enum for flexibility
+    update_type = Column(
+        String(50),
+        nullable=False,
+        default=ItemUpdateType.COMMENT,
+        # Add check constraint to ensure valid values
+        info={'valid_values': ItemUpdateType.ALL_TYPES}
+    )
+
+    # Author information
+    author_name = Column(String(100), nullable=False)
+    author_email = Column(String(255))
+
+    # Tracking
+    timestamp = Column(DateTime, default=datetime.utcnow, nullable=False)
+
+    # Add table-level check constraint
+    __table_args__ = (
+        CheckConstraint(
+            f"update_type IN {tuple(ItemUpdateType.ALL_TYPES)}",
+            name='ck_item_updates_update_type'
+        ),
+    )
+
+    def to_dict(self):
+        return {
+            "id": str(self.id),
+            "project_id": str(self.project_id),
+            "item_id": str(self.item_id),
+            "item_type": self.item_type,
+            "content": self.content,
+            "update_type": self.update_type,  # Now it's already a string
+            "author_name": self.author_name,
+            "author_email": self.author_email,
+            "timestamp": self.timestamp.isoformat() if self.timestamp else None,
+        }