e5vosdo-snimrod

Modern webapplikáció az Eötvös József Gimnázium Diákönkormányzatának

Tervezte és fejlesztette: Simon Nimród

---

📱 Hamarosan Android alkalmazás!

PWA változat már elérhető a weben, a bal fenti letöltés ikonra kattintva: e5vosdo.hu

---

📋 Tartalom

• 🎯 Áttekintés
• 🎨 Funkciók
• 🛠️ Technológiai stack
• 🚀 Kezdő lépések
• 💻 Fejlesztés
• 📄 Licenc
• 🙏 Köszönetnyilvánítás

---

🎯 Áttekintés

Az e5vosdo-snimrod egy korszerű, full-stack webapplikáció, amely az Eötvös József Gimnázium diákjainak és tanárainak mindennapi iskolai életét segíti. A platform modern technológiákra épül, intuitív felhasználói élményt és gyors teljesítményt biztosítva.

A projekt nemcsak egy eszköz, hanem egy közösségi nyílt forrású kezdeményezés is, amely lehetővé teszi a diákok számára, hogy tapasztalatot szerezzenek a webfejlesztés terén, miközben hozzájárulnak iskolájuk digitális környezetének fejlesztéséhez.

✨ Miért ez a projekt?

• 🚀 Modern architektúra: Next.js 15 alapú, server-side rendering és optimalizált teljesítmény
• 💅 Elegáns design: HeroUI komponensek és Tailwind CSS styling
• 🔒 Biztonságos: Google authentikáció (szervezeti szintű) és jogosultságkezelés
• 📱 Reszponzív: Mobil-első megközelítés, minden eszközön tökéletes megjelenés
• 💡 Szabad fejlesztés: Nyílt forráskódú, közösségi hozzájárulásokra ösztönző projekt
• 🤝 Közösségközpontú: Eseményfeltöltési lehetőségek és közösségi interakciók

🎨 Funkciók

• 📅 Órarend kezelés: Valós idejű órarend és helyettesítések megjelenítése
• 🎭 Események: Iskolai programok és események koordinálása
• 🍽️ Menza: Naprakész menü információk
• ⚽ Sport: Sportprogramok és edzések nyilvántartása
• 👤 Felhasználói profilok: Személyre szabott beállítások és preferenciák
• 🔔 Értesítések: PWA támogatás push notifikációkkal
• 🌙 Téma váltás: Világos, sötét és egyedi témák
• 🏫 Teremfoglaltság: Hamarosan

---

🛠️ Technológiai stack

Frontend

• Next.js 15 - React framework server-side renderinggel
• TypeScript - Type-safe fejlesztés
• HeroUI - Modern UI komponenskönyvtár
• Tailwind CSS - Utility-first CSS framework
• Framer Motion - Smooth animációk
• next-themes - Téma kezelés

DevOps

• Docker - Konténerizált deployment
• Python - Segédeszközök és scraping

---

🚀 Kezdő lépések

Előfeltételek

• Node.js 18.x vagy újabb
• npm package manager
• Git

Telepítés

1️⃣ Repo klónozása

git clone https://github.com/sibosi/e5vosdo-snimrod.git
cd e5vosdo-snimrod

2️⃣ Függőségek telepítése

npm install

3️⃣ Környezeti változók beállítása

Hozz létre egy .env.local fájlt a projekt gyökérkönyvtárában:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4️⃣ Fejlesztői szerver indítása

npm run dev

A projekt elérhető lesz a http://localhost:3000 címen.

---

💻 Fejlesztés

Egyéb használt technológiák

• Google Analytics
• Google Cloud
• Supabase Storage

Projekt struktúra

e5vosdo-snimrod/
├── app/                   # Next.js App Router
│   ├── (e5vosdo)/         # Fő alkalmazás route group
│   ├── api/               # API routes
│   └── layout.tsx         # Root layout
├── components/            # React komponensek
├── db/                    # Database utilities
├── config/                # Konfiguráció fájlok
├── hooks/                 # Custom React hooks
├── types/                 # TypeScript type definitions
└── public/                # Statikus fájlok

---

📄 Licenc

A projekt vagy bármely része kizárólag a szerző írásos engedélyével terjeszthető vagy használható.

Licensed under the MIT license.

---

🙏 Köszönetnyilvánítás

Külön köszönet mindenkinek, aki hozzájárult a projekt sikeréhez:

💪 Támogatók

• Ábel - Tanácsadás
• Lajos - Szerverszerzési ötletek
• Barnabás - Tanácsadás és ihletszerzés
• Zsolt - Segítség mindenben is
• Ádám - A transzfermester

🧪 Tesztelők

• Vince - Az örök Android tesztelő
• Timi - Az örök iOS tesztelő, aki sajnos (vagy nem sajnos) Androidra váltott

---

Készítette Simon Nimród

Az Eötvös József Gimnázium Diákönkormányzatának

📧 Email • 🐛 Issue beküldése