RESTfulWebサービス設計課題 和暦検索 #02 要求

とりあえず、和暦検索サービスの要求をざっくりと考えてみました。

1. 機能要求

　1-1. 西暦から和暦を知りたい(例：西暦2012年 -> 平成24年)

　　1-1-1. 西暦に対応する和暦が存在しない場合は、その旨を教えて欲しい

　　1-1-2. 西暦に対応する和暦が複数存在する場合

　　　1-1-2-1. 改元の場合は、改元月日と併せて全和暦を表示して欲しい

　　　1-1-2-2. 南北朝期の場合は、南朝/北朝両方の和暦を表示して欲しい

　1-2. 和暦から西暦を知りたい(例：平成24年 -> 西暦2012年)

　1-3. 元号から和暦情報を知りたい

　　1-3-1. 和暦情報としては少なくとも以下の項目が欲しい

　　　　　　　　　　元号名、元号名の読み、元号の年数、始期(年月日)、終期(年月日)、天皇名、天皇名の読み

　　1-3-2. 元号名の部分一致で和暦情報を検索したい

　　1-3-3. 元号名の読みの部分一致で和暦情報を検索したい

　1-4. 天皇から和暦情報を知りたい

　　1-4-1. 天皇名で和暦情報を部分一致検索したい

　　1-4-2. 天皇名の読みで和暦情報を部分一致検索したい

　1-5. 他アプリへのサービス提供を可能とするためJSON形式のデータが欲しい

　1-6. もちろん人間の読みやすい形でのデータも欲しい

2.非機能要求

　2-1. 他の元号使用国(中国、ベトナム、朝鮮半島)用機能の追加が容易な設計にして欲しい

　2-2. 機密情報は扱わず、ユーザー管理も行わないのでセキュリティに配慮する必要はない

不足はあるでしょうが、まずはこんなところかと。

1-4の天皇による検索は、最初の開発からは落としてもよさそうです。

2-1の他の元号使用国用サービスについては、下の図のように各国元号を西暦で串刺しできると良さそうな感じです。いろいろと面倒なうえ、この記事のタイトルも和暦検索としてしまっているので多分作りませんが、URIの設計等では配慮しておきたいところです。