🎓 AcademiaNow Backend

AcademiaNow is an educational platform designed for students aged 12-17, focusing initially on Geography, with plans to expand into History and Economics.

The platform uses a gamified learning approach inspired by Duolingo, offering interactive lessons, quizzes, and progress tracking to make learning fun, engaging, and effective.

Students can access core content for free or subscribe to a premium model for video explanations, unlimited practice, and extra rewards. Admins can manage content, monitor progress, and handle subscriptions.

🏆 Key Features

1️⃣ Student Features

• Onboarding & Account Creation/Login

  • Students can create an account, log in, and select their subject (Geography, History, Economics) and school year.

• Dashboard/Home Screen

  • View subjects and books
  • Track progress with XP points, gold coins, and streaks
  • Access lessons and exercises

• Interactive Learning

  • Practice questions (word selection, image selection)
  • Instant feedback for correct/incorrect answers
  • Video explanations for premium subscribers

• Gamification & Rewards

  • Earn XP points, gold coins, and streaks
  • Customize profile pictures using earned gold
  • Track streaks with freeze options

• Premium Subscription Features

  • Unlimited hearts (for mistakes)
  • Access exclusive video explanations
  • Earn gold to unlock premium content
  • Watch ads to gain extra hearts (limited)

• Group & Social Features (Optional)

  • Create and join study groups
  • Group leaderboard showing individual XP rankings

---

2️⃣ Admin Features

• Admin Dashboard

  • View and manage user data, active users, and progress
  • Manage premium subscriptions and payments
  • Monitor app usage statistics

• Content Management

  • Upload and manage quiz questions, exercises, and lessons
  • Add or edit subjects and books
  • Manage premium content such as videos
  • Set subscription renewal times

• User Management

  • View and manage individual user accounts
  • Reset or change passwords
  • Handle account deletions or suspensions

---

🚀 Tech Stack

Category	Technology
Language	TypeScript
Framework	Node.js + Express.js
Database	PostgreSQL
ORM	Prisma
File Storage	AWS S3
Validation	Zod
File Upload	Multer
Email Service	Nodemailer

---

🗂️ Project Structure

📦 academianow-backend
├── .vscode/ # VSCode workspace config
├── dist/ # Compiled JS files (after build)
├── node_modules/ # Dependencies
├── prisma/ # Prisma schema and migrations
├── src/
│ ├── app/ # Core application setup
│ ├── config/ # Configuration files (DB, AWS, etc.)
│ ├── emailTemplates/ # Nodemailer email templates
│ ├── interface/ # TypeScript interfaces
│ ├── middlewares/ # Express middlewares (auth, error handling)
│ ├── modules/ # Main modules grouped by domain
│ │ ├── users/ # Student & Admin management
│ │ ├── content/ # Lessons, quizzes, exercises
│ │ ├── subscriptions/ # Premium subscription handling
│ │ ├── gamification/ # XP, coins, streaks, groups
│ ├── routes/ # Express route definitions
│ ├── utils/ # Helper functions
│ ├── validation/ # Zod validation schemas
│ ├── app.ts # Express app initialization
│ ├── createModule.js # Module generation script
│ ├── seedAdmin.ts # Admin seeder
│ └── server.ts # Server bootstrap
├── .env.example # Example environment configuration
├── tsconfig.json # TypeScript config
├── package.json # Dependencies and scripts
└── README.md # Project documentation

---

🧩 Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/junayednoman/academianow-server
cd academianow-server

2️⃣ Install dependencies

npm install

3️⃣ Setup environment variables

cp .env.example .env

Fill out the values as needed.

4️⃣ Run Prisma migrations

npx prisma migrate dev

5️⃣ Seed the initial admin

npm run seed:admin

6️⃣ Start the development server

npm run dev

7️⃣ Build for production

npm run build
npm start

📧 Email & Notification

• Uses Nodemailer for sending verification, job alerts, and notification emails.
• Templates are stored in src/emailTemplates/.

---

🪣 File Uploads (AWS S3)

• Multer handles incoming files.
• Uploaded files are stored securely in AWS S3.
• File URLs are automatically saved in the database through Prisma.

---

🧾 Validation (Zod)

All incoming requests are validated with Zod to ensure data accuracy and prevent malformed input.

---

🧰 Scripts

Command	Description
npm run dev	Start the development server using ts-node-dev with auto-restart on changes
npm run build	Compile TypeScript files into JavaScript (dist folder)
npm start	Start the production server using the compiled JavaScript from dist/app/server.js
npm run lint	Check for code style and syntax issues using ESLint
npm run lint:fix	Automatically fix linting issues using ESLint
npm run format	Format all TypeScript files using Prettier
npm run format:check	Check if files are formatted according to Prettier rules
npm run seed:admin	Seed the database with the default admin account using ts-node-dev

---

Made with ❤️ by Junayed Noman