5 分でクイックスタート
摊盒(BoothKernel)の基本理念は、会場のネットワークに頼らないこと。テザリング(ホットスポット)1 つだけで、複数の端末が LAN 内で連携して動きます。 ここでは会場での実際の流れに沿って、ゼロから使える頒布システムを組み立てます。
v1.1 からアップグレードした方へ
v1.2 では帳簿が新しくなり、以前のイベントや注文は移行されません(Excel に書き出すことはできます)。まず v1.1 から v1.2 へのアップグレード をお読みください。
画面の表記について
アプリの画面は中国語のみです。このガイドでは、ボタンやメニューを 日本語訳(画面表示「中国語の表記」)の形で書いているので、画面の文字と照らし合わせてください。
摊盒には 3 つの役割があります
- 管理画面(画面表示「管理后台」):イベントの前後に使います。商品登録、イベント作成、セット設定、注文や統計の確認、精算書の確認
- お客様注文画面(画面表示「顾客点单页」):ブースの前に置きます。商品の表示、セルフ注文、支払い用 QR コードの表示
- 売り子画面(画面表示「摊主端」):売り子の手元に持ちます。新規注文の通知、入金確認、返品、贈呈・廃棄、撤収
用意するもの
最小構成(おすすめ)
- 端末 A:摊盒アプリをインストールしたタブレット。イベント前後は管理画面、イベント中はお客様注文画面として使います
- 端末 B:ブラウザが使えるスマホ。QR コードで接続し、売り子画面として注文を受けます
混雑するブース向けの構成
- 親機:パソコン(机の下/ブースの後ろに置く)
- 注文画面:タブレット 1~2 台(ブースの前に置いて電子メニューに)
- 売り子画面:スマホ 1~3 台(売り子やサークルメンバーが同時に注文を受ける)
Step 1:インストールと基本設定

- GitHub Releases から摊盒をダウンロードしてインストールします(Windows は
.exe、Android は.apk) - アプリを開き、管理画面に入って設定を始める(画面表示「进入管理后台开始配置」)をタップし、管理者パスワード(初期値
admin123)を入力します - 左のサイドバーには イベント/商品マスタ/サークル/設定/使い方(画面表示「展会 / 商品库 / 社团 / 设置 / 使用教程」)が並んでいます
最初に 1 つだけやっておくこと
設定 → セキュリティ設定(画面表示「设置 → 安全设置」)で、管理者パスワードとデフォルトの売り子パスワードを変更してください。初期パスワードは公開されている説明書に載っているので、 同じ Wi-Fi にいる人なら誰でもログインできてしまいます。変更するまで、管理画面の上部に注意表示が出続けます。
Step 2:商品マスタに登録する
サイドバーから 商品マスタ(画面表示「商品库」)を開き、「新しい商品を登録」(画面表示「添加新商品到仓库」)で 1 つずつ登録します。
- 商品番号(必須・重複不可。A01、B02 のような短いコードがおすすめ)、商品名、標準価格
- 任意:商品カテゴリ(注文画面の左側でこれを使ってグループ分け)、タグ(キャラクターやシリーズで絞り込み)、商品プレビュー画像
- 任意:商用バーコード(画面表示「商业条码」)。商業誌や公式グッズなど JAN / ISBN があるものは入力しておくと、注文時にスキャンでカートに追加できます
- 任意:所有サークル(画面表示「所属社团」)。選ばなければ「自サークル」(画面表示「本社团」)になります。ほかのサークルの委託販売をする場合は、先に「サークル」ページで相手を登録してから選んでください。精算のときに自動で分けて計算されます
商品マスタは使い回せるテンプレート
どこかで 1 日取って、サークルの頒布物をまとめて登録しておきましょう。以後のイベントでは、並べるものを選ぶだけで済みます。 登録したあとは商品マスタの一番下から .boothpack を書き出して、売り子を手伝ってくれる友人に渡して取り込んでもらえます。
Step 3:イベントを作成して商品を並べる

