The Groundbreaking Schools Attendance Records Management System (ARMS)

Med Amine — Sun, 29 Jun 2025 13:42:07 +0000

Building ARMS – A better Attendance Records (or Record) Management System

Introduction

Hello everyone! I'm Mohammed the same dev of Xuploads, I’m excited to share a project I’ve been developing for quite some time — ARMS (Attendance Record Management System). It’s a system designed to streamline the way schools handle attendance, replacing the outdated, error-prone methods with a smarter, faster, and more reliable alternative.

This post covers the purpose, features, technical architecture, and some lessons learned along the way.

Why ARMS?

In many schools, attendance tracking is still handled manually — either using paper sheets or basic spreadsheets. That leaves a lot of room for mistakes, manipulation, and lost records. I’ve personally seen how chaotic it can get, especially when multiple classes are running in parallel or when attendance data is needed for reports.

The idea behind ARMS is to provide a centralized, secure, and intelligent system that schools can use to automate attendance tracking with as little friction as possible.

System Overview

ARMS is made up of three main parts:

The ARMS API – A .NET Framework backend (ASP.NET) that handles all the logic for sessions, attendance records, authentication, logs, etc.
The Desktop Application – A Windows-based GUI app built with VB.NET (Guna2 UI), used by administrators and staff to manage data, view attendance reports, and configure the system (works under WINE) with some UI bugs.
The Attendance Devices – Can be mobile phones, Raspberry Pi, or any device capable of sending RESTful HTTP requests (via RFID, QR codes, or biometric input).

The system is multi-language (Arabic + English), internet-accessible, and multi-device-friendly.

Key Features

Here’s what ARMS currently offers:

Smart Session Handling: Teachers start class sessions, and the system marks all students absent by default. As students scan their ID (via RFID or QR), their attendance is corrected automatically.
Late Arrival Logic: Each subject has a customizable grace period. Arriving after that marks the student as late, not absent.
Role-Based Access:
- Teachers only see their own sessions and classes.
- Admins get full control over schedules, users, attendance logs, and exceptions.
Timetable Management: The school director can set schedules and assign classes and subjects to specific days and times.
Statistics & Reporting: Visual charts and detailed logs allow staff to see absence patterns and generate reports.
Parent Notification (in progress): Absence alerts will be sent to parents via email at the end of the day.
Device Management: Each attendance device can be assigned to specific classes. Devices can be enabled/disabled remotely.
Extension Support: ARMS supports an extension system using interfaces, so new features (like QR scanning, fingerprint support, etc.) can be added without changing the core logic.
Remote API: The API is secured and supports remote access, making it ideal for schools with limited local networking infrastructure.

Tech Stack

Backend: ASP.NET (.NET Framework)
Frontend (Admin): VB.NET WinForms (Guna UI 2)
Database: SQL Server (hosted locally or in the cloud)
Language Support: Arabic & English (fully switchable UI)
API Communication: JSON over HTTP (RESTful endpoints)
Architecture: Layered architecture with full async support on the API side

Under the Hood

Sessions are created by staff and linked to classes and subjects.
Attendance records are updated in real-time as students scan their RFID/QR/ID.
Every major action (session start, student scan, admin edit) is logged for audit purposes.
Extensions implement a common interface and can be loaded dynamically — for example, you could add a fingerprint scanner extension without modifying the API or desktop app.

Deployment & Updates

The Windows desktop app includes a built-in updater it called 'ARMSUpdater'. It pulls the latest version info from a server and displays changelogs before updating.
API rate limiting and logging are implemented to ensure performance and traceability.
All database operations are done asynchronously to avoid locking or bottlenecks.

Future Plans

Daily Attendance Summary Emails to parents
Student Self-Registration Mode
Third-party integrations (e.g., school management systems, Google Calendar)
Mobile Web Interface for teachers
Cloud-ready version with multitenancy support (for multiple schools on the same server)

Final Thoughts

