ADE-Scheduler

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #typescript #deep-learning #docker #windows #kubernetes #vue #awesome-list #pytorch #security #openai

(★ 34)

A webapp for UCLouvain's ADE scheduling tool.

ADE-Scheduler 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ADE Scheduler: a scheduling tool made for humans

[ADE-Scheduler](https://ade-scheduler.info.ucl.ac.be/) is a web-application made by (former) students which is destined to be used by UCLouvain members (students, academics,...).

### Project creators

- [Eertmans Jérome](https://www.linkedin.com/in/j%C3%A9rome-eertmans-130ab1130/) (active maintainer)
- [Navarre Louis](https://www.linkedin.com/in/louis-navarre-36b78b143/) (maintainer until ~2021)
- [Poncelet Gilles](https://www.linkedin.com/in/gilles-poncelet-020442195/) (active maintainer)

We are three former students from the Ecole Polytechnique de Louvain (EPL) and were starting our first master year at the start of the project.

### Project maintainers

- Laurent Dubois ([@lauren-d](https://github.com/lauren-d))

### Why such a tool ?

Until our tool became the official tool used by UCLouvain, the previously used scheduling tool, [ADE](http://horaire.uclouvain.be/direct/), lacked an intuitive interface and general usability. Therefore, we decided to create ADE-Scheduler as a "wrapper" around this tool to make it more intuitive, nice and complete.

Before that, we were using the excellent [ADE2ICS](https://github.com/cdamman/UCL2ICS) made by Corentin Damman which allowed to create subscription links where one could select its events (TPs, CMs, etc). ADE-Scheduler is therefore an improvement of this tool.

### Key dates

- **2019 - August**: start of the project
- **2019 - September**: access to the API of ADE and release of the first version of the tool
- **2020 - Summer**: complete overhaul of the tool to make it more attractive, intuitive and mobile-friendly.
- **2020 - September**: release of the second version of the tool
- **2021 - September**: 2 years of service, Python 3.9 upgrade and 3500+ users
- **2021 - December**: 7000+ users
- **2022 - January**: moving auth. system to UCLouvain OAuth, thereby resetting the number of users to 0 on January 29nth, 2022
- **2022 - Summer**: first major contribution from students to the ADE Scheduler repository
- **2024 - September**: ADE Scheduler became the **official UCLouvain scheduling tool** and changed its name to "Mon Horaire"!

### How does it work ?

#### Back-end <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/c/c3/Python-logo-notext.svg/1024px-Python-logo-notext.svg.png" alt="python" width="20" height="20"></img>

##### Data source

Thanks to the access to the API of ADE, we obtain all the information in a `XML` format. Those are up-to-date with the infos you will find on the ADE website. We are mainly interested in two type of informations:

- Event list sorted by course
- Location of every UCLouvain classroom, auditorium, etc.

#### Data treatment

The backend of ADE-Scheduler is written in Python using the [Flask](https://flask.palletsprojects.com/en/1.1.x/) micro-framework. Other packages are also used to supply many useful functions to enhance the overall user experience.\
Among those, we use [pandas](https://pandas.pydata.org/) pandas to optimise the performances, [ics](https://pypi.org/project/ics/) to convert the schedules in the iCal format - and many more.

We also use a [Redis](https://redis.io) server to store user sessions and buffer data, as well as a [PostgreSQL](https://www.postgresql.org/) database to store user accounts and schedules.

### Front-end <img src="https://www.w3.org/html/logo/downloads/HTML5_Badge_512.png" alt="html" width="20" height="20"></img> <img src="https://i1.wp.com/www.thekitchencrew.com/wp-content/uploads/2016/03/js-logo.png?fit=500%2C500" alt="js" width="20" height="20"></img>

Client-side logic is handled using [Vue](https://vuejs.org/), a JavaScript reactive framework. Moreover, the events are displayed on a calendar generated with the help of the [FullCalendar](https://fullcalendar.io) package.

The UI is made mainly with the help of [Bootstrap](https://getbootstrap.com/), which handles all the CSS and makes the website enjoyable and mobile-friendly.

### Functionalities and comparison with ADE

In short, ADE Scheduler offers the same information as ADE, but in a much
more elegant manner. A side by side comparison of the two sites just
speaks for itself:

![](https://raw.githubusercontent.com/ADE-Scheduler/ADE-Scheduler/main/static/img/ade_official_side_by_side.png)

![](https://raw.githubusercontent.com/ADE-Scheduler/ADE-Scheduler/main/static/img/ade_scheduler_side_by_side.png)

But an intuitive design is not the only advantage of ADE Scheduler, it also
comes with several useful tools which ADE does not have:

- [x] automatically load courses based on classes in your enrolled in;
- [x] black-listing some events in order to have a clean schedule
- [x] easily viewing multiple courses
- [x] handling multiple schedules
- [x] computing your optimized schedule which minimizes conflicts
- [x] adding private events
- [x] no connection required
- [x] caching of you data so you don't lose everything each time you leave
- [x] detailed map of classrooms and events associated
- [x] possibility to download schedule to iCal file or create subscription link
- [x] you can share you calendar with anyone you would like

... and many more !

### Documentation

The website's documentation is available on the [help page](monhoraire.uclouvain.be/help).

### Future improvements

Here are listed a series of issues we would like to implement in the future:

- Implement a complete testing suite to enable easy and robust CI
- Complete the help section with more videos, tips, etc.

We are open to any suggestions !

## Contributing

This application being open source, everyone is more than welcome to contribute in any way !
To see more details about our contributing guidelines, please refer to [contributing](/CONTRIBUTING.md).

Any suggestion, idea or bugs are much appreciated,
and you can contact us at all times via the
[discussions](https://github.com/ADE-Scheduler/ADE-Scheduler/discussions) page.

ADE-Scheduler

ADE-Scheduler 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ADE-Scheduler

ADE-Scheduler 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README