# kabishs/naviro architecture

> Architecture diagram of the GitHub repository kabishs/naviro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kabishs/naviro
- Repository: https://github.com/kabishs/naviro

## Overview

This repository combines a rover-navigation frontend with an HTTP/WebSocket backend and a PX4 bridge. The intended workflow is to plan a route, submit waypoints and mission updates, monitor telemetry, and optionally connect or forward a mission to PX4. The sampled backend shows route dispatch, validation, in-memory mission and waypoint state, and WebSocket broadcasts. Frontend-to-backend wiring and PX4 transport details were not shown in the excerpts, so those links are marked unverified rather than asserted.

Main entry points: [`backend/server.js`](https://github.com/kabishs/naviro/blob/main/backend/server.js) (HTTP Server), [`backend/websocket/websocketServer.js`](https://github.com/kabishs/naviro/blob/main/backend/websocket/websocketServer.js) (WebSocket Manager), [`backend/controllers/waypointController.js`](https://github.com/kabishs/naviro/blob/main/backend/controllers/waypointController.js) (Waypoint Controller), [`js/app.js`](https://github.com/kabishs/naviro/blob/main/js/app.js) (Navigation App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Navigation Client"]
  node_frontend["Navigation App<br/>[app.js]"]
  node_pathfinding["Pathfinding<br/>[pathfinding.js]"]
end

subgraph group_api["Backend API"]
  node_backend["HTTP Server<br/>[server.js]"]
  node_mission_routes["Mission Routes<br/>[missionRoutes.js]"]
  node_waypoint_routes["Waypoint Routes<br/>[waypointRoutes.js]"]
  node_px4_routes["PX4 Routes<br/>[px4Routes.js]"]
  node_validation["Request Validation<br/>[validation.js]"]
end

subgraph group_domain["Mission and Routes"]
  node_mission_controller["Mission Controller"]
  node_mission_service["Mission State<br/>[missionService.js]"]
  node_waypoint_controller["Waypoint Controller"]
  node_waypoint_service["Waypoint State<br/>[waypointService.js]"]
end

subgraph group_integration["Realtime and PX4"]
  node_px4_controller["PX4 Controller<br/>[px4Controller.js]"]
  node_px4_service["PX4 Service<br/>[px4Service.js]"]
  node_px4_bridge["PX4 Bridge<br/>[px4Bridge.js]"]
  node_websocket["WebSocket Manager<br/>[websocketServer.js]"]
end

node_operator(("Operator"))
node_px4(("PX4 SITL"))

node_operator -.->|"plans route"| node_frontend
node_frontend -.->|"plans path"| node_pathfinding
node_frontend -.->|"submits updates"| node_backend
node_backend -->|"mounts routes"| node_mission_routes
node_backend -->|"mounts routes"| node_waypoint_routes
node_backend -->|"mounts routes"| node_px4_routes
node_backend -->|"initializes"| node_websocket
node_mission_routes -->|"validates requests"| node_validation
node_mission_routes -->|"dispatches requests"| node_mission_controller
node_waypoint_routes -->|"validates requests"| node_validation
node_waypoint_routes -->|"dispatches requests"| node_waypoint_controller
node_px4_routes -->|"dispatches requests"| node_px4_controller
node_mission_controller -->|"updates state"| node_mission_service
node_mission_controller -->|"broadcasts events"| node_websocket
node_waypoint_controller -->|"manages waypoints"| node_waypoint_service
node_waypoint_controller -->|"records replanning"| node_mission_service
node_waypoint_controller -->|"broadcasts events"| node_websocket
node_px4_controller -->|"requests operations"| node_px4_service
node_px4_controller -->|"broadcasts status"| node_websocket
node_px4_service -->|"delegates operations"| node_px4_bridge
node_px4_bridge -.->|"connects and forwards"| node_px4
node_websocket -.->|"streams updates"| node_frontend

click node_frontend "https://github.com/kabishs/naviro/blob/main/js/app.js"
click node_pathfinding "https://github.com/kabishs/naviro/blob/main/js/pathfinding.js"
click node_backend "https://github.com/kabishs/naviro/blob/main/backend/server.js"
click node_mission_routes "https://github.com/kabishs/naviro/blob/main/backend/routes/missionRoutes.js"
click node_waypoint_routes "https://github.com/kabishs/naviro/blob/main/backend/routes/waypointRoutes.js"
click node_px4_routes "https://github.com/kabishs/naviro/blob/main/backend/routes/px4Routes.js"
click node_validation "https://github.com/kabishs/naviro/blob/main/backend/middleware/validation.js"
click node_mission_controller "https://github.com/kabishs/naviro/blob/main/backend/controllers/missionController.js"
click node_mission_service "https://github.com/kabishs/naviro/blob/main/backend/services/missionService.js"
click node_waypoint_controller "https://github.com/kabishs/naviro/blob/main/backend/controllers/waypointController.js"
click node_waypoint_service "https://github.com/kabishs/naviro/blob/main/backend/services/waypointService.js"
click node_px4_controller "https://github.com/kabishs/naviro/blob/main/backend/controllers/px4Controller.js"
click node_px4_service "https://github.com/kabishs/naviro/blob/main/backend/services/px4Service.js"
click node_px4_bridge "https://github.com/kabishs/naviro/blob/main/backend/px4/px4Bridge.js"
click node_websocket "https://github.com/kabishs/naviro/blob/main/backend/websocket/websocketServer.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_pathfinding toneBlue
class node_backend,node_mission_routes,node_waypoint_routes,node_px4_routes,node_validation toneAmber
class node_mission_controller,node_mission_service,node_waypoint_controller,node_waypoint_service toneMint
class node_px4_controller,node_px4_service,node_px4_bridge,node_websocket toneRose
class node_operator,node_px4 toneIndigo
```

## Components

### Navigation Client

- [Navigation App](https://github.com/kabishs/naviro/blob/main/js/app.js): `js/app.js`
- [Pathfinding](https://github.com/kabishs/naviro/blob/main/js/pathfinding.js): `js/pathfinding.js`

### Backend API

- [HTTP Server](https://github.com/kabishs/naviro/blob/main/backend/server.js): `backend/server.js`
- [Mission Routes](https://github.com/kabishs/naviro/blob/main/backend/routes/missionRoutes.js): `backend/routes/missionRoutes.js`
- [Waypoint Routes](https://github.com/kabishs/naviro/blob/main/backend/routes/waypointRoutes.js): `backend/routes/waypointRoutes.js`
- [PX4 Routes](https://github.com/kabishs/naviro/blob/main/backend/routes/px4Routes.js): `backend/routes/px4Routes.js`
- [Request Validation](https://github.com/kabishs/naviro/blob/main/backend/middleware/validation.js): `backend/middleware/validation.js`

### Mission and Routes

- [Mission Controller](https://github.com/kabishs/naviro/blob/main/backend/controllers/missionController.js): `backend/controllers/missionController.js`
- [Mission State](https://github.com/kabishs/naviro/blob/main/backend/services/missionService.js): `backend/services/missionService.js`
- [Waypoint Controller](https://github.com/kabishs/naviro/blob/main/backend/controllers/waypointController.js): `backend/controllers/waypointController.js`
- [Waypoint State](https://github.com/kabishs/naviro/blob/main/backend/services/waypointService.js): `backend/services/waypointService.js`

### Realtime and PX4

- [PX4 Controller](https://github.com/kabishs/naviro/blob/main/backend/controllers/px4Controller.js): `backend/controllers/px4Controller.js`
- [PX4 Service](https://github.com/kabishs/naviro/blob/main/backend/services/px4Service.js): `backend/services/px4Service.js`
- [PX4 Bridge](https://github.com/kabishs/naviro/blob/main/backend/px4/px4Bridge.js): `backend/px4/px4Bridge.js`
- [WebSocket Manager](https://github.com/kabishs/naviro/blob/main/backend/websocket/websocketServer.js): `backend/websocket/websocketServer.js`

### Other components

- **Operator**
- **PX4 SITL**

## Connections

- Operator → Navigation App: plans route
- Navigation App → Pathfinding: plans path
- Navigation App → HTTP Server: submits updates
- HTTP Server → Mission Routes: mounts routes (evidence: `backend/server.js`)
- HTTP Server → Waypoint Routes: mounts routes (evidence: `backend/server.js`)
- HTTP Server → PX4 Routes: mounts routes (evidence: `backend/server.js`)
- HTTP Server → WebSocket Manager: initializes (evidence: `backend/server.js`)
- Mission Routes → Request Validation: validates requests (evidence: `backend/routes/missionRoutes.js`)
- Mission Routes → Mission Controller: dispatches requests (evidence: `backend/routes/missionRoutes.js`)
- Waypoint Routes → Request Validation: validates requests (evidence: `backend/routes/waypointRoutes.js`)
- Waypoint Routes → Waypoint Controller: dispatches requests (evidence: `backend/routes/waypointRoutes.js`)
- PX4 Routes → PX4 Controller: dispatches requests (evidence: `backend/routes/px4Routes.js`)
- Mission Controller → Mission State: updates state (evidence: `backend/controllers/missionController.js`)
- Mission Controller → WebSocket Manager: broadcasts events (evidence: `backend/controllers/missionController.js`)
- Waypoint Controller → Waypoint State: manages waypoints (evidence: `backend/controllers/waypointController.js`)
- Waypoint Controller → Mission State: records replanning (evidence: `backend/controllers/waypointController.js`)
- Waypoint Controller → WebSocket Manager: broadcasts events (evidence: `backend/controllers/waypointController.js`)
- PX4 Controller → PX4 Service: requests operations (evidence: `backend/controllers/px4Controller.js`)
- PX4 Controller → WebSocket Manager: broadcasts status (evidence: `backend/controllers/px4Controller.js`)
- PX4 Service → PX4 Bridge: delegates operations (evidence: `backend/services/px4Service.js`)
- PX4 Bridge → PX4 SITL: connects and forwards
- WebSocket Manager → Navigation App: streams updates
