Initial commit - Trekker V2 source
This commit is contained in:
commit
d71faf19e3
65 files changed
+3615
No files matched your search
Whitespace-only changes.
@@ -0,0 +1,17 @@
|
||||
"""Generated asset model: structured JSON output from generators."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
from app.models.route import new_id, utcnow_iso
|
||||
|
||||
|
||||
class Asset(BaseModel):
|
||||
id: str = Field(default_factory=new_id)
|
||||
route_id: str
|
||||
generator: str
|
||||
data: dict[str, Any] = Field(default_factory=dict)
|
||||
created_at: str = Field(default_factory=utcnow_iso)
|
||||
@@ -0,0 +1,26 @@
|
||||
"""Offline map pack metadata."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Optional
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
from app.models.route import new_id, utcnow_iso
|
||||
|
||||
|
||||
class MapPack(BaseModel):
|
||||
id: str = Field(default_factory=new_id)
|
||||
name: str = "Offline area"
|
||||
bbox: list[float] = Field(default_factory=list) # [min_lon, min_lat, max_lon, max_lat]
|
||||
min_zoom: int = 8
|
||||
max_zoom: int = 14
|
||||
layers: list[str] = Field(default_factory=lambda: ["base"])
|
||||
status: str = "queued" # queued | downloading | ready | failed
|
||||
error: Optional[str] = None
|
||||
path: Optional[str] = None
|
||||
size_bytes: int = 0
|
||||
tile_count: int = 0
|
||||
tiles_done: int = 0
|
||||
created_at: str = Field(default_factory=utcnow_iso)
|
||||
updated_at: str = Field(default_factory=utcnow_iso)
|
||||
@@ -0,0 +1,81 @@
|
||||
"""Canonical route models: TrekkerRoute and its sub-models."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import datetime, timezone
|
||||
from typing import Any, Optional
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
def utcnow_iso() -> str:
|
||||
return datetime.now(timezone.utc).isoformat()
|
||||
|
||||
|
||||
def new_id() -> str:
|
||||
return uuid.uuid4().hex
|
||||
|
||||
|
||||
class TrkPt(BaseModel):
|
||||
lat: float
|
||||
lon: float
|
||||
ele: Optional[float] = None
|
||||
time: Optional[str] = None # ISO 8601
|
||||
|
||||
|
||||
class Wpt(BaseModel):
|
||||
lat: float
|
||||
lon: float
|
||||
ele: Optional[float] = None
|
||||
time: Optional[str] = None
|
||||
name: Optional[str] = None
|
||||
desc: Optional[str] = None
|
||||
sym: Optional[str] = None
|
||||
type: Optional[str] = None
|
||||
|
||||
|
||||
class Segment(BaseModel):
|
||||
index: int
|
||||
name: str
|
||||
start_wpt: Optional[str] = None
|
||||
end_wpt: Optional[str] = None
|
||||
start_idx: int
|
||||
end_idx: int # inclusive index into route.points
|
||||
distance_m: float = 0.0
|
||||
elevation_gain_m: float = 0.0
|
||||
elevation_loss_m: float = 0.0
|
||||
grade_pct_avg: float = 0.0
|
||||
grade_pct_max: float = 0.0
|
||||
duration_s: Optional[float] = None
|
||||
|
||||
|
||||
class RouteStats(BaseModel):
|
||||
distance_m: float = 0.0
|
||||
elevation_gain_m: float = 0.0
|
||||
elevation_loss_m: float = 0.0
|
||||
elevation_min_m: Optional[float] = None
|
||||
elevation_max_m: Optional[float] = None
|
||||
duration_s: Optional[float] = None
|
||||
|
||||
|
||||
class TrekkerRoute(BaseModel):
|
||||
id: str = Field(default_factory=new_id)
|
||||
name: str = "Unnamed route"
|
||||
source: str = "manual" # gaia | onx | manual
|
||||
trail_guide_id: Optional[str] = None
|
||||
points: list[TrkPt] = Field(default_factory=list)
|
||||
waypoints: list[Wpt] = Field(default_factory=list)
|
||||
segments: list[Segment] = Field(default_factory=list)
|
||||
stats: RouteStats = Field(default_factory=RouteStats)
|
||||
metadata: dict[str, Any] = Field(default_factory=dict)
|
||||
created_at: str = Field(default_factory=utcnow_iso)
|
||||
updated_at: str = Field(default_factory=utcnow_iso)
|
||||
|
||||
def bounds(self) -> Optional[tuple[float, float, float, float]]:
|
||||
"""(min_lon, min_lat, max_lon, max_lat) or None for empty routes."""
|
||||
if not self.points:
|
||||
return None
|
||||
lats = [p.lat for p in self.points]
|
||||
lons = [p.lon for p in self.points]
|
||||
return (min(lons), min(lats), max(lons), max(lats))
|
||||
@@ -0,0 +1,34 @@
|
||||
"""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)
|
||||
@@ -0,0 +1,23 @@
|
||||
"""Trip: a collection of routes with travelers and a date range."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any, Optional
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
from app.models.route import new_id, utcnow_iso
|
||||
|
||||
|
||||
class Trip(BaseModel):
|
||||
id: str = Field(default_factory=new_id)
|
||||
name: str = "Unnamed trip"
|
||||
route_ids: list[str] = Field(default_factory=list)
|
||||
travelers: list[str] = Field(default_factory=list)
|
||||
date_start: Optional[str] = None
|
||||
date_end: Optional[str] = None
|
||||
notes: Optional[str] = None
|
||||
generated_asset_ids: list[str] = Field(default_factory=list)
|
||||
metadata: dict[str, Any] = Field(default_factory=dict)
|
||||
created_at: str = Field(default_factory=utcnow_iso)
|
||||
updated_at: str = Field(default_factory=utcnow_iso)
|
||||
Reference in new issue
Block a user