RehberAI - Yapay Zekâ Destekli Rehberlik ve Anket Analiz Sistemi

RehberAI, lise düzeyindeki öğrenciler için geliştirilen yapay zekâ destekli bir rehberlik ve anket analiz sistemidir. Sistem; danışmanların anket oluşturmasını, öğrencilere anket atamasını, öğrenci cevaplarını analiz etmesini ve yapay zekâ destekli PDR raporları üretmesini sağlar.

Proje, bilgisayar mühendisliği bitirme projesi kapsamında geliştirilmiştir.

---

Proje Amacı

RehberAI’nin temel amacı, okul rehberlik süreçlerinde kullanılan anket ve envanterlerin dijital ortama taşınması ve sonuçların daha hızlı, düzenli ve yorumlanabilir hale getirilmesidir.

Sistem; öğrencilerin akademik, sosyal, psikolojik ve mesleki yönelimlerine ilişkin verileri analiz ederek danışmanlara destekleyici raporlar sunar. Üretilen raporlar karar destek amacı taşır; kesin tanı veya tek başına değerlendirme aracı değildir.

---

Temel Özellikler

Danışman Paneli

• Öğrenci kayıtlarını onaylama ve yönetme
• Yeni anket oluşturma
• Hazır anket kütüphanesinden anket seçme
• Anket sorularını görüntüleme
• Anketleri sınıf/şube veya öğrenci bazlı atama
• Öğrenci sonuçlarını bireysel olarak inceleme
• Sınıf ve şube bazlı genel analiz görüntüleme
• Anonim şikayetleri kategori ve duygu durumuna göre analiz etme

Öğrenci Paneli

• Sisteme giriş yapma
• Kendisine atanmış anketleri görüntüleme
• Anketleri cevaplama
• Anonim şikayet / geri bildirim gönderme

Yapay Zekâ Destekli Analiz

• Ollama üzerinde çalışan Llama3 modeli ile Türkçe PDR raporu üretimi
• Mesleki Eğilim Belirleme Envanteri için meslek grubu bazlı analiz
• Problem Tarama Listesi için kategori bazlı değerlendirme
• Akademik Benlik ve özel anketler için danışman destekli yorumlama
• Anonim şikayetlerde kategori ve duygu analizi

---

Kullanılan Teknolojiler

Backend

• Python
• Flask
• SQLite
• Ollama / Llama3
• REST API

Frontend

• React
• Vite
• Chart.js
• CSS

---

Sistem Mimarisi

Frontend (React + Vite)
        |
        | REST API
        v
Backend (Flask)
        |
        | SQLite
        v
Veritabanı

Backend ayrıca Ollama servisi üzerinden Llama3 modeline istek göndererek AI destekli rapor üretir.

---

Proje Yapısı

RehberAI/
├── backend/
│   ├── app.py
│   ├── database.py
│   ├── database_setup.py
│   ├── routes/
│   │   ├── auth_routes.py
│   │   ├── admin_routes.py
│   │   └── student_routes.py
│   ├── services/
│   │   └── ai_service.py
│   ├── utils/
│   │   └── helpers.py
│   ├── data/
│   │   └── mesleki_test_data.py
│   └── rehberai_demo.db
│
├── frontend/
│   ├── src/
│   │   ├── App.jsx
│   │   ├── pages/
│   │   │   ├── AuthPage.jsx
│   │   │   └── AdvisorPanel.jsx
│   │   └── components/
│   ├── package.json
│   └── vite.config.js
│
├── README.md
└── .gitignore

---

Kurulum

1. Projeyi klonlama

git clone https://github.com/sudenurozturk/RehberAI.git
cd RehberAI

2. Ollama kurulumu

Önce Ollama bilgisayara kurulmalıdır.

Modeli indirmek için:

ollama pull llama3

Ollama servisini başlatmak için:

ollama serve

Projede kullanılan model:

llama3:latest

---

Backend Kurulumu

Proje kök dizinindeyken:

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

Backend’i başlatmak için:

python app.py

Backend varsayılan olarak şu adreste çalışır:

http://127.0.0.1:5000

Sağlık kontrolü:

http://127.0.0.1:5000/api/health

---

Frontend Kurulumu

Yeni bir terminal açıp:

cd frontend
npm install
npm run dev

Frontend varsayılan olarak şu adreste çalışır:

http://localhost:5173

---

Demo Veritabanı

Projede sunum ve test amacıyla örnek veriler içeren demo veritabanı bulunmaktadır:

backend/rehberai_demo.db

Bu veritabanı gerçek öğrenci verisi içermez; yalnızca demo senaryosu için hazırlanmış örnek kayıtlar içerir.

---

Demo Kullanım Akışı

Danışman

1. Sisteme danışman hesabıyla giriş yapar.
2. Öğrencileri onaylar veya mevcut öğrencileri inceler.
3. Anket kütüphanesinden anketleri görüntüler.
4. Anketleri sınıf/şube veya öğrenci bazlı atar.
5. Analiz merkezinden bireysel ve sınıf bazlı sonuçları inceler.
6. Anonim şikayet analizlerini görüntüler.

Öğrenci

1. Sisteme öğrenci hesabıyla giriş yapar.
2. Kendisine atanmış anketleri görüntüler.
3. Anketleri cevaplar.
4. Anonim şikayet / geri bildirim gönderebilir.

---

Analiz Türleri

Mesleki Eğilim Belirleme Envanteri

160 soruluk mesleki eğilim testi üzerinden öğrencinin A-İ arası meslek gruplarına olan ilgisi analiz edilir. Sınıf bazlı analizde meslek gruplarının ortalama skorları grafikle gösterilir.

Problem Tarama Listesi

Öğrencinin sağlık, kişilik, okul, aile ve sosyal ilişkiler alanlarındaki sorun düzeylerini analiz eder.

Akademik Benlik / Özel Anketler

Öğrencinin akademik öz-yeterlik, motivasyon, hedef belirleme ve çalışma alışkanlıkları gibi alanlarda değerlendirilmesini sağlar.

Anonim Şikayet Analizi

Öğrenciler tarafından gönderilen anonim şikayetler kategori ve duygu durumuna göre analiz edilir. Bu analiz danışmana genel okul iklimi hakkında fikir verir.

---

Notlar

• AI raporları danışmanlara destek amacıyla üretilir.
• Sistem kesin tanı koymaz.
• Üretilen raporlar rehberlik sürecinde ön değerlendirme ve karar destek aracı olarak kullanılmalıdır.
• Proje yerel olarak Flask, React ve Ollama servisleriyle çalışmaktadır.
• Gelecek geliştirme aşamasında Docker tabanlı kurulum desteği eklenebilir.

---

Geliştirici

Sude Nur Öztürk
Bilgisayar Mühendisliği Bitirme Projesi