Skip to content

FinnBotOrca/Achievement-Management-System

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Achievement Management System

A web-based platform where students and teachers track academic achievements in one place. Students view their accomplishments, teachers record them, and everyone gets a clear picture of academic progress — all automated and organized.

Problem

Academic achievements are scattered everywhere — certificates in folders, emails buried in inboxes, paper records collecting dust. Students struggle to showcase their accomplishments during placements or applications. Teachers waste time managing spreadsheets and physical documents. Nobody has a clear, organized view of what students have actually achieved.

Solution

Achievement Management System centralizes everything. Students see all their achievements in one dashboard with analytics. Teachers input achievements through simple forms with auto-complete. The system tracks hackathons, coding competitions, paper presentations, conferences, and symposiums — complete with certificates, dates, positions, and detailed descriptions. Clean, fast, and organized.

Quick Start (Windows PowerShell)

# Clone repository
git clone https://github.com/Manu95021/Achievement-Management-System.git
cd achievement-management-system

# Create virtual environment
python -m venv venv
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Initialize database
python init_db.py

# Run application
python app.py

Quick Start (macOS/Linux)

# Clone repository
git clone https://github.com/Manu95021/Achievement-Management-System.git
cd Achievement-Management-System

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Initialize database
python init_db.py

# Run application
python app.py

Now open → http://localhost:5000

Tech Stack

  • Flask (Python web framework)
  • SQLite (database)
  • JavaScript (vanilla JS for interactivity)
  • HTML/CSS (responsive UI with dark/light mode)
  • Jinja2 (templating)

Core Features

For Students

  • Personal Dashboard → View all achievements at a glance
  • Achievement Analytics → Track progress over time
  • Advanced Filtering → Search by type, year, position
  • Certificate Access → Download proof instantly
  • Profile Management → Update details anytime

For Teachers

  • Quick Entry Forms → Record achievements in seconds
  • Student Search → Auto-complete for easy lookup
  • Certificate Upload → Attach digital proofs
  • Batch Management → Handle multiple entries efficiently
  • Dashboard Analytics → View entry statistics

Achievement Types Supported

✓ Hackathons
✓ Coding Competitions
✓ Paper Presentations
✓ Conferences
✓ Symposiums
✓ Custom Events

Core Pages

Page Link
Home /
Student Login /student-login
Teacher Login /teacher-login
Student Dashboard /student-dashboard
Teacher Dashboard /teacher-dashboard
View Achievements /view-achievements
Add Achievement /add-achievement
GitHub Repo https://github.com/Manu95021/Achievement-Management-System
Contributing Guide CONTRIBUTING.md

Project Structure

achievement-management-system/
├── app.py              → main flask app + routes
├── init_db.py          → database initialization
├── requirements.txt    → python dependencies
├── static/
│   ├── css/           → styles + themes
│   ├── js/            → client-side logic
│   └── certificates/  → uploaded files
├── templates/         → HTML pages
├── database/          → SQLite database
├── README.md
└── CONTRIBUTING.md

Database Schema

StudentsAchievementsTeachers

Student (student_id PK, name, email, password, dept, ...)
  ↓ 1:N
Achievement (id PK, student_id FK, type, event, date, position, certificate, ...)
  ↓ N:1
Teacher (teacher_id PK, name, email, password, dept, ...)

Key Features Explained

Dark/Light Mode

Toggle between themes with persistent preference storage using localStorage. Smooth transitions and optimized color schemes for both modes.

Student Search with Auto-Complete

Teachers can quickly find students by typing student ID or name. Results appear instantly as you type.

Achievement Categories

Each achievement type has custom fields:

  • Hackathons: team size, project title, difficulty level
  • Coding Competitions: programming language, platform, problem difficulty
  • Paper Presentations: paper title, journal name, conference level
  • Conferences: role, conference level, presentation type
  • Symposiums: theme, event scope, participation type

Certificate Management

Upload certificates (PDF, JPG, PNG) up to 5MB. Access and download anytime from achievement records.

Analytics Dashboard

Visual representation of achievement metrics by type, year, and position. Track progress trends over time.

Contributing

PRs and ideas are welcome! Please check → CONTRIBUTING.md before submitting.

Future Roadmap

  • Mobile app (iOS + Android)
  • LinkedIn integration
  • AI-powered certificate validation
  • Email notifications
  • Multi-language support
  • Advanced analytics with predictive insights
  • Export achievements as PDF portfolio

License

Academic project developed at SRM Institute of Science and Technology.

Contact

For questions or collaboration:

Releases

No releases published

Packages

No packages published

Languages

  • Python 96.8%
  • HTML 2.7%
  • Other 0.5%