🎓 Society Management System

A modern, full-stack solution for managing university societies, members, events, and sponsorships. Built with a focus on ease of use, dynamic dashboards, and automated reporting.

---

🚀 Features

🏢 Society Management

• Registration & Renewal: Streamlined workflow for new society registration and annual renewals.
• Approval System: Multi-stage approval process for society requests.
• Member Management: Track active members, alumni, and leadership roles.

📅 Event Coordination

• Event Requests: Societies can submit detailed event proposals for approval.
• Ticketing & Registration: Built-in system for managing event attendees.
• Feedback Collection: Automated forms for post-event evaluations.

📊 Advanced Dashboards

• Society Head Dashboard: High-level overview of society performance, member growth, and pending tasks.
• Admin Panel: Comprehensive tools for system administrators to manage users, societies, and global settings.
• Dynamic Charts: Visual data representation using Chart.js.

💰 Sponsorship & Finance

• Sponsor Tracking: Manage relationships with sponsors and track funding.
• Budgeting: Basic tools for society budget oversight.

✉️ Communication

• Automated Emails: Notifications for approvals, updates, and upcoming events via Nodemailer.
• Documentation: Centralized repository for society constitutions and reports.

---

🛠️ Tech Stack

Frontend

• Framework: Next.js 16 (App Router)
• State Management: Redux Toolkit
• Styling: Tailwind CSS, Framer Motion, GSAP
• Charts: Chart.js / React-chartjs-2
• Reporting: jsPDF, XLSX

Backend

• Runtime: Node.js
• Framework: Express.js
• Database: MongoDB (via Mongoose)
• Language: TypeScript
• Authentication: JWT & Bcrypt
• AI Integration: Google Generative AI (Gemini), Groq SDK

Infrastructure & DevOps

• Containerization: Docker & Docker Compose
• Monitoring: Sentry
• Storage: Cloudinary (for media)

---

⚙️ Installation & Setup

Prerequisites

• Node.js (>= 20.0.0)
• npm (>= 10.0.0)
• MongoDB
• Docker (optional)

Local Development Setup

1. Clone the Repository

   git clone https://github.com/Haseebx162006/Society-Management-System-.git
   cd Society-Management-System-

2. Backend Configuration

   cd backend
   npm install
   cp .env.example .env # Update with your MongoDB URI, JWT secret, etc.
   npm run dev

3. Frontend Configuration

   cd ../frontend
   npm install
   npm run dev

4. Create Super Admin (Optional)

   cd ../backend
   npm run create-admin

Docker Setup

docker-compose up --build

---

📂 Project Structure

├── backend/            # Express API with TypeScript
│   ├── app/src/        # Source code
│   │   ├── controllers/# Business logic
│   │   ├── models/     # Database schemas
│   │   └── routes/     # API endpoints
│   └── scripts/        # Utility scripts
├── frontend/           # Next.js Application
│   ├── src/app/        # App Router pages
│   └── src/components/ # Reusable UI components
└── docker-compose.yml  # Orchestration for containers

---

📄 License

This project is licensed under the MIT License.