社内での問い合わせ管理にQ&Aシステムのススメ #運用

この記事は OPENLOGI Advent Calendar 2017 の24日目（遅刻！）として、また、実際にこのシステムを実運用に導入すべく書かれました。

したいことと書いていること

……という訳で本文です

私たちは日々コードを書いたり、数値として取得できているサーバーの状況を監視してトラブルに対応するだけでなく、もっとアナログに、サービスを使ってくださっているユーザーの皆さまや、その皆様と直接やりとりをしている社内の担当者から様々な質問・要望にお応えしています。

そして実はあなたと同じ質問を、隣の人が既にしていたことに気づいていなかったりするのです。
そして実はあなたがされたのと同じ質問を、隣の人が既に調べて答えていたことに気づいていなかったりするのです。

ここにある無駄を何とかしたい。

自動化・システム化して根本から対策
- 私たちはシステム屋なので、コストが見合うならこれがベストですね
FAQ・マニュアルを作る
- システム化が見合わないorまだ手が回ってないようなものについては、FAQやマニュアルを作成し、それを見ればなんとかなるように文書整備しています。
過去に類似の対応がないか探す
- この手のやり取りは、質問・要望の時点で原則文書化されており、まとめがなくても、過去のログを正しく探せば類似の対応のログを発見できることは多いです。

上記三段階で、全体的なフェーズを一通りカバーできているような気になるのですが、実は結構粗があります。

1, 2のフェーズまで移行してしまえばいいのですが、そうなるのは「ちょっと困ってきた」からこの様になっているんですね。
出来ればこの「ちょっと困った」を通らずに解決したいですよね。

また3のログについても、複数の問題があります。それは

それぞれの投稿に対してvoteで重み付けをするQ&Aのシステムを使ってみよう！

これによって期待することは以下の通り。

というわけで、Apache2.0で提供されているSCOOLDで、今回の問題に向かってみようと思います。

こちらはスウェーデンのErudika社が提供しているQ&Aシステムで、同社の提供するparaio.comというバックエンドサービスと併せて利用すると、とても簡単にQ&Aシステムを構築できます。

バックエンドのparaもApache2.0での提供なので完全に自前で利用できるのですが、今回はまだ様子見なのでparaio.com上で起動してみます。
動かすだけならメチャクチャ簡単です。

アカウントを作って……

アプリを作って……

キーを手に入れる

こちらもあっという間に終わりますが、

https://scoold.com/ からjarファイルをDL
入ってなければJDK8（9だとうまく動かないので注意）を導入
例に従ってapplication.confを作成
java -Dserver.port=8000 -Dconfig.file=./application.conf -jar scoold-*.jar （ドキュメント通りのオプション順だと、mac上ではうまくいきません。順番変えましょう）

これだけ。

質問して……

回答して、voteもして……

よく参照されている順に並ぶ

とまあ実にお手軽に出来上がりました。

しかし何もかも都合良くは行かないものです。
元々公開のサービス前提（というかStackOverflowのクローン）として開発されているので、我々の用途とは合わない部分が幾つかあります。それは、

この2点です。私たちは身内でのみ使う前提なので、必要ならどんどんvoteして順位を上げていきたいわけです。

……といったところでアドヴェントカレンダーを外れて、この先、投稿を分けて少しずつカスタマイズを進めて行きます。
本稿では、ひとまずドキュメント管理の1つのありかたとしてQ&Aサービスが利用している枠組みが便利になる局面もあるのでは？という部分を感じていただければと思います。

ありがとうございました。