ドキュメント

スタートアップウィザード

スタートアップウィザードは、アプリを初めて開いたときに実行されます。使用モードの選択、AI機能の有効化、暗号化と同期の設定、次のステップの確認までをガイドし、実際の使用方法に合わせてアプリを最適化します。

モードを選択

セットアップ手順

1. 言語と、アプリの使用方法に最も合ったモードを選択します — Personal Keeper、Inventory Pro、またはThe Full Bleep。
2. AIスーパーパワー画面で、画像認識(写真を撮るとAIがアイテムの詳細を入力)と販売説明文(AIがマーケットプレイス用の魅力的な出品文を作成)を有効にするかを決定します。
3. 自分仕様にで外観を調整し、ロックする?でエンドツーエンドの暗号化を有効にし、データの保存先でマルチデバイス同期を有効にします。
4. 準備完了!の概要を確認します — AI APIキーの追加、Squareの設定、同期の有効化へのクイックリンクがあります — 始めようをタップしてホームダッシュボードに移動します。

注意: 暗号化を有効にすると、ウィザードは暗号化パスワードの作成と復元フレーズの保存のための短い後続フローを実行します — パスワードを忘れた場合にデータを復元する唯一の方法であるため、復元フレーズは安全な場所に保管してください。ウィザードでのすべての選択は、後から設定で変更できます。

ホームダッシュボード

ホーム画面はメインハブです。すべてのアイテム、チェックイン/チェックアウトのステータスが表示され、下部のタブナビゲーションからすべての主要機能にすばやくアクセスできます。

下部タブナビゲーション

アプリは下部タブバーを使用してメインセクション間を移動します：

アイテム管理

アイテムはWhere The Bleepの中核です。各アイテムには、写真、説明、カテゴリ、メタデータ（シリアル番号、購入価格、推定価値、保険情報）、および保管場所を設定できます。

アイテムの作成

1. ホーム画面の+ボタンをタップします
2. タイトルと説明を入力します — またはAIカメラボタンをタップして写真を撮り、AIに自動生成させることもできます
3. ピッカーからカテゴリを選択します
4. ロケーションツリーを参照して場所を割り当てます
5. 必要に応じて、写真、シリアル番号、購入価格、推定価値、保険情報を追加します
6. 数量を管理する場合は在庫ありをオンにします
7. 保存をタップします

アイテムのステータス

アイテム操作

ロケーション

ロケーションは階層構造で管理されます。コンテナロケーション（部屋、建物、クローゼット）は他のコンテナや保管先を含むことができます。保管先ロケーションはアイテムが保管される場所です — 特定の棚、引き出し、箱など。

ロケーション機能

• パンくずリスト — 例：「自宅 > オフィス > デスク」
• サンバーストチャート — ロケーションツリー全体のインタラクティブな可視化
• QRラベル — 2つのAveryテンプレート形式で、任意の保管場所にカスタマイズ可能なQRコードラベルを生成できます
• アイテム数 — 各ロケーションに保管されているアイテム数を表示
• PDFに出力 — 標準のラベル用紙に印刷できるPDFとしてQRコードラベルシートをエクスポートできます
• 選択的な再印刷 — 未印刷のラベルのみを印刷したり、単一のラベルを再印刷したり、すべてのラベルをまとめて印刷できます
• 検索 — 全文検索と音声検索により、名前や保管されている内容で任意の場所にすばやく移動できます

ロケーションの管理

QRコード＆ラベル

すべての保管先ロケーションにQRコードを設定できます。QRラベルをスキャンすると、そのロケーションが即座に開き、アイテムをチェックインできます。ラベルはbelongings://loc/{uuid} URIスキームを使用します。

QRラベルのワークフロー

1. 保管先ロケーションに移動します
2. QRコードアイコンをタップしてラベルを生成します
3. 個別にラベルを印刷するか、一括PDFエクスポートを使用してまとめて印刷します
4. 物理的なロケーション（棚、箱、引き出し）にラベルを貼ります
5. アイテムをチェックインするには、アプリ内カメラでQRコードをスキャンします

QRステータス管理

印刷オプション

• ラベル形式 — Avery 5160（1 × 2-5/8インチ）またはより大きな2 × 4インチのテンプレートを、縦または横レイアウトで選択できます
• ラベルのカスタマイズ — 場所名とIDコードの個別サイズスライダー、およびパンくずパスの表示・非表示を切り替えるトグル
• 上余白オフセット — 印刷の開始位置を調整して、部分的に使用済みのラベルシートが正しく揃うようにします
• バーコード番号を含める — スキャンが利用できない場合の手動入力用に、各QRの下に生のIDを印刷します
• 未印刷の再印刷のみ — 一括実行で印刷済みのラベルをスキップし、シートを無駄にしません
• PDFとして保存 — プリンターに送信する前に、画面上でシート全体をプレビューします

「印刷済み」トグルを使用すると、すべてを一括で再印刷することなく、個別のラベルを再印刷できます。

検索と音声入力

検索はSQLite FTS5を搭載しており、アイテム名、説明、タグにわたる超高速のフルテキスト検索が可能です。音声検索にはデバイス上の音声テキスト変換が使用されます。

検索機能

• フルテキスト検索 — 名前、説明、タグ全体から一致するものを検索します
• 前方一致検索 — 入力を始めると即座に結果が表示されます
• 音声検索 — マイクアイコンをタップして、検索内容を話してください
• 場所でフィルター — 特定の部屋やエリアに結果を絞り込みます
• カテゴリーでフィルター — 特定のカテゴリーのアイテムのみを表示します
• ステータスでフィルター — 保管中、貸出中、販売出品中など
• すべてのフィールドで音声入力 — マイクは商品名と説明、出品メモ、希望価格、チェックイン／チェックアウト名、およびアプリ内のその他のテキスト入力で動作します
• ロケーション内検索 — ロケーションツリーの上の音声またはテキスト検索で、部屋、引き出し、または容器に名前で移動します

人物と貸し出し管理

アイテムを借りられる人のリストを管理します。アプリには2つの操作があります：<strong>持ち出し</strong>はアイテムを保管場所から取り出し、<strong>貸し出し</strong>はアイテムを特定の人に割り当てます。持ち出し中のアイテムと貸し出し中のアイテムは別々に表示されるため、すべての所在を常に把握できます。

持ち出し・貸し出しワークフロー

1. アイテムの詳細画面から、持ち出しをタップして保管場所から取り出すか、貸し出しをタップして特定の人に割り当てます
2. 貸し出しの場合、連絡先から人物を選択するか、新しく作成します
3. アイテムのステータスがチェックアウト済みまたは貸し出し中に変わり、相手の名前が表示されます
4. 返却するにはチェックインをタップします — アイテムは保管中に戻ります

ピープルの管理

イベント履歴

すべての持ち込み、持ち出し、貸し出しはタイムスタンプ付きで記録されます。履歴はアイテムの詳細画面から確認できます。

在庫管理

チェックイン/チェックアウトとは独立して、任意のアイテムで在庫数を有効にできます。消耗品、備品、または複数所持しているものの数量を管理できます。

使い方

1. アイテムの作成または編集時に、在庫ありをオンにします
2. 初期数量を設定します
3. アイテム詳細画面で、+ボタンと-ボタンを使って数量を調整します
4. 数字自体をタップして特定の数量を手動で設定します
5. すべての変更はタイムスタンプ付きで在庫履歴に記録されます

在庫レポート

在庫トグルの横にあるレポートアイコンをタップして、PDFインベントリレポートを生成します。レポートにはアイテムのサムネイル、現在の数量、完全な変更履歴テーブルが含まれます。システムの共有シートからPDFを保存または共有できます。

バーコードスキャン

在庫タブの緑のQRアイコンをタップして在庫スキャンを開きます — 在庫を調整するための2つのタブを備えたライブカメラスキャナーです：入荷品用の受け取りと、正確な数量を設定するための手動。出荷在庫はPOSの販売スキャンで処理されます。詳細はSquare POSセクションを参照してください。

在庫不足・在庫切れ

追跡商品に再注文ポイントを設定します。在庫タブには、手元の数量がそのポイント以下になるとオレンジの在庫不足バッジが、数量がゼロになると赤の在庫切れバッジが表示されます。ダッシュボードのサマリータイルとホーム画面のアラートカードの両方にカウントが表示されるため、不足を探し回ることなく確認できます。在庫不足と在庫切れのフィルターチップで、リストを該当商品のみに絞り込むことができます。

棚卸し

⋮メニューから棚卸しを開き、対象の場所を選んで、その場所のすべての追跡商品を巡回し、棚で見える実際のカウントを入力します。画面には予想数量と入力値が並べて表示され、緑または赤の矢印で不一致が示されます。保存すると、変更があった商品のみがアプリに記録され、各調整にオプションの理由とメモを添付できます。

CSVインポート

⋮メニューからCSVからインポートを選択し、2列のファイル — barcode_or_nameとquantity — を選びます。8〜14桁の数値はバーコードとして扱われ、それ以外は商品名にあいまい一致されます。最初の行は自動的にヘッダーとして検出されます。インポートはCSVインポート調整として記録されるため、変更内容をファイルまでさかのぼって追跡できます。

破損・損失追跡

棚卸しのカウントが不足している場合は、不一致に理由 — 破損、カウント誤り、陳腐化、劣化、盗難、またはその他 — をタグ付けします。理由は⋮メニューの2つのレポートに反映されます：不一致（すべての調整の生のリスト）とロスレポート（理由と日付範囲ごとに集計された合計）。どちらも保険申請や期末レビュー用にPDFとしてエクスポート可能です。

在庫ダッシュボード

在庫タブは在庫関連のすべての拠点です：追跡商品、合計単位数、在庫不足のサマリーカード；すべて、在庫不足、在庫切れのフィルターチップ；全文検索と音声検索；フローティングQRスキャンボタン；プリンターのショートカット；棚卸し、移動、CSVインポート、4つの組み込みレポート — 在庫レベル、移動、評価、ロス — を開く⋮メニュー。

Square POS

Where The Bleepには、販売タブに組み込み型のPOS（販売時点情報管理）機能があります — バーコードスキャナーで操作するカートで、カード決済はSquareに引き継がれます。釣り銭計算機能付きで現金支払いを受け付けたり、その他のチャネルで支払われた売上を記録することもできます。各レジセッションは本日の概要（売上、返品、純額）と、再印刷や返金が可能な最近の取引一覧から始まります。

支払い方法

会計ワークフロー

1. 販売タブで、緑色のQRスキャナーボタンをタップしてPOSスキャナーを開きます
2. バーコードをスキャン（または検索リストから選択）して商品をカートに追加します — 数量はデフォルトで1ですが、カートに追加モーダルで編集できます
3. カートシートで支払うをタップして会計を開き、支払い方法を選択して合計金額を確認します
4. カードリーダーと手動カード入力の場合はアプリがSquareに引き継ぎ、現金の場合は受領金額を入力するとアプリが釣り銭を計算します
5. 売上完了後、お客様向けレシート画面が表示されます — お客様は任意でメールアドレスを入力すると、ご希望の言語でレシートが送信されます

オフラインPOS

アプリのインターネット接続が切れた場合でも、POSはSquare以外の決済で動作を続け、サーバーとの通信が必要なものはキューに追加されます。

• 現金および外部での売上は完全にオフラインで動作 — ネットワーク不要
• POSの売上による在庫調整はローカルに記録され、再接続した瞬間に他のデバイスと同期されます
• メールレシートはローカルにキューイングされ、ネットワーク復旧後に自動送信されます。お客様向けのお礼画面はその場で表示されます

注意: カードリーダーと手動カード入力での決済には、決済時にアクティブなインターネット接続が必要です — Squareがカードを承認する必要があるためです。会計中にネットワークが切断された場合は、現金または外部決済に切り替え、別の方法で支払いを受け、売上を記録することで在庫とレポートの正確性を保ってください。

販売員とオペレーター

販売員（オペレーター）を追加することで、POSを複数のスタッフで運用でき、すべての取引が担当者に紐付けられます。オペレーターは名前と任意のPINでサインインし、付与した権限のみが利用でき、暗号化パスワードを使用すればいつでも管理者に戻ることができます。

販売員の追加

1. 設定 > 販売 > 販売員を開き、販売員を追加をタップ（または販売員リストの+ボタンをタップ）します
2. 名前と任意の6桁のPINを入力します — PINがない場合、プロファイルは開放され誰でも使用可能になります。信頼できる単独店舗では問題ありませんが、繁忙期の店舗にはおすすめできません
3. 付与したい権限のトグルを切り替えます — 在庫アクセス、レポートアクセス、および期間限定アクセス用の任意の有効期限を設定
4. 任意でデフォルトの販売元拠点を選択することで、オペレーターのPOS売上が自動的に正しい場所の在庫から減算されます

権限レベル

期間限定アクセス

販売員を追加または編集する際に有効期限を設定を有効にして日付を選択します。その日付を過ぎると、権限は自動的に取り消され、オペレーターのログイン画面には期限切れのメッセージが明確に表示されます — 季節雇用者、契約スタッフ、または一時的なアクセス権を付与したい人に便利です。

イベントタグ付けと監査証跡

すべての売上、返品、在庫調整、棚卸しは、それを実行したオペレーター（管理者としてサインインした取引も含む）にタグ付けされます。タグは取引リスト、在庫イベント履歴、エクスポートされたレポートに表示されるため、誰がいつ何をしたかが常に把握できます。

注意: オペレーターセッションから管理者に戻すには、暗号化パスワード（暗号化が無効の場合はデバイスのロック解除）が必要です。これにより、サインイン中のオペレーターが設定を変更したり、他のオペレーターを削除したり、本来見るべきでないキャッシュドロワーレポートを取得することを防ぎます。

販売とマーケットプレイス出品

7つの対応マーケットプレイスにアイテムを出品できます。AIがアイテムデータから出品詳細を自動生成し、投稿時に参照できるPDF販売シートを作成します。

対応マーケットプレイス

出品ワークフロー

1. 販売タブに移動し、新規出品をタップします
2. 検索可能なアイテムピッカーからアイテムを選択します
3. マーケットプレイスを選択します
4. AIが出品フィールド（タイトル、価格、カテゴリ、コンディション、説明）を自動入力します
5. 各マーケットプレイスには独自の追加フィールドがあります（例：eBay: ブランド、UPC、配送、Poshmark: 部門、サイズ）
6. 確認画面ですべてを確認・編集します
7. PDF販売シートを生成します — アイテムの写真、すべての出品詳細、およびマーケットプレイスの出品作成ページへのQRコードが含まれます
8. ダウンロードに保存するか、AirDrop、メール、またはメッセージで共有します

販売トラッキング

アイテムは出品ステータスに沿って進みます：販売中 → 売却済み – 未配送 → 配送済み。販売ダッシュボードには、アクティブな出品（売却済み・未配送のアイテムを含む）、完全な販売履歴、購入者の詳細・価格・手数料・純収益を含むサマリー統計が表示されます。任意の期間のPDFまたはCSV販売レポートを生成できます。

販売向けSquare連携

POSで対面のカード決済を受け付けるだけでなく、Square連携はメールレシート機能も提供します — 有効なSquareメールレシートのサブスクリプションが接続されている場合、顧客向けレシートをPOSのサンキュー画面から購入者の希望言語で直接送信できます。設定 > 販売 > Square決済で一度Squareを認証すれば、カード決済とメールレシートの両方が同じ接続を共有します。

レシート

POSでの販売はすべて、商品明細、合計金額、支払い方法、（現金の場合は）お釣りを表示する顧客向けのサンキューレシート画面で完了します。お客様は任意でメールアドレスを入力して希望の言語でレシートを受け取ることができ、最近の取引リストから過去の販売を再印刷または返金することができます。

レシートの機能

• 多言語対応 — レシートは販売時にお客様が選択した言語に自動翻訳されます（18言語対応）
• 2つの配信チャネル — お客様がデバイス上で読む顧客向け画面と、お客様のメールアドレスに送信される任意のメールレシート
• オンデマンド再印刷 — 最近の取引のすべての取引から完全なレシート詳細ページを開き、再送信、PDF保存、または返金が可能
• 現金釣り銭管理 — 現金販売の場合、レシートに受領金額とお釣りが記録され、監査証跡が明確になります

レシートのワークフロー

1. POSで販売を完了します — 顧客向けレシート画面が合計金額と言語選択ツールとともに自動的に表示されます
2. デバイスをお客様に渡します。画面には大きな文字と言語選択ツールが表示されるので、お客様は快適に読み、必要に応じて言語を切り替えることができます
3. お客様がメールでのコピーを希望する場合、メールアドレスを入力してレシートを送信をタップします — 選択された言語でメールがキューイングされます
4. 完了をタップすると、次の販売に備えてPOSスキャナーに戻ります

レシートのカスタマイズ

レシートのブランディングは設定 > 販売 > 事業情報から取得され、事業者名、住所、電話番号、メールアドレス、税ID、郵便番号がレシート上部に表示されます。メール送信元は設定 > 販売 > メールオプションで設定し、組み込みのWhere The Bleepメールサービス（サブスクリプション必須）または独自のカスタムSMTPサーバーを選択して、自社ドメインからレシートを送信できます。

注意： メールレシートの送信時にはインターネット接続が必要ですが、オフラインの場合はローカルにキューイングされ、ネットワークが復旧次第送信されます。顧客向けのサンキュー画面は、オンライン・オフラインを問わず常に即座に表示されます。

暗号化とセキュリティ

Where The Bleepはゼロ知識のエンドツーエンド暗号化を使用しています。データはクラウドに送信される前にデバイス上で暗号化されます。私たちはあなたのデータを読み取ることができません — あなただけがアクセスできます。

暗号化の詳細

鍵の階層構造

パスワードからPBKDF2-HMAC-SHA256（600K回反復）を介してマスターキー（256ビット）が導出されます。マスターキーから3つのサブキーが導出されます：

• DEK（データ暗号化キー）— アイテムのフィールド、名前、説明を暗号化します
• FEK（ファイル暗号化キー）— 画像とドキュメントを64KBチャンク単位で暗号化します
• SIK（検索インデックスキー）— サーバーサイドクエリ用のブラインドインデックスを生成します

ロック解除オプション

ブルートフォース攻撃対策

パスワードの入力失敗が続くと、指数関数的なロックアウトが発生します：30秒 → 5分 → 15分 → 1時間。

二要素認証

認証アプリをアカウントに連携することで、パスワードに加えてセキュリティをさらに強化できます。設定 > セキュリティ > 二要素認証から設定でき、TOTP対応のアプリ（Google Authenticator、Authy、1Password、Microsoft Authenticator）が利用可能です。連携後は、新しいデバイスでサインインする際にパスワードとアプリで生成される最新の6桁コードの両方が必要になります。

ネットワークセキュリティ

• Certificate Transparency監視 — すべてのAPIエンドポイントに対するTOFU TLS証明書の追跡
• 証明書変更の検出 — 証明書のフィンガープリントが予期せず変更された場合にアラートを表示
• Androidでの平文トラフィックのブロック — 暗号化されていないHTTP接続を禁止
• 証明書監視画面 — エンドポイントごとに証明書発行者、有効期限、フィンガープリント、変更履歴を表示（設定 > セキュリティ > 証明書監視）

クラウド同期

Where The Bleepはオフラインファーストで設計されており、インターネットなしでも完全に動作します。クラウド同期はオプションで、Proサブスクリプション会員がご利用いただけます。

同期の仕組み

• すべてのデータはSQLiteにローカル保存されます — アプリにインターネット接続は必須ではありません
• webDocsSyncFeature2
• データはデバイスから送信される前に暗号化されます — サーバーには暗号化されたデータのみが保存されます
• 競合検出 — 行レベルの最終書き込み優先方式で、競合はイベント監査ログに記録されます
• 削除の伝播 — デバイスAで削除すると、デバイスBからもそのアイテムが削除されます
• ユーザーごとの分離 — Row-Level Securityにより、自分のデータのみが表示されます
• マーケットプレイスの出品と販売は、暗号化された購入者の個人情報とともに同期に含まれます

バックアップと復元

データベース全体と画像を暗号化バックアップアーカイブとしてエクスポートします。エクスポート時にバックアップパスワードを設定し、任意のデバイスで復元に使用します。

バックアップの内容

• SQLiteデータベース全体
• すべてのアイテム画像
• ユーザー設定のバックアップパスワードによるAES-256-GCM暗号化（PBKDF2派生キー）
• アーカイブの整合性検証用JSONマニフェスト

復元ワークフロー

1. 設定 > バックアップと復元に移動します
2. バックアップをインポートをタップします
3. ファイルピッカーを使用してバックアップファイルを選択します
4. バックアップ作成時に設定したバックアップパスワードを入力してください
5. データと画像が復元されます

データエクスポートとレポート

保険請求、個人記録、データポータビリティのために、インベントリデータを複数の形式でエクスポートできます。

エクスポート形式

AI搭載の説明文生成

写真を撮るだけで、AIがアイテムのタイトル、説明、タグを自動生成します。同じAI機能がマーケットプレイス出品の生成にも使われています。対応する8つのプロバイダーからご自身のAPIキーをご用意ください。

対応AIプロバイダー

セットアップ

1. 設定 > AIプロバイダーに移動します
2. ご希望のプロバイダーを選択します
3. APIキーを入力します
4. 必要に応じてデフォルトのモデルを変更します
5. アイテムの追加・編集時にAIカメラボタンをタップして使用します

注意：APIキーはデバイス上にのみ保存され、当社のサーバーに送信されることはありません。AIリクエストはお使いのデバイスからプロバイダーに直接送信されます。

設定

設定画面は、暗号化、同期、AI設定、データエクスポート、アカウント管理のコントロールセンターです。

設定セクション

サブスクリプション

Where The Bleepは、すべての基本機能を備えた充実の無料プランを提供しています。Proにアップグレードすると、クラウド同期、自動バックアップ、優先サポートが利用できます。

料金プラン

サブスクリプションはApp Store（iOS）またはGoogle Play（Android）から管理できます。デバイスのサブスクリプション設定からいつでもキャンセルできます。

What's Included with Pro

• 本格的なビジネスを運営 — カードリーダーおよび手動カード決済対応のSquare POS、PINとオペレーター別権限を持つ販売員、18言語対応のメールレシート、eBay出品、4つの組み込み在庫レポート（在庫レベル、動向、評価、ロス）
• チームと一緒に — 5、10、または20デバイスのティアを選択し、販売員、キッチンスタッフ、共同オーナーがそれぞれ自分のデバイスと自分のログインで作業できます
• Wi-Fiなしでも動作 — ネットワークが切断されてもすべての画面が使用可能で、現金売上、在庫調整、棚卸しも含まれます。すべての操作はキューに入り、再接続した瞬間に同期されます
• 暗号化されたクラウド同期と自動バックアップ — データはデバイス上でエンドツーエンドで暗号化され、ペアリングされたすべてのデバイス間で数秒以内に複製され、クラウドに継続的にバックアップされるため、すべてのデバイスを紛失しても復元可能