FindMyRoomie is a Web Application that provides a platform for lonely wolves (NC State students) to find roommates of their preference. The stakes are high when it comes to finding your best roommate because this relationship starts with a living relationship 😅. We understand how stressful this can be, especially if you are moving to a new city or country. FindMyRoomie is a one-stop solution to your roommate finding needs. Our software has functionalities that allow you to filter and choose your ideal roommate. But if that is too much work for you, we also provide roommate suggestions based on your preferences! Any NC State student could sign up with their NC State Email address from any corner of the world on our website and begin searching for roommates.
The software is free for use by anyone, and we also welcome any contributions to improve our software. Please read our CONTRIBUTING.md file for more details). If you would like to cite our repository, please check our CITATION.cff file.
To jump ahead to installation instructions, click here
The homepage contains the 'Sign in' and 'Sign up' buttons, along with the number of users that have registered.
Allows new users to register to our roommate finding portal. The 'Sign up' page asks to enter an NCSU email id and a suitable password which should be strong enogugh.
After entering the credentials for signup, a confirmation email is sent to the registered mail id, asking to confirm the resgistration. Upon clicking the link provided in the mail, the account gets confirmed and the user is directly redirected to the welcome page.
Allows existing users to login to our website using their credentials.
In case the user forgets the password, they can enter their registered email id in the 'Forgot your password?' tab. An email with a link to set a new password will be sent to the email. Clicking the link will redirect the user to reset their password, and, tada! Password reset!!!
A page with happy two happy wolves enjoying each other's company in the background, just like you and your roommates will be ❤️🔥.
Allows you to introduce whom you are to your future roommate! You are given the opportunity to tell others a little bit about yourself and your preferences. The "Visibility" checkbox in your profile allows you to choose whether you want to be visible to others. If you are looking for roommates, you can toggle it on, and if you have found one (Congratulations 🥳 🥳), you can toggle it off. It's that easy!
Lists the people looking for roommates just like you. Our "Wolf Filter" lets you filter candidates based on your preferences 🐺. Be choosy!
Lists your roommates and provides roommate suggestions based on your preferences. The similarity scores with other roommate seekers are calculated based on Manhattan Distance, and the people with the top scores are shown as suggestions.
Elaborates on the project and provides details about the contributors along with a link to our documentation.
signup.mp4
3.mp4
git clone https://github.com/rohitgeddam/FindMyRoomie.git
`python -m venv venv`
* On Mac/Linux:
`source venv/bin/activate`
* On Windows:
`venv\Scripts\activate`
`pip install -r requirements.txt`
To setup Gmail to send emails to users, first create a new Gmail account. Under 'Manage your Google Account', enable 2-Step Verification and select suitable app and device under 'App passwords'. Check out this link for more information. Save the key that is generated, as well as the email that was used.
Create a new text file called .env as follows:
`./src/config/.env`
Then paste in the following information:
SECRET_KEY=@dr11(7h4n=#@8juk63y(-#bqicdl$9f2okpr@#564=a+-f&*8
DEBUG=True
EMAIL_BACKEND="django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST=smtp.gmail.com
EMAIL_USE_TLS=True
EMAIL_PORT=587
EMAIL_HOST_USER=[your gmail address]
EMAIL_HOST_PASSWORD=[the key you generated earlier]
Fill the above field and save.
cd src
python manage.py migrate
python manage.py runserver
Django's way of propagating changes you make to your models (adding a field, deleting a model, etc.) into your database schema.
python manage.py makemigrations
python manage.py migrate
python manage.py seed_users <number of fake instances>
# creates ten fake users
python manage.py seed_users 10
We use GitHub actions to automate tasks of linting, code coverage, build, tests, and security checks. The codes that perform these actions are stored as .yml files in the .github/workflows directory. The GitHub actions are triggered whenever something is pushed (or pulled) into the remote repository. The results of these automated tasks are shown as badges at the top of this README.md file.
Unit test are performed everytime there is a push or pull into the repository. For more information about Unit test visit Test README
sphinx-build -b html docs/ docs/build
Code Coverage is an important metric that allows us to understand how much of the codebase is tested. Code_Cov.yml performs this task. For more information about Code Coverage, please visit this link.
We are using Flake8 for linting and syntax checking, and it is performed by Linting.yml. For more information about Flake8, please visit this link.
Use flake8 before you push code to GitHub.
Config file present in setup.cfg.
flake8 <directory>
We are using the Black code formatter to format our code before pushing it to GitHub. For more information about Black, please visit this link.
Run the line below everytime you push to GitHub.
Config file present in pyproject.toml
black --line-length 120 <filename>
If you prefer using Black in VSCode, you can add the below settings in your vscode settings:
{
"python.formatting.provider": "black",
"python.formatting.blackArgs": ["--line-length", "120"],
"python.linting.enabled": true
}
- run
pre-commit install - Now everytime you commit, Black and Flake8 will run automatically and will not allow you to push if the code standards are not met.
Image from Ji Miranda.
CodeQL.yml performs automated security checks on the codebase and scans it for any vulnerabilities and bugs. For more information about CodeQL, please visit this link.
To aid you in your roommate search, to help others find you, and also to provide you with relevant roommate suggestions, you will be asked to share your "Name", "Email", "Date of Birth", "Gender", "Diet", "Hometown", "Degree and Course", "Country of Origin". You are free to include anything in your bio (which could include your Instagram ID and other social media handles).
Yes, we will be storing them in our database. We will ONLY use this to match you with potential roommates and improve our software.
NO. Your data is safe with us 🙂. We will not share/lend/rent your data to any outside institutions/personnel.
We retain your information as long as needed to provide you with our services.
Our current release does not provide you with a mechanism to remove your data directly from our website. You are always free to turn off your visibility. If you still feel the need to remove your data from our website, kindly email one of the contributors from your registered Email ID, and we will take care of the rest!
Python 3.7+Django 4.1.2HTML5CSS3BootStrap v5.2
- Provide an update for the 'My Room' page, giving users the option to include and display their finalized roommates.
- Suggest properties based on user filters by scraping it from the web and update the matching algorithm.
- Allowing users to set weights for filters to give more value to there preferences and thereby making a customized search.
- Create a mobile application and publish it on App Store and Google Play Store
- Partner with local property agents like Wilson Properties, Trinity Properties, etc. to list their properties on our website.
M M Abid Naziri - mnaziri@ncsu.edu
Nikhil Mehra - nmehra2@ncsu.edu
Bella Samuelsson - insamuel@ncsu.edu
Parth Katlana - pkatlan@ncsu.edu
Heidi Reichert - hreiche@ncsu.edu
Distributed under the MIT License. See LICENSE for more information
Questions about the software? Kindly contact us through one of the following routes. We are happy to answer all your questions regarding the software.
Feel free to reach out to us in case you encounter issues in the software, for example, issues in signing up, logging in, or any other features.
