SimplyAditya/orycon

This is an opensource tool designed in-order to help OSC student chapter to streamline the process of event management smoothly and effectively.

โ˜… 0Forks 0GitHub โ†—Compare

README

OSC INTERNAL EVENT MANAGEMENT TOOL

A scalable platform to streamline event organization, content creation, social media management, logistics, and student attendance tracking.

This system supports multiple user roles (Students, Team Admins, Social Media, Content, Organising, and Logistics teams) to enable seamless collaboration and efficient event execution.

Project Information

๐Ÿš€ Features

๐Ÿ”‘ Authentication & Access

  • Secure registration and login for Students and Team Admins
  • Password reset/recovery
  • Role-Based Access Control (RBAC)

๐ŸŽŸ Attendance Management

  • QR code generation for attendance
  • Real-time attendance capture
  • Walk-in entry tracking
  • Automatic attendance generation linked to student profiles

๐Ÿ‘ฉโ€๐ŸŽ“ Student Management (Team Admin)

  • Manage student profiles
  • View student list
  • Record disciplinary actions

๐Ÿ“ฑ Social Media Team

  • Post generation (text, image, video)
  • Drafting, editing, and reworking posts
  • Post scheduling with calendar view & reminders
  • Version control for social posts

โœ๏ธ Content Team

  • Collaborative speech drafting with version history
  • Blog/article/write-up creation with rich text formatting
  • Documentation generator for event briefs, reports, and summaries

๐Ÿ“… Organising Team

  • Event planning (dates, venues, descriptions)
  • Task & milestone tracking
  • Idea box with voting and comments
  • Meeting scheduler with calendar integration
  • Hiring portal for onboarding new students into teams

๐Ÿšš Logistics Team

  • Collect and analyze event feedback & surveys
  • Social media engagement analysis
  • Online event monitoring (participants, engagement, etc.)
  • Attendance logistics coordination with real-time updates

๐Ÿ› ๏ธ Tech Stack

  • Frontend: Next.js (React)
  • Backend: Node.js (Express.js)
  • Database: MongoDB
  • ORM/ODM: Prisma
  • Monorepo Management: Turborepo
  • Containerization: Docker

๐Ÿ“‚ Project Structure

apps/
โ”œโ”€โ”€ client/                 # Next.js frontend
โ”‚   โ”œโ”€โ”€ public/            # Static assets
โ”‚   โ”œโ”€โ”€ src/               # Frontend source code
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ tsconfig.json
โ”‚
โ”œโ”€โ”€ server/                # Express.js backend
โ”‚   โ”œโ”€โ”€ src/               # Backend source code
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ tsconfig.json
โ”‚
docker/                    # Docker-related configs
packages/                  # Shared libraries/configs
node_modules/
.env.example
.gitignore
.npmrc
bun.lock
CODE_OF_CONDUCT.md
Contributions.md
docker-compose.yml
License.md
package*.json
README.md
turbo.json

โš™๏ธ Setup & Installation

Prerequisites

  • Node.js 20+
  • Docker & Docker Compose
  • MongoDB instance

Steps

# 1. Clone the repo
git clone https://github.com/Open-Source-Chandigarh/osc-internal-tool.git

cd osc-internal-tool

# 2. Bun Install dependencies (monorepo)
npm install -g bun
bun install

# 3. Start development
bun run dev

๐Ÿ“– Usage

  • Students: Register, log in, and mark attendance
  • Team Admins: Manage students, disciplinary actions, and oversee activities
  • Social Media Team: Create, edit, and schedule posts
  • Content Team: Draft speeches, generate docs, and write posts
  • Organising Team: Plan events, manage ideas, schedule meetings, and handle hiring
  • Logistics Team: Collect feedback, analyze online events, and manage attendance logistics

๐Ÿ”ฎ Future Enhancements

  • Payment gateway for ticket sales
  • Push notifications for event updates
  • Advanced analytics dashboards
  • Integration with 3rd-party social media platforms for direct publishing

๐Ÿค Contribution

We welcome contributions! Please fork the repo, create a feature branch, and open a pull request.

๐Ÿ“œ License

This project is licensed under the terms of the MIT License.

Contributors

AngadSudanMonarchRyuzakiKetan1317turbobot-tempdevsharmagitadityash2006garvittsinglakartik-m39whynotdeep7AdheeshVermaVishal34sdRashmitTopGCoder-MayankSainiHarushii16Divy13anshAkshat-singlaabhinav-1002Abhaytomar2004

Issues