ドキュメント
OKRとKPIの目標管理、KRとKPIの明確な使い分け、スタッフ別の目標配分、Kanbanボードとの双方向連携、API不要のメール自動取り込み、独自ドメインDNS設定、カウンター通知の運用ガイドです。
目標ガバナンス
ホテル、飲食店、サロン、旅行業、小売の現場では、方向性を示すObjective（O）、飛躍を測るKey Result（KR）、毎月の健全性を保つ業務指標（KPI）、日々のタスクを混同すると目標管理が形骸化します。DING OSはこれら4層を明確に分離し、リアルタイムの売上、予約、スタッフ実績、Kanbanボードと直結します。
1. 目標階層マトリクス
エンタープライズ基準| 階層 | 推奨件数 | 核心となる問い | 計測の性質 | 現場での実例 |
|---|---|---|---|---|
| OKR · Objective 戦略目標 | 四半期に 3 - 5 件 施設全体または部門単位 | 今四半期、どこで大きな飛躍を遂げたいか？ | 四半期または通期の定性的な指針です。進捗率（0-100%）は配下のKRから自動集計されます。 | 第4四半期に地域ナンバーワンの法人宴会およびウェルネス施設になる。 |
| KR · Key Result 主要成果 | 1 Objective あたり 3 - 5 件 最大 5 件まで | どの数値をもって Objective 達成と判定するか？ | Objectiveに紐づく定量マイルストーン（基準値Xから目標値Yへの到達）で、新たな変化や成長を測ります。 | 法人宴会B2B売上を $15,000 から $40,000 へ拡大し、会員リピート率を 18% から 35% に引き上げる。 |
| KPI · Metric 業務KPI | 月次 3 - 5 件 チームまたはスタッフ単位 | 毎月の日常業務は基準どおり健全に回っているか？ | 売上目標、稼働率、サービス品質を毎月継続して維持するための独立した定量指標です。 | 月間売上目標 $50,000、客室稼働率 75% 以上、注文キャンセル率 2% 未満を維持。 |
| Task · Kanban 実行タスク | 上限なし 3 - 5 個の目標に紐付け | 数値を動かすために今日誰が何を実行するか？ | 担当者、期限、ステータス（未着手 ➔ 進行中 ➔ レビュー ➔ 完了）を持つKanbanボード上の実行カードです。 | 法人パートナー30社へ忘年会プランを送付し、VIP会員50名へ誕生日特典を案内する。 |
なぜKRとKPIは混同されやすいのか
KRもKPIも数値（$40,000、予約300件、85%）で表されます。3秒で見分けるには自動車を想像してください。KPIは毎月正常値を保つべき計器盤（エンジン水温、燃料残量、巡航速度）です。一方、OKRは新しい目的地へのGPSルートであり、KRはその道筋を示す距離標識です。
業務KPIがKRに変わるタイミング
指標が安定しており毎月の基準値（例: バー月商 $20,000）を維持するだけなら独立したKPIとして登録します。しかしKPIが急落した時や、翌四半期に倍増キャンペーンを打つ時（アコースティックライブ開催でバー売上を $20,000 から $45,000 に伸ばす場合）は、戦略Objective配下のKRへ昇格させます。
形骸化を防ぐ 3-5 集中ルール
一度に10-15個の目標を作ったり、日常作業をKRに詰め込んで達成率を水増ししたりするのが最大の失敗要因です。四半期ごとに3-5個のObjectiveと各3-5個の成果型KRに絞り、各スタッフは会計済み注文（booking.owner）に連動する3-5個の月次KPIに集中させ、日々の作業はKanbanボードで管理します。
2. 目標運用の4ステップ
タスク ➔ 目標 で 目標を作成 を押します。OKR · 戦略目標 を選ぶと2-4件のKRをまとめて定義できるビルダーが開き、KPI · 業務指標 を選ぶと初期値、目標値、単位の入力欄が表示されます。
各KRまたはKPIを5つのデータソースに接続します: 売上（精算済み伝票の自動集計）、予約件数（完了した注文）、スタッフ実績（booking.owner 連動）、完了タスク（完了列のKanbanカード数）、または 手動チェックイン。
ツールバーの Quota Planner を開き、店舗全体の目標（例: 月商 $60,000）を入力して対象スタッフを選び、均等配分または比率配分を実行します。個別のKPIが自動生成され、リアルタイムで進捗が追跡されます。
期間の経過時間と実際の進捗率を自動比較し、遅延やリスク状態の目標を検知します。対象目標の チェックイン ドロワーを開き + ボードにタスク追加 を押すと、目標バッジ付きの実行カードが即座にKanbanボードへ追加されます。
システムアーキテクチャ
DING OSはマルチテナント対応のコマース、予約、カウンター配信OSです。単独での店舗運営はもちろん、既存の会計ソフトやホテル管理システムの前段としても稼働し、受信メール、店頭QR注文、オープンタブ精算を単一のリアルタイムキューに統合します。
| サブシステム | エンドポイント | 動作仕様 |
|---|---|---|
| 受信MIMEパーサー | POST /v1/email/ingest/ | [slug]@getding.io 宛てのSMTP通信をCloudflareエッジで終端し、顧客情報、明細、日時、予約番号、金額を構造化抽出して30日間のSHA-256重複排除を実行します。 |
| エッジホスト名プロキシ | proxy.getding.io | 独自サブドメイン（ding.yourbrand.com）と標準ハンドル（[slug].getding.io）を分離されたテナント領域へマッピングし、DV TLS 1.3証明書を自動発行・更新します。 |
| カウンター配信バス | wss://api.getding.io/v1/ws | チケットの状態遷移（pending, confirmed, ready, completed）を全カウンター端末へ即時配信し、視覚バナーと880Hzチャイムの二重通知を行います。 |
| マルチモード伝票エンジン | POST /v1/counter/ | 即時決済、時間枠予約、オープンタブの実数棚卸し精算（reconcile_order）を実行し、担当者ID（booking.owner）を必ず記録します。 |
既存業務ソフトとの併用構成
勘定科目や税務台帳を変更することなく、単独運用または既存のバックオフィス会計システムとの並列運用が可能です。
メールからの注文・予約自動抽出、14言語対応QRストア、AIチャット見積受付（capture_inquiry）、オープンタブ実数確認、リアルタイムのカウンター配信を担当します。
適格請求書の発行、総勘定元帳への記帳、日次レジ締め、客室カードキー発行、CSV出力やWebhook連携による在庫引き落としを担当します。
メール自動取り込み
API開発なしで注文通知、OTA予約確認書、法人見積依頼メールをワークスペース専用アドレスへ転送できます。IMAPポーリングやメールパスワードの保存を一切行わず、受信MIMEから直接カウンターキューへ登録します。
メールサーバーの転送設定では必ず 「受信トレイにコピーを残す」 を有効にしてください。社内メールボックス（[email protected], [email protected], [email protected]）にすべての原本を保管したまま、DING OSが並行してコピーを処理します。
- Gmail設定 ➔ すべての設定を表示 ➔
メール転送とPOP/IMAPタブを開きます。 - 転送先アドレスを追加 を選択し、
[slug]@getding.ioを入力します。 - 確認メールがワークスペースに届きます。DING OSの 受信箱 を開いて確認リンクを取得し、転送を承認します。
- フィルタとブロック中のアドレス ➔ 新しいフィルタを作成 を開き、含む語句に
subject:(Order OR Quote OR Booking OR Reservation OR Confirmation)を指定します。 - 次のアドレスに転送する で
[slug]@getding.ioを選び、原本を残すため 受信トレイをスキップ のチェックを外したままフィルタを保存します。
api.getding.io からの送信メールには X-Ding-Generated: true と Auto-Submitted: auto-generated が付与され、SMTPエッジで自動的に破棄されます。
受信チケットは30日間 sha256(organization_id + ":" + reference) で管理され、再転送時は重複作成せず既存レコードを更新します。
SMTPの Return-Path または From が *@getding.io や @trip.express に一致するメールはAI解析前に除外されます。
外部チャネル連携
Zalo公式アカウント（ZBSおよびZNS）、Telegramボット、WhatsApp Cloud API、Messenger、オープンバンキング（VietQR, SePay）、Stripe、PayPal、OTAチャネルの設定手順です。
ステージ 1: Zaloアプリの有効化
developers.zalo.me- developers.zalo.me を開いて対象アプリを選択し、右上のステータススイッチを Active に切り替えてエラー
-209を解消します。 - Domain verification に
workspace.getding.ioを入力し、zalo-platform-site-verificationメタタグをコピーして ワークスペース ➔ トラッキング に貼り付け、認証を完了します。 - Products ➔ Official Account API ➔ General settings でOA情報管理とユーザーメッセージ管理の権限を申請します。
- Webhooks でコールバックURLに を設定し、
user_send_text、user_send_image、oa_send_textイベントを有効化します。
ステージ 2: OAuthトークンの発行と25時間自動更新
API Explorerdevelopers.zalo.me/tools/explorerを開き、アプリと OA Access Token を選択して公式アカウントを認可します。- 発行された OA Access Token（有効期限25時間）と Refresh Token（有効期限3か月）、さらに設定画面の App ID と App Secret をコピーします。
- 4つの値を 連携設定 ➔ Zalo OA ➔ 接続 に貼り付けます。DING OSが25時間ごとにバックグラウンドでトークンを自動更新します。
ステージ 3: ZCAビジネスアカウント連携
business.zalo.me- ZBSテンプレート作成時にアプリ一覧が空の場合は、business.zalo.me ➔ ZCAアカウント ➔ Settings ➔ Applications ➔ Link application を開き、Zalo App ID を登録します。
- 双方向OAチャットAPIに関する注意（エラー -224）:
openapi.zalo.me/v3.0/oa/message/cs経由の返信送信には1か月無料トライアルまたは有料OAプラン（zalo.cloud/oa/pricing）が必要です。無料プラン利用時はAI返信案を自動コピーし、ワンクリックでoa.zalo.me/chatv2を開きます。
ステージ 4: ZNSロゴ仕様とテンプレート変数
account.zalo.cloudZalo ZNSでは背景透過の横長PNGロゴ2種（ライト・ダーク両対応、400 x 96 px、比率50:12、上下左右中央配置）が必要です。標準ライブラリから4種のテンプレート（Order, Transfer, Rating, Voucher）を作成し、以下の表どおりに変数を割り当ててください:
| テンプレート | パラメータキー | Zaloデータ型 | サンプル値 |
|---|---|---|---|
| Order, Rating | order_code | Mã số (30) | |
| Order（CTAリンク） | order_id | URL (200) | |
| Order | phone_number | Thông tin liên hệ (50) | |
| Order, Transfer | price | Số lượng / Số tiền (20) | |
| Order | status | Trạng thái giao dịch (30) | |
| Order | date | Thời gian (20) | |
| Order | name | Tên khách hàng (30) | |
| Transfer, Rating, Voucher | customer_name | Tên khách hàng (30) | |
| Transfer | contract_number | Mã số (30) | |
| Transfer | transfer_amount | Tiền tệ (VNĐ) (12) | |
| Transfer | bank_transfer_note | Bank Transfer Note (90) | |
| Rating | order_date | Thời gian (20) | |
| Voucher | customer_id | Mã số (30) | |
| Voucher | voucher_code | Mã số (30) | |
| Voucher | start_date | Thời gian (20) | |
| Voucher | expire | Thời gian (20) |
Gửi tự động xác nhận mã đơn, tổng tiền và trạng thái ngay khi khách đặt dịch vụ thành công. Không chứa quảng cáo.独自ドメインのDNSレコード設定
ご利用のドメイン管理会社（Cloudflare, Route 53, GoDaddy, お名前.comなど）で以下の2つのDNSレコードを公開し、ding.yourbrand.com をエッジプロキシ経由でルーティングします。
| 種別 | ホスト | 必須設定値 | TTL | ステータス |
|---|---|---|---|---|
| CNAME | 自動 | 未確認 | ||
| TXT | 自動 | 未確認 |
カウンター配信と通知
カウンター端末はワークスペース専用の常時接続WebSocket（wss://api.getding.io/v1/ws）を維持します。新規注文、予約、見積依頼が届くと、880HzのWeb Audio合成チャイムと常時表示の視覚バナーで即座に通知します。
カウンター用タブレットでブラウザの音声再生を許可すると、バックグラウンドタブでも操作なしで880Hz A5と1318.5Hz E6のチャイムが鳴動します。下のボタンで音量を確認できます。
すべての着信チケットは、端末スピーカーが消音されていてもユニット番号、顧客名、カテゴリー、必要な対応を画面上の常駐バナーに確実に表示します。
wss://api.getding.io/v1/wsユニット紐付けとQRスポット
物理・オンラインのあらゆる提供枠は全13カテゴリー共通の Unit モデルで管理されます: spaces, realty, events, appointments, travel, mobility, retail, sports, spa, amenities, dining, drinks, takeaway。QRコードの作成数は全プラン無制限です。
各QRスタンドには対象ユニット識別子（UNIT #04 や REF #12）が埋め込まれています。スキャン後はバッジが読み取り専用で固定され、顧客が誤って別のテーブル、コート、客室番号へ切り替える請求ミスを防ぎます。
オープンタブ設定のユニットでは滞在中の追加注文を継続記録できます。会計前にスタッフが reconcile_order を実行し、実際の消費数を確認して未消費分を差し引きます。
スタッフ実績の記録
すべての注文、店頭予約、精算済み伝票には作成者IDが booking.owner として不変記録されます。自動取り込みされた注文はカウンター担当者が引き継ぐまで System AI Ingest として記録されます。
DING OSは一律の固定歩合率を強制しません。各注文・予約・タスクに役割別の貢献（SALES, OPERATIONS, FINANCE, MANAGER, OBSERVER）を記録し、経理部門が社内規定に沿って月末にインセンティブを精算できます。共有カウンターのヘッダーには個人の報酬額を表示せずプライバシーを守ります。
マルチテナントのデータ分離
テナント間のデータ境界は api.getding.io のデータベースクエリ層で強制されます。すべてのリクエストは認証済みセッションの organization_id に厳密に制限されます。
スタッフセッションはOIDCおよびDPoPトークンバインディングを用いた OneUID（uid.one）で認証されます。OneUID は本人識別子（sub）のみを検証し、加盟店のCRMデータや取引履歴は一切保持しません。
各加盟店はGDPRおよび個人情報保護法制における独立したデータ管理者として、顧客プロフィール、連絡先、キャッシュバック残高を100%自社で所有し、他店舗と共有されることはありません。
よくある質問
オーナー、運営責任者、部門マネージャー、情報システム担当者向けの実務リファレンスです。