Skip to content

Nethmina01/SP_EDU_FRONTEND_02

Repository files navigation

🏛️ Cadre Management System – Proposed Version

A Next.js + Nest.js full-stack Cadre Management System developed for the
Southern Provincial Ministry of Education, Land & Land Development, Highways & Information – Sri Lanka.

This repository contains the proposed and demonstrative version of the system.
The finalized production version delivered to the ministry is not publicly available due to government data security policies.


🚀 Overview

The Cadre Management System aims to digitize administrative workflows,
replacing manual paper-based operations with a secure and efficient online platform.

It is designed to:

  • Enhance productivity and data accuracy
  • Improve accessibility and management of employee records
  • Enable secure communication and document approvals
  • Automate notifications, meetings, and report generation

🧩 System Architecture

Frontend: React (Next.js), TypeScript, CSS, MUI
Backend: Nest.js, MongoDB, Express.js
APIs: RESTful API architecture with standard HTTP methods (GET, POST, PUT, DELETE)
Authentication: JWT-based secure login & authorization
Libraries Used: Syncfusion, Lubaru (for digital e-signatures)


⚙️ Key Features

Employee Management – Maintain personal & professional details
Attendance & Leave Tracking – Simplified staff attendance and leave approval
Meeting Scheduler – Manage and schedule ministry meetings efficiently
Notification System – Real-time alerts and reminders
Report Generation – Generate dynamic reports for administrative insights
E-Signature Support – Digital signing for official documents (certifications, letters, and reports)


🧠 Project Purpose

This project was developed as part of a digital transformation initiative to modernize internal staff management processes of the Ministry.

It addresses inefficiencies in:

  • Manual documentation and record keeping
  • Slow approval workflows
  • Lack of centralized data access and reporting

By implementing this system, administrative operations are streamlined with real-time access, automation, and data-driven decision-making.


🔒 Security Notice

⚠️ This repository contains only the proposed and non-final public version.
The official deployed version includes secure API integrations, sensitive datasets,
and government authentication layers — these are excluded for confidentiality.


🧰 Tech Stack Summary

Category Technologies
Frontend Next.js, React, TypeScript, TailwindCSS, MUI
Backend Nest.js, Express.js
Database MongoDB
Auth JWT
E-Signatures Syncfusion, Lubaru
Architecture RESTful API

🏗️ Project Structure

/src ├── app/ # Next.js app routes and layouts ├── components/ # Reusable UI components ├── pages/ # Page views (login, dashboard, etc.) ├── hooks/ # Custom React hooks ├── services/ # API and data service layer ├── public/images/ # Assets and logo files └── styles/ # Global CSS and theming


🧾 Background & Scope

The Southern Provincial Ministry of Education, Land, and Land Development, Highways & Information
previously relied on manual, paper-based systems for staff management.

This project proposes a digital Cadre Management System to:

  • Streamline HR and administrative processes
  • Maintain accurate staff databases
  • Improve internal communication and documentation flow
  • Enhance transparency and operational efficiency

👨‍💻 Author

Nethmina Bandara
Software Developer – Proposed System Version

📧 nethminanavodya1@gmail.com
🔗 LinkedIn | GitHub


🏁 Disclaimer

This repository is published for research, demonstration, and academic purposes only.
It does not contain confidential or deployable backend modules used in the official system.
All government data, API endpoints, and integrations are securely maintained in the private version.


This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Inter, a custom Google Font.

Learn More

To learn more about Next.js, take a look at the following resources:

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

About

Cadre Management System for the Southern Provincial Ministry of Education, Sri Lanka. Built with Next.js, Nest.js, and MongoDB to digitize staff management, attendance, and e-document approvals. ⚠️ This is a public-safe proposed version; the finalized system is confidential for security reasons.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages