https://github.com/ankithans/aadhaar-address-update
Aadhaar address update
https://github.com/ankithans/aadhaar-address-update
Last synced: about 1 year ago
JSON representation
Aadhaar address update
- Host: GitHub
- URL: https://github.com/ankithans/aadhaar-address-update
- Owner: ankithans
- License: mit
- Created: 2021-10-25T12:58:27.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-10-31T17:28:56.000Z (over 4 years ago)
- Last Synced: 2025-04-08T00:19:25.494Z (about 1 year ago)
- Language: Java
- Homepage: https://ankithans.github.io/aadhaar-address-update
- Size: 22.7 MB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Aadhaar Address Update in Urban Areas
## Steps to Access
To access our application you can either download the [android application]() or [click here](https://uidai-address-update.netlify.app/) to view on web.
- [Backend API Swagger Documentation](https://uidai-aadhaar.herokuapp.com/docs)
- [Android App](https://github.com/ankithans/aadhaar-address-update/releases/download/v1.0.0/app-release.apk)
- [Web App](https://uidai-address-update.netlify.app/)
- [Google Slides Presentation](https://docs.google.com/presentation/d/1jLPull2oPpjYmqjZ3OYSywi6pUvDwz_kdRglHXa2vA0/edit?usp=sharing)
- [Video Demonstration](https://drive.google.com/file/d/1dfzlQbMaFiceaMA3m3UuaSNw_MhVyJiU/view?usp=sharing)
> Note : If you are on web version, Aadhaar API's(OTP and EKYC) blocks the requests due to CORS issue. Please use browser with disabled CORS and security.
**Linux**
```bash
google-chrome --disable-web-security --disable-gpu --user-data-dir=~/tem
```
**MacOS**
```bash
open -n -a /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --args --user-data-dir="/tmp/chrome_dev_test" --disable-web-security
```
## Problem Statement
Address Update in Aadhaar in Urban Areas
> An innovative solution using technology that will help in overcoming your challenge to update the address.
## Approach
- Tenant will log in by using their Aadhaar Number/Staging UID which is kept encrypted via Base64 in our secure Database.
- Tenant enters Landlord’s phone number on their application and Landlord receives a request regarding request to lend their address to tenant, which can be approved or declined.
- The Request Notification is sent via SMS service as well as in app notifications.
- If landlord declines or approves the request, tenant will get notified about their request status through SMS and in App Notification.
- After getting approval, tenant gets the address and can edit the address minimally.
- The address edited by tenant and the address approved by the landlord will be validated using geocoding api.
- If the two addresses are having difference of more than 100 meters, the request will get rejected and further updates will be demanded from the Tenant.
- Else request succeeds and address of tenant will get updated successfully.
## Features
- Our solution is Multiplatform, users can use both web as well as mobile application.
- Native In App Notifications for updates on requests.
- Notifications through SMS Service for updates on requests.
- OTP and Ekyc Aadhaar API’s are integrated.
- Request can be updated or deleted by the Tenant.
Landlord can Approve/Decline the request.
- Profile Page for getting updated information as stored on Aadhaar Servers.
- Address Verification through Geocoding API’s and strict limit to distance between 2 addresses.
- Usage of BLOC Architecture, with which we capable of replacing any backend services without affecting the User Interface.
- Easy to understand Interactive UI/UX Design using color coding the requests.
- Input Validation before sending requests to servers.
- Our web and app is fully responsive, the users can run app or web in any device irrespective of its size.
## Mockups
## Tech Stack
FastAPI, Flutter, MongoDB, Twilio, Firebase Messaging, Google Fonts, Bloc Architecture, Google Maps API's, OpenCage API's, Base64 Encryption
## Steps to run loclly
Clone the repo in your local machine and setup python and flutter environment. Create .env file similar to .env.sample file with all the required fields.
### Mobile Application
1. Go into `app/` directory by doing `cd app` in terminal.
2. Configure firebase for android by folllowing the [doumentation](https://firebase.flutter.dev/docs/installation/android/).
3. Write `flutter run` in the terminal to start the application.
### FastAPI Server
1. Install all the required packages in python virtual enviroment `pip install requirements.txt`
2. Run `python main.py` in the root directory of the project.
## Contributors
- [Kartik Bansal](https://github.com/kbansal77)
- [Adit Patel](https://github.com/aditpatel01)
- [Aryamaan Pandey](https://github.com/Aryamaan23)
- [Ankit Hans](https://github.com/ankithans)
- [Sagnik Biswas](https://github.com/sbiswas2209)