I-connect

heroku link : https://i-connect.herokuapp.com/

CMPUT404-project-social-distribution-app

See Abram Hindle's project.org (plain-text/org-mode) for a description of the project.

Make a distributed social network!

This project's background, description and requirement are based on Abram Hindle's work, please check his project here.

Contributor

_xiu

_frieda1

_ztan4

_xichen3

_bi2

Welcome to join us by joining our slack channel!

Please use npm ci instead of npm install to install all the dependency for the front end

Demo video

YouTube Link: https://youtu.be/znyX1znNkLc

Development Process(from root dir)

virtualenv venv --python=python3.7 (if you did not get the virtual env)
source venv/bin/activate
pip install -r requirements.txt (to install all required libraries for backend using pip)
python manage.py runserver

# open another terminal
npm ci
npm start
#open browser and go to url localhost:8000 and/or localhost:3000 and start coding

Run all tests

virtualenv venv --python=python3.7 (if you did not get the virtual env)
source venv/bin/activate
pip install -r requirements.txt (to install all required libraries for backend using pip)
python manage.py test

Documentation

Development Admin Management

You can login to the page https://i-connect.herokuapp.com/admin/ to manage the database's entries. The credentials is:

username: admin
password: admin

API documentation

API specification

service address: https://i-connect.herokuapp.com/service
local port: 8000
local hostname: 127.0.0.1 or localhost
prefix of service: service

Online documentation

Documentation Link

It is deployed by Heroku, you can view the doc here. The source code of the documentation is here. The API documentation is developed by swagger editor and swagger ui. They are under Apache 2.0 LICENSE.

Pagination

We enables pagination for authors, comments and posts
Use query string for get method to realize pagination posts?page=4&size=40

Connection with other groups

Team 1:
- API endpoint: https://social-distance-api.herokuapp.com/
- Username for Basic Auth: team16
- Password for Basic Auth: socialdistance
Team 4:
- API endpoint: https://social-distribution-fall2021.herokuapp.com/api/
- Username for Basic Auth: team16
- Password for Basic Auth: secret16
Team 6:
- API endpoint: https://newconnection-server.herokuapp.com/api/v1/
- Username for Basic Auth: admin
- Password for Basic Auth: NewConnectionAdmin

Reference

Special reference

The references used for single cases are decleared in code.

General reference

Basic Auth: https://www.django-rest-framework.org/api-guide/authentication/#how-authentication-is-determined
Serialization: https://www.django-rest-framework.org/tutorial/1-serialization/
Django Query: https://docs.djangoproject.com/en/3.2/topics/db/queries/
React Hooks: https://reactjs.org/docs/hooks-state.html and https://reactjs.org/docs/hooks-effect.html
Material UI: https://mui.com/components/cards/ , https://mui.com/components/material-icons/ and https://mui.com/components/grid/
Reactstrap: https://reactstrap.github.io/
Axios: https://axios-http.com/docs/intro
Test: https://www.django-rest-framework.org/api-guide/testing/

AJAX design

We used the library Axios, which is an AJAX and promises-based HTTP Client for node.JS and browser. It implements all API requests with AJAX call.
In this way, we can only retrieve necessary data from the server and handle the data on the client-side with JavaScript which improved the performance a lot compared with the original web application.
We used Axios for all requests so all of our requests are based on AJAX. For detail of each AJAX request, you can view our online documentation.

xius666 / 404