🕊️ Wisper Backend

Wisper is a professional networking platform that connects job seekers, recruiters, and industry experts. This backend powers all core features — from authentication and job management to messaging and file uploads — built for scalability, security, and performance.

🏆 Key Features

👤 Job Seeker Features

• Profile Management

  • Create and update personal profiles with name, title, location, and portfolio.
  • Upload resumes (PDF/DOC) and showcase projects with images or videos.
  • Receive recommendations and endorsements from other users.

• Job Search

  • Search jobs using filters (industry, salary, location, type).
  • Save favorite jobs and apply directly using profile/resume.
  • Apply via external job links using an in-app web browser.

• Networking & Learning

  • Join industry-specific groups and interactive classes.
  • Participate in community discussions.
  • Follow experts, recruiters, and peers.

• Messaging & Communication

  • One-on-one and group chat with recruiters and peers.
  • Voice and video call support.
  • Send and receive files, media, and images.

• Account Settings

  • Manage privacy, language, and password settings.
  • Access wallet and manage payments.

---

🏢 Recruiter Features

• Profile & Job Management

  • Create and edit company profiles with logo, industry, and description.
  • Post, edit, or delete job listings with detailed information.
  • Manage applications and saved candidate profiles.

• Talent Search & Recruitment

  • Search candidates by skill, experience, or location.
  • Review applications and contact candidates directly via chat or call.
  • Organize and categorize candidate profiles for future hiring.

• Communication Tools

  • One-on-one or group messaging with applicants.
  • Voice and video call support.
  • Send and receive attachments, resumes, or other media.

• Account Settings

  • Manage company preferences, privacy, and advertising visibility.

---

🛠️ Admin Features

• Dashboard & User Management

  • Monitor app statistics (active users, job posts, new signups).
  • Approve, restrict, or suspend user accounts.
  • Handle complaints, disputes, and reports.

• Content & Community Management

  • Moderate posts, groups, and discussions.
  • Manage classes, community events, and professional groups.

• Advertising & Monetization

  • Oversee ad campaigns and promotional job listings.
  • Track ad revenue and marketing spend.

• System & Compliance

  • Manage server health, user data, and app settings.
  • Ensure GDPR and CCPA compliance.
  • Configure notification systems and push alerts.

---

🚀 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

📦 wisper-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
│   │   ├── exampleModule 1/
│   │   ├── exampleModule 2/
│   │   ├── exampleModule 3/
│   │   ├── exampleModule 4/
│   ├── 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/wisper-server
cd wisper-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