https://github.com/mclintprojects/present-sir
The repository that contains the source code for Present Sir, a USSD based class attendance logging system. Built at the 2018 forLoopGhana UG Hackathon.
https://github.com/mclintprojects/present-sir
Last synced: about 2 months ago
JSON representation
The repository that contains the source code for Present Sir, a USSD based class attendance logging system. Built at the 2018 forLoopGhana UG Hackathon.
- Host: GitHub
- URL: https://github.com/mclintprojects/present-sir
- Owner: mclintprojects
- License: mit
- Created: 2018-03-09T14:54:09.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-04T09:22:52.000Z (about 8 years ago)
- Last Synced: 2025-03-21T03:35:42.994Z (about 1 year ago)
- Language: C#
- Size: 701 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Present-Sir
The repository that contains the source code for Present Sir, a USSD based class attendance logging system.
Built at the 2018 forLoopGhana UG Hackathon, using Africa's Talking USSD API and Xamarin.Android for the Android app and ASP.NET MVC5 + LiteDB for the backend.
> Contributors: Mbah Clinton, Eyioyo Omatsola
This repository contains:
PresentSir.Web - our ASP.NET Backend
PresentSir.Droid - our Xamarin.Android app
PresentSir - The original Java android app before the rewrite in C# because of the verbosity of Java and our time constraints.
=======
1. PresentSir.Web - our ASP.NET Backend
2. PresentSir.Droid - our Xamarin.Android app
3. PresentSir - The original Java android app before the rewrite in C# because of the verbosity of Java and our time constraints.
# Functionality
Present Sir is built for students and teachers. Below is more information on the functionality available to both classes of users.
### Teacher
1. Create or delete classes students can register for and subsequently mark attendance.
2. Start an attendance marking session. A class marking USSD code will be provided for you to present to students. That USSD code can currently only be accessed via Africa's Talking USSD simulator.
3. End an attendance marking session after which students will no longer be able to mark attendance for that particular class.
4. View students that attended a class on any particular day.
> **Students can mark attendance for a class only if the student has registered for that class and if you (Teacher) have started a marking session.**
### Student
1. Register or unregister from a class.
2. Mark attendance for a class using the USSD code the teacher of that class will provide when a marking session is started.
# Getting started
## Android app
To begin, you can download the Present Sir android apk via the link below.
_NB: Only runs on Android 4.4 (Kitkat) and above._
> [Download apk file](https://doc-0g-3g-docs.googleusercontent.com/docs/securesc/ha0ro937gcuc7l7deffksulhg5h7mbp1/gskd868nqsuka5iabqp36is0b3a3d2bp/1520762400000/04851421854738192448/*/1XzqR9Dvq62W937nKrzF-pSXbBeGCYAyd?e=download)
### Signing in
There are two demo accounts available.
| Account type | Username | Password | Index number |
| ------------ | -------------- | -------- | ------------ |
| Teacher | mclint-teacher | password | N/A |
| Student | mclint | password | 040915010 |
### Screenshots
#### Login
#### Teacher home -- Classes
#### Teacher -- Create a class
#### Teacher -- Mark attendance
#### Teacher -- View class attendance
#### Student home -- Registered classes
#### Student -- Register for a class
