-
Notifications
You must be signed in to change notification settings - Fork 1
/
index.html
137 lines (93 loc) Β· 3.46 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
<p align="center">
<img width="150" src="./client/public/sociol_logo.png">
</p>
<h1 align="center">Sociol</h1>
<div align="center">
Analysts for your Social Media</br></br>
</div>
## π Technologies Used
### Frontend
- [NextJS]()
- [Redux](https://github.com/reduxjs/redux)
- [Jest](https://github.com/facebook/jest)
- [Enzyme](https://github.com/FormidableLabs/enzyme-matchers/tree/master/packages/jest-enzyme)
### Backend
- [Django](https://github.com/django/django)
- [MongoDB]()
## β
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
### π Prerequisites
What things you need to install the software and how to install them
- Install [Yarn](https://classic.yarnpkg.com/en/docs/install/#mac-stable)
- Install [Node.js/npm](https://nodejs.org/en/download/)
- Install [python3/pip3](https://www.python.org/downloads/) (Version >= 3.6)
- Install [MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/)
- Install [MongoDB Compass](https://docs.mongodb.com/compass/master/install) (Recommended)
### βοΈ Installation
```
# Clone this repository
git clone https://github.com/CS161-SJSU/social-analytics
# Go into the repository
cd social-analytics
```
### π» Client Start-up
```
# Go into client folder
cd client
# Install client dependencies
yarn install or npm install
# Setup Environment Variables
# Create a .env file in the client folder
# Place your SPOTIFY, TWIITER, GOOGLE CLIENT/SECRET ID in the file
# Start client on localhost:3000
yarn dev or npm run dev
```
### β¨οΈ Server Start-up
```
# Create virtual environment (recommend) using conda/virtualenv
conda create --name your_env_name
# Start virtual env
source activate your_env_name
# For Windows
Create the virtual environment named "env":
python -m venv env
Add the path to the git ignore file (optional):
echo env/ >> .gitignore
Activate the virtual env:
.\env\Scripts\activate
```
```
# Setup Environment Variables
# Go into server folder
cd server
# Create a .env file in the same directory where settings.py resides
# Place your SPOTIFY, TWIITER, GOOGLE CLIENT/SECRET ID in the file
```
```
# Install server packages from requirements.txt
pip3 install -r requirements.txt or python -m pip3 install -r requirements.txt
# Create new migrations
python3 manage.py makemigrations or Python manage.py makemigrations (Windows)
# Apply new migrations
python3 manage.py migrate
# Start server on localhost:8000
python3 manage.py runserver
```
## βοΈ Testing
```
# Test server using Django unittest
cd server
python3 manage.py test
```
```
# Test client using Jest and Enzyme
cd client
npm test
```
## βοΈ Team
π©π»βπ» **Trinity Nguyen** - [trinwin](https://github.com/trinwin) (Project Lead + Frontend Lead)
π¨π»βπ» **Cagan Sevencan** - [cagansevencan](https://github.com/orgs/CS161-SJSU/people/cagansevencan) (Frontend Developer)
π©π»βπ» **Julia Chin** - [juliachin123](https://github.com/orgs/CS161-SJSU/people/juliachin123) (Backend Developer)
π¨π»βπ» **Eric Wu** - [ericwu12345](https://github.com/orgs/CS161-SJSU/people/ericwu12345) (Backend Developer)
π¨π»βπ» **Toan Dao** - [toandaosjsu](https://github.com/toandaosjsu) (Backend Developer)
See also the list of [contributors](https://github.com/CS161-SJSU/social-analytics/graphs/contributors) who participated in this project.