LINE Report — MARUGO S 管理システム
リポジトリ: MARUGO-s/line_report
本番 GitHub Pages: https://marugo-s.github.io/line_report/
バックエンド Supabase: https://hocbnifuactbvmyjraxy.supabase.co（プロジェクト名: hocbn）
最終更新: 2026-09-10（数値予測・評価・関連文書。その他の設定値は各節の確認時点）
[!WARNING]
Google Places API（New）停止中 — 2026-10-02
LINE Report の Google Places API は完全停止しています。自店舗・競合の検索、口コミ更新、新着口コミ通知は実行されません。Supabase に保存済みの店舗情報・口コミスナップショット・店舗理解資料は削除せず、既存データの表示と分析だけを継続します。
store_review_places、competitor_places の登録行を削除すると、関連する履歴スナップショットも削除されるため、停止中は削除しないでください。
目次
- システム概要
- 画面一覧（全ページ）
- アーキテクチャ
- 認証・セキュリティ
- Supabase Edge Functions
- フードコート専用システム（marugoS）
- LINE Webhook フロー
- フロントエンド共通仕様
- デプロイ手順
- ローカル開発
- ドキュメント索引
1. システム概要
マルゴグループ（飲食店チェーン）向けの LINE 連携型 店舗管理プラットフォーム です。
主な機能
| 機能カテゴリ | 概要 |
|---|
| LINE レシート解析 | スタッフが撮影したレジ精算書をAIが自動解析し、売上・客数・予算達成率をLINEに返信 |
| 売上分析ダッシュボード | 全店舗の日次・月次売上、前年比、予算比をブラウザで閲覧 |
| フードコート AI 分析 | MARUGO S（東京ドーム）専用。来客予測・施策効果・AI経営アドバイスを自動生成 |
| フードコート日報 | MARUGO S スタッフが現場の施策・出来事を記録する日報入力システム |
| AI 学習進化トラッキング | 事前予測のWAPE/MAE・5方式比較・参考再計算を分離表示 |
| 予約表 | Gmail 予約メールを自動取り込み、来客履歴と紐付けてブラウザで管理 |
| メディア閲覧 | LINE で受け取った画像・動画をブラウザで閲覧・管理 |
| 会話検索 | 全 LINE グループの会話をキーワード全文検索 |
| 口コミ・競合分析 | Google マップ・競合店の口コミをAIが自動収集・要約 |
| AI 使用料管理 | Groq / Gemini / Claude の API 使用量・コストを一元管理 |
| 小口現金管理 | 経費レシートをLINEに送るだけで自動記帳 |
2. 画面一覧（全ページ）
| ページ名 | URL | 認証 | 説明 |
|---|
| 管理コンソール | /index.html | ✅ 要 | 全機能の起点。ルーム設定・権限管理・店舗設定 |
| 売上分析 | /analytics.html | ✅ 要 | 全店舗・月別・日次の売上ダッシュボード |
| メディア閲覧 | /media.html | ✅ 要 | LINE 受信画像・動画のギャラリー |
| 会話検索 | /message-search.html | ✅ 要 | LINE グループ会話の全文検索 |
| 予約表 | /reservation.html | ✅ 要 | 予約カレンダー・来店履歴管理 |
| 口コミ・競合 | /reviews.html | ✅ 要 | Google 口コミ分析・競合店比較 |
| AI 使用料 | /ai-usage.html | ✅ 要 | AI API コスト・使用量ダッシュボード |
| システムマップ | /system-map.html | ✅ 要 | Graphifyコード/SQL構成、本番・業務AI・開発知識循環 |
| 小口現金 | /petty_cash.html | ✅ 要 | 経費仕訳・小口現金帳 |
| フードコート分析 | /foodcourt.html | ✅ 要 | MARUGO S 専用 来客予測・売上分析・Q&A（期間→手法→必要な売価確認） |
| AI学習 進化 | /foodcourt-evolution.html | ✅ 要 | MARUGO S 専用 事前予測の精度・5方式比較 |
| フードコート日報 | /foodcourt-report.html | ✅ 要 | MARUGO S 専用 現場日報の入力・閲覧 |
認証フロー
index.html（接続設定）で管理トークン（lrst_xxxx）を入力しログイン- セッションは
auth-session.js が sessionStorage + localStorage（スコープ別）に保存
- 同一ドメイン・同一パス配下のページ間でセッションは自動共有される
- LINE リンクからのアクセスは
?lt=lrlt_xxxx（ワンタイムログインチケット）で自動ログイン
3. アーキテクチャ
┌─────────────────────────────────────────────────┐
│ GitHub Pages（静的配信） │
│ HTML + CSS + JS（認証・UI） │
│ https://marugo-s.github.io/line_report/ │
└──────────────────┬──────────────────────────────┘
│ HTTPS（API呼び出し）
┌──────────────────▼──────────────────────────────┐
│ Supabase (hocbn) │
│ ┌────────────────┐ ┌────────────────────────┐ │
│ │ Edge Functions│ │ Database │ │
│ │ ・line-webhook│ │ ・line_receipt__* │ │
│ │ ・admin-api │ │ ・line_webhook_raw__* │ │
│ │ ・各種 cron │ │ ・foodcourt_* │ │
│ └────────┬───────┘ │ ・reservation_* │ │
│ │ │ ・admin_dashboard_* │ │
│ ┌────────▼───────┐ └────────────────────────┘ │
│ │ AI 外部API連携 │ │
│ │ ・Groq (主力) │ │
│ │ ・Gemini │ │
│ │ ・Claude │ │
│ └────────────────┘ │
└─────────────────────────────────────────────────┘
│
┌──────────────────▼──────────────────────────────┐
│ LINE Messaging API │
│ グループチャット / トークルームでの │
│ レシート送信・会話・返信 │
└─────────────────────────────────────────────────┘
設定の単一ソース
public/pages-config.js がフロントエンド全体で使う URL・店舗情報を一元管理します。
PROJECT_URL = 'https://hocbnifuactbvmyjraxy.supabase.co' // 全 API の向き先
ADMIN_SURFACE = 'line_report' // 認証面識別子
Graphify × Obsidian × AI 開発知識環境
public/system-map.html: 既存管理セッションをPOST /auth/verifyで確認してからマップを表示（公開URLは/system-map.html）。public/system-map/graph.html: Graphifyによる自作コード・SQL migrationの構造図。public/system-map/environment.html: 本番・業務AI・AI開発知識循環の3層環境図。knowledge/system-architecture.json: 環境図の構造化された正本。- Obsidian
アプリ知識/10_アプリ別/LINE Report/:
70_AI作業環境: AI入口、環境図、チェックリスト、Graphify/Obsidianブリッジ80_リポジトリ文書: README/docsの自動ミラー90_Graphify: コード・SQLノートとCanvas
標準フロー:
npm run knowledge:search -- "<依頼・症状・機能名>"
npm run knowledge:check
graphify query "<コード・SQL上の質問>"
npm run knowledge:update
Graphifyはtree-sitter-sqlを使ってmigrationを解析します。vendor、node_modules、生成物、バックアップ、秘密設定は.graphifyignoreで除外します。
4. 認証・セキュリティ
トークンの種類
| 種類 | プレフィックス | 有効期限 | 用途 |
|---|
| ログインリンクトークン（lt） | lrlt_ | 24時間・1回限り | LINE リンクでの自動ログイン用 |
| セッショントークン（st） | lrst_ | 3日間 | ブラウザが保持するセッション |
| 管理トークン | なし（生値） | 無期限 | ADMIN_DASHBOARD_TOKEN 環境変数の値 |
ストレージ方針（auth-session.js）
- 生の管理トークンは永続化しない（初回読込時に自動削除）
- セッショントークンは
sessionStorage + スコープ別 localStorage に保存
- スコープ =
origin + ディレクトリパス のハッシュ → 同一アプリ配下でのみ共有
店舗スコープ（marugoS 等）
LINE リンクから開いた画面はセッション作成時に store_partition_key がメタデータに付与され、その店舗のデータのみ閲覧・操作できる。
5. Supabase Edge Functions
常駐 Function 一覧
| Function 名 | トリガー | 役割 |
|---|
line-webhook | LINE Webhook（店舗別） | レシート解析・会話応答・予約受付の全ハンドリング |
line-admin-webhook | LINE Webhook（@392hdime 管理Bot） | 新規ユーザー・ルームの承認専用 |
admin-api | HTTPS リクエスト | 全管理画面の API バックエンド |
admin-line-test-push | 手動 / テスト | LINE へのテスト Push 送信 |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
