Spaces:

Duke410
/

PawTrace

Running

Elliott Duke

Claude Opus 4.8

HomingPet: lost-dog reunification (FastAPI + React) with Render deploy

de1e3fc 4 months ago

7.55 kB

// Shapes mirror the backend Pydantic schemas (spec §12). Kept hand-written for clarity;
// could be codegen'd from /openapi.json (see DECISIONS.md).

export type Role = "owner" | "finder" | "admin";
export type DogSize = "small" | "medium" | "large";
export type CaseType = "lost" | "found";
export type CaseStatus = "open" | "matched" | "resolved" | "closed";
export type MatchStatus = "pending" | "confirmed" | "rejected";

export interface User {
  id: number;
  name: string;
  email: string;
  phone: string | null;
  zip: string;
  role: Role;
}

export interface Picture {
  id: number;
  subject_type: "known" | "unknown";
  subject_id: number;
  is_primary: boolean;
  is_probably_not_dog: boolean;
  url: string | null;
  thumb_url: string | null;
}

export interface KnownDog {
  id: number;
  owner_id: number;
  name: string;
  breed: string | null;
  age: string | null;
  color: string | null;
  size: DogSize | null;
  description: string;
  other_info: string | null;
  last_known_zip: string | null;
  status: "home" | "lost" | "reunited";
  created_at: string;
  pictures: Picture[];
  estimated_breeds: string[];
}

export interface Case {
  id: number;
  type: CaseType;
  status: CaseStatus;
  event_zip: string;
  event_date: string;
  current_location: string | null;
  search_radius_miles: number;
  notes: string | null;
  known_dog_id: number | null;
  unknown_dog_id: number | null;
  person_id: number | null;
  created_at: string;
}

export interface MatchCandidate {
  type: "known" | "unknown";
  id: number;
  name?: string;
  description?: string;
  breed?: string | null;
  est_breed?: string | null;
  color?: string | null;
  size?: string | null;
  current_zip?: string | null;
  current_location_detail?: string | null; // shelter/vet holding a found dog (public)
  last_known_zip?: string | null;
  status?: string;
  estimated_breeds?: string[];
  pictures: Picture[];
}

export interface Match {
  id: number;
  case_id: number;
  candidate_type: "known" | "unknown";
  candidate_id: number;
  candidate_case_id: number | null;
  similarity_score: number;
  rank: number;
  status: MatchStatus;
  model_name: string;
  model_version: string;
  candidate: MatchCandidate | null;
}

export interface FoundReportResponse {
  case: Case;
  matches: Match[];
  vet_guidance: { name: string; detail: string; type: string }[] | null;
}

export interface ReclaimContact {
  name: string | null;
  email: string | null;
  phone: string | null;
}

export interface ReclaimInfo {
  match_id: number;
  match_status: MatchStatus;
  your_dog_name: string | null;
  your_photos: DogPhoto[];
  found: boolean;
  held_at: "shelter_or_vet" | "finder_custody" | "unknown";
  location_name: string | null;
  current_zip: string | null;
  current_location: string | null;
  found_date: string | null;
  contact: ReclaimContact | null;
  photos: DogPhoto[];
  nearby_shelters: { name: string; detail: string; type: string }[];
}

export interface Page<T> {
  items: T[];
  total: number;
  limit: number;
  offset: number;
}

// ---- Admin: datasets / data loading ----

export type DatasetType = "test_known" | "test_found" | "known" | "unknown";

export interface Dataset {
  id: number;
  name: string;
  type: DatasetType;
  description: string | null;
  source_path: string | null;
  dog_count: number;
  creation_time: string;
  case_count: number;
}

export interface DatasetStats {
  known_dog_count: number;
  unknown_dog_count: number;
  dog_count: number;
  user_count: number;
  case_count: number;
  match_count: number;
  picture_count: number;
  embedded_picture_count: number;
  error_count: number;
}

export interface DatasetDetail extends Dataset {
  stats: DatasetStats;
}

