136 lines
5.9 KiB
Markdown
136 lines
5.9 KiB
Markdown
# Positionai Platform & Incense App (v1.0) 技術仕様書
|
||
|
||
本ドキュメントは、日本酒アプリ (`Sake App`) の成功を基に、共通基盤 (`Posimai Core`) を構築し、第二弾としてお香アプリ (`Incense App`) を開発するための技術仕様書です。
|
||
|
||
## 1. ディレクトリ構成戦略: "Posimai Core"
|
||
|
||
モノレポ構成を採用し、共通コードと各アプリ固有のコードを明確に分離します。
|
||
|
||
```text
|
||
lib/
|
||
├── core/ # [共通] 全アプリで共有する基盤コード
|
||
│ ├── services/
|
||
│ │ ├── gemini_service.dart # AI解析 (プロンプトを引数化)
|
||
│ │ ├── camera_service.dart # カメラ・ギャラリー操作
|
||
│ │ ├── database_helper.dart # Hive Box管理の抽象基盤
|
||
│ │ └── gamification_core.dart # バッジ・レベル計算の抽象クラス
|
||
│ ├── models/
|
||
│ │ └── base_item.dart # ID, ImagePath, CreatedAtなどを定義
|
||
│ └── widgets/
|
||
│ └── attribute_radar_chart.dart # 汎用レーダーチャート (ラベル可変)
|
||
│
|
||
├── features/ # [共通] 特定機能のウィジェット群
|
||
│ ├── settings/ # アプリ設定、バックアップ画面
|
||
│ └── onboarding/ # 初回起動画面
|
||
│
|
||
└── apps/ # [固有] 各アプリの実装
|
||
├── sake/ # 日本酒アプリ
|
||
│ ├── main_sake.dart # エントリーポイント
|
||
│ ├── models/ # SakeItem, TasteStats
|
||
│ └── screens/ # Home, Detail (Sake ver)
|
||
│
|
||
└── incense/ # お香アプリ (New!)
|
||
├── main_incense.dart
|
||
├── models/ # IncenseItem, ScentStats
|
||
└── screens/ # Home (Zen Mode対応), Detail
|
||
```
|
||
|
||
---
|
||
|
||
## 2. データモデル定義 (Incense App)
|
||
|
||
日本酒アプリの `SakeItem` に相当する、お香アプリ専用のモデル定義です。
|
||
|
||
### 2.1 `IncenseItem`
|
||
`core/models/base_item.dart` を継承します。
|
||
|
||
```dart
|
||
@HiveType(typeId: 20) // TypeIDは日本酒(0-10)と被らないように付与
|
||
class IncenseItem extends HiveObject {
|
||
@HiveField(0)
|
||
final String id; // UUID
|
||
|
||
@HiveField(1)
|
||
final IncenseDisplayData displayData;
|
||
|
||
@HiveField(2)
|
||
final IncenseSpecs specs; // 香りの詳細データ
|
||
|
||
@HiveField(3)
|
||
final IncenseMetadata metadata;
|
||
}
|
||
```
|
||
|
||
### 2.2 `ScentStats` (香りのパラメータ)
|
||
五味（甘辛酸苦鹹）は難解なため、現代的な5軸を採用します。
|
||
|
||
```dart
|
||
@HiveType(typeId: 22)
|
||
class ScentStats {
|
||
@HiveField(0) final int sweet; // 甘さ (Fruity/Sweet)
|
||
@HiveField(1) final int spicy; // スパイシー (Clove/Cinnamon)
|
||
@HiveField(2) final int fresh; // 爽やかさ (Pine/Mint)
|
||
@HiveField(3) final int calm; // 落ち着き (Woody/Earthy)
|
||
@HiveField(4) final int traditional; // 伝統感 (Sandalwood/Aloeswood)
|
||
|
||
// 0-5 で評価
|
||
const ScentStats({this.sweet = 3, ...});
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. AI解析プロンプト (Incense Prompt)
|
||
|
||
`GeminiService` に渡すお香専用プロンプトです。
|
||
|
||
```text
|
||
あなたは「香司（こうし）」と呼ばれるお香の専門家です。
|
||
添付の「お香のパッケージ画像」とOCRテキストを分析し、以下の情報をJSON形式で抽出してください。
|
||
|
||
【出力要件】
|
||
1. name: 商品名（例: "春の夜", "堀川"）
|
||
2. brand: メーカー・ブランド名（例: "松栄堂", "日本香堂"）
|
||
3. scentType: 香りの系統を一言で（例: "白檀ベース", "フローラル系"）
|
||
4. description: 香りのイメージや焚くのに適した情景を100文字以内で魅力的に説明してください。
|
||
5. stats: 5段階評価 (1-5)
|
||
- sweet (甘さ)
|
||
- spicy (スパイシーさ)
|
||
- fresh (爽やか・清涼感)
|
||
- calm (ウッディ・落ち着き)
|
||
- traditional (古典的・和風)
|
||
|
||
【注意点】
|
||
OCRテキストに誤りがある場合は、画像情報を正として補正してください。
|
||
情報がパッケージに記載されていない場合は、パッケージの色やデザイン、商品名から香りの傾向を推測してください。
|
||
```
|
||
|
||
---
|
||
|
||
## 4. ゲーミフィケーション実装 ("Quiet Achiever")
|
||
|
||
お香アプリの特性に合わせ、2つのモードを実装します。
|
||
|
||
### モード定義 (`UserPreference`)
|
||
* `GameMode.collector`: 従来通り。数値・バッジ・レベルを表示。
|
||
* `GameMode.zen`: **静寂モード**。
|
||
|
||
### Zen Mode の挙動仕様
|
||
| 項目 | Collector Mode | Zen Mode |
|
||
| :--- | :--- | :--- |
|
||
| **ホーム画面** | 現在のレベル、次のレベルまでのEXPバーを表示 | 香炉と煙のアニメーションのみ表示（バーは非表示） |
|
||
| **登録完了時** | "EXP +10! Level Up!" の派手なスナックバー | "香りの記憶を留めました。" と質素な通知のみ |
|
||
| **レベルアップ** | ファンファーレ音 + ダイアログ | アニメーションの煙が少し高くなる / 花が一輪増える (環境変化) |
|
||
| **バッジ** | バッジ一覧画面でコレクションを確認 | (機能自体を非表示、または「足跡」としてテキストのみ表示) |
|
||
|
||
---
|
||
|
||
## 5. 開発ロードマップ (最短経路)
|
||
|
||
1. **Core Refactoring**: `lib/core` フォルダを作成し、`GeminiService` を移動・汎用化（プロンプトを引数化）。
|
||
2. **Flavor Setup**: `main_sake.dart` と `main_incense.dart` を作成し、起動設定を分離。
|
||
3. **Model Impl**: `IncenseItem` と `ScentStats` を実装。
|
||
4. **UI Clone & Adapt**: 日本酒アプリのHome画面をコピーし、お香用に「パラメータ名」と「Zen Modeスイッチ」を変更。
|
||
|
||
このプランにより、既存の安定したコードベースを破壊することなく、最短で `Incense App (v1.0)` をリリース可能です。
|