BDD Specs

ストーリー

ユーザがqiitaの一覧情報を見たいとリクエストする

物語1

Who:オンラインのユーザーは What:最新のデータをアプリに自動で取得して欲しい。 Why:なぜなら、いつでも最新の情報をチェックできるからだ。

シナリオ

Given:ユーザがオンラインの状態にある時に When:qiita情報の一覧を見たいとリクエストすると Then:アプリはリモートから最新のqiitaの情報を表示してキャッシュを新しい情報と入れ替える。

Given:ユーザがオンラインの状態で画面を表示している時に When:取得しているデータの続きのqiita情報の一覧を見たいとリクエストすると Then:アプリはリモートから取得済みのデータの次に最新のqiitaの情報を取得してキャッシュにも追加する

物語2

Who:オフラインのユーザーは What:最新のキャッシュデータをアプリに自動で取得して欲しい。 Why:なぜなら、いつでも取得可能な最新の情報をチェックできるからだ。

シナリオ

Given:ユーザがオフラインの状態にあり、有効期限内のキャッシュが存在する場合 When:qiita情報の一覧を見たいとリクエストすると Then:アプリはキャッシュ上の最新のqiitaの情報を表示する

Given:ユーザがオフラインの状態にあり、有効期限が切れたキャッシュが存在する場合 When:qiita情報の一覧を見たいとリクエストすると Then:アプリはデータがない時のメッセージを表示する

Given:ユーザがオフラインの状態にあり、キャッシュが存在しない場合 When:qiita情報の一覧を見たいとリクエストすると Then:アプリはデータがない時のメッセージを表示する

Given:ユーザがオフラインの状態で画面を表示している時に When:取得しているデータの続きのqiita情報の一覧を見たいとリクエストすると Then:アプリはキャッシュ上の取得済みのデータの次に最新のqiitaの情報を取得する

ユースケース

リモートからqiita情報を取得

Data:

Happy Path:

dataを使って「qiita情報を取得する」コマンドを実行する
システムがURLからデータをダウンロードする
システムがダウンロードデータをバリデーションする
システムが妥当なデータからqiita情報を作成する
システムがqiita情報を伝達する

Invalid data(sad path):

システムからinvalid data errorを伝達する

No connectivity(sad path):

システムからconnectivity errorを伝達する

リモートからqiitaユーザの画像を取得

Data:

Happy Path:

dataを使って「qiitaユーザの画像を取得する」コマンドを実行する
システムがURLからデータをダウンロードする
システムがダウンロードデータをバリデーションする
システムが画像データを伝達する

Invalid data(sad path):

システムからinvalid data errorを伝達する

No connectivity(sad path):

システムからconnectivity errorを伝達する

キャッシュからqiita情報を取得

Data:

Happy Path:

「qiita情報を取得する」コマンドを実行する
システムがキャッシュからデータを取得する
システムがキャッシュが有効期限内であるかをバリデーションする
システムがキャッシュからqiita情報を作成する
システムがqiita情報を伝達する

取得に失敗(sad path):

システムからerrorを伝達する

キャッシュの有効期限切れ(sad path):

システムからデータがないことを伝達する

キャッシュが空(sad path):

システムからデータがないことを伝達する

キャッシュからqiitaユーザの画像を取得

Data:

Happy Path:

dataを使って「qiitaユーザの画像を取得する」コマンドを実行する
システムがキャッシュからデータを取得する
システムが画像データを伝達する

キャンセルされた場合:

システムはデータもエラーも送らない

取得に失敗(sad path):

システムからerrorを伝達する

キャッシュが空(sad path):

システムからnot found errorを伝達する

qiita情報のキャッシュのバリデーション

Happy Path:

「キャッシュをバリデーションする」コマンドを実行する
システムがキャッシュからデータを取得する
システムがキャッシュが有効期限内かどうかをチェックする

取得に失敗(sad path):

システムがキャッシュを削除する

キャッシュの有効期限切れ(sad path):

システムがキャッシュを削除する

qiitaのユーザ画像のキャッシュのバリデーション

