BetterPoll-Android

This is an android application which can be setup and used as a complete campus platform. A campus (eg.- a college campus) provides many facilities such as a mess, shuttle services. BetterPoll is an attempt to create a completely open source campus management system. This repository contains the frontend ( an android application) of the application.

For the backend repo you can check out : https://github.com/adityabisht02/BetterPoll-Backend

This project will have an admin side, the admin will be able to add services, timings etc. and the other users shall be able to see these services.

Connecting to the Backend Repository

1. Follow the setup steps as mentioned in the readme of the backend repo : https://github.com/adityabisht02/BetterPoll-Backend.
2. You should be able to make requests to the locally running server from the emulator (use the ip :"http://10.0.2.2:3000/" to access the server from the emulator).

App Flow

User Side

1. The user will need to login once ,only if the admin has created this user will he be able to login.
2. On logging in the user will be remembered using SharedPreferences, the user id will be saved locally as well.
3. The user can now interct with the app, he can view the mess menu(updates automatically), he can interact with other users, and he can view available shuttles for booking. All of these are fetched from the backend.
4. The user can use his mess code to log his attendance at the mess.

Admin Side

1. The admin can create new users who can access the app.
2. The admin can add new shuttles,edit the mess menu.
3. The admin can also verify users using their user code.

The User Side of the application

The User side of the application is what the students(assuming a college campus) will see and interact with.

BetterPoll.User.side.mp4

The Admin Side of the application

The admin will be able to add shuttles, add new users and monitor mess attendance and menu.

BetterPoll.admin.side.mp4

😄CONTRIBUTING GUIDELINES