export interface DatasetDog {
  kind: "known" | "unknown";
  id: number;
  name: string;
  status: string;
  zip: string | null;
  thumb_url: string | null;
}

export interface DatasetDogsPage {
  items: DatasetDog[];
  total: number;
  limit: number;
  offset: number;
}

export interface PurgeResult {
  dataset_id: number;
  deleted: Record<string, number>;
}

export interface EmbedAllResult {
  dataset_id: number;
  total_pictures: number;
  embedded: number;
  breeds: number;
  skipped: number;
  errors: number;
}

export interface MatchDatasetResult {
  dataset_id: number;
  cases_processed: number;
  matches_created: number;
  candidate_dataset_id: number | null;
}

export interface AdminDog {
  kind: "known" | "unknown";
  id: number;
  name: string;
  breed: string | null;
  color: string | null;
  size: string | null;
  status: string;
  zip: string | null;
  dataset_id: number | null;
  dataset_name: string | null;
  picture_count: number;
  thumb_url: string | null;
  predicted_breeds: string[];
}

export interface BreedOption {
  label: string;
  count: number;
}

export interface AdminDogsPage {
  items: AdminDog[];
  total: number;
  limit: number;
  offset: number;
  counts: { known: number; unknown: number };
}

export interface TestMatchCandidate extends AdminDog {
  score: number;
}

export interface TestMatchResult {
  query: AdminDog;
  results: TestMatchCandidate[];
  model: string;
  candidate_count: number;
  query_embedded: boolean;
}

export interface DogPhoto {
  id: number;
  url: string | null;
  thumb_url: string | null;
  is_primary: boolean;
}

export interface DogDetailResult {
  profile: AdminDog;
  photos: DogPhoto[];
}

export interface CaseDog {
  kind: "known" | "unknown" | null;
  photos: DogPhoto[];
}

export interface PhotoSearchMatch {
  dog: AdminDog;
  score: number;
  distance_miles: number | null;
  photos: DogPhoto[];
}

export interface PhotoSearchResult {
  results: PhotoSearchMatch[];
  model: string;
  candidate_count: number;
  zip: string | null;
  radius_miles: number;
  pool: "found" | "lost";
}

export interface BreedEstimate {
  label: string;
  score: number;
}

export interface BreedEstimateResult {
  breeds: BreedEstimate[];
  model: string;
}

export interface AdminCaseDog {
  kind: "known" | "unknown";
  id: number;
  name: string;
  status: string;
  zip: string | null;
  thumb_url: string | null;
}

export interface AdminCase {
  id: number;
  type: "lost" | "found";
  status: string;
  event_zip: string;
  event_date: string;
  created_at: string;
  dog: AdminCaseDog | null;
  person: { id: number; name: string; email: string } | null;
  finder_name: string | null;
  finder_email: string | null;
  match_count: number;
}

export interface AdminCasesPage {
  items: AdminCase[];
  total: number;
  limit: number;
  offset: number;
  counts: { lost: number; found: number };
}

export interface AdminCaseDetail {
  case: AdminCase;
  dog: { profile: AdminDog; photos: DogPhoto[] } | null;
  matches: Match[];
}

export interface AdminOwner {
  id: number;
  name: string;
  email: string;
  zip: string;
  dog_count: number;
  dogs: { id: number; name: string; status: string; zip: string | null; thumb_url: string | null }[];
}

export interface AdminOwnersPage {
  items: AdminOwner[];
  total: number;
  limit: number;
  offset: number;
}

export interface AdminOwnerDetail {
  owner: {
    id: number;
    name: string;
    email: string;
    zip: string;
    phone: string | null;
    dog_count: number;
  };
  dogs: AdminDog[];
  cases: AdminCase[];
}

