"""TrailGuide: curated trail knowledge, separate from raw GPS routes.""" from __future__ import annotations from typing import Optional from pydantic import BaseModel, Field from app.models.route import new_id, utcnow_iso class WaterCrossing(BaseModel): name: Optional[str] = None depth_ft: Optional[float] = None notes: Optional[str] = None class TrailGuide(BaseModel): id: str = Field(default_factory=new_id) name: str = "Unnamed trail guide" source: str = "manual" # web | pdf | manual source_url: Optional[str] = None pdf_path: Optional[str] = None difficulty: Optional[str] = None obstacle_types: list[str] = Field(default_factory=list) water_crossings: list[WaterCrossing] = Field(default_factory=list) gate_codes: list[str] = Field(default_factory=list) vehicle_recommendations: list[str] = Field(default_factory=list) closures: list[str] = Field(default_factory=list) warnings: list[str] = Field(default_factory=list) notes: Optional[str] = None raw_text: Optional[str] = None # extracted source text kept for re-review created_at: str = Field(default_factory=utcnow_iso) updated_at: str = Field(default_factory=utcnow_iso)