https://github.com/emiran404/atolye.platform
Atölye.Platform, PolyOS tarafından geliştirilen açık kaynaklı bir sınav gönderme ve eğitim yönetim platformudur. Pardus okul laboratuvarları için optimize edilmiştir.
https://github.com/emiran404/atolye.platform
education exam-system linux management-system multilingual nodejs ogrenci-merkezli-egitim open-source open-source-project pardus react sinav-sistemi student-management-system student-platform
Last synced: about 1 month ago
JSON representation
Atölye.Platform, PolyOS tarafından geliştirilen açık kaynaklı bir sınav gönderme ve eğitim yönetim platformudur. Pardus okul laboratuvarları için optimize edilmiştir.
- Host: GitHub
- URL: https://github.com/emiran404/atolye.platform
- Owner: Emiran404
- License: mit
- Created: 2026-03-13T20:58:26.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-09T18:29:38.000Z (2 months ago)
- Last Synced: 2026-04-09T19:37:00.116Z (2 months ago)
- Topics: education, exam-system, linux, management-system, multilingual, nodejs, ogrenci-merkezli-egitim, open-source, open-source-project, pardus, react, sinav-sistemi, student-management-system, student-platform
- Language: JavaScript
- Homepage:
- Size: 73.9 MB
- Stars: 7
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🎓 Atölye.Platform
### Eğitim kurumları için modern, güvenli ve dinamik sınav yönetim ekosistemi.
[](https://github.com/Emiran404/Atolye.Platform/releases)
[](LICENSE)
[](https://github.com/Emiran404/Atolye.Platform)
[](https://react.dev/)
[](https://vitejs.dev/)
[](https://nodejs.org/)
[](https://expressjs.com/)
[](https://www.electronjs.org/)
[](https://socket.io/)
[](https://tailwindcss.com/)
[](https://zustand-demo.pmnd.rs/)
[](https://webauthn.io/)
[](https://liderahenk.org/)
[](src/utils/i18n.js)
[](https://www.npmjs.com/package/bonjour-service)
     
[Özellikler](#-temel-özellikler) • [Ekran Görüntüleri](#-ekran-görüntüleri) • [Kurulum](#-kurulum) • [Mimari](#-sistem-mimarisi) • [Yol Haritası](#-yol-haritası)
---
## 🌟 Nedir?
**Atölye.Platform**, Alanya Mesleki ve Teknik Anadolu Lisesi için geliştirilen, **Pardus** ve **Debian** tabanlı sistemlerde yerel ağ üzerinden çalışan açık kaynaklı bir sınav ve ödev yönetim ekosistemidir. Öğretmenlere uçtan uca sınav oluşturma, dağıtma, toplama ve değerlendirme; öğrencilere ise şık ve odaklanmış bir portal sunar.
> [!NOTE]
> **Atölye.Platform** bir [PolyOS](https://github.com/Emiran404) ürünüdür — *Pardus Okul Laboratuvar Yönetim ve Ödev Sistemi.*
---
## 📥 Hazır Paketler
Derleme yapmadan, aşağıdaki hazır paketlerle saniyeler içinde kurulum yapın:
| | Paket | İşletim Sistemi | İndir |
| :---: | :--- | :--- | :---: |
| 🖥️ | **Öğretmen Sunucusu** | Pardus / Debian | [📥 `.deb` Sunucu](https://github.com/Emiran404/Atolye.Platform/releases/latest) |
| 🪟 | **Masaüstü İstemci** | Windows 10/11 | [📥 `.exe` Kurulum](https://github.com/Emiran404/Atolye.Platform/releases/latest) |
| 🐧 | **Masaüstü İstemci** | Linux / Pardus | [📥 `.deb` İstemci](https://github.com/Emiran404/Atolye.Platform/releases/latest) |
> [!TIP]
> **Pardus kullanıcıları:** `.deb` paketlerini çift tıklayarak veya `sudo dpkg -i paket.deb` komutuyla yükleyebilirsiniz.
---
## ✨ Temel Özellikler
### 👨🏫 Öğretmen Paneli
- 📊 **Canlı Dashboard** — İstatistik kartları ve anlık aktivite akışı
- 📝 **Sınav Oluşturma** — Esnek süre, sınıf hedefleme ve çoklu format desteği
- 🔍 **Akıllı Değerlendirme** — Split-view dosya inceleme ve anlık notlandırma
- 📈 **İstatistik & Raporlama** — Sınıf bazlı başarı analizi ve PDF rapor
- 🗂️ **Dinamik Arşiv** — Geçmiş sınavları filtreleme ve toplu dışa aktarma
- 📅 **Sınav Takvimi** — Haftalık/aylık planlama görünümü
- 🏫 **Sınıf Yönetimi** — Dinamik sınıf ekleme/silme (API-driven)
- 👥 **Öğrenci Listesi** — Kayıt durumu takibi ve toplu yönetim
### 👨🎓 Öğrenci Paneli
- 🎯 **Odaklanmış Arayüz** — Sadece aktif sınavlara odaklanan sade tasarım
- 📤 **Sürükle-Bırak Yükleme** — Gelişmiş dosya yükleme ile hızlı teslim
- 📋 **Sınav Geçmişi** — Geçmiş notlar ve geri bildirimleri görüntüleme
- 🔔 **Anlık Bildirimler** — Socket.io ile gerçek zamanlı uyarılar
- 🔐 **Passkey Girişi** — Şifresiz, biyometrik kimlik doğrulama
- 🌍 **4 Dil Desteği** — Türkçe, İngilizce, Almanca ve Rusça
### 🛡️ Güvenlik & Entegrasyon
| Özellik | Açıklama |
| :--- | :--- |
| **🔐 WebAuthn / Passkey** | Windows Hello ve Pardus biyometrik sistemleriyle şifresiz giriş |
| **📂 LiderAhenk / LDAP** | Kurumsal kullanıcı dizinleriyle otomatik senkronizasyon *(Beta)* |
| **📡 mDNS Auto-Discovery** | İstemciler sunucuyu ağda otomatik keşfeder — IP girmeye gerek yok |
| **🛡️ Kod Karıştırma** | Production build'de JavaScript Obfuscation ile kaynak kodu koruması |
| **🔒 JWT Authentication** | Her API çağrısında token bazlı yetkilendirme |
| **⏱️ Rate Limiting** | Brute-force ve DDoS koruması |
| **📑 Güvenli PDF/Resim** | Kimlik doğrulamalı ve korumalı dosya izleyici (v3.7.0) |
---
## 📸 Ekran Görüntüleri
### Öğretmen Paneli
| Dashboard | Sınav Oluşturma |
| :---: | :---: |
|  |  |
| *Canlı istatistikler ve sistem takibi* | *Esnek sınav hazırlama ekranı* |
| Değerlendirme | Kullanıcı Yönetimi |
| :---: | :---: |
|  |  |
| *Split-view notlandırma ve geri bildirim* | *Öğrenci ve öğretmen hesap yönetimi* |
| Güvenlik Ayarları | |
| :---: | :---: |
|  | |
| *Passkey, güvenlik ve platform ayarları* | |
| Öğrenci Dashboard | Sınav Ekranı | Soru Görüntüleyici |
| :---: | :---: | :---: |
|  |  |  |
| *Sade ve odaklanmış öğrenci portalı* | *Dosya yükleme ve sınav teslim arayüzü* | *Güvenli ve şık dosya izleme modalı* |
### Ana Sayfa
*Cinematic tasarımlı ana sayfa*
---
## 🚀 Kurulum
### Sistem Gereksinimleri
| Gereksinim | Minimum |
| :--- | :--- |
| **Node.js** | v18.0.0+ |
| **npm** | v9.0.0+ |
| **İşletim Sistemi** | Pardus 21+ / Debian 11+ / Windows 10+ |
| **RAM** | 2 GB (Sunucu) |
| **Disk** | 500 MB boş alan |
### Hızlı Başlangıç (Linux / Pardus)
```bash
# 1. Projeyi klonlayın
git clone https://github.com/Emiran404/Atolye.Platform.git
cd Atolye.Platform
# 2. Otomatik kurulum sihirbazını çalıştırın
chmod +x kurulum.sh
./kurulum.sh
# 3. Platformu başlatın
chmod +x baslat.sh
./baslat.sh
```
### Manuel Kurulum
```bash
# 1. Projeyi klonlayın
git clone https://github.com/Emiran404/Atolye.Platform.git
cd Atolye.Platform
# 2. Bağımlılıkları yükleyin (frontend + backend)
npm run install:all
# 3. .env dosyasını yapılandırın
cp .env.example .env
# 4. Geliştirme modunda başlatın
npm run dev
# 5. Production build
npm run build
```
> [!WARNING]
> **Windows kullanıcıları:** `kurulum.sh` yerine doğrudan `npm run install:all` ve `npm run dev` komutlarını kullanın.
---
## 🏗️ Sistem Mimarisi
```
Atölye.Platform/
├── 📂 src/ # React Frontend (Vite)
│ ├── components/ # Yeniden kullanılabilir UI bileşenleri
│ ├── pages/
│ │ ├── teacher/ # 20+ öğretmen modülü
│ │ ├── student/ # Öğrenci portalı
│ │ └── auth/ # Kimlik doğrulama sayfaları
│ ├── store/ # Zustand state yönetimi
│ ├── services/ # API istemci katmanı
│ └── utils/ # i18n, tarih ve yardımcı fonksiyonlar
├── 📂 server/ # Node.js / Express Backend
│ ├── routes/ # REST API endpoint'leri
│ ├── middleware/ # Auth, rate-limit, CORS
│ ├── data/ # JSON veri dosyaları (DB gerektirmez)
│ └── utils/ # LDAP, dosya işlemleri
├── 📂 client-electron/ # Electron masaüstü istemcisi
├── 📂 scripts/ # .deb paketleme scriptleri
├── 📂 deploy/ # Systemd servis yapılandırmaları
└── 📂 screenshots/ # Ekran görüntüleri
```
### Teknoloji Yığını
| Katman | Teknoloji | Versiyon |
| :--- | :--- | :--- |
| **Frontend** | React + Vite + Zustand | 19.x / 5.x / 5.x |
| **Arayüz** | Tailwind CSS + Vanilla CSS | 4.x |
| **İkonlar** | Lucide React | 0.5x |
| **Backend** | Node.js + Express.js | 18+ / 4.x |
| **Gerçek Zamanlı** | Socket.io | 4.x |
| **Masaüstü** | Electron + Electron-Builder | 30.x |
| **Keşif** | Bonjour (mDNS) | 1.x |
| **Auth** | JSON Web Token + WebAuthn | — |
| **Veri** | JSON tabanlı (DB gerektirmez) | — |
| **Grafikler** | Recharts | 3.x |
---
## 🗺️ Yol Haritası
- [x] ~~Dinamik sınıf yönetimi (API-driven)~~
- [x] ~~Passkey / WebAuthn desteği~~
- [x] ~~4 dilli arayüz (TR/EN/DE/RU)~~
- [x] ~~mDNS otomatik sunucu keşfi~~
- [x] ~~Windows (.exe) ve Linux (.deb) paketleri~~
- [x] ~~Cinematic UI ve Glassmorphism tasarım~~
- [x] ~~Çoklu öğretmen desteği ve rol yönetimi~~
- [ ] LiderAhenk tam entegrasyon (LDAP kullanıcı senkronizasyonu)
- [ ] Otomatik sınav değerlendirme (OGA modülü)
- [ ] Docker konteyner desteği
- [ ] Progressive Web App (PWA) desteği
---
## 🧹 Bakım
Sistem sıfırlama gerektiğinde:
| Platform | Komut |
| :--- | :--- |
| **Linux / Pardus** | `./cleanup_linux.sh` |
| **Windows** | `cleanup_windows.bat` |
> Bu araçlar kilitli süreçleri otomatik sonlandırır ve sistemi fabrika ayarlarına döndürür.
---
## 🤝 Katkıda Bulunma
Katkılarınızı bekliyoruz! Detaylı bilgi için [CONTRIBUTING.md](CONTRIBUTING.md) dosyasına göz atın.
1. 🍴 Projeyi **Fork** edin
2. 🌿 Feature branch oluşturun (`git checkout -b feature/yeni-ozellik`)
3. 💾 Commit yapın (`git commit -m "feat: yeni özellik eklendi"`)
4. 🚀 Push edin (`git push origin feature/yeni-ozellik`)
5. 📬 **Pull Request** açın
---
## 📄 Lisans
Bu proje [MIT](LICENSE) lisansı altında lisanslanmıştır. Eğitim amaçlı özgürce kullanılabilir.
---
### 💙 Atölye.Platform
**Alanya Mesleki ve Teknik Anadolu Lisesi**
Geliştiren: [Emirhan Gök](https://github.com/Emiran404) • PolyOS Ekosistemi
*Coded with ❤️ for the future of education.*
[⭐ Bu projeyi beğendiyseniz yıldız vermeyi unutmayın!](https://github.com/Emiran404/Atolye.Platform)