title: “仕様要件定義書：KNN禁酒アプリ” version: “1.0.0” author: “企画担当” date: “2023-10-27” # 作成日に合わせて変更してください status: “仕様定義” target_platform: “Web Application (Smartphone Responsive)” goal: “禁酒の継続を時間・節約金額・肝臓への貢献度（比喩的指標）で可視化し、ユーザーのモチベーション維持を支援する” tags:

• 禁酒
• 健康管理
• 節約
• モチベーション
• カウントアップ
• スマートフォンアプリ

1. 概要

1.1. アプリケーション名称

KNN禁酒アプリ

1.2. 目的

ユーザーが禁酒を開始した日時と1日あたりの飲酒金額を設定することで、禁酒継続時間、節約できた金額、そして禁酒による肝臓への貢献度（比喩的な健康指標）をリアルタイムに可視化する。これにより、禁酒継続のモチベーションを高め、健康的な生活習慣への移行を支援する。

1.3. ターゲットユーザー

• 禁酒・節酒を目指している個人
• 自身の飲酒習慣による経済的・健康的影響を把握したい個人
• 禁酒の成果を具体的に見てモチベーションを維持したい個人

1.4. 利用シーン

• 禁酒開始時に初期設定を行う。
• 日々の禁酒成果（時間、金額、健康指標）を確認し、モチベーションを維持する。
• 友人や家族に禁酒の成果を共有する際の参考にする。

2. 機能要件

2.1. 初期設定・データ入力機能

2.1.1. 禁酒開始日時の設定

• ユーザーは禁酒を開始した年月日（および任意で時刻）を入力・設定できる。
• カレンダー形式や数値入力形式など、スマートフォンで入力しやすいインターフェースを提供する。
• 「今すぐ禁酒開始」ボタン: このボタンをタップすると、現在の日時が禁酒開始日時として自動的に設定される。

2.1.2. 1日あたりの飲酒金額の設定

• ユーザーは、飲酒していた頃の1日あたりの平均的な飲酒金額（円）を入力できる。
• 入力フィールドは数値入力を基本とする。
• 入力補助:
  • 半角・全角数字の入力を受け付ける（内部で半角数値に変換して処理）。
  • 入力中に自動で3桁ごとにカンマを挿入し、視認性を高める。例: 1000 -> 1,000
• 入力された金額はアプリ内に保存される。

2.2. 禁酒期間表示機能

2.2.1. リアルタイムカウントアップ表示

• 設定された禁酒開始日時から現在時刻までの経過時間をリアルタイムで表示する。
• 表示形式は「X年 Yヶ月 Z日 H時間 M分 S秒」のように、詳細に表示する。
• 秒単位でカウントアップし、ストップウォッチのように時間が経過していく様子を視覚的に示す。

2.2.2. 期間単位での表示切り替え（任意だが推奨）

• ユーザーは表示される期間の主たる単位を切り替えられる（例：「合計日数」「合計時間」など）。
  • 合計時間: 経過時間を総時間数で表示。
  • 合計日数: 経過時間を総日数（小数点以下も表示可能）で表示。
  • 合計月数: 経過時間を総月数（小数点以下も表示可能）で表示。
  • 合計年数: 経過時間を総年数（小数点以下も表示可能）で表示。
• デフォルトは詳細表示（X年Yヶ月…）とする。

2.3. 節約金額表示機能

2.3.1. 節約総額の計算

• 以下の計算式に基づき、節約できた総額を算出する。
  • 節約総額 = 1日あたりの飲酒金額 × 禁酒継続日数
  • 禁酒継続日数は、経過時間から日単位で算出する（例: 24時間経過で1日とする）。小数点以下の日数も計算に含める。

2.3.2. 節約総額の表示

• 算出された節約総額を円単位で表示する。
• 表示する金額には3桁ごとにカンマを付与する。例: 15000 -> ¥15,000
• 表示はリアルタイム（または定期的に）更新され、禁酒期間が延びるにつれて金額が増加する様子がわかるようにする。

