📋 プロジェクト引き継ぎ資料

作成日: 2026年2月20日 | 対象: C:\Users\kawag\work 配下の全プロジェクト

1. 全体概要

このドキュメントについて

Claude Code(AI コーディングツール)を活用して開発・運用しているプロジェクト群の引き継ぎ資料です。
管理者向けの概要と、エンジニア向けの技術詳細の両方を含みます。

プロジェクト規模

項目数値
プロジェクト総数25件
種別数6種(HP / Webアプリ / モバイル / デスクトップ / 自動化 / 動画)
使用技術数26種
作業ディレクトリC:\Users\kawag\work

種別ごとの内訳

種別件数説明主な利用者
🌐 ホームページ3企業・クリニックの情報公開サイト一般閲覧者・患者
💻 Webアプリ15ブラウザで操作する業務・医療アプリスタッフ・セラピスト
📱 モバイルアプリ1スマホにインストールして使用患者・セラピスト
🖥️ デスクトップアプリ1PCにインストールして使用スタッフ
⚙️ 自動化ツール4バックグラウンドで自動実行(自動)
🎬 動画制作1コードから動画を自動生成スタッフ

デプロイ先の分布

プラットフォーム件数用途
Vercel5Next.js / Vite アプリのホスティング
Cloudflare (Workers/Pages)4静的サイト・Workerアプリ
Firebase3認証・データベース・ホスティング
Static (自己ホスト)7静的ファイル配信
その他6Docker, Desktop, CLI, GitHub Actions 等

2. プロジェクト一覧(使う側の視点)

🌐 ホームページ(3件)

プロジェクト名説明デプロイ先最終更新
hirakata-pt-hpひらかた理学療法クリニック 公式HPCloudflare Pages2026-02-04
kawaguchi-ns-hp川口脳神経外科リハビリ 健康経営HPStatic2026-02-13
full-lafu-corporate株式会社フルラフ コーポレートサイトCloudflare2026-02-16

💻 Webアプリ - 認知症・認知機能スクリーニング(4件)

プロジェクト名説明デプロイ先最終更新
dementia-cf-suite認知症リスク評価スイート(CF版・Lancet 2024論文ベース)Cloudflare2026-02-17
dementia-risk-check認知症リスク評価(簡易版)Static2026-02-06
dementia-risk-suite認知症リスク+認知機能テスト統合版Static2026-02-06
drawing-cognitive-test描画タスクによる認知機能スクリーニングCloudflare2026-02-20

💻 Webアプリ - 医療評価・リスクチェック(5件)

プロジェクト名説明デプロイ先最終更新
dysphagia-risk-check嚥下障害リスク評価Static2026-02-06
rokomo-check-appロコモ評価(ロコモ25・立ち上がり・2ステップ)Static2026-02-17
suita-stroke-risk脳卒中リスク評価(吹田スコア)Static2026-02-06
updrs-trackerUPDRS Part III 運動機能評価・可視化Vercel2026-02-17
rehab-fee-calculatorリハビリ料金シミュレーターVercel2026-02-06

💻 Webアプリ - 業務管理・DX(6件)

プロジェクト名説明デプロイ先最終更新
endai-system包括的医療DXシステム(QR・PDF・Stripe)Vercel2026-02-17
bento_order_web弁当注文システムVercel2026-02-17
productivity-health-survey健康アンケート・労働生産性計算Static2026-02-17
visitcare訪問介護管理(スケジュール・請求)Vercel2026-02-14
conference-app学会・カンファレンス管理Docker2026-02-14
webapp-security-checkerWebアプリ セキュリティ診断Static2026-02-06

📱 モバイル / 🖥️ デスクトップ / ⚙️ 自動化 / 🎬 動画

種別プロジェクト名説明最終更新
📱rehab_monitoring_projectリハビリモニタリング(歩数・Health連携)2026-02-14
🖥️VoiceClipオフライン音声入力ツール2026-02-18
⚙️abstract-extractor論文アブストラクト自動抽出2026-02-02
⚙️pdf-literature-systemPDF文献管理・Markdown変換2026-02-18
⚙️supabase-keep-aliveSupabase pause防止2026-02-17
⚙️dashboard_deployダッシュボード自動生成2026-02-20
🎬remotion-videosRemotion 動画自動生成2026-01-26
📄everything-claude-codeClaude Code 設定集2026-01-19

3. 各プロジェクト詳細(エンジニア向け)

クリックで展開して詳細を確認できます。

4. 開発環境セットアップ

必須ソフトウェア

ソフトウェア用途備考
Node.js (v20+)Webアプリ全般のビルド・実行npm 同梱
Python (3.10+)VoiceClip, 抄録抽出, 文献管理pip 同梱
Gitバージョン管理GitHub連携
VSCodeコードエディタClaude Code 拡張機能推奨
Wrangler CLICloudflare デプロイnpm i -g wrangler
Firebase CLIFirebase デプロイnpm i -g firebase-tools
Vercel CLIVercel デプロイnpm i -g vercel

Flutter 環境(モバイルアプリ用)

項目
Flutter SDK パスC:/flutter/bin/flutter.bat
Android minSdkAPI 26 (Android 8.0)
APK ビルドC:/flutter/bin/flutter.bat build apk --release

作業ディレクトリ構造

C:\Users\kawag\
├── work\              ← Claude Code 作業用(自由アクセス可)
├── shared_data\       ← 匿名化データ(R/Python スクリプト経由のみ)
├── personal_data\     ← 個人情報(完全アクセス禁止)
└── .claude\           ← Claude Code 設定ファイル
    ├── CLAUDE.md      ← グローバル指示
    ├── agents/        ← カスタムエージェント
    ├── rules/         ← ルール設定
    └── settings.json  ← 権限・フック設定