- サイドバーの イベント → 新規イベント(画面表示「新建展会」)で、名前・日付・場所を入力します。このイベント専用の売り子パスワードも設定できます(空欄ならグローバルのデフォルト売り子パスワードを使用)
- WeChat Pay の受取 QR コードと Alipay の受取 QR コードをアップロードします(任意・片方だけでも可)。お客様が注文すると、注文画面にこれが表示されます
- イベントカードをタップするとイベントワークベンチ(画面表示「展会工作台」)に入ります。上部は「準備中 → 開催中 → 精算済み」(画面表示「筹备 → 进行中 → 已结算」)のステータスバーで、その下のタブは「事前準備/当日/撤収」(画面表示「展前 / 现场 / 收摊」)でまとめられています
- 事前準備 · 商品(画面表示「展前 · 商品」)で、このイベントで売るものを並べます。
- 商品マスタから選ぶ(画面表示「从商品库选」):商品を複数選び、「出品待ち」(画面表示「待上架」)の表で販売価格(初期値は商品マスタの価格)と在庫(空欄なら 0。あとから「補充」(画面表示「补货」)できます)を入力します
- 前回のイベントから取り込む(画面表示「从上一场导入」):初参加でなければ、前回の商品とセットにチェックを入れてまとめて持ってこられます
- セット割引(N 点選び放題、まとめ買い価格)が必要なら 事前準備 · セット(画面表示「展前 · 套装」)で設定します。セットと割引 を参照してください
- 準備ができたら、ステータスバーの イベント開始(画面表示「开始展会」)をタップします。イベントが「開催中」になり、注文画面と売り子画面からイベントが見えるようになります

Step 4:ネットワークを組む(オフライン LAN)

複数の端末は LAN で同期します。一番安定するのはスマホのテザリングです。
- どれか 1 台のスマホでテザリングをオンにします(モバイルデータは不要)
- すべての端末をこのテザリングに接続します
- 親機(アプリを入れた端末)では摊盒を開いたままにします
- 親機で 設定 → LAN 接続(画面表示「设置 → 局域网连接」)を開き、LAN QR コードを取得(画面表示「获取局域网二维码」)をタップすると、3 つの QR コードが表示されます。 お客様用入口(画面表示「顾客入口」)、売り子用入口(画面表示「摊主入口」)、管理者用入口(画面表示「管理员入口」)
- ほかの端末は標準のカメラアプリで該当する QR コードを読み取ります(WeChat や Alipay のスキャナーは使わないでください。ブロックされることがあります)
- 初回は「この接続ではプライバシーが保護されません」という警告が出ます。「詳細設定 → アクセスする」をタップすれば OK。1 台につき 1 回だけです(理由は LAN HTTPS(中国語) を参照)
会場 Wi-Fi や学内ネットワークにはつながないでください
会場 Wi-Fi は混雑して頻繁に切れます。学内ネットワークのような大規模ネットワークは多くの場合クライアント分離が有効になっていて、端末同士がそもそも通信できません。 Windows の親機は初回起動時にファイアウォールの許可を求めてくるので、「プライベート ネットワーク」を許可してください。
Step 5:端末を配置する

ブラウザからのアクセスでもアプリとほぼ同じ機能が使えるので、どの端末を親機にするかはあまり重要ではありません。会場の都合に合わせて割り振ってください。
注文用タブレット
用途:ブースの前に置いて商品を見せ、お客様にセルフ注文してもらい、支払い用 QR コードを表示します。
- 「お客様用入口」の QR コードで開きます(または親機アプリのサイドバー下部にある「お客様画面」(画面表示「顾客端」)をタップ)
- 開催中のイベントをタップして注文画面に入ります
- 60 秒間操作がないと「いらっしゃいませ」(画面表示「欢迎光临」)の待ち受け画面に戻り、カートが空になります