2.4. 肝臓年齢（仮）/ 健康貢献度 表示機能

※注意: ここで示す指標は医学的根拠に基づく正確な「肝臓年齢」ではなく、禁酒による肝臓への負担軽減を比喩的に表現し、モチベーション向上を目的とした架空の指標である。アプリ内でもその旨を明記することが望ましい。

2.4.1. 健康貢献度の概念定義

• 全く飲酒しない人が100歳まで健康な肝機能を維持すると仮定する（基準値）。
• 飲酒は肝臓に負荷をかける行為であり、禁酒はその負荷を軽減する（肝臓を休ませる）行為とみなす。
• 禁酒期間が長くなるほど、本来かかるはずだった負荷から解放された時間が増え、肝臓の「健康寿命」が維持・回復に近づく、という考え方に基づく指標。

2.4.2. “肝臓が休めた割合”（仮称）の計算と表示

• 計算ロジック案:
  1. 基準生涯日数: 100年 × 365日 = 36,500日
  2. 禁酒により肝臓が休めた日数: 禁酒継続日数 × (1日あたりのアルコール分解負荷係数 – 飲酒しない場合の負荷係数)
     • この「係数」の設定は非常に難しく根拠を示せないため、よりシンプルな表現を採用する。
  3. 代替ロジック（シンプル案）: 「禁酒によって、”飲酒しない健康な状態” にどれだけ近づいたか」を示す割合を表示する。
     • 例：「あなたの肝臓は、禁酒によって [禁酒継続日数] 日間、余計な負荷から解放されました！」のようなメッセージと共に、禁酒日数自体を強調する。
     • または、「理想的な肝臓健康度（100%）に対し、禁酒によって [回復ポイント] ポイント回復しました！」のようなゲーム的なスコア表示。
       • 回復ポイント = 禁酒継続日数 × 定数 （定数は任意の値、例: 1日あたり1ポイント）

2.4.3. 表示形式

• 算出された指標（例: “肝臓が休めた日数” や “回復ポイント”）を分かりやすく表示する。
• 「肝臓年齢XX歳」のような誤解を招く表現は避け、「肝臓への貢献度」「健康回復ポイント」などの表現を用いる。
• 禁酒期間が長くなるほど、数値が向上していくことを明確に示す。
• 例: 「禁酒 [XXX] 日目！肝臓への貢献度 [YYY] ポイント！」

2.5. データ永続化

• ユーザーが入力した禁酒開始日時、1日あたりの飲酒金額は、ユーザーのデバイス（ブラウザのLocal Storageなど）に保存され、アプリを閉じても次回起動時に保持される。
• これにより、継続的な利用が可能となる。

2.6. データ編集機能

• ユーザーは設定済みの禁酒開始日時や1日あたりの飲酒金額を後から修正できる。
• 修正した場合、表示される禁酒期間や節約金額は即座に再計算され、反映される。

3. 画面イメージ（概念）

3.1. メイン画面構成

• ヘッダー: アプリタイトル (KNN禁酒アプリ)
• 禁酒期間表示エリア:
  • 大きく目立つフォントで「X年 Yヶ月 Z日 H時間 M分 S秒」形式のカウントアップタイマーを表示。
  • （任意）タップやボタンで「合計日数」「合計時間」などの表示に切り替え可能。
• 節約金額表示エリア:
  • 「節約できた金額」ラベルと共に、計算された金額（¥X,XXX,XXX）を表示。
• 健康貢献度表示エリア:
  • 「肝臓への貢献度」などのラベルと共に、計算されたポイントや日数、ポジティブなメッセージを表示。
  • ※医学的根拠のない指標である旨の注釈を小さく添える。
