Skip to content

Latest commit

Β 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Accessible Campus Navigation System β™ΏπŸ“

An end-to-end accessible route navigation web platform designed for university campuses. The system calculates optimal paths for mobility-impaired students using a Modified Dijkstra Algorithm that filters out non-accessible routes (e.g., stairs) in real time.


🌟 Key Features

  • Accessible Route Calculation: Custom pathfinding algorithm filtering paths based on accessibility attributes (is_accessible).
  • Voice Assistance (NFR-01): Integrated Web Speech API for visual-impaired usability.
  • Usability Focused: Built according to the 3-Click Rule for intuitive user navigation.
  • Admin Management Panel: Interface for administrators to update node/edge accessibility statuses.
  • Security & Testing: Full STRIDE Threat Modeling analysis (Rate-Limiting DoS mitigation) and 100% core test coverage via Jest.

πŸ› οΈ Tech Stack & Architecture

  • Frontend: React (Vite), Bootstrap 5, Web Speech API
  • Backend: NestJS (TypeScript, Modular Architecture)
  • Database: PostgreSQL via Supabase
  • DevOps & Containerization: Docker (Node Alpine Image)
  • Testing: Jest Unit Testing
  • Architecture Models: C4 Context & Container Diagrams, UML Use Case, Sequence, and Class Diagrams

πŸ—οΈ System Architecture

[ React Frontend ] ---> (REST API) ---> [ NestJS Backend ] ---> [ Supabase / Postgres ]
                                              |
                                    [ Dijkstra Engine ]
πŸ“‚ Repository Structure
Plaintext
β”œβ”€β”€ engelsiz-backend/      # NestJS REST API, Dijkstra Algorithm & Jest Tests
└── engelsiz-frontend/     # React web application UI

πŸš€ Getting Started with Docker
Prerequisites
Docker Desktop installed on your machine.

Running Backend via Docker
Clone the repository:

Bash
git clone [https://github.com/Arzuduzgun/accessible-campus-navigation.git](https://github.com/Arzuduzgun/accessible-campus-navigation.git)

Build and run the Docker container:

Bash
cd engelsiz-backend
docker build -t engelsiz-backend-image .
docker run -p 3000:3000 --env-file .env engelsiz-backend-image

Running Unit Tests
Bash
cd engelsiz-backend
npm test


About

An accessible campus navigation web app built with NestJS, React, PostgreSQL (Supabase), and Docker. Implements a modified Dijkstra algorithm, Web Speech API, and Jest unit testing.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages