OFFICIAL SPECIFICATION DOCUMENT

冒険者ギルド × 推しの声ナビ
× 地域再発見

地域活性化エンターテインメントアプリ「JAPAN ＱＵＥＳＴ」。
その体験の全てと、裏側にある技術仕様をここに公開する。

ユーザージャーニーを見る 技術仕様書を読む

01. 概要

本ドキュメントは、地域活性化エンターテインメントアプリ「JAPAN ＱＵＥＳＴ」における、ユーザー体験（UX）の流れと、それを実現するための機能要件・技術仕様を定義するものである。

CORE CONCEPT

「冒険者ギルド」 × 「推しの声ナビ」 × 「地域再発見」

02. USER JOURNEY MAP

詳細な体験フロー

01

Phase 1: 冒険の準備 (Onboarding)

1. アプリ導入

  • Action: ユーザーがストアからアプリをDLし、起動。
  • UI/UX: スプラッシュ画面（ギルドの扉が開くアニメーション）、世界観導入ナレーション。

2. ギルド登録 (アカウント作成)

  • Action: ニックネーム登録、利用規約同意。
  • Feature: アバター作成、ナビゲーター契約 (重要)。
  • Free: 標準執事/メイド（AI音声）
  • Premium: 人気声優・芸能人（月額サブスク or 個別課金）。サンプルボイス試聴可能。
02

Phase 2: クエスト受注 (Quest Selection)

3. ギルド本部 (ホーム画面)

  • UI: RPGの酒場風インターフェース。
  • Feature: エリア選択（地球 > 日本 > 県 > 市町村 > 特定の商店街/エリア）、難易度フィルタ。

4. クエスト詳細確認

  • Display: ターゲットエリア概要、クリア報酬。
  • Check: 年齢制限チェック（アダルトグッズ取扱店等が含まれる場合、18歳以上認証を要求）。
  • Action: 「クエストを受注する」ボタン押下。
03

Phase 3: 探索と移動 (Navigation)

5. ナビゲーション開始

  • System: GPS位置情報取得開始。
  • UX (Voice): 「さあ、出発だ！」（推しの声）。画面を見ずに音声でガイド（歩きスマホ防止）。
  • 周辺情報: 観光名所や隠れスポット接近時のトリビアボイス再生。

6. チェックポイント(CP) 到着

  • Condition: 対象店舗の半径15m以内に進入。
  • Notification: バイブレーションと音声通知。
04

Phase 4: ミッション遂行 (Mission Action)

ここが「儲からないお店への送客」の核心部分。

Lv.1: チェックイン（来店証明）

アプリでGPSチェックイン、または店頭QRスキャン。小～中のRP獲得。

Lv.2: コミュニケーション（謎解き/会話）

店員との会話、ARカメラでの撮影・画像認識。中～大のRP獲得。

Lv.3: 購入・消費（経済貢献）

実際に商品を購入しレシート等をスキャン。特大のRP獲得 + 限定アバター装備。

05

Phase 5: 報酬と成長 (Result)

8. クエスト報告

  • UI: リザルト画面。
  • Effect: 獲得RP加算演出、レベルアップ演出。
  • Special: 推しからの褒め言葉ボイス（親密度依存）。
06

Phase 6: 景品交換 (Exchange)

9. 宝物庫 (景品交換所)

UIはECサイト風だが、世界観は「ギルドの宝物庫」。

地域の名産品 限定グッズ デジタルコンテンツ 寄付

10. 交換申し込み & 配送

欲しいアイテムを選択 → ポイント消費 → 配送先入力。
システムから提携業者へ指示 → ユーザーの手元へ「戦利品」として届く。

03. FUNCTIONAL REQUIREMENTS

アプリ機能要件・詳細仕様

A. クライアントアプリ (iOS/Android)

認証基盤

メール/SNS認証 (Firebase Auth)、年齢確認機能 (eKYC連携または簡易認証)

※18禁エリア制限のため必須

マップ・GPS

Google Maps SDK / Mapbox利用、現在地追跡、バックグラウンド取得、ジオフェンシング

※バッテリー消費対策が重要

ボイス再生

オーディオエンジン実装、状況別再生(開始/右左折/接近/到着/クリア)、キャッシュ管理

※通信量削減のためWi-Fi時DL推奨

カメラ・AR

QRコードリーダー (チェックイン用)、画像認識 (特定の看板や商品を認識)

※VuforiaやML Kit活用

その他

クエスト管理(オフライン対策)、ウォレット(RP管理/寄付証明)、アバター(着せ替え/ステータス)

B. 管理画面・バックエンド (For 運営・店舗)

店舗管理

CP店舗情報の登録・編集 (写真、説明、位置)、店舗用管理画面 (Webブラウザ)、来店数・売上貢献度レポート

※店舗自身が情報を更新可能に

クエスト作成

マップ上でのルート作成ツール、ミッション条件設定 (写真、キーワード、購入)、報酬ポイント設定

※地域コーディネーターが使用

ユーザー管理

ユーザー情報照会、不正ユーザーのBAN対応、ログ解析

在庫・配送

景品在庫管理、配送ステータス連携、寄付金集計

※ECシステムとのAPI連携

分析基盤

ヒートマップ (ユーザーの動線分析)、経済効果試算レポート出力

※自治体・スポンサー向けレポート用

04. DATABASE SCHEMA

主要エンティティ概要

Users
  • • ユーザーID (PK)
  • • 基本情報
  • • 累計RP / 現在のRP
  • • アバター設定
  • • ナビゲーター設定
Shops
  • • 店舗ID (PK)
  • • 店舗名 / カテゴリ
  • • 位置情報(Lat/Lon)
  • • 紹介文 / リンク
Quests
  • • クエストID (PK)
  • • エリアID / 難易度
  • • ルート情報(CPリスト)
  • • クリア条件 / 報酬設定
CheckIns
  • • ログID (PK)
  • • ユーザーID / 店舗ID
  • • 日時
  • • アクションタイプ(GPS/QR/Photo)
  • • 承認ステータス
Transactions
  • • 取引ID (PK)
  • • ユーザーID
  • • 変動RP / 日時
  • • 理由(クエスト/景品)
Items
  • • 商品ID (PK)
  • • 名称
  • • 必要RP
  • • 在庫数 / カテゴリ

05. DEV CHRONICLES

想定される技術的課題と対策

01

位置情報の精度と「ズル」防止

課題: GPS偽装アプリ等による現地に行かないチェックイン。
対策: GPSに加え、現地設置のQRコードスキャンや、特定のオブジェクトの写真撮影（画像認識）を必須とするハイブリッド判定を導入。

02

バッテリー消費

課題: 常時GPSと音声再生による電池消耗。
対策: 画面オフ状態での音声ガイドをメインとし、画面描画頻度を下げる「省電力モード」をデフォルトにする。

03

通信環境

課題: 地方や建物の奥まった店舗（電波が弱い場所）でのチェックイン不可。
対策: チェックイン情報を一時的にローカル保存し、電波復帰時に送信・同期する機能の実装。

04

店舗オペレーションの負荷

課題: 忙しい店員がゲーム対応に追われる。
対策: 基本は「QRコードを置くだけ」で完結するフローにする。店員との会話ミッションは、店舗側が「許可」した場合のみ設定可能なオプションとする。

冒険の準備はできたか？

JAPAN ＱＵＥＳＴは、地域とエンタメをつなぐ新しいプラットフォーム。
開発パートナー、協賛企業、そして最初の冒険者を募集しています。