MOSAIC

チームの稼働状況、プロジェクトの要員不足、過負荷を同じ時間軸で確認・調整できる、プロジェクトアサイン管理ツールです。誰のための道具か、既に決まった非目標、機能を足すときの判断基準は製品方針が唯一の出典です。

公開サイト

本番は Cloudflare Workers（Worker 名 mosaic）の https://mosaic.taps-desk.workers.dev/ です。切替期間中の旧 URL は GitHub Pages の凍結成果物 です。

主な機能

• 日付範囲と配分率を持つアサインボード
• プロジェクト、メンバー、4週から12か月までのレポートの連動表示
• 部門階層、主所属・兼務・責任者、組織別の検索と需給
• 欠員への候補者仮置きと、過負荷の推奨調整
• メンバー、プロジェクト、不足要員、アサインの登録・編集・取消・アーカイブ
• 保存前の変更確認と、保存済み状態を守る取り消し
• 検索、絞り込み、詳細ドロワー、レスポンシブ表示
• スキル分類ツリー、習熟度、組織のスキルマップ
• メンバー・プロジェクトのカスタム項目、一覧/詳細/検索への配置、業務経歴
• 受注前案件、要員計画、候補検討、受注時のプロジェクト引き継ぎ
• 保存した検索シーンと、必須/歓迎スキルによるスコアリングマッチング
• 任意項目の保存レポートと、メンバー・プロジェクトのグループ集計
• スキル・経歴の更新依頼と、本人提出・管理者確認
• Supabase Authによる招待制ログインと、組織ごとの共有ワークスペース
• Geminiをserver側から呼び出す、認証済み利用者向けAIチャット
• owner / admin / planner / viewerの権限分離
• 組織招待の登録・取消、利用者の権限変更・利用停止、変更前後を追える監査ログ
• 外部連携資格、バージョン付き外部API、Webhook通知
• 外部AI向けの Remote MCP Server（参照と確認付きの気づき送信）
• ロール別の項目・機能・参照範囲の権限設定
• AI秘書から承認済み外部MCPサーバーを参照するMCP Client
• revision比較による競合防止、冪等保存、Realtime更新通知

Supabase接続値が未設定の環境では、画面上にDEMOと表示し、サンプルデータだけをブラウザのlocalStorageへ保存します。接続済み環境でDB読込に失敗した場合はデモへ切り替えず、エラーとして停止します。

ローカル実行

npm ci
npm run dev

品質確認は次のコマンドで実行できます。

npm run lint
npm test
npm run typecheck

共有運用のセットアップ

業務データは非公開のapp schemaに置き、ブラウザは認証済みRPCだけを利用します。migration、Auth URL、GitHub Repository Variables、role別検証はSupabaseセットアップを参照してください。AIチャットのserver-side APIキー、ローカル実行、FunctionデプロイはAIチャット設定に記載しています。外部APIとWebhookは外部APIを参照してください。Remote MCP ServerはMCP Server、AI秘書から社外MCPへ接続する出口は外部MCP Clientを参照してください。リリース、バックアップ、障害対応は運用手順、認可とsecretの境界はセキュリティ方針、製品方針は製品方針に記載しています。

.env.localには公開可能な接続値だけを設定します。

VITE_SUPABASE_URL=https://PROJECT_REF.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=sb_publishable_REPLACE_ME
VITE_REQUIRE_SHARED_MODE=false
VITE_ENABLE_GOOGLE_AUTH=false

本番切替後はVITE_REQUIRE_SHARED_MODE=trueを設定します。これにより接続値が消えたデプロイをデモとして公開せず、設定エラーで停止します。

公開方法

Pull Requestではlint、unit/static test、build、dependency review、dependency auditに加え、隔離Postgresへmigrationを適用してrole/RLSを検証します。mainへの反映後、GitHub Actionsが静的ビルドを作成し、Cloudflare Workersへ自動公開します。

リリースごとの変更点はCHANGELOGを参照してください。