Happy Path:

「キャッシュをバリデーションする」コマンドを実行する
システムがキャッシュからデータを取得する
システムがキャッシュが有効期限内かどうかをチェックする

取得に失敗(sad path):

システムがキャッシュを削除する

キャッシュの有効期限切れ(sad path):

システムがキャッシュを削除する

qiita情報をキャッシュする

Data

qiita情報

Happy Path:

「キャッシュを保存する」コマンドを実行する
システムが古いキャッシュを削除する
システムがキャッシュをエンコードする
システムが新しいキャッシュにタイムスタンプを押す
システムが新しいキャッシュを保存する
システムが成功メッセージを伝達する

削除に失敗(sad path):

システムからerrorを伝達する

保存に失敗(sad path):

システムからerrorを伝達する

qiitaのユーザ画像をキャッシュする

Data

URL
画像データ

Happy Path:

「画像データを保存する」コマンドを実行する
システムが新しいキャッシュを保存する
システムが成功メッセージを伝達する

保存に失敗(sad path):

システムからerrorを伝達する

リモートから取得済みのデータの次に最新のqiita情報を取得

Data:

URL
画面に表示されている一番古いデータの更新日時

Happy Path:

dataを使って「次のqiita情報を取得する」コマンドを実行する
システムがURLからデータをダウンロードする
システムがダウンロードデータをバリデーションする
システムが妥当なデータからqiita情報を作成する
システムがqiita情報を伝達する

Invalid data(sad path):

システムからinvalid data errorを伝達する

No connectivity(sad path):

システムからconnectivity errorを伝達する

キャッシュから取得済みのデータの次に最新のqiita情報を取得

Data:

画面に表示されている一番古いデータの更新日時

Happy Path:

dataを使って「次のqiita情報を取得する」コマンドを実行する
システムがキャッシュからデータを取得する
システムがキャッシュからqiita情報を作成する
システムがqiita情報を伝達する

取得に失敗(sad path):

システムからerrorを伝達する

キャッシュが空(sad path):

システムからデータがないことを伝達する

TDDQiita

Commits

Merge pull request #9 from stzn/dependabot/bundler/rexml-3.3.9

Bump rexml from 3.3.6 to 3.3.9

Merge pull request #8 from stzn/dependabot/bundler/rexml-3.3.6

Bump rexml from 3.3.3 to 3.3.6

Merge pull request #7 from stzn/dependabot/bundler/rexml-3.3.3

Bump rexml from 3.2.8 to 3.3.3

README

BDD Specs

ストーリー

物語1

シナリオ

物語2

シナリオ

ユースケース

リモートからqiita情報を取得

Data:

Happy Path:

Invalid data(sad path):

No connectivity(sad path):

リモートからqiitaユーザの画像を取得

Data:

Happy Path:

Invalid data(sad path):

No connectivity(sad path):

キャッシュからqiita情報を取得

Data:

Happy Path:

取得に失敗(sad path):

キャッシュの有効期限切れ(sad path):

キャッシュが空(sad path):

キャッシュからqiitaユーザの画像を取得

Data:

Happy Path:

キャンセルされた場合:

取得に失敗(sad path):

キャッシュが空(sad path):

qiita情報のキャッシュのバリデーション

Happy Path:

取得に失敗(sad path):

キャッシュの有効期限切れ(sad path):

qiitaのユーザ画像のキャッシュのバリデーション

Happy Path:

取得に失敗(sad path):

キャッシュの有効期限切れ(sad path):

qiita情報をキャッシュする

Data

Happy Path:

削除に失敗(sad path):

保存に失敗(sad path):

qiitaのユーザ画像をキャッシュする

Data

Happy Path:

保存に失敗(sad path):

リモートから取得済みのデータの次に最新のqiita情報を取得

Data:

Happy Path:

Invalid data(sad path):

No connectivity(sad path):

キャッシュから取得済みのデータの次に最新のqiita情報を取得

Data:

Happy Path:

取得に失敗(sad path):

キャッシュが空(sad path):