LIFF 全体像 | 2026-04-21 KIWAMI打ち合わせ補足資料

Chapter 01

LIFFとは何か?

まず誤解を解きます。LIFF ≠ リッチメニュー。LIFF は LINE の中で動くミニWebアプリであり、リッチメニューはその入り口(ボタン)です。

Comparison — 3つの違い

観点	LIFF	リッチメニュー	LINE Mini App
正体	LINE内で動くWebアプリ	トーク画面下の固定ボタン	LIFFの一種(公式審査済)
実装	React/Vue等の通常Web技術	画像+URL の設定だけ	LIFFと同じ(審査要)
できること	入力フォーム・DB読書き・写真・通知・ログイン	URL起動・定型メッセ送信のみ	LIFFと同等+LINE検索露出
表示	フルスクリーンWebView	トーク画面下 1/4〜1/2の枠	フルスクリーンWebView
例	KIWAMI スタッフ用入力アプリ	「温度報告」「清掃」等のボタン	KIWAMI会員Mini App(17,977名)

関係図 — 入り口と中身

LINE公式アカウントチャット画面

▼ リッチメニューに配置

🔘 温度報告

→

🔘 清掃

→

🔘 在庫棚卸

▼ ボタンタップ

LIFF WebView(入力画面)

Key Point

リッチメニュー = 入り口(ボタン)、LIFF = 中身(Webアプリ)。両者を組み合わせて「ボタンを押したらフォームが開く」体験を実現します。

Chapter 02

KIWAMI の LIFF マップ

KIWAMI には現在 2種類のLIFF が動いています。顧客向けの KIWAMI Mini App と、スタッフ向けの staff-line-liff。両者は同じ「LIFF」という技術で構築されていますが、役割が完全に分かれています。

Customer-facing

KIWAMI SAUNA Mini App

会員17,977名が利用する顧客向けアプリ

ポイントカード・ランク確認
来店履歴・予約
景品交換(KIWAMI POINTS)
レディースDAY情報
外部ベンダー実装

Staff-facing

staff-line-liff

スタッフ・マネージャーが業務で使う

登録 / 欠勤申請
日次チェックリスト(duty)
インシデント報告
マネージャー: スタッフ承認・Todo
自社実装(90_GitHub/staff-line-liff/)

本資料で扱うのは staff-line-liff の拡張

穴⑨「スタッフ入力LIFF統合」は、staff-line-liff に 6業務の入力画面を追加する話です。顧客側の Mini App には影響しません。

① 温度計測 (10エリア) — 新規画面
② 残留塩素計測 (水風呂・湯風呂) — ①と統合
③ 営業中清掃チェック (時間帯別44項目) — 既存duty拡張
④ 浴槽換水・清掃 (月次) — 新規画面
⑤ 脱衣所・厨房清掃 (日次) — ③に統合 or 新規
⑥ 在庫棚卸し (週次グッズ + 月次消耗品) — 新規画面

Chapter 03

穴⑨統合後の絵姿 — Before / After

LIFF統合前と後で、スタッフの報告体験・データ化の度合いが根本から変わります。

Before — 現在

バラバラに報告されるデータ

温度・塩素: LINEグループに写真+テキスト
清掃完了: LINEグループに「完了しました」
浴槽換水: 月1回実施、記録なし
脱衣所・厨房: 毎日実施、記録なし
在庫棚卸: 実施確認が不明
→ 法令記録として蓄積されない
→ AI部長が分析できない
→ 時系列の推移が見えない

After — LIFF統合後

全報告が構造化データに

温度・塩素: 数値 + 写真が measurement_reports に自動蓄積
清掃: 時間帯別チェック状態が duty_reports に蓄積
浴槽換水: 月次記録が hygiene_reports に保存
脱衣所・厨房: 日次記録が自動残存
在庫棚卸: 品目別数量が inventory_counts に蓄積
→ 法令記録が自動で積み上がる
→ AI部長が実データで稼働
→ 時系列で異常検知・トレンド分析

Business Impact

LIFF統合で /sauna-bucho-facility 🟡→🟢、/sauna-bucho-compliance 🟡→🟢、/sauna-bucho-ops の在庫AI予測が稼働。AI部長体制の完成に大きく近づきます。

Chapter 04

時刻通知 + 先着対応の動線

リッチメニューから開く「プル型」に加え、定刻にLINE Pushを飛ばす「プッシュ型」を併用します。通知の「対応する」ボタンを 先着で押したスタッフが担当確定し、そのまま LIFF で入力して完了します。

Cloudflare Workers Cron が定刻発火

例: 毎朝 6:00 に Cron Trigger 起動 → LINE Messaging API でスタッフ全員に Push 送信

スタッフLINEに Flex Message が届く

「🌡️ 温度計測の時間です / [対応する]」ボタン付き。出勤中スタッフ or 全員に配信(要ヒアリング)

最初の1人が「対応する」をタップ

Webhook経由でPostback受信 → claim_logs テーブルに INSERT(UNIQUE制約で先着保証) → 担当確定

担当者に LIFF URL を Reply

時刻・エリアが事前入力された計測画面を開く。2番目以降のスタッフには「野田さんが対応中」と通知

LIFF で数値入力 + 写真撮影 → 送信

写真は Cloudflare R2 に署名URLでアップロード。数値は measurement_reports にINSERT

完了通知 & AI部長への連携

報告完了をスタッフ全員に共有。AI部長(/sauna-bucho-facility)が最新データで健康診断を更新

エスカレーション

発火時刻: Push 通知(1回目)
+15分: 誰も対応していなければ再Push「まだ対応者がいません」
+30分: 店長LINE DMに自動通知
+60分: 経営者にエスカレーション(要判断)

