🛠️ Admin Console

🛠️ Tech stack

🏗️ Architecture

The portal is a Next.js frontend that talks to a self-hosted ERPNext instance. Every ERP request is proxied through a catch-all Next.js API route so credentials stay on the server:

Browser ──▶ Next.js (App Router)
                │
                ├─ /(portal)        employee self-service pages
                ├─ /admin           HR admin console pages
                ├─ /api/auth/*      login / logout (session)
                └─ /api/erp/[...]   server-side proxy ──▶ ERPNext (Frappe) REST API

Authentication flows through /api/auth/login and /api/auth/logout, with session/auth helpers in src/lib/. Because the ERP base URL and cookies are handled in the proxy route, the browser never sees them.

🧭 Routes

src/app/
├── (portal)/   dashboard · checkin · attendance · shifts · leave ·
│               payslip · expenses · directory · profile · announcements
├── admin/      dashboard · employees (+/new) · recruitment (applicants, interviews) ·
│               attendance · leave-approvals · payroll (run, slips) · onboarding · reports
├── login/
└── api/        auth/login · auth/logout · erp/[...path]

📦 Installation

Prerequisites

• Node.js 18+
• A running ERPNext / Frappe backend (the portal proxies its HR APIs)

npm install
cp .env.example .env.local       # set the ERPNext base URL + credentials
npm run dev                      # http://localhost:3000

Scripts

npm run dev      # start dev server
npm run build    # production build
npm run start    # run the production build
npm run lint     # lint

🗂️ Project structure

src/
├── app/
│   ├── (portal)/   # employee self-service pages
│   ├── admin/      # HR admin console pages
│   ├── api/        # auth + ERPNext proxy routes
│   ├── login/
│   └── layout.tsx
├── components/     # shared UI (Sidebar, AdminSidebar, …)
└── lib/            # api client, auth, types
docs/               # HRMS user guide
proxy.ts            # ERP proxy helper