communIIITy
GAUS team's submission for HackOFiesta 2.0
Devfolio Submission Link: https://devfolio.co/submissions/communiiity-2197
The problem
There are no good online solutions for students of an institute(like our college, IIIT Lucknow) to discuss technical questions among their peers and instructors. We realized that this was a problem when our professor, Saurabh Sir, started receiving multiple emails with nearly identical questions. We had already tried and failed to use platforms like stackoverflow teams(which needs a subscription after 3 months). So, we decided to make a customizable solution geared towards catering to the needs of individual institutions.
Our Solution
To tackle this problem and help everyone learn more effectively, we have made communIIITy. communIIITy is a platform where students and instructors from an institute can easily interact with each other, be it via asking questions or posting answers. Unlike global platforms like StackOverflow, communIIITy is primarily geared towards people from individual organizations. This provides an exclusive communIIITy (pun intended!) platform, customized to its unique needs. It also gives liberty to have discussions among people with a similar knowledge level and helps avoid the financial overhead of buying a teams subscription on StackOverflow. communIIITy is based upon the decentralized matrix protocol, which is used to share highest upvoted questions and answers are shared among peers (other institutes). It also means lower downtime when compared to websites such as StackOverflow which can face outages.
communIIITy uses Tezos blockchain for peer discovery, and uses that data to exchange information with its peers. The peer-to-peer exchange is cryptographically secured and authenticated via signed trusted certificates.
Installation Instructions
Installation involves two parts: setting up the frontend webapp, and connecting to the backbone network. Run npm install to install the dependencies.
Setting up the webapp
- Set up nginx/apache/similar and install your public certificates
- Start mongodb locally(preferred) or on a provider like MongoDB Atlas
- Run
npm start, ornode server.js. Remember to update your ports and mongodb database urls in the .env file as necessary.
Connecting to backbone
- Currently, you need a signed certificate signed by certificate authority(ca) Pranav Gade<pranavgade20@gmail.com> to connect to the network. This will be moved to a crowd-concensus/proof-of-stake model in the future.
- So, create a certificate using openssl and get it signed by the relevant CA.
- Add the said certificate and your api domain/url to the storage of the Tezos contract(not deployed on mainnet yet, but see contract.py).
- Update sync.js and syncserver.js with the certificate and details.
- Add your tezos details to enviornment variables as required by updater.py.
- Run
node updater.jsonce. You typically won't need to execute it every day, as it is meant for peer discovery. - Set up a cronjob/jobber/script to run
node sync.jsevery 18-24 hours(fewer if you would like more frequent updates)- If you are using heroku, you can run this on startup as heroku instances are restarted every 24 hours
- Start syncserver.js with
node syncserver.js
Development
Follow installation instructions, but also install nodemon and dotenv as dev dependencies, and run npm run devStart or nodemon server.js. Also, create and add google credentials (client id and client secret), redirect uri, cookie secret and the institute's college domain (for example iiitl.ac.in) in the .env file.
Presentation Link
https://github.com/N-Shar-ma/communIIITy/blob/master/Presentation.pdf
Demo Link
You can also visit the live demo at http://commun-iiit-y.herokuapp.com/ (you need an email ending with @iiitl.ac.in to login)
Screenshots
Creating a question:
View question and its answers:
Main page with latest questions:
Login page:
