rustysnek / elixirus

Alternative Frontend for Synergia Learning Managment System written in Elixir LiveView for better user experience.

A better replacement for Synergia Learning Managment System frontend

Tech used

• Phoenix LiveView - Rich, real-time user experiences with server-rendered HTML 🐦
• bun - Incredibly fast JavaScript runtime, bundler, test runner, and package manager 🥖
• erlport - Connecting Elixir with Python 🧪 ❤️ 🐍
• librus-apix - Web Scraper for Librus Synergia written in Python 🪛🐍

Working with devenv

Run direnv allow to allow .envrc execution

Prerequisites

• bun
• erlang
• elixir 1.15
• python 3.11
• pip

Setup

• To simplify setup you can run: sh initialize.sh

• Manual setup

  Set MIX_BUN_PATH and PYTHONPATH:

  export MIX_BUN_PATH=$(which bun)
  export PYTHONPATH="$PWD/priv/librus-apix:$PWD/priv/librus-apix/venv/lib/python3.11/site-packages"

  Install mix and bun dependancies:

  mix deps.get
  bun install

  Setup python environment:

  python -m venv $PWD/priv/librus-apix/venv
  source $PWD/priv/librus-apix/venv/bin/activate
  pip install -r $PWD/priv/librus-apix/requirements.txt
  deactivate

• Start Phoenix endpoint with mix phx.server or inside IEx with iex -S mix phx.server

  Now you can visit localhost:4001 from your browser.

Tasks

Todo

• Think of some cool extras to include 😲

In Progress

• Make stuff more appealing to user's eye
  • Mobile scalibility down to 320px

Done ✓

• Announcements Page 📯
  • Parse descriptions properly 📯
• Schedule Page 📆
  • Add schedule page 📑
  • Add schedule to Timetable 🗓️
• Overview Page 📄
• Host the application 🚀
• Docker 🐳
  • Auto deploy 📦
• Attendance Page ✔️
• Add frequency percentage
• Grades Page 📑
  • Calculating averages 💯
  • Add nice filtering for subjects and grades 🧐
• Homework Page 📰
• Timetable page 🗓️
  • Add timeline indicator 🕚
  • Add google calendar functionality
  • Add details modal 🔍
• Messages Page 📫
  • Handle recieved messages 📩
  • Sending messages 📩
  • Add message content modal 📑
• Authentication
  • Add a modal for quick login to pages

elixirus's Issues

more features

Add schedule to timetable✔️
Add healthcheck status + token status and option to keep it alive after logging in ✔️
Count total absences ✔️
Better dropdown placements for mobile ✔️
Next weeks for timetable ✔️
choose token ttl when logging in ✔️
reply in messages ✔️
Add google calendar to schedule
Next months for schedule
save timetable week in url
Save token ttl options in local storage✔️

Add proper error handling

as of now stuff just refresh loops if error is encoutered

Fix focus and autofill username bugging out in lovin screen

probably adding an event listener on show and hide will help instead of mount hook

Fix stuff

• fix semester cookie and add a way to select it ✔️
• fix flowbite tooltips ✅
• fix mobile navigator ☑️
• add grade averages 🏁
• add weight to grade view ✅
• maybe do something with how messsages look ~ postponed

slow replies

as of now replies load all group's recipient's in search of recipient id. This takes some time and isn't really efficient. Find a better solution...

Moar improvements ✨

Do something about scroll sensitivity on mobile in timetable -
Fix the initial semester value to be actually correct +
Add general average for each semester +
Group navigation into categories +
create overview for each category +