プロジェクト

全般

プロフィール

編集 履歴

Wiki » 履歴 » バージョン 30

近藤 @tu21themouth, 2018/09/15 15:35

1 1 みぞ @mizo0203 
# Wiki
2 





    3
    27
    みぞ @mizo0203
    
{{toc}}





    4
    
    
    





    5
    16
    みぞ @mizo0203
    
## 開発環境





    6
    
    
    





    7
    
    
    
* Python 開発環境のセットアップ





    8
    
    
    
    * https://cloud.google.com/python/setup





    9
    
    
    
* エディタのインストール





    10
    
    
    
    * https://code.visualstudio.com





    11
    
    
    
* Python extension for Visual Studio Code のインストール





    12
    
    
    
    * https://marketplace.visualstudio.com/items?itemName=ms-python.python





    13
    18
    みぞ @mizo0203
    
* Flake8 のインストール





    14
    
    
    
    * `$ pip3 install flake8`





    15
    
    
    
* Visual Studio Code の設定





    16
    24
    みぞ @mizo0203
    
    * [![vs_code_setting.png](http://redmine.mizo0203.com/attachments/thumbnail/63)](http://redmine.mizo0203.com/attachments/63/VS%20Code%20Setting.png)





    17
    16
    みぞ @mizo0203
    





    18
    25
    みぞ @mizo0203
    
## デプロイコマンド





    19
    
    
    





    20
    26
    みぞ @mizo0203
    
`$ gcloud app deploy --version 1 --project api-project-379224789817`





    21
    25
    みぞ @mizo0203
    





    22
    1
    みぞ @mizo0203
    
## 開発ツール





    23
    
    
    





    24
    
    
    
* GitHub





    25
    
    
    
    * コード管理





    26
    
    
    
        * プライベートリポジトリ（後にパブリックへ変更する）





    27
    5
    みぞ @mizo0203
    
        * 中央集権型ワークフローを採用する





    28
    
    
    
            * 中央リポジトリ: https://github.com/mizo0203/google-home-shiritori





    29
    1
    みぞ @mizo0203
    
* Redmine





    30
    
    
    
    * 要件管理





    31
    
    
    
    * 不具合管理





    32
    
    
    
    * Wiki





    33
    
    
    
* Markdown + PlantUML





    34
    
    
    
    * ドキュメント作成





    35
    
    
    
    * 設計図作成





    36
    
    
    
        * ※ Word・Excel・PowerPoint は使用禁止





    37
    4
    みぞ @mizo0203
    
* CircleCI - 1 コンテナ無料（プライベートリポジトリでも可、ビルド時間 25h/month まで）





    38
    1
    みぞ @mizo0203
    
    * ビルドチェック





    39
    
    
    
    * 静的解析





    40
    
    
    
        * Lint - コードの構文チェック 





    41
    
    
    
        * FindBugs - 実行時に起こり得るバグの検出





    42
    
    
    
    * 【できれば】Programming Tests





    43
    
    
    
    * 【できれば】Deploy





    44
    
    
    
* Slack





    45
    
    
    
    * チャット





    46
    28
    みぞ @mizo0203
    
* [Unicode Escape Sequence | KWONLINE.ORG](https://www.kwonline.org/u_esc_seq.php)





    47
    
    
    
    * 日本語と「¥uXXXX」形式のユニコードエスケープを相互変換するツール





    48
    1
    みぞ @mizo0203
    





    49
    
    
    
## 利用サービス





    50
    
    
    





    51
    
    
    
* DialogFlow





    52
    8
    a a
    
    * [JSONフォーマット](https://dialogflow.com/docs/fulfillment#section-format-of-request-to-the-service)





    53
    11
    みぞ @mizo0203
    
    * 参考:





    54
    
    
    
        * Dialogflow入門 - https://qiita.com/kenz_firespeed/items/0979ceb05e4e3299f313





    55
    
    
    
            * > User saysに「明日の福岡を予約」





    56
    
    
    
                * 「User says」欄は現在存在しない、「Training phrases」欄に入力する 





    57
    12
    みぞ @mizo0203
    
            * > 入力内容を元に自動的にEntityが検出されParameterとして設定されました。





    58
    
    
    
                * 自動的には検出されないので、単語をクリックして Entity を追加すること





    59
    
    
    
                * `@sys.date` は「明日の」ではなく「明日」を指定すること





    60
    11
    みぞ @mizo0203
    
        * Dialogflowの使い方について - http://hiyo-ac.hatenablog.com/entry/2018/02/25/162729





    61
    1
    みぞ @mizo0203
    





    62
    29
    近藤 @tu21themouth
    
* ipadic





    63
    
    
    
    * 形態素解析ツール「ChaSen」に用いられる辞書データ (「ipadic2.7.0」内の「Noun.dic」を利用)





    64
    
    
    
    * http://chasen.naist.jp/hiki/ChaSen/





    65
    
    
    
    * 使い方





    66
    
    
    
        * 「Noun.dic」をテキストエディタなどで「UTF8」に変換する(デフォルトは「EUC-JP」)





    67
    
    
    
        * 「make_json_dict.py」で「dict.json」に変換する





    68
    30
    近藤 @tu21themouth
    
            * > `$ python make_json_dict.py Noun.dic dict.json`





    69
    
    
    
        * 作成した「dict.json」をプロジェクトのdataディレクトリに配置





    70
    29
    近藤 @tu21themouth
    





    71
    1
    みぞ @mizo0203
    
## 開発フロー





    72
    
    
    





    73
    
    
    
1. Redmine にチケットを作成





    74
    
    
    
2. GitHub で各自ブランチを切って Commit & Push





    75
    2
    みぞ @mizo0203
    
    * プリフィックス(範囲) + 英語のコミットメッセージ + #チケット番号 + @作業時間





    76
    14
    みぞ @mizo0203
    
        * ```feat(*): hogehoge. fix #999 @1.5h``` ：新しい機能





    77
    
    
    
        * ```fix(*): hogehoge. fix #999 @1.5h``` ：バグフィックス





    78
    
    
    
        * ```docs(*): hogehoge. fix #999 @1.5h [ci skip]``` ：ドキュメントのみ変更（CI は実行しない）





    79
    
    
    
        * ```style(*): hogehoge. fix #999 @1.5h``` ：コードの意味に影響を与えない変更（空白、フォーマット、セミコロンの欠落など）





    80
    
    
    
        * ```refactor(*): hogehoge. fix #999 @1.5h``` ：バグを修正したり、機能を追加したりしないコード変更





    81
    
    
    
        * ```perf(*): hogehoge. fix #999 @1.5h``` ：パフォーマンスを向上させるコード変更





    82
    
    
    
        * ```test(*): hogehoge. fix #999 @1.5h``` ：既存のテストの欠落または修正の追加





    83
    
    
    
        * ```chore(*): hogehoge. fix #999 @1.5h``` ：ビルドプロセスやドキュメント作成などの補助ツールやライブラリの変更





    84
    2
    みぞ @mizo0203
    
            * 参考: [【今日からできる】コミットメッセージに 「プレフィックス」 をつけるだけで、開発効率が上がった話 - Qiita](https://qiita.com/numanomanu/items/45dd285b286a1f7280ed)





    85
    
    
    
            * 参考: [angular.js/DEVELOPERS.md at master · angular/angular.js](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type)





    86
    
    
    
    * 原則 1 Commit 1 チケット





    87
    15
    みぞ @mizo0203
    
        * ```fix(*): hogehoge. ref #999 @1h``` ：対処未完了で Commit する場合





    88
    
    
    
        * ```fix(*): hogehoge. fixs #99 @0.5h #999 @1h``` ：例外的に複数チケットを 1 Commit で対処する場合





    89
    2
    みぞ @mizo0203
    
3. CircleCI でビルドチェック、静的解析、PT





    90
    
    
    
4. みぞ + 1 名の 2 名でコードレビュー & マージ





    91
    
    
    
5. CircleCI でビルドチェック、静的解析、PT、Deploy





    92
    1
    みぞ @mizo0203
    





    93
    
    
    
## 開発言語





    94
    
    
    





    95
    17
    みぞ @mizo0203
    
Python 2.7





    96
    1
    みぞ @mizo0203
    





    97
    17
    みぞ @mizo0203
    
* Google App Engine for Python の無料枠では Python 2.7 しか動かせない





    98
    
    
    
    * 





    99
    
    
    
* ただし、 Python 3 系に Porting できる実装で行う





    100
    22
    a a
    
    * ```pylint --py3k ./* tests/*``` でチェック可能





    101
    
    
    
* PEP 8に準拠した実装を行う





    102
    
    
    
    * ```flake8 ./ tests``` でチェック可能





    103
    
    
    
* 単体テストを記述する





    104
    
    
    
    * ```python -m unittest discover -v tests``` で実行可能





    105
    17
    みぞ @mizo0203
    





    106
    
    
    
## 設計資料





    107
    
    
    





    108
    
    
    
[[Design_Documents|設計資料]]





    109
    
    
    





    110
    1
    みぞ @mizo0203
    
## Google App Engine for Java を利用する開発





    111
    17
    みぞ @mizo0203
    





    112
    
    
    
サーバーはJSONを処理できれば、何でも使用できる





    113
    1
    みぞ @mizo0203
    





    114
    9
    みぞ @mizo0203
    
* IntelliJ IDEA Community Edition で環境構築





    115
    
    
    
    * https://cloud.google.com/tools/intellij/docs/quickstart-IDEA





    116
    10
    みぞ @mizo0203
    
    * https://cloud.google.com/tools/intellij/docs/create-standard





    117
    13
    みぞ @mizo0203
    





    118
    
    
    
## 利用 OSS ライブラリ





    119
    
    
    





    120
    
    
    
| 名前 | License | URL |





    121
    
    
    
|:----------:|:-----------:|:------------:|





    122
    23
    a a
    
| | | |





    123
    13
    みぞ @mizo0203
    





    124
    
    
    
### 利用目的





    125
    1
    みぞ @mizo0203
    





    126
    28
    みぞ @mizo0203
    
*