ARMS has been a challenging but rewarding project. It's not just about tracking who showed up — it's about making school management more efficient, accountable, and modern. I've built it with real-world use in mind, based on feedback from actual school staff and administrators.

If you're working on similar systems or have ideas for improvements, I’d love to hear your thoughts!

GitHub & Demo

This is still a private project under active development, but I’m considering open-sourcing parts of it (like the extension system or attendance logic) once I clean them up.

Feel free to reach out if you're interested in contributing or testing it in a real-world environment.

Thanks for reading!

Let me know what you think in the comments.

My first project 'Xuploads'

Med Amine — Sat, 26 Oct 2024 10:28:42 +0000

This is my first project, it's a web app for uploading, downloading and sharing file, developed using VB.net (ASP.NET)

Xuploads: A Feature-Rich, Secure, and Customizable File Upload Platform

Xuploads is a powerful file-sharing platform built for control, flexibility, and security. With no accounts required, users can enjoy a streamlined upload experience where every file is managed individually with advanced security options and customizable settings. Xuploads combines ease of use with robust functionality to make file management seamless.

Key Features:

File upload: Allows users to upload files to the server with options for customization like password protection and expiration.
1. File download: Users can download uploaded files through unique, secure links provided after the upload.
2. Password protection for files: Adds a password requirement for accessing a file, ensuring only authorized users can download it.
3. One-time download links: Generates a link that can only be used once for downloading a file, enhancing security.
4. File expiration: Sets a specific duration for how long a file remains accessible. Once expired, the file is automatically deleted.
5. VirusTotal file scanning: Scans uploaded files for malware or viruses and deletes flagged files to ensure safety.
6. File renaming: Allows users to change the displayed name of the uploaded file without affecting its functionality.
7. File replacement: Lets users upload a new version of a file while retaining its original link and metadata.
8. QR code generation for links: Creates QR codes for download links, making it easier to share files via mobile devices.
9. View tracking: Records the number of times a file is accessed or viewed.
10. Download tracking: Tracks the number of times a file is downloaded for analytics or user monitoring.
11. Upload from URL: Allows users to upload files directly from an external link instead of their local device.
12. Multiple file downloads as ZIP: Enables users to download multiple files in a single compressed ZIP file for convenience.
13. Allowed/disallowed file extensions: Restricts or permits specific file types to ensure compliance with upload policies.
14. File size limits: Sets a maximum allowable size for uploaded files to prevent server overload or abuse.
15. Inactive file deletion: Automatically deletes files that haven’t been accessed for a predefined period.
16. Maintenance mode: Temporarily disables the upload and download functionalities during maintenance or updates.
17. Additional header and footer: Adds consistent navigation and branding elements to all pages for a polished look.
18. Bootstrap design integration: Enhances the user interface with a modern, responsive design using the Bootstrap framework.
19. Error handling improvements: Provides clearer error messages and resolves issues for a smoother user experience.

Introducing XUAPI

XUAPI (Xuploads API) is an extension of the Xuploads platform that empowers developers to integrate its functionality into their applications. Released as a part of the Xuploads project, XUAPI brings automation and scalability to file management.

Current Features of XUAPI
File Upload from a Link: Allows developers to upload files directly from a URL, making it perfect for automating workflows.
File Upload from a Posted File: Supports uploading files via HTTP POST requests, enabling seamless integration with external applications.
Metadata Control: Developers can specify file expiry dates and descriptions during uploads.
Flexible Configurations: XUAPI works seamlessly with Xuploads, supporting different upload locations and configurations for specific needs.
Planned Features
Deletion Method: Future updates will include API support for deleting files programmatically, enhancing remote file management capabilities.

Why Choose Xuploads? Xuploads is perfect for users who need a secure, flexible, and customizable file upload platform without the hassle of account management. From hobbyists to advanced users, Xuploads brings a seamless solution to file hosting with full control over shared content.

it's an open-source project with MIT-License, hosted on GITHUB.

DEV Community: Med Amine