A role-based training management platform ensuring employees complete mandatory compliance sessions. Built with React, Node.js/Express, and MongoDB Atlas. Backend-first approach: structured data, access control, and durable audit-ready storage.
Learnly streamlines compliance training management for organizations. Four user roles (Admin, Manager, Trainer, Employee) ensure secure role-based workflows: admins configure training, managers assign sessions, trainers record completion, and employees enroll/track progress.
Compliance training data is often fragmented across spreadsheets, emails, and ad-hoc tools. This creates risk during audits and slows organizational oversight.
A centralized, MongoDB-backed app that enforces consistency: training programs, assignments, and completions are all stored in a single source of truth, accessible by role and secured with authentication.
Bio: Oversees compliance for 120 employees.
Goals: Assign sessions, track completions, avoid audit fines.
Pain: Juggling spreadsheets and email reminders.
Fit: Uses Learnly’s dashboard to assign training and monitor completion rates.
Bio: Customer service rep with mandatory yearly training.
Goals: Easily find and complete required sessions.
Pain: Forgetting due dates or losing track of PDFs.
Fit: Accesses Learnly via mobile to view assigned sessions and mark completion.
Professional and minimal UI with clear contrasts for role-based dashboards. Accessibility and readability prioritized.
Type: Inter for UI and body text, bold weights for headings.
High-level navigation for each role and shared routes.
Full wireframes in Figma: open file ↗
client/ # React (role dashboards, forms, tables)
server/
src/
models/ # Mongoose schemas (User, Role, Training, Session, Assignment, Enrollment, Completion)
middleware/ # auth.js (JWT), authorizeRole.js (RBAC), errorHandler.js
routes/ # /auth, /users, /trainings, /sessions, /assignments, /enrollments, /completions
controllers/ # handler logic per resource
db.js # MongoDB Atlas connection
app.js # Express app (CORS, JSON, routes, errors)
serverless.json # Vercel config (if using)// models/Role.js
const RoleSchema = new mongoose.Schema({
name: { type: String, enum: ["ADMIN","MANAGER","TRAINER","EMPLOYEE"], required: true }
});
// models/User.js
const UserSchema = new mongoose.Schema({
firstName: String,
lastName: String,
email: { type: String, unique: true, index: true },
passwordHash: String,
role: { type: mongoose.Schema.Types.ObjectId, ref: "Role", required: true }
});
// models/TrainingProgram.js
const TrainingProgramSchema = new mongoose.Schema({
title: { type: String, required: true },
description: String,
duration: Number, // minutes or hours
manager: { type: mongoose.Schema.Types.ObjectId, ref: "User" },
deadline: Date
});
// models/TrainingSession.js
const TrainingSessionSchema = new mongoose.Schema({
training: { type: mongoose.Schema.Types.ObjectId, ref: "TrainingProgram", required: true },
trainer: { type: mongoose.Schema.Types.ObjectId, ref: "User" },
sessionDate: Date,
sessionTime: String
});
// models/Assignment.js
const AssignmentSchema = new mongoose.Schema({
training: { type: mongoose.Schema.Types.ObjectId, ref: "TrainingProgram", required: true },
employee: { type: mongoose.Schema.Types.ObjectId, ref: "User", required: true },
assignedByManager: { type: mongoose.Schema.Types.ObjectId, ref: "User", required: true }
});
// models/Enrollment.js
const EnrollmentSchema = new mongoose.Schema({
employee: { type: mongoose.Schema.Types.ObjectId, ref: "User", required: true },
session: { type: mongoose.Schema.Types.ObjectId, ref: "TrainingSession", required: true },
enrollmentDate: { type: Date, default: Date.now }
});
// models/CompletionStatus.js
const CompletionStatusSchema = new mongoose.Schema({
enrollment: { type: mongoose.Schema.Types.ObjectId, ref: "Enrollment", required: true },
trainer: { type: mongoose.Schema.Types.ObjectId, ref: "User" },
completionDate: Date,
status: { type: String, enum: ["COMPLETED","IN_PROGRESS","FAILED"], default: "COMPLETED" }
});// db.js
import mongoose from "mongoose";
const uri = process.env.MONGODB_URI; // mongodb+srv://user:pw@cluster/db?retryWrites=true&w=majority
export async function connectDB() {
mongoose.set("strictQuery", true);
await mongoose.connect(uri, { dbName: process.env.MONGODB_DB || "learnly" });
console.log("✅ Connected to MongoDB Atlas");
}
.env (backend): MONGODB_URI,
JWT_SECRET, CORS_ORIGIN, etc.
// middleware/auth.js (JWT)
export function requireAuth(req,res,next){
const token = req.headers.authorization?.replace("Bearer ","");
if(!token) return res.status(401).send("Unauthorized");
try {
req.user = jwt.verify(token, process.env.JWT_SECRET);
next();
} catch { return res.status(401).send("Invalid token"); }
}
// middleware/authorizeRole.js
export const authorizeRole = (...allowed) => (req,res,next) => {
if(!allowed.includes(req.user.role)) return res.status(403).send("Forbidden");
next();
};// routes/trainings.js
router.post("/", requireAuth, authorizeRole("ADMIN","MANAGER"), createTraining);
router.get("/", requireAuth, listTrainings);
// routes/assignments.js
router.post("/", requireAuth, authorizeRole("MANAGER"), assignTrainingToEmployee);
router.get("/me", requireAuth, listAssignmentsForCurrentUser);
// routes/completions.js
router.post("/", requireAuth, authorizeRole("TRAINER"), markCompletion);
router.get("/", requireAuth, authorizeRole("ADMIN","MANAGER"), listCompletionsByProgram);// client/src/App.jsx (conceptual)
const { user } = useAuth();
if (!user) return <AuthScreens />;
switch (user.role) {
case "ADMIN": return <AdminDashboard />;
case "MANAGER": return <ManagerDashboard />;
case "TRAINER": return <TrainerDashboard />;
default: return <EmployeeDashboard />;
}Each dashboard calls role-appropriate endpoints and renders tables (trainings, sessions, assignments, enrollments, completions) with filters, due dates, and actions.
Learnly offered a scalable way for organizations to manage compliance training digitally. Instead of fragmented tools, all data and workflows became centralized, reducing audit risk and saving managers time.