Skip to content

Commit

Permalink
Merge pull request #98 from hoppiece/readme
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
KoukiNAGATA committed Mar 26, 2021
2 parents 93216dd + b020a19 commit 77e7798
Showing 1 changed file with 25 additions and 67 deletions.
92 changes: 25 additions & 67 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# オタクとアニメのマッチングサービス「Toonder」
TinderライクなUIで機械学習を用いたアニメのマッチングアプリです。<br>
2021年3月に開催されたサポーターズ様の[初めてのハッカソン~オンライン開発合宿vol.1~](https://talent.supporterz.jp/events/337ce715-9813-41d4-a995-e3504dc8e719/)にて制作し、努力賞を頂きました🎉
[初めてのハッカソン~オンライン開発合宿vol.1~](https://talent.supporterz.jp/events/337ce715-9813-41d4-a995-e3504dc8e719/)(サポーターズ様、2021年3月開催)にて制作、努力賞を頂きました🎉

<table>
<tr>
<td><img src="https://pbs.twimg.com/media/Ew_79wEU8AM7d7J.jpg"></td>
Expand All @@ -14,83 +15,40 @@ TinderライクなUIで機械学習を用いたアニメのマッチングアプ

<table>
<tr>
<th width="60px">アプリ名</th><td>Toonder</td>
<th width="60px">アプリ名</th>
<td>Toonder</td>
</tr>
<tr>
<th>開発人数</th><td>4人<br>
<b><a><a href="https://github.com/knknk98"><img src="https://github.com/knknk98.png" width="50px;" style="border-radius: 50%;" /></a></b>
<b><a><a href="https://github.com/koukiNAGATA" target="_blank"><img src="https://github.com/koukiNAGATA.png" width="50px;" /></a></b>
<b><a><a href="https://github.com/littleIkawa" target="_blank"><img src="https://github.com/littleIkawa.png" width="50px;" /></a></b>
<b><a><a href="https://github.com/hoppiece" target="_blank"><img src="https://github.com/hoppiece.png" width="50px;" /></a></b></td>
<th>開発人数</th>
<td>
4人<br>
<b><a href="https://github.com/knknk98"><img src="https://github.com/knknk98.png" width="50px;" /></b>
<b><a href="https://github.com/koukiNAGATA"><img src="https://github.com/koukiNAGATA.png" width="50px;" /></b>
<b><a href="https://github.com/littleIkawa"><img src="https://github.com/littleIkawa.png" width="50px;" /></b>
<b><a href="https://github.com/hoppiece"><img src="https://github.com/hoppiece.png" width="50px;" /></b>
</td>
</tr>
<tr>
<th>担当</th><td>フロントエンド:@knknk98 @koukiNAGATA<br>
バックエンド(APIサーバ):@litteleIkawa、
バックエンド(レコメンドアルゴリズム):@hoppiece</td>
<th>担当</th>
<td>フロントエンド:<a href="https://github.com/knknk98">@knknk98</a>
<a href="https://github.com/koukiNAGATA">@koukiNAGATA</a><br>
バックエンド(APIサーバ):<a href="https://github.com/littleIkawa">@litteleIkawa</a><br>
バックエンド(レコメンドアルゴリズム):<a href="https://github.com/hoppiece">@hoppiece</a>
</td>
</tr>
<tr>
<th>開発期間</th><td>約1週間</td>
<th>開発期間</th>
<td>約1週間</td>
</tr>
<tr>
<th>使用技術</th>
<td><img src="https://user-images.githubusercontent.com/65712721/112453423-0481e100-8d9b-11eb-830a-b394215beddf.png" width="70%"></td>
</tr>
</table>

## 構成
- Docker ... バージョン管理
- flask ... サーバサイドフレームワーク
- Nuxt.js ... フロントエンドフレームワーク
- Vuetify ... UIライブラリ
- figma ... ワイヤーフレーム
- swagger ... API仕様書

## ディレクトリ構成
```
anime-tinder
├── README.md
├── docker-compose.yml
├── Dockerfile ... python用のDockerfile
├── api-document.yaml ... API仕様書
├── app ... フロントエンド
│ ├── Dockerfile
│ └── front ... Nuxtのプロジェクト
│ ├── assets
│ ├── components
│ ├── layouts
│ ├── middleware
│ ├── node_modules
│ ├── nuxt.config.js
│ ├── package.json
│ ├── pages
│ ├── plugins
│ ├── README.md
│ ├── static
│ ├── store
│ └── yarn.lock
├── mysql ... データベース
│ ├── Dockerfile
│ ├── my.cnf
│ └── sqls
│ └── initialize.sql ... 初回起動時実行されるSQL
└── src ... pythonのコード
```

## フロントエンド(Nuxt)
### 実行
`docker-compose up` コンテナを起動。自動的に`yarn run dev` が実行されるようになっている

http://localhost:3000 にページが表示される

`Ctrl+C`で終了

## バックエンド(flask)
### 実行
`docker-compose up -d` でバックグラウンド実行. `flask run -h 0.0.0.0`が実行される(`0.0.0.0`で外部からの受付、実行ファイルは`Dockerfile`で指定している). http://localhost:5000 でバックエンドに接続できる.

## API仕様書
swaggerを用いた。yaml形式で記述されている。

`api-document.yaml`https://editor.swagger.io/ などで開く。
### 使用方法
1. Dockerコンテナ立ち上げ
docker-compose.ymlがあるパスで`$ docker-compose up`

サーバに接続した状態で各APIの"Try it out"を押してパラメータやらリクエストの値やらを入力し"Execute"するとちゃんとAPIが動作してるかチェックできる。
2. ブラウザでアクセス
`http://localhost:3000`

0 comments on commit 77e7798

Please sign in to comment.