Initial commit - Trekker V2 source

This commit is contained in:
Cortex committed 2026-06-10 11:03:37 -04:00
commit d71faf19e3
65 files changed
+3615

No files matched your search

View File
Whitespace-only changes.
+17
View File
@@ -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)
+26
View File
@@ -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)
+81
View File
@@ -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))
+34
View File
@@ -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)
+23
View File
@@ -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)