Ask on 4/21

現場運用として「先着でボタンを押した人が担当」で回るイメージがつくか。回らない場合は 担当制(特定スタッフのみ通知) or エリア別割当(10エリアを分担) に切り替え可能。

Chapter 05

権限管理 — staff / manager

LIFFの利用者は staff(一般スタッフ) と manager(店長・GM) の2役割に分かれます。権限はリッチメニューの自動切替 + LIFF内の画面出し分けで制御。

Role-based Access

操作	staff	manager
温度・塩素計測入力	✓ 可	✓ 可
清掃チェック	✓ 可	✓ 可
浴槽換水・日次衛生	✓ 可	✓ 可
在庫棚卸し	✓ 可	✓ 可
インシデント報告	✓ 可	✓ 可
欠勤申請	✓ 可(自分分のみ)	✓ 可(全員)
スタッフ承認	— 不可	✓ manager専用
Todo 割り当て	— 不可	✓ manager専用
マニュアル編集	閲覧のみ	✓ manager可
レポート閲覧	自分の分のみ	✓ 全体

リッチメニューの自動切替 (Phase 1-A 実装済)

LINEユーザーが staff か manager かを検出し、リッチメニューが自動で切り替わるよう実装済み([`やることリスト.md`](../../やることリスト.md) Phase 1-A)。

staff メニュー: 温度報告・清掃・インシデント・在庫のみ
manager メニュー: staff メニュー + スタッフ管理・承認・Todo・レポート

Future

穴⑨着手時に、経営者ロール(全体俯瞰ダッシュボード専用)の追加を検討。中島代表が1画面で6店舗(将来)のKIWAMI全体を見られる想定。

Chapter 06

セキュリティ & 写真保管

LIFFは LINEの認証基盤を使うため、パスワード管理や独自ログインは不要。ただし写真保管先と認証強化は 4/21の判断事項です。

認証

LINE ID Token による認証(改ざん防止の署名検証を追加予定)
スタッフ登録時に LINE UID を staff テーブルに紐付け
LIFF URL を知っていても、UIDが登録外なら入力不可

写真保管 — Cloudflare R2 推奨

保管先の比較

方式	メリット	デメリット
LINE添付	実装コスト最小	1ヶ月で自動失効 → 法令記録として不適
Cloudflare R2 (推奨)	3年保管・署名URL・10GB/月まで無料枠内・既存staff-line-apiと同じCloudflare内で完結	新規承認が必要(4/21判断)
Google Drive	既に契約あり・容量豊富	API連携実装コスト中・認証フロー複雑

Ask on 4/21

写真保管先を Cloudflare R2 で承認できるか。10GB/月の無料枠内で3年分の写真(温度計・塩素計・清掃Before/After)を保管可能な試算。

Chapter 07

4/21の判断が全体に連鎖する

今日の打ち合わせで 4つの判断が揃えば、LIFF統合Phase 1-A が即着手可能になります。逆に1つでも保留だと、全体が遅延します。

LIFF統合 Go/No-Go

6業務をLIFF経由に統合する方針を Go 判定 → Phase 0 共通基盤着手

写真保管 R2 承認

R2 採用を承認 → 画像アップロードAPI実装 → 全業務の写真機能が稼働

時刻通知方式の運用可能性確認

店長(野田さん)に運用実感を確認 → 先着制 / 担当制 / エリア別割当のいずれかで実装確定

新設温度計6台の調達判断

脱衣所・蔵・2F内気浴・フロント・フロント2F・フロント3階の機種選定・発注

4つ揃ったら連鎖的に解錠される領域

穴①法令データ(水質・衛生のLIFF連動で過去遡及不要)
穴⑨LIFF統合の 6業務すべて
/sauna-bucho-facility 🟡→🟢(データ投入で即稼働)
/sauna-bucho-compliance 🟡→🟢(法令記録自動化)
穴⑩シフトの暗黙知言語化ヒアリング (並列実施可能)
戦略案件 #27(発注自動化) の実装前提データ整備
戦略案件 #45(負荷設計) の業務量測定データ整備

Strategic

LIFFは単独の機能ではなく、AI経営OSの「センサー」。現場の実態をデジタル化する入り口であり、ここが稼働しないと他の穴も連鎖的に解決しません。

Chapter 08

60日ロードマップ

4/21 Go 判定後、60日間で 6業務すべてのLIFF化と運用定着を目指します。

Phase 0: 共通基盤(〜 4/28, 1週間)

LIFFホームをタイル型に改修 / 時刻通知Cron + claim_logs テーブル / R2写真アップロードAPI

Phase 1-A: 計測報告(〜 5/12, 2週間)

穴①②(温度・塩素) / measurement_reports テーブル / 温度計6台配備 / エリア別入力画面

Phase 1-B: 在庫棚卸し(〜 5/19, 1週間)

穴⑥(在庫) / inventory_counts テーブル / 週次グッズ + 月次消耗品の入力

Phase 1-C: 営業中清掃(〜 6/02, 2週間)

穴③⑤(清掃) / duty_reports 拡張 / 時間帯別チェック画面 / 清掃項目マスタ整備

Phase 1-D: 月次衛生(〜 6/20, 3週間)

穴④(浴槽換水) / hygiene_reports テーブル / 月次作業記録 / 薬剤マスタ

完全稼働 (6/30)

6業務すべてLIFF稼働 / AI部長2名🟢化 / 法令記録が自動蓄積される状態へ

Beyond 60 Days

7月以降は 穴⑩シフト生成の暗黙知言語化(店長ヒアリング2-3時間×2店舗) と、戦略案件10件の個別プロジェクト化に着手。AI経営OS完成形へ。