AI-Powered-Real-time-Employee-Management-System

KO | EN

gitlite — search

#html #java #reactjs #cloud-native #machine-learning #ios #kotlin #css #cpp #mcp

AI-Powered-Real-time-Employee-Management-System

(★ 9)

No description available.

File Explorer

ZIP Download

- - index.ts
- - seed.ts
  - server.ts
- .env.example
- .gitignore
- bun.lock
- nodemon.json
- package.json
- tsconfig.build.json
- tsconfig.json
- vercel.json
- - app.css
  - root.tsx
  - routes.ts
  - types.ts
- - favicon.ico
- .dockerignore
- .env.example
- .gitignore
- bun.lock
- components.json
- Dockerfile
- package.json
- react-router.config.ts
- README.md
- tsconfig.json
- vite.config.ts
- activity-log.md
- ai-insights.md
- announcements-head-role.md
- attendance.md
- auth-setup.md
- dashboard-analytics.md
- data-layer.md
- departments.md
- email-notifications.md
- express-setup.md
- feedback.md
- inngest.md
- leave-management.md
- login-page.md
- middleware-setup.md
- mongodb-setup.md
- notifications.md
- performance-reviews.md
- rate-limiting.md
- reports.md
- request-logging.md
- route-protection.md
- search-pagination.md
- searchable-selects.md
- sidebar-navigation.md
- sse-realtime.md
- tasks.md
- toast-notifications.md
- user-management.md
.gitignore
knowledge.md
myprompts.md
README.md
skills-lock.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A full-stack employee management platform built with the MERN stack and React Router framework mode. Features role-based access control, AI-powered insights, and real-time notifications.

## Tech Stack

| Layer | Technology |
|-------|-----------|
| **Frontend** | React 19, React Router 8 (framework mode), TanStack Query, Tailwind CSS 4, Shadcn UI |
| **Backend** | Express 5, MongoDB (Mongoose 9), JWT auth, Inngest (background jobs) |
| **Email** | Resend |
| **Runtime** | Bun |
| **Deploy** | Vercel |

## Quickstart

### Prerequisites

