Journal Platform

Modern, full‑stack tutoring and course marketplace inspired by Udemy. Designed for clean UX, fast discovery, and data‑driven course pages with real calculations for sections, lectures, and total hours.

Table of Contents

• Overview
• What Users Can Do
• Core Features
• Tech Stack
• Monorepo Layout
• Quick Start
• Environment Variables
• Run & Build
• API Highlights
• Data Model
• Architecture Notes
• Roadmap
• Contact

Overview

Journal enables students to browse, preview, and enroll in courses, while tutors create, publish, and manage content. Course pages pull real data from the database and compute totals directly from modules and lectures—no hardcoded numbers.

What Users Can Do

Students

• Discover courses with search and filters
• Preview course content before enrolling
• See real totals (sections, lectures, hours)
• Enroll in free courses instantly or pay for premium courses
• Access enrolled content from the student dashboard

Tutors

• Create courses with modules and lectures
• Upload thumbnails and media assets
• Publish, unpublish, and archive courses
• Track learners and performance
• Show a public tutor profile with avatar, bio, and course list

Admins

• Access secure admin panel (separate application on port 3002)
• Manage all users (students, tutors, admins)
• Control course publication and visibility
• Monitor all enrollments and student progress
• Review and manage payment transactions
• Moderate course reviews
• View comprehensive analytics and platform statistics

Core Features

• Course catalog with search, category, and level filters
• Udemy‑style preview pages (stats, highlights, content outline)
• Enrollment (free + paid)
• Tutor profiles with published courses
• Role‑based authentication and protected routes
• Module/lecture hierarchy with duration calculations
• Cloudinary media uploads

Tech Stack

• Frontend: Next.js, React, Tailwind CSS, React Icons, Axios
• Backend: Node.js, Express, MongoDB (Mongoose), JWT, Cloudinary

Monorepo Layout

• client/
  • admin-app/ (Next.js admin panel - port 3002)
  • main-app/ (Next.js main app - port 3000)
• server/ (Express + MongoDB API - port 5000)

Quick Start

git clone <repo-url>

# server
cd server
npm install

# main client app
cd ../client/main-app
npm install

# admin app
cd ../admin-app
npm install

Setting Up Admin User

Before accessing the admin panel, create an admin user:

cd server
npm run create-admin

This will create a default admin user:

• Email: admin@example.com Create client/admin-app/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:5000/api

Run & Build

Backend:

cd server
node server.js   # or npm start

Frontend (main app):

cd client/main-app
npm run dev   # http://localhost:3000
npm run build && npm run start

Admin Panel:

cd client/admin-app
npm run dev   # http://localhost:3002
npm run build && npm run start

Accessing the Admin Panel

1. Make sure the backend server is running
2. Navigate to http://localhost:3002
3. Login with admin credentials
4. Manage your platform!

The admin panel is completely separate from the main application and requires admin role to access.ORPAY_KEY_ID=... # if payments enabled RAZORPAY_KEY_SECRET=... # if payments enabled

tutor/:id (tutor + their courses)
- Admin endpoints:
  - GET /auth/users (all users with filters)
  - PUT /auth/users/:id (update user)
  - DELETE /auth/users/:id (delete user)
  - PATCH /auth/users/:id/toggle-status (activate/deactivate)
  - GET /stats/admin-dashboard (dashboard statistic
## Run & Build

Backend:

```bash
cd server
node server.js

Frontend (main app):

cd client/main-app
npm run dev   # http://localhost:3000
npm run build && npm run start

API Highlights

• Base URL: http://localhost:5000/api
• Courses: GET /courses (list), GET /courses/:id (detail with modules, lectures, tutor)
• Enrollment: GET /enrollments/check/:id, POST /enrollments
• Tutor profile: GET /auth/users/:id (tutor + their courses)

Data Model

• User: name, email, role, avatar, bio
• Course: title, description, price, level, thumbnail, tutor, modules, ratings, enrolledStudents
• Module: title, description, order, lectures
• Lecture: title, description, duration (seconds), videoUrl, isPreview

Architecture Notes

• REST API with Express and Mongoose
• Role‑based access control with JWT
• Media storage via Cloudinary
• UI data is fully server‑driven (no hardcoded totals)

Roadmap

• Payments UI/flow hardening
• Reviews and ratings UI
• Better analytics on tutor dashboard

Contact

• Project: https://github.com/TheForgeDevs/Journal (replace with actual repo)
• Author: add your name/email/social here