StockManagement説明

diff --git a/Introduction.html b/Introduction.html index 090fea9..922d7d6 100644 --- a/Introduction.html +++ b/Introduction.html @@ -18,8 +18,8 @@

Javaによる実務経験3年以上のエンジニアの方々を対象に，被験者として実験へのご協力をお願いいたします．
この実験は，Javaプログラムを手作業でリファクタリングするのに，どの程度の時間を要するのかを計測することを目的としています．
- 対象となるJavaプログラムは2つあり，それぞれのプログラムに対して1回ずつリファクタリングの課題に取り組んでいただきます．
- リファクタリングの作業は時間を計測しながらお手元のPCで行っていただき，課題を終えるたびに，アンケートにお答えいただきます．
+ 対象となるJavaプログラムは2つあり，それぞれのプログラムに対して1つずつリファクタリングの課題に取り組んでいただきます．
+ リファクタリングの作業はお手元のPC上で行っていただき，課題を終えるたびに，アンケートにお答えいただきます．
全体の作業時間としては，2~3時間程度を想定しています．お答えいただくアンケートは最初と最後，および各リファクタリング課題の完了後の計4個あります．
アンケートへの回答が終わるたびに作業を中断していただいて構いません． @@ -30,11 +30,11 @@

実験における作業内容について説明いたします．
- 対象となるJavaプログラムはいずれも小規模なGUIアプリケーションです．それぞれのプログラムに対して1回ずつ，計2回リファクタリングの課題に取り組んでいただきます．
+ 対象となるJavaプログラムはいずれも小規模なGUIアプリケーションです．それぞれのプログラムに対して1つずつ，計2個リファクタリングの課題に取り組んでいただきます．
課題で取り組むリファクタリングは，PUSH型のデータ転送をPULL型に変更するものと，PULL型のデータ転送をPUSH型に変更するものの2種類です．
- PUSH型のデータ転送とPULL型のデータ転送については，実験をはじめる前に改めて説明いたします．
- 実験では，まずGitHub上に公開した実験用のJavaプログラムを，お手元のPCにダウンロード（クローン）していただき，動作確認を行っていただきます．
- その後，お手元の時計で時間を計測しながらいずれかのリファクタリングを手作業で実施していただきます．
+ PUSH型のデータ転送とPULL型のデータ転送については，実験をはじめる前に説明いたします．
+ 実験では，まずGitHub上に公開した実験用のJavaプログラムを，お手元のPCにダウンロード（クローン）していただき，動作確認を行った上で，手作業でリファクタリングを行っていただきます．
+ このとき，お手元の時計でリファクタリング作業に要した時間を計測していただきます．また，作業の結果はGitHubにコミット＆プッシュしていただきます．
開発環境は何をお使いいただいても結構ですが，主に Eclipse と IntelliJ IDEA を想定しています．リファクタリング課題を終えるたびに，アンケートにお答えいただきます．
また，実験の開始前と終了後にも1つずつアンケートにお答えいただきます．

@@ -51,25 +51,23 @@

実験にご同意いただける場合は，個人アンケートにお答えいただきます．

実験へのご同意，個人アンケートの内容，プロフィールの内容等を元に実験依頼の可否を判断させていただきます．

実験依頼の可否についてご連絡いたします．実験をご依頼する場合は，実験準備が整い次第，実験用のWebページをこちらからお伝えいたします．(実験準備に数日を要する可能性があります．)

実験の前半部分に取り組んでいただきます．

1つめの実験用プログラムについてリファクタリング課題に取り組んでいただきます．

6つの小さな仮想プログラムについて，以下の手順を繰り返します．

対象となる仮想プログラムのソースコードを読んでいただき，アンケートにお答えいただきます．
上記ソースコードに対して，シーケンス図を拡張した表記法，オブジェクト図に呼び出し木を埋め込んだ表記法，オブジェクトの動きを表すアニメーションによる可視化を比較し，アンケートにお答えいただきます． - オブジェクトの動きを表すアニメーションはリモートデスクトップ上の専用アプリケーションにてご覧いただきます．

プログラムの仕様を理解していただきます．
GitHub上のプログラムをクローンしていただき，お手元の環境でビルドと動作確認を行っていただきます．
リファクタリング課題の目的と手順を説明いたします．
作業用のブランチを切っていただき，時間計測をしながらリファクタリング作業を行っていただきます．
作業の結果をブランチにコミット＆プッシュしていただきます．
課題別アンケートにお答えいただきます．

実験の後半部分に取り組んでいただきます．

2つめの実験用プログラムについても同様にリファクタリング課題に取り組んでいただきます．

3つのアプリケーションから1~2つずつ計5つの機能を選んで，機能毎に以下の手順を繰り返します．

(必要に応じて)対象となるオープンソースプログラムに関する，簡単な説明をお読みいただきます．
対象となる機能に関する説明をお読みいただきます．
対象となる機能に関係するソースコード(50~200行程度)と，いずれか手法による可視化を合わせて閲覧していただき，2つのアンケートにお答えいただきます． - オブジェクトの動きを表すアニメーションはリモートデスクトップ上の専用アプリケーションにてご覧いただきます．

プログラムの仕様を理解していただきます．
GitHub上のプログラムをクローンしていただき，お手元の環境でビルドと動作確認を行っていただきます．
リファクタリング課題の目的と手順を説明いたします．
作業用のブランチを切っていただき，時間計測をしながらリファクタリング作業を行っていただきます．
作業の結果をブランチにコミット＆プッシュしていただきます．
課題別アンケートにお答えいただきます．

最後に実験全体に関してのアンケートにお答えいただきます．

@@ -85,7 +83,7 @@

実験時間(拘束時間)に関して説明いたします．
-全体の作業としては4~6時間を想定していますが，人によっては多少前後する可能性があります．
+全体の作業としては2~3時間を想定していますが，人によっては多少前後する可能性があります．
時間に余裕がある際に行ってください．
また，後日大学にお越しいただいたり，こちらから連絡を行うことはありません(参加者に不利益が発生する恐れのある場合は除く)．

@@ -100,7 +98,7 @@ 契約と報酬に関して説明いたします．

報酬は作業全体に対して一律に(10,000円)支払われます．
報酬は作業全体に対して一律に(8,000円)支払われます．
作業は全てのアンケートにお答えいただいた時点で終了とします．
実験の途中で参加を取りやめた場合は，報酬は支払われません．あらかじめご了承下さい．
契約及び報酬に関してご不明な点がございましたら，メッセージにてご連絡ください．

- 同意確認フォーム + 同意確認フォーム

@@ -134,7 +132,7 @@

- 個人アンケートはこちら + 個人アンケートはこちら

StockManagement説明

「StockManagement」は，ソフトウェア工学分野において共通問題として用いられる酒屋の在庫問題を一部簡略化し，
+ Javaを用いて実装したGUIアプリケーションです．

StockManagementでは，倉庫に対するお酒の搬入処理と，出庫依頼を行うことができます．

お酒の在庫は，品名と数量で管理されます．プログラムはどのお酒の在庫もない状態から始まります．
+ お酒の在庫の状態は画面下部左側に表形式で表示されています．
+ 倉庫にコンテナの搬入があった場合は，画面上部左側にコンテナ内のお酒の品名と数量を入力します．
+ 受付係が出庫依頼を受けた場合は，画面上部中央に依頼されたお酒の品名と数量を入力します．
+ +

以下，搬入処理と出庫依頼処理のそれぞれについて説明します．