app: person enrichment use case + staleness checks

crates/application/src/context.rs

@@ -3,11 +3,11 @@ use std::sync::Arc;
 use domain::ports::{
     AuthService, DiaryExporter, DiaryRepository, DocumentParser, EventPublisher, GoalRepository,
     ImportProfileRepository, ImportSessionRepository, MetadataClient, MovieProfileRepository,
-    MovieRepository, ObjectStorage, PasswordHasher, PersonCommand, PersonQuery,
-    PosterFetcherClient, RemoteGoalRepository, RemoteWatchlistRepository, ReviewRepository,
-    SearchCommand, SearchPort, SocialQueryPort, StatsRepository, UserProfileFieldsRepository,
-    UserRepository, UserSettingsRepository, WatchEventRepository, WatchlistRepository,
-    WebhookTokenRepository, WrapUpRepository, WrapUpStatsQuery,
+    MovieRepository, ObjectStorage, PasswordHasher, PersonCommand, PersonEnrichmentClient,
+    PersonQuery, PosterFetcherClient, RemoteGoalRepository, RemoteWatchlistRepository,
+    ReviewRepository, SearchCommand, SearchPort, SocialQueryPort, StatsRepository,
+    UserProfileFieldsRepository, UserRepository, UserSettingsRepository, WatchEventRepository,
+    WatchlistRepository, WebhookTokenRepository, WrapUpRepository, WrapUpStatsQuery,
 };
 
 use crate::config::AppConfig;
@@ -51,6 +51,7 @@ pub struct Services {
     pub diary_exporter: Arc<dyn DiaryExporter>,
     pub document_parser: Arc<dyn DocumentParser>,
     pub review_logger: Arc<dyn ReviewLogger>,
+    pub person_enrichment: Option<Arc<dyn PersonEnrichmentClient>>,
 }
 
 #[derive(Clone)]

crates/application/src/person/enrich.rs

@@ -0,0 +1,13 @@
+use crate::context::AppContext;
+use domain::{
+    errors::DomainError,
+    models::{PersonEnrichmentData, PersonId},
+};
+
+pub async fn execute(
+    ctx: &AppContext,
+    person_id: PersonId,
+    data: PersonEnrichmentData,
+) -> Result<(), DomainError> {
+    ctx.repos.person_command.update_enrichment(&person_id, &data).await
+}

crates/application/src/person/get.rs

@@ -1,11 +1,33 @@
 use crate::context::AppContext;
+use chrono::Utc;
 use domain::{
     errors::DomainError,
+    events::DomainEvent,
     models::{Person, PersonId},
 };
 
+const ENRICHMENT_TTL_DAYS: i64 = 90;
+
 pub async fn execute(ctx: &AppContext, id: PersonId) -> Result<Option<Person>, DomainError> {
-    ctx.repos.person_query.get_by_id(&id).await
+    let person = ctx.repos.person_query.get_by_id(&id).await?;
+    if let Some(ref p) = person {
+        if should_enrich(p) {
+            let _ = ctx.services.event_publisher.publish(
+                &DomainEvent::PersonEnrichmentRequested {
+                    person_id: id,
+                    external_person_id: p.external_id().value().to_string(),
+                },
+            ).await;
+        }
+    }
+    Ok(person)
+}
+
+fn should_enrich(p: &Person) -> bool {
+    match p.enriched_at() {
+        None => true,
+        Some(at) => (Utc::now() - at).num_days() >= ENRICHMENT_TTL_DAYS,
+    }
 }
 
 #[cfg(test)]

crates/application/src/person/get_credits.rs

@@ -1,11 +1,31 @@
 use crate::context::AppContext;
+use chrono::Utc;
 use domain::{
     errors::DomainError,
-    models::{PersonCredits, PersonId},
+    events::DomainEvent,
+    models::{Person, PersonCredits, PersonId},
 };
 
+const ENRICHMENT_TTL_DAYS: i64 = 90;
+
 pub async fn execute(ctx: &AppContext, id: PersonId) -> Result<PersonCredits, DomainError> {
-    ctx.repos.person_query.get_credits(&id).await
+    let credits = ctx.repos.person_query.get_credits(&id).await?;
+    if should_enrich(&credits.person) {
+        let _ = ctx.services.event_publisher.publish(
+            &DomainEvent::PersonEnrichmentRequested {
+                person_id: id,
+                external_person_id: credits.person.external_id().value().to_string(),
+            },
+        ).await;
+    }
+    Ok(credits)
+}
+
+fn should_enrich(p: &Person) -> bool {
+    match p.enriched_at() {
+        None => true,
+        Some(at) => (Utc::now() - at).num_days() >= ENRICHMENT_TTL_DAYS,
+    }
 }
 
 #[cfg(test)]

crates/application/src/person/mod.rs

@@ -1,2 +1,3 @@
+pub mod enrich;
 pub mod get;
 pub mod get_credits;

crates/application/src/test_helpers.rs

@@ -297,6 +297,7 @@ impl TestContextBuilder {
                 diary_exporter: self.diary_exporter,
                 document_parser: self.document_parser,
                 review_logger: self.review_logger,
+                person_enrichment: None,
             },
             config: self.config,
         }