📍 URL: https://asep.fmaths.gr
👤 Δημιουργός: Φώτης Χ. Κουτσουμπίδης
Το asep αποτελεί μια διαδραστική εφαρμογή προσομοίωσης και εξάσκησης με ερωτήσεις πολλαπλής επιλογής από το Μητρώο Θεμάτων Γνώσεων του ΑΣΕΠ, οργανωμένες σε 11 θεματικές ενότητες.
Ο χρήστης μπορεί να επιλέξει:
- συγκεκριμένες ή όλες τις ενότητες
- συγκεκριμένο πλήθος ερωτήσεων ή όλες τις διαθέσιμες ερωτήσεις
- λειτουργία προσομοίωσης ή εξάσκησης
- επανάληψη ερωτήσεων που απαντήθηκαν λανθασμένα
ℹ️ Η εφαρμογή είναι ανεπίσημη και προορίζεται αποκλειστικά για εκπαιδευτική χρήση, χωρίς εμπορικό σκοπό.
- ⚛️ React 19
- ⚡ Vite για ανάπτυξη και build
- 🟢 Node.js για npm scripts & περιβάλλον ανάπτυξης
- 🎨 JSX & CSS
- 📄 JSON δεδομένα για τις ερωτήσεις με αυτοματοποιημένο build
- 📊 Google Analytics (
gtag.js) - ✅ ESLint με React rules
asep/
├── README.md # Περιγραφή της εφαρμογής, οδηγίες εγκατάστασης και χρήσης
├── LICENSE # Άδεια χρήσης: CC BY-NC-ND 4.0
├── .gitignore # Εξαιρέσεις Git
├── package.json # Scripts και εξαρτήσεις του project
├── package-lock.json # Κλείδωμα εκδόσεων npm
├── vite.config.js # Ρυθμίσεις Vite
├── eslint.config.js # Ρυθμίσεις ESLint
├── index.html # Βασικό HTML με metadata και Google Analytics
├── public/
│ ├── logo.png # Λογότυπο για favicon και social preview
│ ├── sitemap.xml # Sitemap για SEO
│ └── robots.txt # Ρυθμίσεις crawlers και παραπομπή στο sitemap
├── data-source/
│ ├── section_01.json
│ ├── section_02.json
│ ├── ...
│ └── section_11.json # Πηγαία δεδομένα των 11 θεματικών ενοτήτων
├── scripts/
│ └── build_questions.py # Δημιουργία του ενιαίου αρχείου questions.json
├── src/
│ ├── main.jsx # Entry point της εφαρμογής
│ ├── App.jsx # Κύριο component και διαχείριση ροής
│ ├── AppStyles.css # Κεντρικό CSS
│ ├── components/
│ │ └── Disclaimer.jsx # Κοινό ενημερωτικό disclaimer
│ ├── pages/
│ │ ├── StartPage.jsx # Επιλογές έναρξης
│ │ ├── TestRunPage.jsx # Προσομοίωση
│ │ ├── PracticePage.jsx # Εξάσκηση
│ │ └── ResultsPage.jsx # Αποτελέσματα
│ ├── data/
│ │ └── questions.json # Παραγόμενο ενιαίο αρχείο ερωτήσεων
│ └── utils/
│ └── shuffle.js # Τυχαιοποίηση ερωτήσεων και απαντήσεων
├── dist/ # Παραγόμενο production build
└── node_modules/ # Εξαρτήσεις npm
Χρήση με Vite:
npm install # Εγκατάσταση εξαρτήσεων
npm run dev # Ανάπτυξη με live reload
npm run build # Παραγωγικό build
npm run preview # Προεπισκόπηση του build💡 Προϋπόθεση: εγκατεστημένα Node.js και npm
🖥 Ο development server είναι προσβάσιμος και από το τοπικό δίκτυο (host: true).
- 🏁 StartPage – Επιλογή ενοτήτων, πλήθους ερωτήσεων και λειτουργίας
- 📝 TestRunPage – Προσομοίωση με ερωτήσεις πολλαπλής επιλογής
- 🧪 PracticePage – Εξάσκηση με άμεσο έλεγχο της απάντησης
- 🎯 ResultsPage – Εμφάνιση αποτελεσμάτων και λανθασμένων απαντήσεων
🔁 Δυνατότητα επανεκκίνησης και επανάληψης ερωτήσεων που απαντήθηκαν λανθασμένα.
- 🔀 Τυχαιοποίηση σειράς ερωτήσεων και πιθανών απαντήσεων
- 📝 Λειτουργία προσομοίωσης με αποτελέσματα και αναφορά λανθασμένων απαντήσεων
- 📚 Λειτουργία εξάσκησης με άμεσο έλεγχο της απάντησης
- 🔁 Επανάληψη ερωτήσεων που απαντήθηκαν λανθασμένα
- 📏 Έλεγχος εγκυρότητας εισαγωγής
- 📱 Responsive σχεδιασμός
- 📊 Εμφάνιση πίνακα όπου απαιτείται
- 🌐 SEO-friendly δομή (Open Graph, favicon, meta tags, sitemap, robots)
Η εφαρμογή φιλοξενείται στο subdomain:
🔗 https://asep.fmaths.gr
Η εφαρμογή παράγεται ως static build και μπορεί να φιλοξενηθεί σε οποιονδήποτε web server (π.χ. Nginx) ή σε υπηρεσίες static hosting όπως GitHub Pages, Netlify και Vercel.
Οι ερωτήσεις που περιλαμβάνονται σε αυτή την εφαρμογή προέρχονται από το Μητρώο Θεμάτων Γνώσεων του ΑΣΕΠ. Η παρούσα εφαρμογή είναι ανεπίσημη και προορίζεται αποκλειστικά για εκπαιδευτική χρήση, χωρίς εμπορικό σκοπό.
Αυτό το έργο διατίθεται υπό την άδεια CC BY-NC-ND 4.0.
- 📚 Οι ερωτήσεις της εφαρμογής προέρχονται από το Μητρώο Θεμάτων Γνώσεων του ΑΣΕΠ και δεν αποτελούν πρωτότυπο περιεχόμενο του δημιουργού.
- 💻 Η άδεια αφορά τη συλλογή και την οργάνωση του υλικού, καθώς και τον σχεδιασμό και τον πηγαίο κώδικα της εφαρμογής, στον βαθμό που αυτά αποτελούν πρωτότυπο έργο του δημιουργού.
- ❌ Για κάθε είδους εμπορική χρήση ή ενσωμάτωση μέρους του έργου σε τρίτο έργο απαιτείται έγγραφη άδεια από τον δημιουργό.
📄 Αναλυτικοί όροι περιλαμβάνονται στο αρχείο LICENSE.
📩 Επικοινωνία: fkoutsoubidis@gmail.com