06/18 Phase 7

app/models/__init__.py

@@ -12,8 +12,9 @@ from app.models.payments import Subscription, Transaction, Boost
 from app.models.ads import Ad, Sponsor, PromotedKeyword
 from app.models.audit import AuditLog
 from app.models.setting import Setting
+from app.models.review import Review
 
 __all__ = ["Plan", "User", "TrustEvent", "Category", "Listing",
            "ListingImage", "ZipGeo", "Metro", "Conversation", "Message",
            "Favorite", "Report", "Subscription", "Transaction", "Boost",
-           "Ad", "Sponsor", "PromotedKeyword", "AuditLog", "Setting"]
+           "Ad", "Sponsor", "PromotedKeyword", "AuditLog", "Setting", "Review"]

app/models/review.py

@@ -0,0 +1,34 @@
+"""Seller reviews — left by buyers after a listing is marked sold."""
+from datetime import datetime
+from app.extensions import db
+
+
+class Review(db.Model):
+    __tablename__ = "reviews"
+
+    id = db.Column(db.BigInteger().with_variant(db.Integer, "sqlite"),
+                   primary_key=True, autoincrement=True)
+    listing_id = db.Column(db.BigInteger().with_variant(db.Integer, "sqlite"),
+                           db.ForeignKey("listings.id"), nullable=False, index=True)
+    author_id = db.Column(db.BigInteger().with_variant(db.Integer, "sqlite"),
+                          db.ForeignKey("users.id"), nullable=False, index=True)
+    seller_id = db.Column(db.BigInteger().with_variant(db.Integer, "sqlite"),
+                          db.ForeignKey("users.id"), nullable=False, index=True)
+    rating = db.Column(db.SmallInteger, nullable=False)   # 1–5
+    body = db.Column(db.Text, nullable=True)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False)
+
+    listing = db.relationship("Listing",
+                              backref=db.backref("reviews", lazy="dynamic"))
+    author = db.relationship("User", foreign_keys=[author_id],
+                             backref=db.backref("reviews_written", lazy="dynamic"))
+    seller = db.relationship("User", foreign_keys=[seller_id],
+                             backref=db.backref("reviews_received", lazy="dynamic"))
+
+    __table_args__ = (
+        db.UniqueConstraint("listing_id", "author_id", name="uq_review_listing_author"),
+        db.CheckConstraint("rating BETWEEN 1 AND 5", name="ck_review_rating"),
+    )
+
+    def __repr__(self):
+        return f"<Review L{self.listing_id} by u{self.author_id} {self.rating}*>"