One integrated platform that carries every trainee from the day they walk in for admission to the day they become an alumnus. From attendance and exams to payroll, LMS and reports, everything lives in one place.
14 chapters . swipe like a book . 5 min read
Crafted by M. Shoka - mikeshokah@gmail.com - 0797 127 021
SmartSys Portal - Complete Overview
One portal. Every operation.
SmartSys is a complete, integrated management platform built for technical training institutions, vocational colleges and polytechnics. It unifies admissions, academics, examinations, attendance, finance, human resources, co-curricular life, student services and a full Learning Management System into a single coherent system that shares one source of truth.
Trainers, HODs, principals, bursars, registry, students - each user sees exactly what their role permits.
Change a mark, a fee or a unit allocation once - the change flows through every report and screen.
Every action records the officer, timestamp and affected record. Reports are official and traceable.
Runs on Node.js and MySQL. Your data stays on your server - no third-party cloud lock-in.
What it takes to run SmartSys
SmartSys is deliberately lightweight. It runs comfortably on the hardware most institutions already own - a modest desktop, a stable network and a modern browser are enough. The requirements below are grouped the way a software project groups them: functional, technical, network, human and security.
Admissions, attendance, marks entry, fees, payroll, LMS, reports - the core services the system must deliver end to end.
A dual-core processor at 2.0 GHz, 4 GB RAM, 20 GB free disk and a 1366 x 768 display per workstation.
Server runs Node.js and MySQL on Windows or Linux. Clients need only a modern browser - nothing to install.
A stable LAN or internet link at 2 Mbps per active user. A UPS keeps sessions alive during power dips.
Basic computer skills - typing, browsing, file handling and form filling. No programming knowledge required.
Role-based access, bcrypt-hashed passwords, scheduled backups and a full audit trail on every action.
Admission to alumni
The complete life cycle of every trainee. Whether a student is registering for the first time, moving to the next year of study, going on attachment, graduating or - in rare cases - being reinstated, every event is captured and every record stays linked.
Admit new students with personal, residence, academic, health and parent details in one flow.
Proceed students between years, mark completions or flag dropouts with a formal reason.
Bring a former dropout back onto the active roll with a formal resume record and date.
Log industrial attachment placements, monitor ongoing ones and update statuses.
Maintain graduate profiles with employer, workstation and contact details.
Generate professional CR80 ID cards with photo, expiry and principal signature.
Structure, teaching and evaluation
Everything that defines what is taught, who teaches it and how it is evaluated. From department setup through marksheets, verification and final transcripts - a complete, auditable academic workflow.
Define departments, programmes, courses and the units that make up each programme.
Assign units to trainers per year of study, ready for attendance and marks entry.
Single-student or class-wide entry for CATs and main exams. Locked components stay frozen.
Trainer to Exam Officer to Academic Committee. Verify, return or reject with a reason.
Ranked merit lists and per-unit analysis, ready to print as A4 reports.
Official transcripts listing every unit with scores, grades, remarks and cumulative average.
Curriculum, topics, resources and quizzes
A full in-house LMS tightly integrated with academics, attendance and examinations. Trainers upload the curriculum, the parser builds the topic tree automatically, students progress strictly topic-by-topic, and the quiz engine grades every attempt the moment it is submitted - no paper, no spreadsheets, no guesswork.
Drop a PDF, DOCX, TXT or MD file - or paste raw text. Smart numbering parser (1.1, 1.1.1, 1.3.2.1) builds the hierarchy automatically.
Each topic unlocks only when the previous one is complete. Optional forum-post or forum-reply gates keep students actively engaged.
Notes, external links, PDFs, Office files, images, audio and video - all attached to a topic and streamed securely from your own server.
Broadcast to every student enrolled in the unit at the moment of posting, with a full delivery log per learner.
Five question types - MCQ, True/False, short text, matching and drag-and-drop - with per-question marks and Bloom's taxonomy tagging.
Practice quizzes allow unlimited retakes. CATs are one-shot, windowed, autosave every 15s and auto-submit when time expires.
Every question is graded deterministically, with partial credit for multi-answer MCQs and case-tolerant short-text answers.
Filter by department, program, course, intake, intake year, year of study and term- so two intakes on the same unit never mix.
Two ways to mark, one record
Accurate attendance sits at the heart of every institution. SmartSys gives trainers a full weekly register and gives students a fair, transparent self-service check-in - with optional face and passkey verification for fast, tamper-resistant marking.
Weekly register per unit or lesson with a per-trainee grid view.
Set lessons per unit with day, time and room - clash checks built-in.
Register a passkey once; verify with a tap on supported devices.
Camera-based check-in using on-device face recognition. Fast and private.
Every shilling accounted for
Student fees and staff payroll live side by side, each with a full audit trail. Payment methods, receipting and bank details are captured per transaction, and the reports you need for audits are always one click away.
Bill students, record payments, issue receipts and track outstanding balances.
Compute salaries, statutory deductions, arrears and generate payslips.
Maintain staff bank accounts for direct deposit and reconcile payments.
Fee collection trends, payroll summaries and audit-ready extracts.
People, roles and access
The people who run the institution. Manage staff profiles, define the roles that describe their access level, and control which login accounts can see which modules. Every staff member has exactly one account and one role - nothing more, nothing less.
Employment, academic, contact and designation details in one record.
Define role codes and names - HOD, Trainer, Registrar, Bursar and more.
Create one login per staff member with a secure bcrypt-hashed password.
Appoint exam officers and academic committee members who verify marksheets.
Configure once, use everywhere
The foundation every other module depends on. Set these up first and the rest of the system will feel effortless. Everything configured here feeds the official reports generated across the platform - including your logo, motto and contact details on every printed document.
Counties, subcounties and wards - the geographic structure used everywhere.
Official name, code, contacts, logo and motto - used on every report.
Define admission intakes (e.g. JAN-2026, SEP-2026) used at registration.
Set term, module or semester start and end dates per intake, programme and year.
Curate the four background images that rotate on the home screen.
Co-curricular life, beautifully managed
Clubs and societies are where campus character is built. SmartSys runs the full life of a club - registry, membership with roles, fee structures by role and term, activity proposals with approval workflow, and a clean payment ledger that shows collections in real time.
Register clubs with code, name, description, status and maximum membership.
Enrol students or staff as members and assign chairman, secretary, treasurer or member.
Define per-role fees - one-time, termly, annual or monthly - with effective dates.
Propose activities with venue and date; approvers review and approve or reject.
Record payments per member and fee; print receipts and track balances.
See clubs, active members, collections and pending activities update in real time.
Teams, fixtures and results
From friendly inter-class matches to full leagues, SmartSys tracks every team, every player, every fixture and every result. Fixtures support both internal teams and external opponents, so matches against visiting colleges fit naturally in the same schedule.
Register internal teams per sport with status, capacity and description.
Enrol students or staff per team with jersey number, position and season.
Schedule matches between internal and external teams, with venue and league.
Record scores, declare winners and compute standings automatically.
Three desks, one clean flow
Departments raise requisitions for supplies and services; each one travels through Procurement verification, Finance approval and Principal sign-off. Every action is timestamped and remarks are recorded, so nothing gets lost and nothing gets approved twice.
Capture purpose, required date and multiple line items with quantities and prices.
Verify prices and availability; approve, request more detail or reject with a reason.
Confirm budget availability and record financial remarks before forwarding.
Final approval. Approved requisitions become ready for procurement and payment.
Animated pulse shows how many requisitions sit at each desk and their total value.
Every stage records actor, role, action, remarks and timestamp for accountability.
Everyday tools, quietly powerful
The supporting modules that keep daily life running smoothly - from the library book a student borrows on Monday, to the SMS that reaches a parent in the evening, to the timetable a trainee opens on their phone each morning.
Books, copies, reservations, loans, fines and lost-book handling - all tracked.
Track institutional assets, stock levels, issuances and audits across stores.
Send fee, exam or general SMS notices to parents and guardians with a full delivery log.
Track departmental projects, budgets, milestones, documents and staff assignments.
Profile, current module, active units, today's lessons and self-service attendance marking.
Students mark attendance via Passkey, Face or a simple tap - always with the trainer's session live.
Development and support
SmartSys is designed and maintained as a single, coherent platform - not a bundle of third-party tools bolted together. If you have ideas for new modules, need a custom report, or want help deploying SmartSys at your institution, please reach out directly.
mikeshokah@gmail.com
0797 127 021
Node.js . Express . MySQL . EJS . Bootstrap 5 . Chart.js . WebAuthn . Face-API
SmartSys is self-hosted. No third-party cloud dependency; your records stay on your infrastructure.
Thank you for choosing SmartSys.