export interface Job {
  id: string;
  type: string;
  status: "pending" | "running" | "done" | "error";
  progress: { processed?: number; total?: number; dataset_id?: number };
  result: Record<string, unknown> | null;
  error: string | null;
  created_at: string;
}

	// Shapes mirror the backend Pydantic schemas (spec §12). Kept hand-written for clarity;
	// could be codegen'd from /openapi.json (see DECISIONS.md).

	export type Role = "owner" \| "finder" \| "admin";
	export type DogSize = "small" \| "medium" \| "large";
	export type CaseType = "lost" \| "found";
	export type CaseStatus = "open" \| "matched" \| "resolved" \| "closed";
	export type MatchStatus = "pending" \| "confirmed" \| "rejected";

	export interface User {
	id: number;
	name: string;
	email: string;
	phone: string \| null;
	zip: string;
	role: Role;
	}

	export interface Picture {
	id: number;
	subject_type: "known" \| "unknown";
	subject_id: number;
	is_primary: boolean;
	is_probably_not_dog: boolean;
	url: string \| null;
	thumb_url: string \| null;
	}

	export interface KnownDog {
	id: number;
	owner_id: number;
	name: string;
	breed: string \| null;
	age: string \| null;
	color: string \| null;
	size: DogSize \| null;
	description: string;
	other_info: string \| null;
	last_known_zip: string \| null;
	status: "home" \| "lost" \| "reunited";
	created_at: string;
	pictures: Picture[];
	estimated_breeds: string[];
	}

	export interface Case {
	id: number;
	type: CaseType;
	status: CaseStatus;
	event_zip: string;
	event_date: string;
	current_location: string \| null;
	search_radius_miles: number;
	notes: string \| null;
	known_dog_id: number \| null;
	unknown_dog_id: number \| null;
	person_id: number \| null;
	created_at: string;
	}

	export interface MatchCandidate {
	type: "known" \| "unknown";
	id: number;
	name?: string;
	description?: string;
	breed?: string \| null;
	est_breed?: string \| null;
	color?: string \| null;
	size?: string \| null;
	current_zip?: string \| null;
	current_location_detail?: string \| null; // shelter/vet holding a found dog (public)
	last_known_zip?: string \| null;
	status?: string;
	estimated_breeds?: string[];
	pictures: Picture[];
	}

	export interface Match {
	id: number;
	case_id: number;
	candidate_type: "known" \| "unknown";
	candidate_id: number;
	candidate_case_id: number \| null;
	similarity_score: number;
	rank: number;
	status: MatchStatus;
	model_name: string;
	model_version: string;
	candidate: MatchCandidate \| null;
	}

	export interface FoundReportResponse {
	case: Case;
	matches: Match[];
	vet_guidance: { name: string; detail: string; type: string }[] \| null;
	}

	export interface ReclaimContact {
	name: string \| null;
	email: string \| null;
	phone: string \| null;
	}

	export interface ReclaimInfo {
	match_id: number;
	match_status: MatchStatus;
	your_dog_name: string \| null;
	your_photos: DogPhoto[];
	found: boolean;
	held_at: "shelter_or_vet" \| "finder_custody" \| "unknown";
	location_name: string \| null;
	current_zip: string \| null;
	current_location: string \| null;
	found_date: string \| null;
	contact: ReclaimContact \| null;
	photos: DogPhoto[];
	nearby_shelters: { name: string; detail: string; type: string }[];
	}

	export interface Page<T> {
	items: T[];
	total: number;
	limit: number;
	offset: number;
	}

	// ---- Admin: datasets / data loading ----

	export type DatasetType = "test_known" \| "test_found" \| "known" \| "unknown";

	export interface Dataset {
	id: number;
	name: string;
	type: DatasetType;
	description: string \| null;
	source_path: string \| null;
	dog_count: number;
	creation_time: string;
	case_count: number;
	}

	export interface DatasetStats {
	known_dog_count: number;
	unknown_dog_count: number;
	dog_count: number;
	user_count: number;
	case_count: number;
	match_count: number;
	picture_count: number;
	embedded_picture_count: number;
	error_count: number;
	}

	export interface DatasetDetail extends Dataset {
	stats: DatasetStats;
	}

	export interface DatasetDog {
	kind: "known" \| "unknown";
	id: number;
	name: string;
	status: string;
	zip: string \| null;
	thumb_url: string \| null;
	}

	export interface DatasetDogsPage {
	items: DatasetDog[];
	total: number;
	limit: number;
	offset: number;
	}

	export interface PurgeResult {
	dataset_id: number;
	deleted: Record<string, number>;
	}

	export interface EmbedAllResult {
	dataset_id: number;
	total_pictures: number;
	embedded: number;
	breeds: number;
	skipped: number;
	errors: number;
	}

	export interface MatchDatasetResult {
	dataset_id: number;
	cases_processed: number;
	matches_created: number;
	candidate_dataset_id: number \| null;
	}

	export interface AdminDog {
	kind: "known" \| "unknown";
	id: number;
	name: string;
	breed: string \| null;
	color: string \| null;
	size: string \| null;
	status: string;
	zip: string \| null;
	dataset_id: number \| null;
	dataset_name: string \| null;
	picture_count: number;
	thumb_url: string \| null;
	predicted_breeds: string[];
	}

	export interface BreedOption {
	label: string;
	count: number;
	}

	export interface AdminDogsPage {
	items: AdminDog[];
	total: number;
	limit: number;
	offset: number;
	counts: { known: number; unknown: number };
	}

	export interface TestMatchCandidate extends AdminDog {
	score: number;
	}

	export interface TestMatchResult {
	query: AdminDog;
	results: TestMatchCandidate[];
	model: string;
	candidate_count: number;
	query_embedded: boolean;
	}

	export interface DogPhoto {
	id: number;
	url: string \| null;
	thumb_url: string \| null;
	is_primary: boolean;
	}

	export interface DogDetailResult {
	profile: AdminDog;
	photos: DogPhoto[];
	}

	export interface CaseDog {
	kind: "known" \| "unknown" \| null;
	photos: DogPhoto[];
	}

	export interface PhotoSearchMatch {
	dog: AdminDog;
	score: number;
	distance_miles: number \| null;
	photos: DogPhoto[];
	}

	export interface PhotoSearchResult {
	results: PhotoSearchMatch[];
	model: string;
	candidate_count: number;
	zip: string \| null;
	radius_miles: number;
	pool: "found" \| "lost";
	}

	export interface BreedEstimate {
	label: string;
	score: number;
	}

	export interface BreedEstimateResult {
	breeds: BreedEstimate[];
	model: string;
	}

	export interface AdminCaseDog {
	kind: "known" \| "unknown";
	id: number;
	name: string;
	status: string;
	zip: string \| null;
	thumb_url: string \| null;
	}

	export interface AdminCase {
	id: number;
	type: "lost" \| "found";
	status: string;
	event_zip: string;
	event_date: string;
	created_at: string;
	dog: AdminCaseDog \| null;
	person: { id: number; name: string; email: string } \| null;
	finder_name: string \| null;
	finder_email: string \| null;
	match_count: number;
	}

	export interface AdminCasesPage {
	items: AdminCase[];
	total: number;
	limit: number;
	offset: number;
	counts: { lost: number; found: number };
	}

	export interface AdminCaseDetail {
	case: AdminCase;
	dog: { profile: AdminDog; photos: DogPhoto[] } \| null;
	matches: Match[];
	}

	export interface AdminOwner {
	id: number;
	name: string;
	email: string;
	zip: string;
	dog_count: number;
	dogs: { id: number; name: string; status: string; zip: string \| null; thumb_url: string \| null }[];
	}

	export interface AdminOwnersPage {
	items: AdminOwner[];
	total: number;
	limit: number;
	offset: number;
	}

	export interface AdminOwnerDetail {
	owner: {
	id: number;
	name: string;
	email: string;
	zip: string;
	phone: string \| null;
	dog_count: number;
	};
	dogs: AdminDog[];
	cases: AdminCase[];
	}

	export interface Job {
	id: string;
	type: string;
	status: "pending" \| "running" \| "done" \| "error";
	progress: { processed?: number; total?: number; dataset_id?: number };
	result: Record<string, unknown> \| null;
	error: string \| null;
	created_at: string;
	}