| """Privacy-aware hydration of Match candidates for API responses (spec §14). |
| |
| - Unknown dogs are shown at ZIP level only. The shelter/vet where a found dog is being held |
| (``current_location_detail``) IS included: it's a public place, and telling the owner where to |
| reclaim their dog is the whole point. Only *home* locations are withheld — those are never |
| collected below ZIP granularity and contact stays mediated. |
| - Known dogs show appearance fields; owner contact is mediated, never inlined. |
| """ |
| from __future__ import annotations |
|
|
| from sqlalchemy.orm import Session |
|
|
| from ..models import KnownDog, Match, UnknownDog |
| from ..models.base import SubjectType |
| from ..schemas.case import MatchOut |
| from .helpers import estimated_breeds_for, pictures_for |
|
|
|
|
| def build_match_out(db: Session, match: Match) -> MatchOut: |
| out = MatchOut.model_validate(match) |
| if match.candidate_type == SubjectType.unknown: |
| dog = db.get(UnknownDog, match.candidate_id) |
| if dog: |
| out.candidate = { |
| "type": "unknown", |
| "id": dog.id, |
| "description": dog.description, |
| "est_breed": dog.est_breed, |
| "est_age": dog.est_age, |
| "color": dog.color, |
| "size": dog.size.value if dog.size else None, |
| "current_zip": dog.current_zip, |
| |
| "current_location_detail": dog.current_location_detail, |
| "status": dog.status.value, |
| "estimated_breeds": estimated_breeds_for(db, SubjectType.unknown, dog.id), |
| "pictures": [p.model_dump() for p in pictures_for(db, SubjectType.unknown, dog.id)], |
| } |
| else: |
| dog = db.get(KnownDog, match.candidate_id) |
| if dog: |
| out.candidate = { |
| "type": "known", |
| "id": dog.id, |
| "name": dog.name, |
| "breed": dog.breed, |
| "age": dog.age, |
| "color": dog.color, |
| "size": dog.size.value if dog.size else None, |
| "last_known_zip": dog.last_known_zip, |
| "status": dog.status.value, |
| "estimated_breeds": estimated_breeds_for(db, SubjectType.known, dog.id), |
| "pictures": [p.model_dump() for p in pictures_for(db, SubjectType.known, dog.id)], |
| } |
| return out |
|
|
