Jun 24 - Implement devices tracker - Update

app/models/api_token.py

@@ -10,9 +10,9 @@ RefreshToken
     Revocation is instant: delete the row.
 
 DeviceToken
-    One row per (user, device) pair.  Stores the APNs token so the server
-    can push notifications to the device.  Updated on every app launch
-    because APNs tokens can rotate.
+    One row per (user, device) pair.  Stores device info so the admin can
+    see all installed devices and their versions.  Updated on every app
+    launch because APNs tokens can rotate.
 """
 
 import secrets
@@ -100,25 +100,28 @@ class RefreshToken(db.Model):
 
 class DeviceToken(db.Model):
     """
-    APNs device token for push notification delivery.
+    Device record for admin tracking and optional APNs push delivery.
 
     One row per (user, device_id) pair — upserted on every app launch.
-    The apns_token is the hex string returned by the iOS SDK.
+    apns_token is optional (empty string when APNs push is not configured).
+    ios_version and last_seen_at added in phase31 for the admin Devices page.
     """
     __tablename__ = 'api_device_tokens'
 
-    id          = db.Column(db.Integer, primary_key=True)
-    user_id     = db.Column(
+    id            = db.Column(db.Integer, primary_key=True)
+    user_id       = db.Column(
         db.Integer,
         db.ForeignKey('users.id', ondelete='CASCADE'),
         nullable=False,
         index=True,
     )
-    device_id   = db.Column(db.String(64),  nullable=False)   # UIDevice.identifierForVendor
-    apns_token  = db.Column(db.String(200), nullable=False)
-    device_name = db.Column(db.String(100), nullable=True)
-    app_version = db.Column(db.String(20),  nullable=True)
-    registered_at = db.Column(db.DateTime, nullable=False, default=now_eastern)
+    device_id     = db.Column(db.String(64),  nullable=False)
+    apns_token    = db.Column(db.String(200), nullable=False, default='')
+    device_name   = db.Column(db.String(100), nullable=True)
+    app_version   = db.Column(db.String(20),  nullable=True)
+    ios_version   = db.Column(db.String(20),  nullable=True)
+    registered_at = db.Column(db.DateTime,    nullable=False, default=now_eastern)
+    last_seen_at  = db.Column(db.DateTime,    nullable=True)
 
     __table_args__ = (
         db.UniqueConstraint('user_id', 'device_id', name='uq_device_token_user_device'),