Skip to content

FurriousFox/Zermos-Archive

 
 

Repository files navigation

Zermos icon

Zermos

Alle schoolinformatie in één oogopslag

GitHub Stars License: MIT Website Status Changelog


Welkom bij Zermos 🎉

Leuk dat je geïnteresseerd bent in Zermos!
Zermos is een webapplicatie die je net dat beetje extra geeft. Het laat je Somtoday, Zermelo en Infowijs koppelen aan je account, zodat je in één oogopslag al je info bij elkaar hebt — superhandig.

Deze pagina’s zijn bedoeld om je wegwijs te maken in Zermos.


✨ Wat Zermos kan (als je alles hebt gekoppeld):

  • 📅 Je rooster bekijken én delen met vrienden
  • 📊 Je cijfers tot in detail inzien
  • 📝 Zelf huiswerk plannen en filteren

➡️ Check het hier: https://zermos.kronk.tech


📖 Het verhaal achter Zermos

Ik heb Zermos over een paar jaar tijd gebouwd, met veel plezier. Op een gegeven moment hing ik zelfs posters door de school om meer leerlingen te overtuigen het te gebruiken. Dat leverde uiteindelijk maar zo’n ±100 gebruikers op, maar geloof me: het voelde ultiem gaaf om te zien dat het werkte.

Nu ben ik klaar met de middelbare school en vind ik dat dit project voor iedereen toegankelijk moet zijn. Er zit ongelofelijk veel werk in de koppelingen, en ik heb heel wat uitgezocht over de systemen van Somtoday en Infowijs. Daarom deel ik nu alles met jullie: leer ervan, bouw erop verder, doe ermee wat je wil — (wel graag conform licentie 😉).


⚠️ Belangrijke kanttekeningen

Let op: Zermos, Somtoday, Zermelo en Infowijs hebben geen officiële samenwerking of contract. Buiten Zermelo werd het project eigenlijk niet “gewenst” 😬.

  • Dit is een archief van de volledige code, niet per se bedoeld om zelf 1-op-1 te hosten. Het mag wel, maar houd er rekening mee dat alles is gebouwd op mijn eigen infrastructuur.
  • Ja, ik heb fouten gemaakt. Heel veel. Vooral hardcoded databasewachtwoorden (die nu allemaal gepatcht zijn). Dus nee, je gaat geen bruikbare wachtwoorden vinden. Alles wat je ziet is oud en onbruikbaar.

🛠️ Gebruikte technologieën & evolutie van Zermos

Het hele project is echt een groeiverhaal, met behoorlijk wat omzwervingen in technologie en aanpak — ik neem je even mee:

  1. Unity project (vanuit niks)
    De allereerste versie van Zermos was een experiment in Unity, puur vanilla. Geen frameworks, niks fancy, gewoon leren door doen. Dit was vooral een proof of concept, niks voor productie.
Filmpje met hoe dat eruit zag
Zermelo+Somtoday.-._MainScene.-.Android.-.Unity.2021.3.17f1.Personal_._DX11_.2023-03-02.13-10-36.mp4
  1. Raw HTML/CSS/JS website
    Daarna ben ik helemaal teruggegaan naar basics: een pure statische website met vanilla HTML, CSS en JavaScript. Lekker direct, geen gedoe met backend, maar wel beperkt in wat je kon doen met de koppelingen.
Wat was dit intens lelijk 😬

Screenshot 1 Screenshot 2 Screenshot 3

  1. ASP.NET Core website (huidige versie)
    Toen vond ik het tijd voor iets stevigers: een ASP.NET Core backend, waarmee ik alle koppelingen serieus kon aanpakken en dynamische functionaliteit kon bouwen. Dit is nu het kloppende hart van Zermos.

    Dit gaf me ook de optie om een database voor gebruikers aan te maken, dus dan konden mensen op hun computer, tablet, ipad, laptop, telefoon, en ja ook smartwatch hun rooster, cijfers en alles bekijken!

  2. Windows, Android en PWS apps
    Om het af te maken zijn er ook native apps gekomen:

    • Allen zijn in feite een webview van de website.
    • Met extra kleine features, zoals deeplinking, speciaal voor de Somtoday-koppeling. (android en windows)
    • Hiermee kon ik gebruikers een app-gevoel geven zonder alles helemaal opnieuw te bouwen.

Zermos is dus niet één rechtlijnig project, maar een verzameling experimenten, verbeteringen en platformen die samen het huidige product vormen. Het was soms frustrerend en chaotisch, maar ook super leerzaam.


🖼️ Screenshots

Klik om screenshots te tonen

Screenshot 4
Screenshot 5
Screenshot 6
Screenshot 7
Screenshot 8

Niet alle screenshots zijn beschikbaar — ik heb geen toegang meer tot Somtoday, dus de cijferpagina’s ontbreken.


🎨 Promo posters

Klik om posters te bekijken

Poster 1
Poster 2


🌐 Hosting & documentatie

Voor nu blijf ik Zermos gewoon hosten, inclusief documentatie:
https://zermos-docs.kronk.tech


📜 Changelog

De volledige changelog vind je hier:
📄 Bekijk de changelog


🛠️ Disclaimers

  • Ja, er zat een backdoor in — maar alleen in de debug build en alleen als het ingelogde e-mailadres hetzelfde was als het mijne. Daarmee kon ik inloggen op accounts van anderen, puur om te helpen tijdens de moeizame uitrol.
  • Licentie: MIT. Je mag het gebruiken, verkopen, aanpassen, maar niet claimen als eigen code. Ik heb hier jaren aan gewerkt, door 5 à 6 totaal verschillende versies heen. Het minste wat ik verdien, is dat je me credit geeft.

About

Zermos is een web-applicatie die Somtoday, Zermelo én Infowijs' Hoy app combineerd in één overzichtelijke web-app (ARCHIEF)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • C# 40.0%
  • HTML 36.6%
  • JavaScript 11.7%
  • CSS 11.5%
  • Dockerfile 0.2%