campus.unbloat.app

CampusUnbloat is the go-to home for any¹ BA student. It combines both CampusDual and Studentenwerk data into a modern and fast webapp. This is the frontend and main repository.

This project was inspired by the poor condition of campus dual

• wise words by Simon Nikolaidis.

Components

This repo: SvelteKit-based very cool app.io.dev.sh

🦀 campus-api: Adapter API for NetWeaver-based CampusDual

🦀 mensa-api: Adapter API for Studentenwerk Leipzig Mensae

docker-compose.yml

services:
  unbloat-frontend:
    image: docker.io/flschmidt/campusunbloat-webapp
    environment:
      - CD_API_URL=http://unbloat-api-campus:8080
      - MENSA_API_URL=http://unbloat-api-mensa:9090

      # Impressum data
      - PUBLIC_IMPRESS_FULLNAME= # your full name
      - PUBLIC_IMPRESS_STRASSE_HAUSNR= # your street and house number
      #- PUBLIC_IMPRESS_ADDRZUSATZ= Optional Adresszusatz
      - PUBLIC_IMPRESS_PLZ_ORT= # your zip code and city
      - PUBLIC_IMPRESS_TELEFON= # your phone number
      - PUBLIC_IMPRESS_EMAIL= # your email address

    # A reverse proxy is necessary for TLS. HTTP is only allowed in dev mode
    # ports:
    #   - '3000:3000'
    networks:
      - eduroam

  unbloat-api-campus:
    image: docker.io/flschmidt/campusunbloat-api-campus
    environment:
      - JWT_SECRET= # your JWT secret. The longer the better
      - AES_KEY= # your AES key. Has to be 32 bytes or longer (only the first 32 bytes will be used)
    networks:
      - eduroam

  unbloat-api-mensa:
    image: docker.io/flschmidt/campusunbloat-api-mensa
    environment:
      - FILTER_OPENMENSA=y # query every openmensa canteen and filter out those without data.
        # recommended but optional. Places some load on their servers
    volumes:
      - mensa_volume:/app/data # used for caching mensa data, technically optional
    networks:
      - eduroam

networks:
  eduroam:
volumes:
  mensa_volume:

Developing

1. Build both APIs

• have a working Rust toolchain (see here)
• api-mensa:
  • install SQLite3 development files (e.g. libsqlite3-dev on Debian)
• run cargo run in each root

2. Clone this repo

• npm i
• # CD_API_URL=http://localhost:8080 MENSA_API_URL=http://localhost:9090 npm run dev
  • these environment variables will likely be fine, but adapt them if necessary

Building

Dockerfiles exist in each repo, and workflows exist which demonstrate what needs to be done

Footnotes

1. Hundreds of canteens in Germany are supported thanks to OpenMensa, but Studentenwerk Leipzig has 'native' support. ↩