https://github.com/filips123/gimvicurnik

A system for a school timetable, substitutions and menus at Gimnazija Vič
https://github.com/filips123/gimvicurnik

gimvic menus substitutions timetable timetables

Last synced: 4 months ago
JSON representation

A system for a school timetable, substitutions and menus at Gimnazija Vič

• Host: GitHub
• URL: https://github.com/filips123/gimvicurnik
• Owner: filips123
• License: gpl-3.0
• Created: 2020-10-13T13:26:57.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-03-09T14:11:27.000Z (over 1 year ago)
• Last Synced: 2025-04-15T06:42:03.613Z (about 1 year ago)
• Topics: gimvic, menus, substitutions, timetable, timetables
• Language: Python
• Homepage: https://urnik.gimvic.org
• Size: 2.78 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
GimVičUrnik

===========

A system for a school timetable, substitutions and menus at Gimnazija Vič.

## Description

This repository contains a system for a Progressive Web App to show the timetable, substitutions, menus and lunch schedules for students and teachers at Gimnazija Vič.

It uses Python API built with Flask and SQLAlchemy to download and parse the data from the official sources (e-classroom, website) using pdfplumber and bs4. The website is built using Vue.js framework and Vuetify theme. The source code can be found in [`API`](API) and [`website`](website) subdirectories.

The website is currently deployed at [urnik.gimvic.org](https://urnik.gimvic.org).

**Warning:** This project is unofficial and may contain incomplete or incorrect information. To view the official data, use the official e-classroom of Gimnazija Vič.

## Usage

See the READMEs of the API and the website for more details and instructions how to set up them:

* [Python API](API/README.md)

* [JavaScript website](website/README.md)

## Versioning

The project uses [SemVer](https://semver.org/) for versioning. For the available versions and the changelog, see [the releases](https://github.com/filips123/GimVicUrnik/releases) on this repository.

The API and website at released tags are compatible with each other according to SemVer. The API and the website at non-tagged commits may *not* be compatible with each other, because it is possible that not both of them were updated at the same time.

## License

This project is licensed under the GPLv3+ license. See the [LICENSE](LICENSE) file for details.