NavigaTUM is a tool developed by students for students, to help you get around at TUM. Feel free to contribute, we are open to new people π.
Features:
- Interactive or static maps to look up the position of rooms or buildings
- Fast and typo-tolerant search
- Support for different room code formats as well as generic names
All functionality is also available via an API.
Note: Not all buildings in NavigaTUM are owned by TUM, but are instead being used by TUM departments.
You can consume our API Documentation in two ways:
- Head over to our Website and look at the interactive documentation
- We also describe our API in an OpenAPI 3.0 compliant file.
You can find it here.
Using this Specification you can generate your own client to access the API in the language of your choice. To do this head over to the Swagger Editor or other similar OpenAPI tools.
Note: The API is still under development, and we are open to Issues, Feature Requests or Pull Requests.
NavigaTUM consists of three main parts + deployment resources.
Depending on what you want to work on, you do not need to set up all of them. For an overview of how the components work, have a look at the deployment documentation.
data/
contains the code to obtain and process the dataserver/
contains the APIs written in Rustwebclient/
contains a JS based web-frontend for the APIdeployment/
contains deployment related configurationmap/
contains information about our own map, how to style it and how to run it
The following steps assume you have just cloned the repository and are in the root directory of it.
In case you do not want to work on the data processing, you can instead download the latest compiled files:
wget -P data/output https://nav.tum.de/cdn/api_data.json
wget -P data/output https://nav.tum.de/cdn/search_data.json
Else you can follow the steps in the data documentation.
If you want to work on the webclient only (and not server or data), you don't need to set up the server. You can instead either use the public API (see the webclient documentation) or use our ready-made docker images to run the server locally:
docker network create navigatum-net
sudo rm -fr /tmp/navigatum/ && mkdir -p /tmp/navigatum/ && mkdir -p /tmp/navigatum/meili/ && mkdir -p /tmp/navigatum/server/
docker run -it --rm -v /tmp/navigatum/meili:/meili_data ghcr.io/tum-dev/navigatum-mieli-search-init:main
docker run -it --rm -p 7700:7700 --name search -v /tmp/navigatum/meili:/meili_data --network navigatum-net getmeili/meilisearch:latest
docker run -it --rm -v /tmp:/navigatum/server/ ghcr.io/tum-dev/navigatum-building-db-init:main
docker run -it --rm -p 8080:8080 --network navigatum-net -e API_SVC_SERVICE_HOST=search ghcr.io/tum-dev/navigatum-server:main /bin/navigatum-main-api
Else you can follow the steps in the server documentation.
Follow the steps in the webclient documentation. If you want to only run the webclient locally, you can skip the "Data" and "Server" steps above and use docker (as seen above) or you can edit the webclient configuration to point to production.
We have multiple programming languages in this repository, and we use different tools to format them.
since we use pre-commit to format our code, you can install it in an virtual environment with:
python3 -m venv venv
source venv/bin/activate
pip install -r data/requirements.txt -r server/test/requirements.txt -r requirements-dev.txt # for mypy the server and data requirements are needed
To format all files, run the following command:
pre-commit run --all-files
You can also automatically format files on every commit by running the following command:
pre-commit install
All code is licensed under the GNU GPL v3:
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.