https://github.com/team-04b/event_planner_team_4b
https://github.com/team-04b/event_planner_team_4b
ba fron jwt next nodejs opti postgresql prisma-orm sql typescript
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/team-04b/event_planner_team_4b
- Owner: Team-04B
- Created: 2025-04-29T16:07:26.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-23T17:27:39.000Z (about 1 year ago)
- Last Synced: 2025-06-08T19:07:58.601Z (12 months ago)
- Topics: ba, fron, jwt, next, nodejs, opti, postgresql, prisma-orm, sql, typescript
- Language: TypeScript
- Homepage: https://eventplannerfrontend.vercel.app
- Size: 60.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EvenTora (Event Planner & Participation System)
A secure, full-featured event management web platform developed by **Team #4b**. EvenTora empowers users to create, discover, and manage public and private events with flexible participation flows, payment integration, and strong community moderation.
**EvenTora** is a JWT-protected event platform where users can:
- Host Public or Private events (free or paid)
- Join events instantly or request access with payment
- Manage participants through approvals, bans, and invitations
- Browse featured and upcoming events
- Enjoy a well-moderated experience, thanks to Admin oversight
## Features
### User Functionality
- **User Registration & JWT Authentication**
- **Event Management**
- Create, update, and delete events
- Configure visibility: Public or Private
- Set optional registration fee
- **Event Discovery**
- Browse all events
- Filter and search events by type or keyword
- **Participation & Requests**
- Join Free Public Events instantly
- Join Paid Public Events after payment → approval required
- Request to join Free/ Paid Private Events → optional payment → pending approval
- **Invitations**
- Invite users to events (Pay & Accept for paid)
- **Participant Management**
- Approve or reject join requests
- Ban users from events
- **Post-Event Feedback**
- Leave and manage reviews/ratings
### Admin Functionality
- **Dashboard to oversee all events and user activity**
- **Delete inappropriate events or user accounts**
- **Feature specific events on the homepage slider**
---
## Pages & UI
### Global Navigation
- Home • Events • Login/Signup • Dashboard
### Footer
- About • Contact • Privacy Policy
### Home Page
- Hero section with Admin-selected featured event
- Slider of 9 upcoming public events with fee indicators
### Events Page
- Filter by: Public Free | Public Paid | Private Free | Private Paid
- Search by Title or Organizer
### Event Details
- Metadata: Title, Date/Time, Venue/Link, Description, Organizer, Fee
- Dynamic CTA based on event type:
- Free Public → Join
- Paid Public → Pay & Join
- Free Private → Request to Join
- Paid Private → Pay & Request
- Owner actions: Edit, Delete, Approve, Reject, Ban
- Reviews & Ratings section
### Dashboard
- **Sidebar:** My Events • Invitations • My Reviews • Settings
- **Main Sections:**
- My Events (CRUD & payment statuses)
- Invitations (Accept/Decline with refund logic)
- My Reviews (Editable within time window)
- Profile & Notification Settings
---
## Event Visibility & Workflow
| Type | Listed | Join Flow |
|-------------------|--------|------------------------------------------|
| Public (Free) | Yes | Instant join |
| Public (Paid) | Yes | Pay → Pending approval |
| Private (Free) | Yes | Request → Pending approval |
| Private (Paid) | Yes | Pay & Request → Pending approval |
---
## Technology Stack
### Frontend
- **Next.js** – Server-side rendering & routing
- **Tailwind CSS** – Utility-first styling framework
### Backend
- **Node.js** with **Express.js** – RESTful API server
- **Prisma ORM** – Database query builder
### Database
- **PostgreSQL** – Relational database
### Authentication
- **JWT** – Token-based authentication system
### Payment Integration
- **SSLCommerz** or **ShurjoPay** – Secure payment processing for paid events
### Deployment
- **Frontend:** Vercel
- **Backend:** Neon database(Vercel)
---
## Non-Functional Requirements
- **Usability:** Clean, intuitive, and responsive design
- **Maintainability:** Modular codebase with clean architecture
- **Security:** Protected routes using JWT, secure payment flow
- **Scalability:** Supports multiple concurrent users and event types
---
## Future Enhancements (Optional Ideas)
- **Subscription Plans**
- **Email Notifications**
- **Event Analytics**
- **Google Maps / Location Picker**
- **Live Chat between Hosts and Attendees**
---
## 🌐 Project Links
- 🔴 **Live Website:** [https://eventplannerfrontend.vercel.app/](https://eventplannerfrontend.vercel.app/)
- 💻 **Frontend Repository:** [https://github.com/Team-04B/Event_Planner_Team_4b/tree/main/frontend](https://github.com/Team-04B/Event_Planner_Team_4b/tree/main/frontend)
- ⚙️ **Backend Repository:** [https://github.com/Team-04B/Event_Planner_Team_4b/tree/main/backend](https://github.com/Team-04B/Event_Planner_Team_4b/tree/main/backend)
---
## 📸 Screenshots
### Homepage

### Dashboard View

---
## 🎥 Demo Video
[](https://drive.google.com/drive/u/0/folders/1E_UKALN95kuyVWY_GGo6iV5xBKP7EwY9)
## Getting Started
### Prerequisites
- Node.js
- PostgreSQL
- Environment variables for database, JWT secret, and payment credentials
### Installation
```bash
# Clone the repository
git clone https://github.com/Team-04B/Event_Planner_Team_4b.git
cd event-planner
# Install dependencies
npm install
# Setup environment variables
cp .env.example .env
# Fill in your database, JWT, and payment gateway keys
# Run the development server
npm run dev
```
## Contributors
- [**Rifat Sarker**](https://github.com/rifat-sarker) – Web Developer
[](https://www.linkedin.com/in/rifatswd/)
- [**Amdadul Haque**](https://github.com/amdadulhaque) – Web Developer
[](https://www.linkedin.com/in/Amdadul-Haque-Bhuiyan/)
- [**Md Mydul Islam**](https://github.com/mydul62) – Web Developer
[](https://www.linkedin.com/in/mahim62/)
- [**Md Sanim Mia**](https://github.com/md-sanim-mia) – Web Developer
[](https://www.linkedin.com/in/sanim-mia/)