📖 使い方ガイド
📚 目次(クリックでジャンプ)
⏱ タイムカード運用 — 出社・業務・日報・退勤の 1 日の流れ
2026-05-21 礒貝CEO 指示で新設。Staff Manager はタイムカード兼勤怠管理として動作します。
🌅 朝(業務開始)
- Staff Manager の従業員ポータル (
employee.html) を開く - 「⏱ 今日の勤務をどうしますか?」モーダルが表示される
- 2 つのボタンから選択:
- ✅ 出社する (今からタイムカードを開始) — 業務開始打刻。緑ボタン
- 👀 お休み(画面だけ確認します) — 休日だがアプリは見たい場合(打刻されない)
- 「出社する」を押すと、ヘッダー右上に「📝 日報を書いて退勤 (出社: HH:MM)」ボタンが現れる
⌛ 業務中(日中)
- タイムスケジュールタブで、その日の予定をブロックで管理 (0〜23時のグリッド + 時計プリセット UI)
- タスクタブで進行中のタスクを進める(進捗バーをスライドで上げる)
- 申請タブで経費・出張・稟議の申請(出張は出発日/帰着日も入力)
- 休暇申請タブで休みを申請(2 週間以上先のみ可)
🌇 夕方(業務終了 = 日報書く = 退勤)
- ヘッダー右上の「📝 日報を書いて退勤」ボタンをタップ → 日報タブに自動ジャンプ
- 日報を記入:
- 勤務開始時刻(出社時に自動入力済) / 勤務終了時刻
- 今日やったこと / 明日やること / 課題・ブロッカー
- 今日のコンディション(😣〜😄 の 5 段階)
- タスクの進捗 — 進捗を上げたタスクには 6 文字以上の進捗メモが必須(どこまで進んだか/どんな状況か)
- 「💾 日報を提出して退勤」ボタンを押す → 日報保存 + 退勤打刻が同時実行
- 「⏱ 退勤打刻: HH:MM〜HH:MM (お疲れさまでした!)」のメッセージが出れば完了
🛠 管理側 (社長・管理者) の確認
- 管理ダッシュボード
admin.html→ 「⏱ 勤務状況」タブを開く - 本日の出社・退勤・閲覧のみ・未打刻の人数が 4 枚 KPI で一目で確認
- 表で各スタッフの出社時刻 / 退勤時刻 / 稼働時間 / ステータス(🟢出社中・✅退勤済・👀閲覧のみ・未打刻) / 本日のタスク進捗 / 日報提出状況を一覧
- 表の行をクリックすると、そのスタッフの詳細(連絡先・緊急連絡先・タスク・日報内容)を即確認可能
🆕 最新アップデート (2026-05-21 リリース)
この日リリースされた主な機能変更一覧。社員全員のブラウザに自動反映されています。
朝のログイン時に「出社/休み」モーダル → 業務終了時は日報書く = 退勤打刻。詳細は上記タイムカード運用セクション。
admin.html に新タブ。全スタッフの本日の出社/退勤/稼働時間/タスク進捗/日報提出状況を 1 画面で確認。
マイページの緊急連絡先を「氏名 / 続柄 / 電話 / 住所」の 4 欄に分割。すべて入力必須。
「基本的に休日はない」前提で、休暇申請は必ず 2 週間以上先のみ受付。種類に「固定休日」追加。
申請タブで「出張」種別を選ぶと、出発日と帰着日の入力欄が出ます。日帰りは同日。
タスクの進捗を上げる時、「どこまで進んだか / どんな状況だったか」を 6 文字以上で入力しないと日報を提出できません。
タイムブロック追加モーダルに時(0〜23)+分(0/15/30/45)のボタンパッド。タップだけで時刻入力。
全ての日付欄をタップしただけでカレンダー、時刻欄は時計 picker が即座に開きます。
候補者にメール/電話/LINE/SNS/住所を登録、行/カード/モーダルから削除可能、明細表示も可。
新会社設立時、Q&A はゼロから開始。Q&A 担当者(管理者)が「+ FAQ 追加」で自社向けに登録。
新会社設立時、会計データもゼロから開始。会社間のデータ混在なし。
LV.MAX 社長のみ「🆕 新規会社を追加」ボタンが見える。管理者は新規設立不可。
LV.MIDDLE 管理者も新メンバー招待コードを発行可能。社長の作業負荷を軽減。
社長がマイページで権限を変更すると、Supabase に同期 → 全社員の端末で次回画面表示時に反映。
会社別セッション分離・別タブ干渉防止・STAFF[0]フォールバック撤廃・5重ガード(legacy/mismatch/staff_not_found/staff_not_in_company/STAFF[0]禁止)。
master.html で各スタッフ向けの「24時間有効ログインURL」を発行。LINE で送れば 1 タップで参加完了。
🎖 1. 権限ランクの仕組み
- 全社員の個人情報を閲覧・編集可
- 権限ランク変更権あり(他者を昇格/降格)
- 全タスク・全申請を承認可能
- サポートチケットの全件管理権限
- 全社員の業務情報を閲覧可(個人情報も可)
- 管理ダッシュボードへアクセス可
- 担当範囲のタスク依頼・承認可能
- 権限変更は不可(社長のみ)
- 自分の情報・業務のみ閲覧・編集
- 他人の電話・住所・緊急連絡先は非表示
- 管理ダッシュボードはアクセス不可
- マイページから自分のサポート起票可
🔐 2. ログイン画面 login.html
(リロードで開発者が後ほど更新)
- 🟢 Google でログイン — OAuth 認証。社用メール (@ganecci.net) でも個人 Gmail でもどちらでも OK(両方を見て同じスタッフに引き当てます)
- 🟡 デモログイン — 10 名の中から選択。OAuth 設定がまだの時のフォールバック
- 📥 OAuth Client ID 自動取得 — Google Cloud Console で発行した Client ID をクリップボードからワンクリック貼付
- 🎟 招待リンク —
?as=staffId&invite=XXX付き URL で起動すると、自動的にそのスタッフとしてログイン
🏠 3. ホーム画面 index.html
- 👤 従業員ポータル — タスク・日報・休暇申請など個人業務の入口
- 📊 管理ダッシュボード — チーム全体の状況把握(LV.MIDDLE 以上のみ表示)
- 👤 マイページ — プロフィール・連絡先・権限情報
- 📒 会計・経理 — 月別仕訳帳・領収書管理
- 💬 社内 Q&A — FAQ + isoAi での質問
- 📮 お問い合わせ — バグ報告・機能リクエスト
- 📖 使い方ガイド — このページ
👤 4. 従業員ポータル employee.html
タブ構成
- 📅 今日の予定 — タイムライン(時間枠クリック → スケジュール追加モーダル)+ 今日のタスク
- ✅ タスク — 緊急度カラーで一覧表示 / 編集モーダル(期間・時間・委任・進捗) / Google カレンダー書き戻し
- ⏰ タイムスケジュール — 既存タスクから引用 or 自由入力で時間ブロック登録
- 📝 日報 — 今日やった/明日やる/ブロッカー/コンディション + 📊 タスク進捗一括更新
- 🏖 休暇申請 — 種類(有給/病気/特別/慶弔)・日付・理由 → 履歴ハイライト
- 📅 月間カレンダー — 月/週切替 + 日付タップで詳細
- 🔔 通知 — 自分宛の通知一覧 + 💬 LINE/📧 メール ですぐ依頼者に確認
- 💴 申請(稟議・経費) — 領収書添付(カメラ起動 / アルバム両対応) + 承認者複数選択(自動推奨) + 履歴サムネ
📊 5. 管理ダッシュボード admin.html
KPI(クリックで詳細モーダル)
- 👥 在籍 — 役職順メンバー一覧
- 💼 本日 業務中 — 業務中のメンバー(現在のスケジュール枠)
- 🏖 本日 休暇 — 休暇者(休暇種別 + 理由 + 承認状態)
- ⏰ 遅延タスク — 古い順 + 担当者 + 経過日数バッジ
10 タブ構成
- 👥 チーム稼働状況 — 10 名カード + 負荷バー + 💬 LINE クイック / 📩 即依頼 + 休暇中は金縁バナー
- ✅ 全タスク — 担当・プロジェクト・状態でフィルタ可能
- 📝 日報サマリ — 10 名一覧 + 🤖 isoAi 要約 + 📁 月別アーカイブ(マトリクス + 税理士提出 CSV)
- 🏖 休暇カレンダー — 月ビュー + 申請一覧 + 承認ボタン
- 📂 プロジェクト別 — 進捗バー + メンバーアバター
- 📈 月次レポート — 提出率/完了率/コンディションのバーチャート
- 🔔 通知センター — 検出された通知 + Slack 風送信ログ
- 🎯 採用 — 5 列カンバン + テーブル + 候補者追加
- 💴 稟議・経費 — 承認待ちパルスバッジ(金色ピカピカ) + 領収書サムネ + ⚠ ルール違反 KPI + ✅ 全件チェック + CEO 承認ルール管理
- ⚙ 設定 — ログイン情報 + OAuth ウィザード + 🎟 招待リンク + 連携ステータス + 📧 連絡先一覧 + 👥 LINE グループ管理
👤 6. マイページ mypage.html
- 🪪 プロフィール — 氏名・カナ・所属・色など。アバター色は変更可
- 📞 連絡先・住所 — メール(社用)/ Gmail / 電話 / LINE ID(推奨) / 住所 / 緊急連絡先 / カレンダー ID
- 🔐 アカウント — ログイン情報 + パスワード変更(デモ)
- 📊 業務サマリ — 自分の今月のタスク完了率・日報提出率・コンディション平均
- 📋 申請・休暇履歴 — 自分の起票分すべて
- 🎖 権限 — 自分の権限詳細 + LV.MAXのみ「権限管理テーブル」(他者の昇格/降格)
📒 7. 会計・経理 accounting.html
- 📁 月別フォルダナビ — ◀ 2026年5月 ▶ + 📍 今月ボタン
- 📊 月次サマリ KPI 5 つ — 件数 / 税込 / 税抜 / 消費税 / 領収書添付率
- 🏷 税法準拠 12 カテゴリ — 会議費 / 接待交際費 / 旅費交通費 / 通信費 / 消耗品費 / 新聞図書費 / 広告宣伝費 / 水道光熱費 / 地代家賃 / 租税公課 / 支払手数料 / 雑費
- 🎯 会議費・接待交際費 — 出席者・場所・目的を必須記録(税法対応)
- 📷 領収書画像 — canvas で max 1200px / JPEG q70 自動圧縮 + ドラッグ&ドロップ + ライトボックス拡大
- 💴 消費税自動計算 — 10% / 8% / 0% を選択するだけ
- 📥 月次 CSV(税理士提出用) — UTF-8 BOM 付き、勘定科目別、Excel でそのまま開ける
💬 8. 社内 Q&A chatbot.html
- 📚 FAQ 10 件シード — 経費 / 出張 / 休暇 / 日報 / タスク / PW / カレンダー / 権限 / SightClean / 78カ国
- 🤖 isoAi(Anthropic Claude API) — 社内文脈に詳しい AI が質問に回答。OAuth 不要
- 📥 クリップボード自動取得 — Anthropic API Key をワンクリックで取込
- ⌨ Enter は改行のみ — 誤送信防止。送信は ⌘+Enter or 送信ボタン
- 💬 「これを質問」 — FAQ をクリックすると入力欄に挿入(自動送信なし、編集可能)
📩 9. LINE/メール 連絡(全画面共通)
4 つの送信チャネル
- 💬 LINE — LINE Share Sheet が起動 → 個人/グループ自由に選択して送信(PC・iPhone・Android 全対応)
- 👥 LINE グループ — 設定済みグループへ送信 / 招待 URL なしの場合は Share Sheet にフォールバック
- 📧 メール — 社用メール宛 + 個人 Gmail を CC で同報
- 📱 LINE + メール — 両方を順番に起動(同じメッセージ・サブジェクト)
起動できる場所
- 管理ダッシュボード → メンバーカード — 💬 ボタン(クイック LINE)+ 📩 ボタン(タスク依頼)
- 全タスクモーダル — 「💬 LINE で進捗確認」「📧 メールで連絡」「📩 新規タスク依頼」
- メンバープロフィール — 「💬 LINE で連絡」「📧 メール」
- 連絡先一覧テーブル — 各行に 💬/📧 ボタン + LINE ID 列
- 稟議・経費 承認/却下後 — 申請者へ自動で連絡ダイアログ起動
- タスク依頼後 — 受領者へ自動で連絡ダイアログ起動
- 通知センター(従業員側) — 各通知に 💬 LINE / 📧 メールボタン
- サポートチケット — 起票時 + 礒貝CEO のステータス更新時に自動通知
📮 10. お問い合わせ・バグ報告 support.html
- 🐛 バグ報告 — 動かない / エラーが出る / 表示が崩れる など
- 💡 機能リクエスト — 「こういう機能が欲しい」を礒貝CEO に直接届ける
- 💬 質問・相談 — 使い方が分からない時
- 🎨 デザイン改善 — 見た目・使いやすさの改善提案
フォームの項目
- 種類・重要度 — 4 段階(緊急 / 高 / 中 / 低)
- 発生画面 — どの画面で起きたかを選択(自動推定可)
- タイトル — 短く要点を
- 📌 何をしようとしましたか? / 👍 期待した動作 / 😵 実際の動作 / 🔁 再現手順 — 細かく書くほど直しやすい
- 📷 スクリーンショット — ドラッグ&ドロップ / クリック / iPhone 写真選択
- 🌐 自動取得情報 — デバイス・User Agent・起票者(送信時に自動添付)
送信後の流れ
- 礒貝CEO に LINE/メールで自動通知ダイアログが起動
- 礒貝CEO がステータスを「🔄 対応中」に変更 → コメントとともにあなたに通知
- 修正・実装 → 「✅ 解決」に変更 → 完了通知
⚡ 11. グローバル FAB(右下浮遊メニュー)
- 📋 タスク追加 / ⏰ スケジュール追加 / 📝 日報書く / 🏖 休暇申請 / 💴 経費申請
- 📒 会計記録 / 📩 タスク依頼(LV.MIDDLE 以上) / ✅ 承認(LV.MIDDLE 以上)
- 👥 チーム状況(LV.MIDDLE 以上) / 💬 Q&A 質問 / 👤 マイページ / 🏠 ホーム
🆘 12. 困ったときは
- 🔴 デモデータが古い — 管理ダッシュボード上部の「デモデータ初期化」ボタン or LocalStorage クリア + リロード
- 🟡 シード版番号(DATA_SEED_VERSION)アップ後 — リロード 1 回で自動マージ。ユーザー追加分は保持されます
- 🟢 OAuth エラー — Cloud Console の Client ID 設定を確認。招待・参加フロー を参照
- 🟢 isoAi が動かない — Anthropic API Key が未設定。chatbot.html の「📥 自動取得」から貼付
- 🟢 LINE 送信ができない — LINE アプリがインストールされているか確認。PC は LINE for Mac/Windows、モバイルは LINE アプリが必要
- 🔵 メールが起動しない — デフォルトメーラーが設定されているか OS 側で確認
- 🔵 上記で解決しない — 📮 お問い合わせ から礒貝CEO に直接連絡
🔑 API キー取得手順(本格運用前に設定)
すべて 管理ダッシュボード → ⚙ 設定 → 🔌 連携 + API キー設定 から登録可能。
🟢 Google OAuth Client ID(Google ログイン + カレンダー連携)
- Google Cloud Console にアクセス → ログイン
- プロジェクト作成 → 「API とサービス」→「OAuth 同意画面」 → 外部 / 必要事項入力
- 「認証情報」→「+ 認証情報を作成」→「OAuth クライアント ID」
- アプリケーションタイプ: 「ウェブアプリケーション」
- 承認済みの JavaScript 生成元に本番 URL を追加(例:
https://staff-manager.bcdc-ai.com/ 開発時はhttp://127.0.0.1:4321) - 承認済みのリダイレクト URIも同じ URL を追加
- 「作成」→ Client ID(
xxxx.apps.googleusercontent.com)をコピー - 本アプリの 管理ダッシュボード → ⚙ 設定 で「🟢 Google OAuth」欄に貼付 → 💾 保存
🤖 Anthropic API Key(isoAi / Claude API)
- console.anthropic.com にアクセス → ログイン
- 左メニュー 「API Keys」 → 「Create Key」
- キー名を入力(例:
ganecci-staff-manager)→ Create - 表示された
sk-ant-...をコピー(この画面でしか見れません) - 本アプリの 管理ダッシュボード → ⚙ 設定 で「🤖 Anthropic API」欄に貼付 → 💾 保存
使用上限を設定して暴走を防ぐのを推奨。
💬 LINE Login Channel(Phase 2 で有効化)
- LINE Developers Console にアクセス → ログイン
- 「新規プロバイダー作成」(or 既存を選択)→ プロバイダー名入力
- プロバイダー詳細画面 → 「新規チャネル作成」→「LINE Login」
- アプリ名・説明・アイコン・地域・メールアドレスを入力
- 作成後、「チャネル基本設定」 タブ:
- Channel ID(数字 10 桁前後)をコピー
- Channel Secret(英数 32 桁)をコピー
- 「LINE Login 設定」 タブ → Callback URL に
https://staff-manager.bcdc-ai.com/auth/line/callbackを追加 - 本アプリの 管理ダッシュボード → ⚙ 設定 で「💬 LINE Login」の Channel ID + Secret を保存
⚡ LIFF — LINE 実認証(Phase 1 で動く・推奨)
- LINE Developers Console にログイン → 上記の「💬 LINE Login Channel」手順 1〜5 でチャネルを作成
- そのチャネルの 「LIFF」 タブを開く → 「追加」
- LIFF アプリ設定:
- LIFF アプリ名:
Staff Manager - サイズ: Tall(中央表示)
- エンドポイント URL: 本番 https URL(例:
https://staff-manager.bcdc-ai.com/login.html) - Scope:
profile+openidをチェック - Bot 連携: On (Aggressive)(LINE 公式アカウントを連動させる場合)
- LIFF アプリ名:
- 作成後、表示される LIFF ID(例:
1234567890-AbCdEfGh)をコピー - 本アプリの 管理ダッシュボード → ⚙ 設定 → 🔌 連携 → 💬 LINE 実認証 (LIFF) 欄に貼付して保存
- これで login.html の「💬 LINE でサインイン」と マイページの「⚡ LIFF で自動連携」が本物の LINE 認証になります
http://127.0.0.1:4321 のローカル環境では liff.init がエラーになります。Vercel / Netlify / Cloudflare Pages 等にデプロイして本番 URL で動作確認してください。📩 LINE Notify トークン(個人/全社通知)
- notify-bot.line.me/my/ にアクセス → LINE アカウントでログイン
- 下にスクロール → 「トークンを発行する」
- トークン名を入力(例:
Staff Manager) - 通知先トークルームを選択:
- 1:1 で LINE Notify から通知を受け取る(個人通知用)
- または グループを選択(全社通知用)— その場合は事前に LINE Notify を該当グループに招待
- 「発行する」 → 表示された英数トークンをコピー(この画面でしか見れません)
- 個人用 → マイページ → 🔐 アカウント → 🔗 LINE 連携 → Notify トークン に貼付
- 全社用 → 管理ダッシュボード → ⚙ 設定 → 🔌 連携 の「📩 LINE Notify」欄に貼付
☁️ AWS デプロイ(S3 + CloudFront)
aws/README.md 参照。構成(Phase 1.5)
- S3: 静的ファイル(HTML / JS / CSS / 画像)のホスティング、非公開バケット
- CloudFront: HTTPS 配信 + キャッシュ + 全世界エッジ
- Origin Access Control (OAC): CloudFront → S3 を SigV4 で署名(旧 OAI 後継)
- SPA フォールバック: 404/403 →
index.htmlへ転送
5 ステップでデプロイ
- AWS CLI v2 インストール:
curl https://awscli.amazonaws.com/AWSCLIV2.pkg -o /tmp/aws.pkg && sudo installer -pkg /tmp/aws.pkg -target / - AWS アカウント + IAM ユーザ:
ganecci-deployer作成、ポリシー 4 つ付与(S3FullAccess / CloudFrontFullAccess / CloudFormationFullAccess / IAMReadOnlyAccess) - Credentials 設定:
aws configure(リージョン =ap-northeast-1) - デプロイ実行:
./aws/deploy.sh(初回 5〜10 分) - 本番 URL を LIFF と Google OAuth に登録(承認済み生成元 / エンドポイント URL)
日常運用
- コード更新後の再デプロイ:
./aws/sync.sh(1〜2 分で反映) - スタック完全削除:
./aws/destroy.sh(S3 バケット中身も含む)
400 invalid_request を返します。🏢 新規会社登録(マルチ会社運用)
登録手順(4 ステップ)
- ホーム画面 または FAB から「🏢 新規会社を登録」を開く
- Step 1: 会社名・代表者・ドメイン・ブランドカラー・ロゴを入力
- Step 2: 社員情報を入力(👔 役員 7 名テンプレ / 📋 CSV 一括貼付 / ➕ 個別追加 が選べる)
- Step 3: プロジェクトを登録(✨ 汎用セット使用可、空でも OK)
- Step 4: 内容確認 → 🚀 会社を登録 + 切替 をクリック → 即運用開始
登録後の切替
- 管理ダッシュボード → ⚙ 設定 → 🏢 会社プロファイル から登録済み会社の一覧と切替が可能
- 各会社のデータは 完全に独立(タスク・日報・社員・プロジェクト)
- 切替時はページ自動リロード → その会社のデータで運用開始
- 既定の「GANECCI」は削除不可、その他会社はいつでも削除可
📸 スクリーンショットの追加方法 (礒貝CEO 向け)
staff-manager/screenshots/ フォルダに JPG/PNG を置くだけで自動で実画像に差し替わります。- 各画面を開く → ⌘+Shift+4(Mac) or PrtScr(Windows) でスクショ
- ファイル名を以下のいずれかにリネーム:
screenshots/login.jpg
screenshots/index.jpg
screenshots/employee.jpg
screenshots/admin.jpg
screenshots/mypage.jpg
screenshots/accounting.jpg
screenshots/chatbot.jpg
screenshots/contact-dialog.jpg
screenshots/support.jpg staff-manager/screenshots/フォルダに保存(無ければ作成)- このガイドを再読み込み(Cmd+R) → 自動で画像が表示