feat: add WatchMedium field, general review editing, configurable deploy

- WatchMedium enum (cinema/streaming/tv/physical_media/download/media_server/other)
- PATCH /api/v1/reviews/:id partial update (rating, comment, watched_at, watch_medium)
- edit_review use case w/ ownership + remote review guard, best-effort AP Update broadcast
- SPA: icon picker, edit sheet (long-press mobile / pencil desktop), watch medium badge
- shared ReviewFormFields, EditableContextMenu, parse_watched_at/format_watched_at
- deploy.sh parameterized (--features, --tag), CORS allows PATCH
- CONTEXT.md glossary, ADR-0001 general review editing

crates/domain/src/models/review.rs

@@ -2,7 +2,7 @@ use chrono::{NaiveDateTime, Utc};
 
 use crate::{
     errors::DomainError,
-    value_objects::{Comment, MovieId, Rating, ReviewId, UserId},
+    value_objects::{Comment, MovieId, Rating, ReviewId, UserId, WatchMedium},
 };
 
 use super::movie::Movie;
@@ -25,6 +25,16 @@ pub struct PersistedReview {
     pub watched_at: NaiveDateTime,
     pub created_at: NaiveDateTime,
     pub source: ReviewSource,
+    pub watch_medium: Option<WatchMedium>,
+}
+
+/// Partial update for a review. `None` = unchanged, `Some(None)` = clear, `Some(Some(v))` = set.
+#[derive(Clone, Debug, Default)]
+pub struct ReviewEdit {
+    pub rating: Option<Rating>,
+    pub comment: Option<Option<Comment>>,
+    pub watched_at: Option<NaiveDateTime>,
+    pub watch_medium: Option<Option<WatchMedium>>,
 }
 
 #[derive(Clone, Debug)]
@@ -37,6 +47,7 @@ pub struct Review {
     watched_at: NaiveDateTime,
     created_at: NaiveDateTime,
     source: ReviewSource,
+    watch_medium: Option<WatchMedium>,
 }
 
 impl Review {
@@ -46,6 +57,7 @@ impl Review {
         rating: Rating,
         comment: Option<Comment>,
         watched_at: NaiveDateTime,
+        watch_medium: Option<WatchMedium>,
     ) -> Result<Self, DomainError> {
         Ok(Self {
             id: ReviewId::generate(),
@@ -56,6 +68,7 @@ impl Review {
             watched_at,
             created_at: Utc::now().naive_utc(),
             source: ReviewSource::Local,
+            watch_medium,
         })
     }
 
@@ -69,6 +82,27 @@ impl Review {
             watched_at: row.watched_at,
             created_at: row.created_at,
             source: row.source,
+            watch_medium: row.watch_medium,
+        }
+    }
+
+    pub fn apply_edit(&self, edit: ReviewEdit) -> Self {
+        Self {
+            id: self.id.clone(),
+            movie_id: self.movie_id.clone(),
+            user_id: self.user_id.clone(),
+            rating: edit.rating.unwrap_or_else(|| self.rating.clone()),
+            comment: match edit.comment {
+                Some(c) => c,
+                None => self.comment.clone(),
+            },
+            watched_at: edit.watched_at.unwrap_or(self.watched_at),
+            created_at: self.created_at,
+            source: self.source.clone(),
+            watch_medium: match edit.watch_medium {
+                Some(wm) => wm,
+                None => self.watch_medium,
+            },
         }
     }
 
@@ -96,6 +130,9 @@ impl Review {
     pub fn source(&self) -> &ReviewSource {
         &self.source
     }
+    pub fn watch_medium(&self) -> Option<&WatchMedium> {
+        self.watch_medium.as_ref()
+    }
     /// Returns [star1_filled, star2_filled, ..., star5_filled]
     pub fn stars(&self) -> [bool; 5] {
         let r = self.rating.value();
@@ -157,3 +194,7 @@ impl ReviewHistory {
         self.viewings.sort_by_key(|r| *r.watched_at());
     }
 }
+
+#[cfg(test)]
+#[path = "tests/review.rs"]
+mod tests;

crates/domain/src/models/tests/mod.rs

@@ -78,6 +78,7 @@ fn make_review() -> Review {
         Rating::new(4).unwrap(),
         Some(Comment::new("great".into()).unwrap()),
         chrono::Utc::now().naive_utc(),
+        None,
     )
     .unwrap()
 }
@@ -112,6 +113,7 @@ fn review_from_persistence() {
         source: ReviewSource::Remote {
             actor_url: "https://example.com/actor".into(),
         },
+        watch_medium: None,
     });
     assert_eq!(*r.id(), id);
     assert!(r.is_remote());

crates/domain/src/models/tests/review.rs

@@ -0,0 +1,81 @@
+use chrono::NaiveDateTime;
+
+use crate::value_objects::{Comment, MovieId, Rating, UserId, WatchMedium};
+
+use super::*;
+
+fn make_review(watch_medium: Option<WatchMedium>) -> Review {
+    Review::new(
+        MovieId::generate(),
+        UserId::generate(),
+        Rating::new(4).unwrap(),
+        Some(Comment::new("great film".into()).unwrap()),
+        NaiveDateTime::parse_from_str("2024-06-15 20:00:00", "%Y-%m-%d %H:%M:%S").unwrap(),
+        watch_medium,
+    )
+    .unwrap()
+}
+
+#[test]
+fn new_review_stores_watch_medium() {
+    let review = make_review(Some(WatchMedium::Cinema));
+    assert_eq!(review.watch_medium(), Some(&WatchMedium::Cinema));
+}
+
+#[test]
+fn new_review_without_medium() {
+    let review = make_review(None);
+    assert_eq!(review.watch_medium(), None);
+}
+
+#[test]
+fn apply_edit_updates_rating_only() {
+    let original = make_review(Some(WatchMedium::Streaming));
+    let edited = original.apply_edit(ReviewEdit {
+        rating: Some(Rating::new(2).unwrap()),
+        ..Default::default()
+    });
+    assert_eq!(edited.rating().value(), 2);
+    assert_eq!(edited.comment().unwrap().value(), "great film");
+    assert_eq!(edited.watch_medium(), Some(&WatchMedium::Streaming));
+}
+
+#[test]
+fn apply_edit_clears_comment() {
+    let original = make_review(None);
+    let edited = original.apply_edit(ReviewEdit {
+        comment: Some(None),
+        ..Default::default()
+    });
+    assert!(edited.comment().is_none());
+    assert_eq!(edited.rating().value(), 4);
+}
+
+#[test]
+fn apply_edit_sets_watch_medium() {
+    let original = make_review(None);
+    let edited = original.apply_edit(ReviewEdit {
+        watch_medium: Some(Some(WatchMedium::Cinema)),
+        ..Default::default()
+    });
+    assert_eq!(edited.watch_medium(), Some(&WatchMedium::Cinema));
+}
+
+#[test]
+fn apply_edit_clears_watch_medium() {
+    let original = make_review(Some(WatchMedium::Cinema));
+    let edited = original.apply_edit(ReviewEdit {
+        watch_medium: Some(None),
+        ..Default::default()
+    });
+    assert_eq!(edited.watch_medium(), None);
+}
+
+#[test]
+fn apply_edit_no_changes_preserves_all() {
+    let original = make_review(Some(WatchMedium::TV));
+    let edited = original.apply_edit(ReviewEdit::default());
+    assert_eq!(edited.rating().value(), 4);
+    assert_eq!(edited.comment().unwrap().value(), "great film");
+    assert_eq!(edited.watch_medium(), Some(&WatchMedium::TV));
+}