# Architecture **Analysis Date:** 2026-10-21 ## System Overview This is a **pre-implementation / design-phase project**. There is no backend, runtime code, package manifest, build tooling, or test suite yet. The current "architecture" consists of: 1. **Planning documents** at repo root (`DESIGN.md`, `IDEAS.md`) describing the product vision and target stack. 2. **Static HTML UI mockups** (one directory per screen) under `stitch_minimalist_route_navigator/`, each self-contained and openable directly in a browser. ```text ┌──────────────────────────────────────────────────────────────┐ │ Current State: Static UI Mockups │ ├──────────────────┬──────────────────┬────────────────────────┤ │ Mockup screens │ Design system │ Planning docs │ │ stich_.../*/ │ telemetry_rams/ │ DESIGN.md │ │ code.html │ DESIGN.md │ IDEAS.md │ └──────────────────┴──────────────────┴────────────────────────┘ ┌──────────────────────────────────────────────────────────────┐ │ Implied Target Architecture (from IDEAS.md) │ ├───────────────────┬──────────────────────┬───────────────────┤ │ Frontend │ Backend │ Data / Infra │ │ Telegram bot + │ OSRM routing │ Neon Postgres │ │ optional PWA │ (traffic weighting) │ (PostGIS) │ │ (Cloudflare │ RabbitMQ queue │ Cloudflare R2 │ │ Pages) │ Resend email │ Maptiler tiles │ └───────────────────┴──────────────────────┴───────────────────┘ ``` ## Component Responsibilities | Component | Responsibility | File | |-----------|----------------|------| | `active_route_guidance/` | Turn-by-turn navigation HUD mockup: maneuver strip, incident telemetry band, map corridor viewport | `stitch_minimalist_route_navigator/active_route_guidance/code.html` | | `navigate_map_overview/` | Full-map navigation screen mockup: route rendering, layer toggles, recenter control | `stitch_minimalist_route_navigator/navigate_map_overview/code.html` | | `telegram_live_traffic_feed/` | Telegram-bot-styled traffic feed mockup: inline commands (`/traffic`, `/hazard`, `/status`, `/clear`), dispatch confirm | `stitch_minimalist_route_navigator/telegram_live_traffic_feed/code.html` | | `community_incident_reporter/` | Incident-report flow mockup: hazard drawer, modal report, incident type selection | `stitch_minimalist_route_navigator/community_incident_reporter/code.html` | | `telemetry_rams/DESIGN.md` | Formal design system spec (design tokens: colors, typography, spacing, breakpoints, component rules) | `stitch_minimalist_route_navigator/telemetry_rams/DESIGN.md` | | `DESIGN.md` | High-level Rams design philosophy: palette, typography, iconography, interaction flows | `DESIGN.md` | | `IDEAS.md` | Product vision, core principles, target stack outline, gamification and future ideas | `IDEAS.md` | ## Pattern Overview **Overall:** Design-system-driven static mockup pattern (no application architecture exists yet). **Key Characteristics:** - Each mockup screen is a **single self-contained HTML file** (`code.html`) with inline `