⚠️ 重要: personal_data/ は個人情報を含むため、Claude Code からの直接アクセスは禁止されています。shared_data/ も R/Python スクリプト経由でのみアクセス可能です。

5. 運用・デプロイ手順

共通パターン: Vite + React アプリ

大半のWebアプリは以下の手順で開発・デプロイできます:

操作コマンド
依存関係インストールnpm install
開発サーバー起動npm run dev
ビルドnpm run build
E2Eテストnpx playwright test

デプロイ先別手順

Vercel(endai-system, visitcare, updrs-tracker, rehab-fee-calculator, bento_order_web)

Git push で自動デプロイ。手動の場合: vercel --prod

Cloudflare Workers/Pages(dementia-cf-suite, drawing-cognitive-test, hirakata-pt-hp, full-lafu-corporate)

wrangler login でログイン
npm run build でビルド
wrangler deploy でデプロイ
※ D1 データベースがある場合: wrangler d1 execute DB名 --file=./db/schema.sql

Firebase(bento_order_web, drawing-cognitive-test)

firebase login でログイン
npm run build でビルド
firebase deploy でデプロイ

Flutter APK(rehab_monitoring_project)

flutter pub get
flutter build apk --release
③ APK: build\app\outputs\flutter-apk\app-release.apk

自動化ツールの運用

ツール実行方法頻度
supabase-keep-aliveGitHub Actions で自動実行定期(cron)
dashboard_deploy手動またはスクリプト必要時
abstract-extractorpython main.py論文追加時
VoiceCliprun_voiceclip.bat または python main.py常時起動

6. セキュリティ・個人情報保護

⚠️ 医療法人のシステムです。以下のルールは必ず遵守してください。

データ管理ルール

フォルダ内容アクセス制限
personal_data/個人情報(氏名・住所等)🔴 完全アクセス禁止
shared_data/匿名化済みデータ🟡 R/Python スクリプト経由のみ
work/コード・集計結果🟢 自由にアクセス可

禁止事項

環境変数の管理

各プロジェクトの機密情報は .env / .env.local で管理しています。
これらのファイルは Git にコミットしません(.gitignore で除外済み)。
新しい環境にセットアップする際は、各プロジェクトの .env.example を参考に作成してください。

主要な環境変数一覧

プロジェクト必要な環境変数
endai-systemNEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, RESEND_API_KEY
bento_order_webVITE_FIREBASE_* (6項目), VITE_EMAIL_WORKER_URL
visitcareNEXT_PUBLIC_FIREBASE_* (client), FIREBASE_ADMIN_* (server)
updrs-trackerVercel Postgres接続文字列, Google APIs
rokomo-check-appVITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY
drawing-cognitive-testFirebase Config (6項目)

7. よくあるトラブルと対応

🔴 npm install でエラーが出る

① Node.js のバージョンを確認(v20+ 推奨)
node_modulespackage-lock.json を削除して再実行
npm cache clean --force

🔴 ビルドが失敗する

① TypeScript エラーの場合: npx tsc --noEmit でエラー箇所を特定
② 環境変数不足の場合: .env ファイルの設定を確認
③ Claude Code の build-error-resolver エージェントで自動修正可能

🔴 Cloudflare デプロイが失敗する

wrangler whoami でログイン状態を確認
wrangler.toml / wrangler.jsonc の設定を確認
③ D1 データベースがある場合、マイグレーション実行を確認

🔴 Supabase プロジェクトが停止した

supabase-keep-alive の GitHub Actions が正常に動作しているか確認。
手動復旧: Supabase ダッシュボードにログインし、プロジェクトを Resume。

🔴 Flutter ビルドが失敗する

flutter doctor で環境チェック
flutter clean && flutter pub get
③ Android SDK / Gradle のバージョン不一致が多い

8. 連絡先・参照資料

参照ドキュメント

ドキュメント場所
Claude Code グローバル設定C:\Users\kawag\.claude\CLAUDE.md
アクセシビリティガイドラインC:\Users\kawag\work\accessibility-guidelines.md
全体マップ(ダッシュボード)C:\Users\kawag\work\project-dashboard.html
PowerPoint テンプレートC:\Users\kawag\Downloads\雛形\元\
Health連携 作業記録C:\Users\kawag\work\rehab_monitoring_project\作業記録_Health連携機能.md

外部サービスのダッシュボード

サービスURL用途
Vercelhttps://vercel.com/dashboardWebアプリのデプロイ管理
Cloudflarehttps://dash.cloudflare.comHP・Workers のデプロイ管理
Firebasehttps://console.firebase.google.com認証・DB・ストレージ管理
Supabasehttps://supabase.com/dashboardPostgreSQL DB管理
GitHubhttps://github.comソースコード管理
📌 補足: 各サービスのログイン情報は、引き継ぎ時に直接共有してください。この資料には記載しません。

Claude Code の使い方

このプロジェクト群は Claude Code を活用して開発されています。引き継ぎ後も Claude Code を使って保守・開発を続けることを推奨します。

操作方法
起動VSCode で Claude Code 拡張機能を使用、またはターミナルで claude
設定~/.claude/CLAUDE.md にグローバル設定
スキル/do(タスク開始), /done(完了・動画確認), /commit
参考everything-claude-code プロジェクトに設定例集あり