お客様は「📷 AI 画像認識」(画面表示「📷 拍照识别」。事前に AI 画像認識(中国語) の設定が必要)や「▦ スキャン」(画面表示「▦ 扫码」。バーコードスキャン を参照)で商品を探すこともできます。
売り子のスマホ
用途:新規注文の通知、入金確認、商品の用意。
- 「売り子用入口」の QR コードで開き、イベントを選びます
- 売り子パスワードを入力します(イベント専用パスワードを設定していればそれを、なければデフォルトの売り子パスワード
vendor123) - 画面下部に クイック販売/注文/在庫/撤収(画面表示「快售 / 订单 / 库存 / 收摊」)の 4 つのタブがあります

新しい注文が入るとスマホから通知音が鳴ります。メディア音量を上げておき、ページのどこかを一度タップしておいてください(ブラウザの仕様で、一度タップされたページでないと音が出せません)。
「快售」では同じイベントの商品を 1 点でも複数点でも選べます。お客様画面と同じセット割引が自動で計算されます。実際の入金を確認してから支払い方法を選び、必要なら実際の受取額を直して「确认已收,记这单」をタップします。注文はその場で完了します。必要なときは「展示收款码」で支払い用 QR コードを表示できます。通信結果が不明なときは再送信せず、「重试上一单」で同じリクエストを再試行してください。
会場での典型的な流れ
- お客様がタブレットで商品を選ぶ → 「会計へ」(画面表示「去结算」)→「注文を確定」(画面表示「确认下单」)→ タブレットに支払い用 QR コードが表示される
- 売り子のスマホが鳴る → 商品を用意 → 入金の通知音を確認したら 用意完了(画面表示「完成配货」)→ 支払い方法を選んで 入金確認(画面表示「确认收款」)
- お客様の代わりに注文するときは、売り子画面で 注文へ(画面表示「去点单」)をタップし、終わったら 売り子画面に戻る(画面表示「回摊主端」)をタップします
Step 6:撤収と精算

イベントが終わったら、売り子画面で 撤収(画面表示「收摊」)タブに切り替え、ウィザードに沿って 4 ステップ進みます:注文の確認 → 棚卸し → 持ち帰り → 精算(画面表示「清点订单 → 盘点 → 带回 → 结算」)。 最後まで進むとイベントは凍結され、「撤収」タブはこのイベントの精算書に変わります。各ステップの詳細は 撤収と精算 を参照してください。
その後、管理画面のイベントワークベンチで:
- 当日 · 統計(画面表示「现场 · 统计」):売上の推移と商品ごとの販売数。「Excel レポートをダウンロード」(画面表示「下载 Excel 报告」)で売上集計が得られます。「何が売れたか」に答えるものです
- 撤収 · 精算(画面表示「收摊 · 结算」):精算書。「Excel 出力」(画面表示「导出 Excel」)で、各サークルの取り分と「誰にいくら送金すべきか」が得られます。「お金をどう分けるか」に答えるものです
委託販売の分配は精算書で確認し、売上集計では見ないでください。 2 つの違いは エクスポートと振り返り を参照してください。
FAQ:会場でよくある質問
Q1:インターネット接続は必須ですか?
いいえ。摊盒はオフラインの LAN で使えることを目標に設計されていて、テザリングがそのままネットワークになります。インターネットが必要なのは「更新の確認」と、AI 認識モデルの初回ダウンロードだけです。
Q2:何台まで同時に接続できますか?
主にテザリング端末の性能と会場の電波干渉しだいです。親機 1 台 + タブレット 2 台 + スマホ 3 台なら問題ありません。
Q3:接続が切れたらどうなりますか?
切れている間は、最新の注文や在庫が届きません。接続が戻れば自動で再接続するので、ページを再読み込みしてください。データはすべて親機にあるので失われません。
Q4:データのバックアップとエクスポートは?
- 商品マスタ:「商品マスタ」ページの一番下から
.boothpackを書き出します - イベントのデータ:売上集計と精算書(Excel)を書き出します。なお、Excel はアプリに取り込み直せません