Initial commit: enterprise digital platform with portal SSO, DigiServer, IT Assets, NetworkView, Server Monitor

digiserver-v2/app/models/player_feedback.py

@@ -0,0 +1,64 @@
+"""Player feedback model for tracking player status and errors."""
+from datetime import datetime
+from typing import Optional
+
+from app.extensions import db
+
+
+class PlayerFeedback(db.Model):
+    """Player feedback model for tracking player status updates.
+    
+    Attributes:
+        id: Primary key
+        player_id: Foreign key to player
+        status: Current status (playing, paused, error, unknown)
+        current_content_id: ID of currently playing content
+        message: Optional status message
+        error: Optional error message
+        timestamp: Feedback timestamp
+    """
+    __tablename__ = 'player_feedback'
+    
+    id = db.Column(db.Integer, primary_key=True)
+    player_id = db.Column(db.Integer, db.ForeignKey('player.id'), 
+                         nullable=False, index=True)
+    status = db.Column(db.String(50), nullable=False, default='unknown')
+    current_content_id = db.Column(db.Integer, db.ForeignKey('content.id'), 
+                                   nullable=True)
+    message = db.Column(db.Text, nullable=True)
+    error = db.Column(db.Text, nullable=True)
+    timestamp = db.Column(db.DateTime, default=datetime.utcnow, 
+                         nullable=False, index=True)
+    
+    # Relationships
+    player = db.relationship('Player', back_populates='feedback')
+    content = db.relationship('Content', backref='feedback_entries')
+    
+    def __repr__(self) -> str:
+        """String representation of PlayerFeedback."""
+        return f'<PlayerFeedback Player={self.player_id} Status={self.status}>'
+    
+    @property
+    def is_error(self) -> bool:
+        """Check if feedback indicates an error."""
+        return self.status == 'error' or self.error is not None
+    
+    @property
+    def age_seconds(self) -> float:
+        """Get age of feedback in seconds."""
+        delta = datetime.utcnow() - self.timestamp
+        return delta.total_seconds()
+    
+    @classmethod
+    def get_latest_for_player(cls, player_id: int) -> Optional['PlayerFeedback']:
+        """Get most recent feedback for a player.
+        
+        Args:
+            player_id: Player ID to query
+            
+        Returns:
+            Latest PlayerFeedback instance or None
+        """
+        return cls.query.filter_by(player_id=player_id)\
+            .order_by(cls.timestamp.desc())\
+            .first()