JustLearnIt

O platformă de învățare complexă construită cu Flask care oferă o experiență de învățare interactivă și captivantă pentru studenți și educatori.

Caracteristici

• Autentificare Utilizator

  • Sistem securizat de autentificare și înregistrare
  • Verificare prin email
  • Gestionare parole
  • Gestionare sesiuni

• Module de Învățare

  • Conținut interactiv de învățare
  • Urmărirea progresului
  • Trimitere și validare răspunsuri
  • Sistem de puncte de experiență (XP)

• Panou de Administrare

  • Autentificare securizată pentru administratori
  • Gestionare utilizatori
  • Gestionare conținut
  • Monitorizare sistem

• Caracteristici Adiționale

  • Sistem de clasament
  • Gestionare stocare
  • Studio pentru crearea conținutului
  • Personalizare cont
  • Secțiune Despre

Tehnologii Utilizate

• Backend: Flask
• Bază de Date: SQLite cu SQLAlchemy ORM
• Autentificare: Flask-Login, Flask-Bcrypt
• Email: Flask-Mail
• Formulare: Flask-WTF, WTForms
• Migrări Bază de Date: Flask-Migrate, Alembic
• Instrumente Adiționale:
  • Python-dotenv pentru gestionarea variabilelor de mediu
  • Pillow pentru procesarea imaginilor
  • Gunicorn pentru deployment în producție

Cerințe Preliminare

• Python 3.x
• pip (manager de pachete Python)
• Mediu virtual (recomandat)

Instalare

1. Clonați repository-ul:

   git clone [repository-url]
   cd JustLearnIt

2. Creați și activați un mediu virtual:

   python -m venv venv
   source venv/bin/activate  # Pentru Windows: venv\Scripts\activate

3. Instalați dependențele:

   pip install -r requirements.txt

4. Configurați variabilele de mediu: Creați un fișier .env în directorul rădăcină:

   cp env.example .env

   Apoi editați fișierul .env cu valorile reale:

   SECRET_KEY=cheia_ta_secreta_securizata
   MAIL_USERNAME=emailul_tau
   MAIL_PASSWORD=parola_aplicatiei_emailului_tau
   MAIL_DEFAULT_SENDER=emailul_tau
   ADMIN_EMAIL=email_administrator
   

   IMPORTANT: Nu comiteți niciodată fișierul .env în repository!

5. Inițializați baza de date:

   python init_db.py

   Opțiuni suplimentare pentru gestionarea bazei de date:

   # Recrearea completă a bazei de date
   python init_db.py recreate
   
   # Verificarea integrității bazei de date
   python init_db.py verify
   
   # Informații despre baza de date
   python init_db.py info
   
   # Backup al bazei de date
   python init_db.py backup

   Utilitar pentru backup și restaurare:

   # Crearea unui backup
   python db_backup.py backup
   
   # Restaurarea din backup
   python db_backup.py restore storage/storage.db.backup.20241201_120000
   
   # Exportarea datelor în JSON
   python db_backup.py export
   
   # Importarea datelor din JSON
   python db_backup.py import storage/exports/data_export_20241201_120000
   
   # Listarea backup-urilor disponibile
   python db_backup.py list-backups
   
   # Listarea export-urilor disponibile
   python db_backup.py list-exports

Rularea Aplicației

1. Mod dezvoltare:

   python run.py

2. Mod producție:

   gunicorn app:app

Aplicația va fi disponibilă la adresa http://localhost:5000

Structura Proiectului

JustLearnIt/
├── AboutPage/         # Componente pagină Despre
├── AccountPage/       # Gestionare cont utilizator
├── AdminPage/         # Panou administrator
├── ChoosePage/        # Interfață de selecție
├── LandingPage/       # Pagină principală
├── LearnPage/         # Module de învățare
├── LoginPage/         # Autentificare
├── RankingPage/       # Clasamente utilizatori
├── StoragePage/       # Gestionare stocare
├── StudioPage/        # Creare conținut
├── static/           # Fișiere statice (CSS, JS, imagini)
├── Templates/        # Șabloane HTML
├── storage/          # Stocare bază de date
├── app.py           # Fișier principal aplicație
├── models.py        # Modele bază de date
├── extensions.py    # Extensii Flask
├── utils.py         # Funcții utilitare
└── requirements.txt # Dependențe proiect

Caracteristici de Securitate

• Gestionare securizată a sesiunilor
• Criptare parole
• Protecție CSRF
• Setări securizate pentru cookie-uri
• Rotație credențiale administrator
• Notificări de autentificare

Contribuție

1. Fork repository-ul
2. Creați o branch pentru funcționalitate
3. Commit modificările
4. Push la branch
5. Creați un Pull Request

Licență

[Adăugați informațiile despre licență aici]

Suport

Pentru asistență, vă rugăm să contactați [informațiile de contact]