Merge branch 'master' of https://github.com/FacerAin/OSS-Jaksimsamil
Showing
15 changed files
with
155 additions
and
46 deletions
LICENCE
0 → 100644
1 | + | ||
2 | +MIT License | ||
3 | + | ||
4 | +Copyright (c) 2020 Yong-Woo Song | ||
5 | + | ||
6 | +Permission is hereby granted, free of charge, to any person obtaining a copy | ||
7 | +of this software and associated documentation files (the "Software"), to deal | ||
8 | +in the Software without restriction, including without limitation the rights | ||
9 | +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
10 | +copies of the Software, and to permit persons to whom the Software is | ||
11 | +furnished to do so, subject to the following conditions: | ||
12 | + | ||
13 | +The above copyright notice and this permission notice shall be included in all | ||
14 | +copies or substantial portions of the Software. | ||
15 | + | ||
16 | +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
17 | +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
18 | +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
19 | +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
20 | +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
21 | +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
22 | +SOFTWARE. | ||
... | \ No newline at end of file | ... | \ No newline at end of file |
No preview for this file type
No preview for this file type
1 | # Jaksimsamil | 1 | # Jaksimsamil |
2 | 2 | ||
3 | + | ||
4 | + | ||
5 | + | ||
6 | + | ||
7 | + | ||
3 | ## Project Overview | 8 | ## Project Overview |
4 | 9 | ||
5 | -> **Jaksaimsamil PS Helper service** | 10 | +> **Jaksaimsamil Algorithm Study Helper Service** |
6 | > | 11 | > |
7 | > 작심삼일 알고리즘 문제풀이 도우미 서비스<br/> | 12 | > 작심삼일 알고리즘 문제풀이 도우미 서비스<br/> |
8 | > | 13 | > |
9 | > > 알고리즘 문제 풀이 스터디를 꾸준히 할 수 있게 돕는 웹 서비스입니다. | 14 | > > 알고리즘 문제 풀이 스터디를 꾸준히 할 수 있게 돕는 웹 서비스입니다. |
15 | +> > <br> [링크](http://facerain.dcom.club)에서 직접 사용해 보세요! | ||
16 | + | ||
17 | + | ||
10 | 18 | ||
11 | -## Features | 19 | + |
20 | + | ||
21 | +## Features (ver.1.0.0) | ||
12 | 22 | ||
13 | - 회원가입/로그인 제공 | 23 | - 회원가입/로그인 제공 |
14 | - Online Judge 연동 가능 (Baekjoon) | 24 | - Online Judge 연동 가능 (Baekjoon) |
15 | - 나의 학습 현황 한눈에 보기 | 25 | - 나의 학습 현황 한눈에 보기 |
16 | - 추천 문제 제공 | 26 | - 추천 문제 제공 |
17 | -- 친구와의 경쟁 | ||
18 | - Slack 알리미 | 27 | - Slack 알리미 |
19 | 28 | ||
29 | +## Upcoming Features | ||
30 | + | ||
31 | +- 친구 추가 | ||
32 | +- 친구와의 경쟁 | ||
33 | +- 그룹 추가 | ||
34 | +- 그룹 추천 | ||
35 | +- 개선된 문제 추천 (사용자 실력 맞춤형) | ||
36 | + | ||
37 | +## Usages | ||
38 | + | ||
39 | +#### 회원 | ||
40 | + | ||
41 | +1. 로그인하여 서비스에 접속 할 수 있습니다. | ||
42 | +2. 서비스가 처음이라면, 회원가입을 하세요. | ||
43 | + <br> | ||
44 | + | ||
45 | +#### 설정 | ||
46 | + | ||
47 | +1. 백준 아이디를 등록하고 동기화하세요. [상세]() | ||
48 | +2. 슬랙 HOOK URL을 등록하세요. [상세]() | ||
49 | +3. 일일 목표량을 등록하세요. | ||
50 | + | ||
20 | ## Getting Started | 51 | ## Getting Started |
21 | 52 | ||
22 | -- | 53 | +1. Clone |
54 | + | ||
55 | +``` | ||
56 | +git clone https://github.com/FacerAin/OSS-Jaksimsamil.git | ||
57 | +``` | ||
58 | + | ||
59 | +2. Install MongoDB(Ubuntu) | ||
60 | + | ||
61 | +``` | ||
62 | +sudo apt-get update | ||
63 | +sudo apt-get install -y mongodb-org | ||
64 | +sudo service mongod start | ||
65 | +``` | ||
66 | + | ||
67 | +3. Set Serverfile | ||
68 | + | ||
69 | +``` | ||
70 | +cd Jaksimsamil-server | ||
71 | +touch .env | ||
72 | +---TYPE THIS IN FILE---- | ||
73 | +SERVER_PORT= ### | ||
74 | +MONGO_URL= ### | ||
75 | +JWT_SECRET= ### | ||
76 | +``` | ||
77 | + | ||
78 | +4. Start Node Server | ||
79 | + | ||
80 | +``` | ||
81 | +cd Jaksimsamil-server | ||
82 | +sudo npm install | ||
83 | +npm start | ||
84 | +``` | ||
85 | + | ||
86 | +[링크](/jaksimsamil-server/README.md)에서 API 제공 목록을 볼 수 있습니다. | ||
87 | +<br> | ||
88 | + | ||
89 | +5. Set Front-end page | ||
90 | + | ||
91 | +``` | ||
92 | +cd Jaksimsamil-server | ||
93 | +sudo npm install | ||
94 | +npm start #Start React | ||
95 | +``` | ||
96 | + | ||
97 | +## Contributing | ||
98 | + | ||
99 | +컨트리뷰션은 언제나 환영입니다. 다음 절차를 지켜주세요! | ||
100 | + | ||
101 | +1. Fork the Project | ||
102 | +2. Create your Feature Branch | ||
103 | +3. Commit our changes | ||
104 | +4. Push to Branch | ||
105 | +5. Open a Pull Request | ||
23 | 106 | ||
24 | ## License | 107 | ## License |
25 | 108 | ||
26 | -- | 109 | +- MIT LICENCE | ... | ... |
jaksimsamil-server/API.md
deleted
100644 → 0
1 | -# Jaksimsamil API Documentation | ||
2 | - | ||
3 | -## Overview | ||
4 | - | ||
5 | -- TBA | ||
6 | - | ||
7 | -## URL | ||
8 | - | ||
9 | -- TBA | ||
10 | - | ||
11 | -## Usage | ||
12 | - | ||
13 | -- TBA | ||
14 | - | ||
15 | -## Example | ||
16 | - | ||
17 | -- TBA | ||
18 | - | ||
19 | -## API Table | ||
20 | - | ||
21 | -| group | description | method | URL | Detail | Auth | | ||
22 | -| ------- | --------------------------------- | ------ | ----------------------- | -------- | --------- | | ||
23 | -| user | 유저 등록 | POST | api/user | 바로가기 | JWT Token | | ||
24 | -| user | 유저 삭제 | DELETE | api/user:id | 바로가기 | JWT Token | | ||
25 | -| user | 특정 유저 조회 | GET | api/user:id | 바로가기 | None | | ||
26 | -| user | 전체 유저 조회 | GET | api/user | 바로가기 | JWT Token | | ||
27 | -| friend | 유저 친구 등록 | POST | api/friend | 바로가기 | JWT Token | | ||
28 | -| friend | 유저의 친구 조회 | GET | api/friend:id | 바로가기 | None | | ||
29 | -| profile | 유저가 푼 문제 조회(백준) | GET | api/profile/solvedBJ:id | 바로가기 | None | | ||
30 | -| profile | 유저가 푼 문제 동기화(백준) | PATCH | api/profile/syncBJ | 바로가기 | None | | ||
31 | -| profile | 유저 정보 수정 | POST | api/profile/setprofile | 바로가기 | JWT TOKEN | | ||
32 | -| profile | 유저 정보 받아오기 | POST | api/profile/getprofile | 바로가기 | JWT | | ||
33 | -| profile | 추천 문제 조회 | POST | api/profile/recommend | 바로가기 | None | | ||
34 | -| notify | 슬랙 메시지 전송 요청 (성취여부) | POST | api/notify/goal | 바로가기 | Jwt Token | | ||
35 | -| notify | 슬랙 메시지 전송 요청 (문제 추천) | POST | api/notify/recommend | 바로가기 | None | | ||
36 | -| auth | 로그인 | POST | api/auth/login | 바로가기 | None | | ||
37 | -| auth | 로그아웃 | POST | api/auth/logout | 바로가기 | JWT Token | | ||
38 | -| auth | 회원가입 | POST | api/auth/register | 바로가기 | None | | ||
39 | -| auth | 로그인 확인 | GET | api/auth/check | 바로가기 | None | |
jaksimsamil-server/README.md
0 → 100644
1 | +# Jaksimsamil Server Documentation | ||
2 | + | ||
3 | +## Overview | ||
4 | + | ||
5 | +- KOA 프레임워크 기반의 REST-API로 동작합니다. | ||
6 | +- API 문서는 아래를 참고해주세요. | ||
7 | + | ||
8 | +## Usage | ||
9 | + | ||
10 | +- Starting Server | ||
11 | + | ||
12 | +``` | ||
13 | +npm install | ||
14 | +npm update | ||
15 | +node index.js | ||
16 | +``` | ||
17 | + | ||
18 | +## Example | ||
19 | + | ||
20 | +``` | ||
21 | +POST http://facerain.dcom.club/profile/getprofile | ||
22 | +{ | ||
23 | + username: 'syw5141', | ||
24 | +} | ||
25 | +``` | ||
26 | + | ||
27 | +## API Table | ||
28 | + | ||
29 | +| group | description | method | URL | Detail | Auth | | ||
30 | +| ------- | -------------------------------------- | ------ | ----------------------- | -------------------------------------- | --------- | | ||
31 | +| profile | 유저가 푼 문제 조회(백준) | GET | api/profile/solvedBJ:id | [바로가기](/src/api/profile/README.md) | None | | ||
32 | +| profile | 유저가 푼 문제 동기화(백준) | PATCH | api/profile/syncBJ | [바로가기](/src/api/profile/README.md) | None | | ||
33 | +| profile | 유저 정보 수정 | POST | api/profile/setprofile | [바로가기](/src/api/profile/README.md) | JWT TOKEN | | ||
34 | +| profile | 유저 정보 받아오기 | POST | api/profile/getprofile | [바로가기](/src/api/profile/README.md) | JWT | | ||
35 | +| profile | 추천 문제 조회 | POST | api/profile/recommend | [바로가기](/src/api/profile/README.md) | None | | ||
36 | +| profile | 친구 추가 | POST | /api/profile/addfriend | [바로가기](/src/api/profile/README.md) | JWT TOKEN | | ||
37 | +| notify | 슬랙 메시지 전송 요청 (목표 성취 여부) | POST | api/notify/goal | [바로가기](/src/api/notify/README.md) | Jwt Token | | ||
38 | +| notify | 슬랙 메시지 전송 요청 (문제 추천) | POST | api/notify/recommend | [바로가기](/src/api/notify/README.md) | None | | ||
39 | +| auth | 로그인 | POST | api/auth/login | [바로가기](/src/api/auth/README.md) | None | | ||
40 | +| auth | 로그아웃 | POST | api/auth/logout | [바로가기](/src/api/auth/README.md) | JWT Token | | ||
41 | +| auth | 회원가입 | POST | api/auth/register | [바로가기](/src/api/auth/README.md) | None | | ||
42 | +| auth | 로그인 확인 | GET | api/auth/check | [바로가기](/src/api/auth/README.md) | None | |
... | @@ -33,7 +33,7 @@ | ... | @@ -33,7 +33,7 @@ |
33 | "nodemon": "^2.0.4" | 33 | "nodemon": "^2.0.4" |
34 | }, | 34 | }, |
35 | "scripts": { | 35 | "scripts": { |
36 | - "start": "node src", | 36 | + "start": "node ./index.js", |
37 | "start:dev": "nodemon --watch src/ src/index.js" | 37 | "start:dev": "nodemon --watch src/ src/index.js" |
38 | } | 38 | } |
39 | } | 39 | } | ... | ... |
jaksimsamil-server/src/api/auth/README.md
0 → 100644
File mode changed
jaksimsamil-server/src/api/friend/README.md
0 → 100644
File mode changed
jaksimsamil-server/src/api/notify/README.md
0 → 100644
File mode changed
jaksimsamil-server/src/api/profile/README.md
0 → 100644
1 | +. |
jaksimsamil-server/src/api/user/README.md
0 → 100644
File mode changed
This diff could not be displayed because it is too large.
This diff could not be displayed because it is too large.
-
Please register or login to post a comment