Stsezhka

Appearance

Feature Index Dashboard ​

Welcome to the Features MOC (Map of Content). This index tracks the current supported product surface. Retired editor experiments are intentionally not listed here.

📋 Core Product Modules ​

Feature 01: Route Planning & Waypoint Navigation ​

  • Goal: Enable interactive, custom bike route creation on MapLibre canvas with profiles (road, MTB, gravel).
  • Key Components:
    • MapCanvas.tsx (listeners, waypoints, layer rendering).
    • PlannerSidebar.tsx (profile toggler, mileage/surface summaries).
    • routing.router.ts (API calculate route endpoints).
  • Related Use Cases: Out & Back, Round Trip.

Feature 02: Virtual Garage & Component Wear ​

  • Goal: Track virtual component degradation over distance (km) and operational hours, integrating Strava sync.
  • Key Components:
    • GarageTab.tsx (virtual bike status dashboard).
    • components.router.ts (Drizzle CRUD routes for inventory).
    • ride_wear_logs schema & environmental multiplier updates.
  • Related Use Cases: Component Wear Alerts, Physics Wear Multipliers.

Feature 03: Track Library & Favorite Folders ​

  • Goal: Manage user saved routes, sorting into collections/folders, soft deletions, and cloud archiving.
  • Key Components:
    • LibraryPage.tsx (lists routes, grids, search).
    • collections.router.ts (creates, updates, and deletes folders).
    • tracks PostgreSQL table constraints.
  • Related Use Cases: Library Track Extraction.

Feature 04: Turn-by-Turn Cue Sheets ​

  • Goal: Generate precise maneuver lists (turns, distance markers) with GPX cues integrations.
  • Key Components:
    • CueSheetPanel.tsx (sidebar turn listing).
    • cues JSONB columns in database schema.
    • GPX export engine integrations.
  • Related Use Cases: Cue Sheets Scenario, Control Points.

Feature 05: Point of Interest (POI) Management ​

  • Goal: Place custom marker markers (water, food, viewpoint) directly onto map canvas via right-click contexts.
  • Key Components:
    • AddPoiModal.tsx (form overlay).
    • poiStore.ts (Zustand coordinates filter states).
    • poi.router.ts (API route checks, coordinates validation).
  • Related Use Cases: POI Scenarios, Custom POIs & Waypoints.

Feature 06: Stack-Based Undo & Redo History ​

  • Goal: Maintain user waypoints/POI/drawing historical stack states for seamless undos.
  • Key Components:
    • usePlannerHistory.ts (stack-based history state hook).
    • Zustand historical wrappers.
  • Related Use Cases: Undo/Redo States, Undo Drag Atomicity.

🔀 Architectural Interactions ​