• 設定エリア（または設定画面への導線）:
  • 「禁酒開始日時」の表示と編集ボタン。
  • 「1日の飲酒金額」の表示と編集ボタン。
  • 「今すぐ禁酒開始」ボタン（未設定時、またはリセット後に表示）。
• フッター（任意）: データのリセットボタン、情報・ヘルプへのリンクなど。

3.2. 入力・編集画面（モーダル表示 or 別画面）

• 禁酒開始日時を設定するためのカレンダーや数値入力フィールド。
• 1日の飲酒金額を入力するための数値入力フィールド（カンマ自動挿入）。
• 「保存」「キャンセル」ボタン。

4. 非機能要件

4.1. 対応プラットフォーム

• 主要なスマートフォンのWebブラウザ（Safari, Chromeなど）で正しく表示・動作すること（レスポンシブデザイン）。

4.2. パフォーマンス

• 禁酒期間のカウントアップはスムーズに行われ、アプリの動作が重くならないこと。
• 入力データの反映は即時に行われること。

4.3. ユーザビリティ

• 直感的な操作: 電卓のようにシンプルで、少ないタップ数で主要な操作（設定、確認）が完結すること。
• 視認性: 各表示項目（時間、金額、健康指標）が明確に区別でき、読みやすいフォントサイズ・デザインであること。
• 入力容易性: スマートフォンでの数値入力、日付選択がストレスなく行えること。
• フィードバック: ボタンのタップ時やデータ保存時に、適切な視覚的フィードバックがあること（例: 保存完了メッセージ）。

4.4. データ管理

• ユーザーデータはユーザーのデバイス（ブラウザ）内に限定して保存し、サーバー側でのデータ収集・管理は行わない（プライバシーへの配慮）。Local Storageの使用を想定。
• ブラウザのキャッシュクリア等でデータが消失する可能性があることを、ヘルプ等で明記する。

4.5. 入力バリデーション

• 日付入力では、未来の日付が選択できないようにするなどの基本的なチェックを行う。
• 金額入力では、数値以外の文字が入力された場合にエラーとするか、無視する。負の値は入力できないようにする。

5. 技術的考察・補足事項

• 肝臓年齢（仮）指標の扱い: この指標はあくまでモチベーション維持のためのゲーム的な要素であり、医学的な診断やアドバイスに代わるものではないことを明確にユーザーに伝える必要がある。誤解を避ける表現（例：「貢献度」「回復ポイント」）を慎重に選択する。
• リアルタイム更新: JavaScriptの setInterval 関数などを用いて、秒単位での表示更新と再計算を行う。
• 数値フォーマット: 金額表示のカンマ区切りや、入力時の半角/全角対応、自動カンマ挿入はJavaScriptで実装する。
• 開発ツール: HTML, CSS, JavaScript を基本とし、必要に応じてフレームワーク（React, Vue, Angularなど）やライブラリ（日付処理ライブラリなど）の利用を検討する。

Use code with caution. Markdown 【解説】 YAML Front Matter: ファイルの最初に — で囲まれた部分で、文書のメタデータを記述しています。タイトル、バージョン、目的、対象プラットフォームなどを定義しました。 構造化: Markdownの見出し（#, ##, ###）を使って、概要、機能要件、非機能要件などを階層的に整理しました。 詳細化: 各機能について、具体的な動作（リアルタイム更新、カウントアップ、表示形式、計算ロジック）を記述しました。 入力に関する要件（半角/全角対応、カンマ区切り）も明記しました。 「肝臓年齢」については、誤解を招かないよう注意喚起しつつ、モチベーション指標としての具体的なロジック案（シンプル案を推奨）と表示方法を示しました。 スマートフォンでの使いやすさ（電卓ライク、入力容易性）を非機能要件として強調しました。 データ保存方法（Local Storage）についても言及しました。 緻密化: 各要件について、可能な限り具体的な仕様（例: 表示フォーマット、計算式、ボタンの動作）を落とし込みました。