- [Bun](https://bun.sh) v1.x
- MongoDB instance (local or Atlas)
- Vercel account (for deployment)

### Setup

```bash
# Clone and install
git clone <repo-url>
cd ems
bun install

# Backend setup
cd backend
cp .env.example .env   # fill in your values (see Environment Variables)
bun run seed            # optional: populate demo data
cd ..

# Frontend setup
cd frontend
cp .env.example .env   # fill in your values
cd ..
```

### Development

```bash
# Backend (port 5000)
cd backend && bun run dev

# Frontend (port 5173)
cd frontend && bun run dev
```

### Production Build

```bash
cd backend && bun run build   # TypeScript compile
cd frontend && bun run build  # React Router build
```

### Typecheck

```bash
cd backend && bun run typecheck
cd frontend && bun run typecheck
```

## Environment Variables

### Backend

| Variable | Description | Example |
|----------|-------------|---------|
| `PORT` | Server port | `5000` |
| `MONGODB_URI` | MongoDB connection string | `mongodb://localhost:27017/ems` |
| `JWT_SECRET` | Secret for signing JWT tokens | `your-super-secret-key` |
| `JWT_EXPIRES_IN` | Token expiry | `7d` |
| `CORS_ORIGIN` | Allowed frontend origin | `http://localhost:5173` |
| `RESEND_API_KEY` | Resend API key for email | `re_xxx` |
| `NODE_ENV` | `development` or `production` | `production` |

### Frontend

| Variable | Description | Example |
|----------|-------------|---------|
| `VITE_API_BASE_URL` | Backend API URL | `http://localhost:5000` |

## Project Structure

```
ems/
├── backend/                        # Express REST API
│   ├── src/
│   │   ├── server.ts               # Express app entry + route mounting
│   │   ├── db/                     # Mongoose connection
│   │   ├── models/                 # Mongoose schemas
│   │   │   ├── User.ts
│   │   │   ├── Department.ts
│   │   │   ├── Leave.ts
│   │   │   ├── Attendance.ts
│   │   │   ├── Task.ts
│   │   │   ├── Announcement.ts
│   │   │   ├── PerformanceReview.ts
│   │   │   ├── Feedback.ts
│   │   │   ├── AiInsight.ts
│   │   │   └── ActivityLog.ts
│   │   ├── controllers/            # Business logic per resource
│   │   ├── routes/                 # Express routers (auth + role gated)
│   │   ├── middlewares/            # requireAuth, requireRole, rateLimit
│   │   ├── lib/                    # Utilities (jwt, permissions, leavePolicies, activityLog)
│   │   └── inngest/                # Background AI functions
│   └── api/
│       └── index.ts                # Vercel serverless entry point
│
└── frontend/                       # React Router 8 app
    └── app/
        ├── routes/                 # Page components (framework-mode loaders)
        │   ├── dashboard.tsx
        │   ├── attendance.tsx
        │   ├── leaves.tsx
        │   ├── tasks.tsx
        │   ├── announcements.tsx
        │   ├── performance-reviews.tsx
        │   ├── feedback.tsx
        │   ├── ai-insights.tsx
        │   ├── profile.tsx
        │   └── admin/             # Admin-only pages
        ├── components/
        │   ├── ui/                 # Shadcn components
        │   ├── globals/            # Reusable layout components
        │   └── auth/               # Login, RequireAuth
        ├── hooks/                  # TanStack Query hooks
        ├── lib/
        │   └── api.ts              # Axios client (withCredentials)
        └── types.ts                # Shared TypeScript interfaces
```

## Features

### Authentication & Authorization

- JWT-based authentication with httpOnly cookies
- Role-based access control: **admin**, **head**, **employee**
- Permission-gated routes via middleware (`requireAuth`, `requireRole`)

### Employee Management

- Full employee profiles (personal info, contact, employment details)
- Department assignment and management
- User CRUD with role-based permissions

### Attendance

- Clock in / clock out tracking
- Daily attendance records with status (present, late, absent, half-day, on leave)
- Attendance overview per month

### Leave Management

- Apply for leave with type, date range, and reason
- Leave balance tracking per type (sick, vacation, personal, etc.)
- Admin/head approval workflow
- Configurable leave policies per department

### Tasks

- Create, assign, and track tasks
- Status updates (todo, in-progress, review, done)
- Priority levels (low, medium, high, urgent)

### Performance Reviews

- Admin-initiated performance reviews for employees
- Rating system with written feedback

### Feedback

- Employee feedback submission

### Announcements

- Admin-created announcements visible to all employees

### AI Insights

- AI-powered analytics for workforce management
- Admin dashboard with generated insights

### Activity Logging

- Full audit trail of user actions across the system

### Dashboard

- **Admin/Head**: department stats, leave overview, task metrics, attendance overview
- **Employee**: personal attendance rate, leave balance, active tasks, completed tasks

### Notifications

- Real-time notification system for users

## API Routes

| Method | Endpoint | Description | Auth |
|--------|----------|-------------|------|
| `POST` | `/api/auth/login` | Login | Public |
| `POST` | `/api/auth/logout` | Logout | Public |
| `GET` | `/api/auth/me` | Current user | Auth |
| CRUD | `/api/users` | User management | Admin |
| CRUD | `/api/departments` | Department management | Admin |
| CRUD | `/api/leaves` | Leave applications | Auth |
| CRUD | `/api/attendance` | Attendance records | Auth |
| CRUD | `/api/tasks` | Task management | Auth |
| CRUD | `/api/announcements` | Announcements | Admin |
| CRUD | `/api/performance-reviews` | Performance reviews | Admin/Head |
| CRUD | `/api/feedback` | Feedback | Auth |
| CRUD | `/api/ai-insights` | AI insights | Admin |
| `GET` | `/api/dashboard/analytics` | Admin/head dashboard | Admin/Head |
| `GET` | `/api/dashboard/my` | Employee dashboard | Auth |
| CRUD | `/api/notifications` | Notifications | Auth |
| `GET` | `/api/reports` | Reports | Admin/Head |
| `GET` | `/api/activity-logs` | Activity log | Admin |

## Roles & Permissions

| Feature | Employee | Head | Admin |
|---------|----------|------|-------|
| View own profile | ✅ | ✅ | ✅ |
| View all profiles | ❌ | ❌ | ✅ |
| Clock in/out | ✅ | ✅ | ✅ |
| View own attendance | ✅ | ✅ | ✅ |
| View all attendance | ❌ | ✅ | ✅ |
| Apply for leave | ✅ | ✅ | ✅ |
| Approve leaves | ❌ | ✅ | ✅ |
| Manage leave policies | ❌ | ❌ | ✅ |
| Create/update tasks | ✅ | ✅ | ✅ |
| View department dashboard | ❌ | ✅ | ✅ |
| Manage departments | ❌ | ❌ | ✅ |
| Manage users | ❌ | ❌ | ✅ |
| Create announcements | ❌ | ❌ | ✅ |
| AI insights | ❌ | ❌ | ✅ |
| Activity log | ❌ | ❌ | ✅ |

## Deployment

The project is configured for Vercel deployment:

- **Backend**: `backend/api/index.ts` serves as the serverless function entry point
- **Frontend**: Standard React Router Vercel build

Ensure the following Vercel environment variables are set for production:

- `MONGODB_URI`
- `JWT_SECRET`
- `CORS_ORIGIN` (your frontend domain)
- `RESEND_API_KEY`
- `NODE_ENV=production`

## License

AI-Powered-Real-time-Employee-Management-System

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

AI-Powered-Real-time-Employee-Management-System

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README