OKIMOCHI (see here for English manual)
日頃の感謝の気持ちを、少額のビットコインという形にして、Slack上の従業員同士で送り合えるbotアプリケーション。
OKIMOCHI開発の背景
事務所への配送業者の来訪に席の配置の関係で特定の社員が応対をする。給湯室の片付けを気付いた社員が行う。特別な事ではなく業務とも言えないけれど、従業員のささやかな善意や気遣いで企業や事務所の運営が成り立っているケースが多々あります。そのような善意へのありがとうという感謝の気持ちに加え、少額のビットコインの送付ができるSlackbotが「OKIMOCHI」です。
使い方イメージ
- 送付の原資となるビットコインをメインウォレットに入金する（会社の福利厚生用の資金を纒めて入金するような形を想定しています）※ 原資となるビットコインは利用者の誰から入金されても同じウォレットに入金されます。
- 送付のトリガーとなる指定のスタンプや指定コマンドを入力して送金する。
- 一定のビットコインが貯まったら、指定した外部のビットコインウォレットへ引き出す。※その他の詳しい使い方はヘルプコマンドにて参照頂けます。
利用上の注意事項
このアプリケーションは各利用者の善意に基づいております。二人以上の利用者が結託した場合、メインウォレット内の資金を盗むことができます。（自分から自分に対する送金は不可だが、お互いに送金し合うことでメインウォレット内の資金を盗むことが可能）預け金の合計は小額にとどめ、信頼できる仲間内のチームで使用してください！
導入方法
- Slack Appsの作成/Webhook URLを発行
Slack AppsとWebhook URLを slack APIにて作成
Slack Botの管理ページ からAdd Configurationをクリックし、
API Tokenを発行します。Client IDClient SecretVerification TokenWebhook URLAPI Tokenをメモ - Protlyのアカウント作成・API keyの発行
ビットコインの獲得ランキングなどを図化するための作図アプリ Plotly のアカウントを作成し、API Keyを発行する。
API Keyusernameをメモ - インフラ準備
- Gitをinstallし、Repositoryをclone
- 環境変数を更新
.env_exampleをコピーし、環境変数を設定
cp .env_example .env # modify .env with your own slack bot token
| 変数名 | 内容 |
|---|---|
| SLACK_CLIENT_ID | Slack Client ID を入力 |
| SLACK_CLIENT_SECRET | Slack Client Secret を入力 |
| VERIFICATION_TOKEN | Slack Verification Token を入力 |
| EMOJI | Slack Botのアイコンを設定 |
| TOKEN | Slack BotのAPI Token を入力 |
| WEBHOOK_URL | Slack Webhook URL を入力 |
| DEFAULT_CHANNEL | デフォルトのSlackチャンネルを入力 |
| ADMIN_USERNAME | 管理者となるSlack ユーザ名を入力 |
| BITCOIND_HOST_DIR | ブロックチェーンや秘密鍵などの格納先。デフォルトは ~/.bitcoin |
| BITCOIND_URI | 既にbitcoindサーバをお持ちの場合、URIを入力 |
| BITCOIND_USERNAME | 既にbitcoindサーバをお持ちの場合、USERNAMEを入力。新規の場合、任意の文字列を入力(十分長くて推測できないものを推奨) |
| BITCOIND_PASSWORD | 既にbitcoindサーバをお持ちの場合、PASSWORDを入力。新規の場合、任意の文字列を入力(十分長くて推測できないものを推奨) |
| BITCOIND_NETWORK | 本番用の場合は mainnet 、試験用の場合は testnet |
| PLOTLY_API_KEY | Plotlyの API Key を入力 |
| PLOTLY_API_USER | Plotlyの username を入力 |
| MESSAGE_LANG | 日本語と英語を用意。日本語は ja 、英語は en |
| MINIMUM_TX | この値に達したらトランザクションを初めて発行する（支払いごとに発行しないのは、手数料節約のため） |
- Docker環境の構築、dokcer-compose up（bitcoindの同期に約10時間程度必要）
docker network create -d bridge --subnet 172.0.0.0/24 --gateway 172.0.0.1 okimochi-network
COMPOSE_HTTP_TIMEOUT=45000 docker-compose up --build
- 稼働確認
# Slack チャンネルにて@okimochiを招待
/invite @okimochi
# 使い方をリクエスト
@okimochi help
その他設定項目
反応する対象のボタンとその金額
okimochi/locale/*.js の emoji_to_BTC_map を編集してください。
最低トランザクション金額の設定
okimochi/config.js の minimumTxAmount を設定してください。
tip 時の最大金額
okimochi/config.js の MAX_TIP_AMOUNT を設定してください。
ホストマシンの推奨スペック
- Memory ... 3GB
- Storage ... 160GB(
BITCOIND_HOST_DIRで指定するブロックチェーンデータ容量) + 2GB (ユーザーデータベース)
CAMPFIREでの試験導入結果
CAMPFIREでは社内における試験を実施し、1週間で約100件の「OKIMOCHI」が送られました。 試験概要は以下の通りです。
- 試験期間 : 2017年7月25日 〜 2017年8月11日
- 参加従業員数 : 約40名
- tip数（トランザクション数）：200件
- 1度の送付金額(botの設定で可変) : 約30円
- ビットコインの原資 : 約60,000円
開発への参加方法
ソースコードのコメント、GitHub のイシューやプルリクエストでは、日本語か英語を使用して下さい。
- ローカルでのセットアップ
cp .env_example .env
# 環境変数を設定後
docker network create -d bridge --subnet 172.0.0.0/24 --gateway 172.0.0.1 okimochi-network # 3つのdockerコンテナが走るネットワークの作成
docker-compose up -d bitcoind mongo # アプリの後ろで走るコンテナをバックグラウンドで走らせる。
# bitcoindの初回同期にはかなり時間がかかるので、同期状況を見たい場合は-dオプションなしでフォアグラウンドでの実行をおすすめします。
COMPOSE_HTTP_TIMEOUT=45000 docker-compose up --build okimochi # アプリ本体を立ち上げる
- 今後の想定ToDo 作者側で想定しているToDoは、以下となります。 TODO
テストの実行
- ユニットテスト ...
cd okimochi && npm test - 結合テスト&ユニットテスト ...
./test.sh
ライセンス
MIT © CAMPFIRE and Joe Miyamoto