# khairulhafis/mynav architecture

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

- Interactive diagram: https://gitdiagram.com/khairulhafis/mynav
- Repository: https://github.com/khairulhafis/mynav

## Overview

MynaV is an investigator-led CCTV direction-analysis system: users configure cameras, upload footage for processing, search candidate sightings by area and time, inspect evidence, and record review decisions. The backend coordinates job processing and investigation data; a separate video engine tracks people within uploaded footage and produces candidate sightings and media evidence. The README emphasizes that sightings are independent candidates—not automatic identification or cross-camera route reconstruction. Several frontend and persistence implementations were not sampled, so their internal links are omitted where evidence is unavailable.

Main entry points: [`Backend/src/app/compositionRoot.js`](https://github.com/khairulhafis/mynav/blob/main/Backend/src/app/compositionRoot.js) (HTTP application), [`Frontend/src/app/App.jsx`](https://github.com/khairulhafis/mynav/blob/main/Frontend/src/app/App.jsx) (Workspace app), [`VideoAnalysisEngine/src/application/pipeline.py`](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/application/pipeline.py) (Video analysis), [`Backend/src/modules/processing/application.js`](https://github.com/khairulhafis/mynav/blob/main/Backend/src/modules/processing/application.js) (Job orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Investigator interface"]
  node_app["Workspace app<br/>[App.jsx]"]
  node_camera_ui["Camera setup"]
  node_processing_ui["Job workspace"]
  node_search_ui["Sighting search"]
  node_evidence_ui["Evidence review"]
  node_review_ui["Review decisions"]
end

subgraph group_backend["Backend services"]
  node_backend["HTTP application<br/>[compositionRoot.js]"]
  node_camera_service["Camera service"]
  node_investigation_service["Investigation search"]
  node_review_service["Review service"]
  node_processing_service["Job orchestration<br/>[application.js]"]
  node_data_store[("Application data")]
  node_engine_client["Engine client"]
end

subgraph group_processing["Footage processing"]
end

subgraph group_investigation["Investigation workflow"]
end

subgraph group_engine["Analysis engine"]
  node_engine_api["Processing API<br/>[app.py]"]
  node_attempts["Attempt handling<br/>[attempts.py]"]
  node_pipeline["Video analysis<br/>[pipeline.py]"]
  node_tracking["Person tracking<br/>[tracking.py]"]
  node_candidate_analysis["Candidate sightings<br/>[analyses.py]"]
  node_evidence_rendering["Evidence media<br/>[evidence.py]"]
  node_contract["Analysis contract<br/>[schemas.py]"]
end

node_investigator(("Investigator"))

node_investigator -->|"uses"| node_app
node_app -->|"renders"| node_camera_ui
node_app -->|"renders"| node_processing_ui
node_app -->|"renders"| node_search_ui
node_app -->|"uses"| node_evidence_ui
node_app -->|"uses"| node_review_ui
node_search_ui -.->|"requests sightings"| node_investigation_service
node_processing_ui -.->|"manages jobs"| node_processing_service
node_review_ui -.->|"submits decisions"| node_review_service
node_backend -->|"registers"| node_camera_service
node_backend -->|"registers"| node_investigation_service
node_backend -->|"registers"| node_review_service
node_backend -->|"registers"| node_processing_service
node_backend -->|"configures"| node_engine_client
node_backend -->|"configures"| node_data_store
node_processing_service -->|"dispatches attempts"| node_engine_client
node_engine_api -->|"submits attempts"| node_attempts
node_engine_api -->|"runs analysis"| node_pipeline
node_pipeline -->|"uses tracks"| node_tracking
node_pipeline -->|"qualifies tracks"| node_candidate_analysis
node_pipeline -->|"renders evidence"| node_evidence_rendering
node_pipeline -->|"validates batch"| node_contract
node_candidate_analysis -->|"reads track data"| node_tracking

click node_app "https://github.com/khairulhafis/mynav/blob/main/Frontend/src/app/App.jsx"
click node_camera_ui "https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/cameras"
click node_processing_ui "https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/processing"
click node_search_ui "https://github.com/khairulhafis/mynav/blob/main/Frontend/src/features/investigations/useSightingSearch.js"
click node_evidence_ui "https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/evidence"
click node_review_ui "https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/reviews"
click node_backend "https://github.com/khairulhafis/mynav/blob/main/Backend/src/app/compositionRoot.js"
click node_camera_service "https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/cameras"
click node_investigation_service "https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/investigations"
click node_review_service "https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/reviews"
click node_processing_service "https://github.com/khairulhafis/mynav/blob/main/Backend/src/modules/processing/application.js"
click node_data_store "https://github.com/khairulhafis/mynav/tree/main/Backend/src/infrastructure/persistence/json"
click node_engine_client "https://github.com/khairulhafis/mynav/blob/main/Backend/src/infrastructure/engine/httpModelProcessingClient.js"
click node_engine_api "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/app.py"
click node_attempts "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/application/attempts.py"
click node_pipeline "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/application/pipeline.py"
click node_tracking "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/domain/tracking.py"
click node_candidate_analysis "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/domain/analyses.py"
click node_evidence_rendering "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/infrastructure/evidence.py"
click node_contract "https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/schemas.py"

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_app,node_camera_ui,node_processing_ui,node_search_ui,node_evidence_ui,node_review_ui toneBlue
class node_backend,node_camera_service,node_investigation_service,node_review_service,node_processing_service,node_data_store,node_engine_client toneAmber
class node_engine_api,node_attempts,node_pipeline,node_tracking,node_candidate_analysis,node_evidence_rendering,node_contract,node_investigator toneIndigo
```

## Components

### Investigator interface

- [Workspace app](https://github.com/khairulhafis/mynav/blob/main/Frontend/src/app/App.jsx): `Frontend/src/app/App.jsx`
- [Camera setup](https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/cameras): `Frontend/src/features/cameras`
- [Job workspace](https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/processing): `Frontend/src/features/processing`
- [Sighting search](https://github.com/khairulhafis/mynav/blob/main/Frontend/src/features/investigations/useSightingSearch.js): `Frontend/src/features/investigations/useSightingSearch.js`
- [Evidence review](https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/evidence): `Frontend/src/features/evidence`
- [Review decisions](https://github.com/khairulhafis/mynav/tree/main/Frontend/src/features/reviews): `Frontend/src/features/reviews`

### Backend services

- [HTTP application](https://github.com/khairulhafis/mynav/blob/main/Backend/src/app/compositionRoot.js): `Backend/src/app/compositionRoot.js`
- [Camera service](https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/cameras): `Backend/src/modules/cameras`
- [Investigation search](https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/investigations): `Backend/src/modules/investigations`
- [Review service](https://github.com/khairulhafis/mynav/tree/main/Backend/src/modules/reviews): `Backend/src/modules/reviews`
- [Job orchestration](https://github.com/khairulhafis/mynav/blob/main/Backend/src/modules/processing/application.js): `Backend/src/modules/processing/application.js`
- [Application data](https://github.com/khairulhafis/mynav/tree/main/Backend/src/infrastructure/persistence/json): `Backend/src/infrastructure/persistence/json`
- [Engine client](https://github.com/khairulhafis/mynav/blob/main/Backend/src/infrastructure/engine/httpModelProcessingClient.js): `Backend/src/infrastructure/engine/httpModelProcessingClient.js`

### Analysis engine

- [Processing API](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/app.py): `VideoAnalysisEngine/app.py`
- [Attempt handling](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/application/attempts.py): `VideoAnalysisEngine/src/application/attempts.py`
- [Video analysis](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/application/pipeline.py): `VideoAnalysisEngine/src/application/pipeline.py`
- [Person tracking](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/domain/tracking.py): `VideoAnalysisEngine/src/domain/tracking.py`
- [Candidate sightings](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/domain/analyses.py): `VideoAnalysisEngine/src/domain/analyses.py`
- [Evidence media](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/infrastructure/evidence.py): `VideoAnalysisEngine/src/infrastructure/evidence.py`
- [Analysis contract](https://github.com/khairulhafis/mynav/blob/main/VideoAnalysisEngine/src/schemas.py): `VideoAnalysisEngine/src/schemas.py`

### Other components

- **Investigator**

## Connections

- Investigator → Workspace app: uses (evidence: `README.md`)
- Workspace app → Camera setup: renders (evidence: `Frontend/src/app/App.jsx`)
- Workspace app → Job workspace: renders (evidence: `Frontend/src/app/App.jsx`)
- Workspace app → Sighting search: renders (evidence: `Frontend/src/app/App.jsx`)
- Workspace app → Evidence review: uses (evidence: `Frontend/src/app/App.jsx`)
- Workspace app → Review decisions: uses (evidence: `Frontend/src/app/App.jsx`)
- Sighting search → Investigation search: requests sightings
- Job workspace → Job orchestration: manages jobs
- Review decisions → Review service: submits decisions
- HTTP application → Camera service: registers (evidence: `Backend/src/app/compositionRoot.js`)
- HTTP application → Investigation search: registers (evidence: `Backend/src/app/compositionRoot.js`)
- HTTP application → Review service: registers (evidence: `Backend/src/app/compositionRoot.js`)
- HTTP application → Job orchestration: registers (evidence: `Backend/src/app/compositionRoot.js`)
- HTTP application → Engine client: configures (evidence: `Backend/src/app/compositionRoot.js`)
- HTTP application → Application data: configures (evidence: `Backend/src/app/compositionRoot.js`)
- Job orchestration → Engine client: dispatches attempts (evidence: `Backend/src/modules/processing/application.js`)
- Processing API → Attempt handling: submits attempts (evidence: `VideoAnalysisEngine/app.py`)
- Processing API → Video analysis: runs analysis (evidence: `VideoAnalysisEngine/app.py`)
- Video analysis → Person tracking: uses tracks (evidence: `VideoAnalysisEngine/src/application/pipeline.py`)
- Video analysis → Candidate sightings: qualifies tracks (evidence: `VideoAnalysisEngine/src/application/pipeline.py`)
- Video analysis → Evidence media: renders evidence (evidence: `VideoAnalysisEngine/src/application/pipeline.py`)
- Video analysis → Analysis contract: validates batch (evidence: `VideoAnalysisEngine/src/application/pipeline.py`)
- Candidate sightings → Person tracking: reads track data (evidence: `VideoAnalysisEngine/src/domain/analyses.py`)
