CCS Sitin Monitoring System

A Django-based web application for monitoring and managing computer lab sessions at a college level. The system allows students to reserve PCs, sit in during available sessions, receive rewards, and stay updated via announcements. Admins manage reservations, sessions, and generate reports through a dedicated interface.

---

🚀 Features

• 🔔 Real-time Notifications using WebSockets
• 🗣️ Announcement System with comment, edit, and delete functionalities
• 🖥️ Computer Reservation System for lab PCs
• 📥 Sit-in Requests — students can request admins to sit them in without reserving
• ⏳ Session-Based Sitin — students can sit in as long as a session is active
• 🏅 Rewards & Leaderboards — admins reward active students based on performance
• 📄 Pagination for fast content loading and display
• 👤 Profile Management System to customize user profiles
• 🛠️ Admin Dashboard via Django Admin for full management control

---

🛠️ Installation (Development)

Make sure you have Python, Git, and your preferred IDE installed.

git clone https://github.com/VulpritProoze/sysarch001_alin.git
cd sysarch001_alin
pip install virtualenv
virtualenv venv
venv\Scripts\activate    # For Windows (use `source venv/bin/activate` on macOS/Linux)
pip install -r requirements.txt
cd app
python manage.py runserver

Then open the app at: http://localhost:5006

---

💡 Usage Examples

1. Dashboard: Displays lab rules and latest announcements.

2. Announcements: View, comment, edit, and delete announcements.

3. Reservations:

   • Navigate to a lab room.
   • Click the action button of an available PC.
   • Wait for admin approval.
   • Admin logs out the student manually in /admin/.

4. Sitin History: Students can review previous sitins and give feedback.

5. Resources: Students can access educational files shared by admins, and upload their own lab schedules (their study load).

6. Admin Page: Administrators can browse through various tools to monitor student activity.

---

👥 User Modes

• Student/User: Accessible at /
• Admin: Accessible via Django Admin panel at /admin/

---

🤝 Contributing Guidelines

We welcome contributions to improve the CCS Sitin Monitoring System! To contribute:

1. Fork the repository to your own GitHub account.

2. Clone your forked repo to your local machine:

   git clone https://github.com/your-username/sysarch001_alin.git

3. Create a new branch for your feature or bugfix:

   git checkout -b feature/your-feature-name

4. Make your changes, following the existing code style and structure.

5. Test your changes thoroughly before committing.

6. Commit and push your changes to your fork:

   git add .
   git commit -m "Add: Your detailed commit message"
   git push origin feature/your-feature-name

7. Open a Pull Request from your branch to the main branch of this repository. Clearly describe:

   • What the change does
   • Why it's needed
   • Any additional context or dependencies

Please ensure your code:

• Is well-documented
• Does not introduce breaking changes
• Has been tested for bugs and regressions

We appreciate clean, respectful collaboration!