# Project Atom — UG Chemistry Department Student Hub & Administrative Portal

> Project Atom is the official web application for the Department of Chemistry at the University of Ghana (Legon). It provides real-time academic schedule management, Hugging Face hosted document distribution, online souvenir e-commerce with Paystack, semester lab session registration, and a complaint resolution system for students and staff.

## System Overview

- **Institution**: Department of Chemistry, University of Ghana, Legon
- **Platform Name**: Project Atom (UG Chemistry Student Hub)
- **Primary Audience**: Level 100 to 400 Chemistry Undergraduate Students, Teaching Assistants, Lecturers, and Department Administrators
- **Tech Stack**: React 19, TypeScript, Vite, Cloud Firestore, Firebase Authentication, Firebase Storage, Hugging Face Hub (Large PDF Document Storage), Paystack Payment Gateway

## Core Features & Capabilities

1. **Student Registration & Authentication**:
   - Verification via UG Student ID and Institutional Email.
   - Dual-step registration flow with Google OAuth & Email/Password.
   - Department Admin approval gate before granting active student privileges.

2. **Academic Document Repository**:
   - Access to lecture notes, past examination questions, lab manuals, and chemistry reference textbooks.
   - Files hosted securely on Hugging Face Hub with local Browser Cache API support for offline offline study.

3. **Semester Lab Session Allocation**:
   - Capacity-managed lab slot selection for Level 100-400 practical sessions.
   - Dynamic real-time capacity tracking with system deadline locking.

4. **Lecture & Practical Timetable**:
   - Interactive schedule filter by course code, day of week, venue, and lecturer name.

5. **Department Souvenir Shop & Paystack Payments**:
   - Online purchase of official white lab coats, UV safety goggles, and nitrile gloves.
   - Direct integration with Paystack Payment Gateway (GHS currency) and in-person department pickup management.

6. **Complaints & Timetable Conflict Resolution**:
   - Ticket submission and real-time messaging thread between students and department administration.

7. **Admin Portal**:
   - Student approval/rejection interface, timetable CSV spreadsheet loader, lab session capacity manager, announcement broadcast system, and dynamic 6-digit OTP office token generator.

## Public Resources & Information

- [Project Atom Home](https://atom.ug.edu.gh/)
- [Student Sign In](https://atom.ug.edu.gh/login)
- [Student Account Registration](https://atom.ug.edu.gh/signup)
- [Department Staff Portal](https://atom.ug.edu.gh/admin/login)
- [Robots File](https://atom.ug.edu.gh/robots.txt)
- [Sitemap](https://atom.ug.edu.gh/sitemap.xml)