Student-Management-System

Student Management System (Desktop App) built with Python and MySQL, supporting role-based access control and credit-based training process management.

🚀 Key Features

• User Roles: Admin, Lecturer, Student.
• Academic Management: Manage Courses, Classes, Semesters, Departments.
• Grade Management: Lecturers enter grades, system calculates GPA, students view transcripts.
• Utilities: View schedule, notifications, password security (Bcrypt), OTP authentication.

🛠 Technologies Used

• Language: Python 3.x
• Database: MySQL
• Interface (GUI): Tkinter / CustomTkinter
• Security: Bcrypt, Secrets

📄 Documentation

• Project Structure
• Requirement Specification & Design Document
• Requirements (requirements.txt)

⚙️ Installation & Run

1. Clone the project

   git clone https://github.com/your-username/student-management-system.git
   cd student-management-system

2. Setup Virtual Environment

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

3. Install dependencies

   pip install -r requirements.txt

4. Configure Database

   • Create MySQL database and run scripts in docs/sql_script/.
   • Copy .env.example to .env and fill in DB connection info.

5. Run Application

   python src/main.py

📦 Running Executables (Windows/Linux)

If you prefer running pre-built binaries instead of setting up the Python environment:

1. Download: Get the .exe (Windows) or binary file (Linux) from the releases.
2. Configuration: The application still requires a database connection.
   • Important: Place your configured .env file in the same directory as the executable file.
3. Launch: Run the executable file directly.