PlanMagic

ローカルタスク

日常的な操作は just 経由で実行します。利用可能な recipe は次で確認できます。

just --list

たとえば just dev で開発環境を起動し（現状の既知の制限は下記 Note 参照）、just check で format/lint、just test でテスト、just verify で一通りの検証を実行できます。

PlanMagic is a Cloudflare-native project planning application combining fast work-item workflows with dependency-aware scheduling and a production-grade Gantt experience.

Documentation

• Architecture
• Runtime configuration

The backend serves its OpenAPI 3.1 document at /api/v1/openapi.json. After changing an API route or schema, run bun run openapi:generate; CI verifies the committed document and frontend generated types with bun run openapi:check.

Local trial

just trial

内部で install → db-schema-apply-local → preview-e2e（build-local を含む）を順に実行します。 個別に実行したい場合は次のように分割できます。

just install
just db-schema-apply-local
just build-local
just preview-e2e

db-schema-apply-local は backend/schema.sql をローカル D1 に宣言的に適用します。既存のローカル D1 データは作り直されるため消えます。詳細は backend/MIGRATIONS.md を参照 してください。

Open http://127.0.0.1:5173. The local environment exposes only the development sign-in adapter; preview and production require the configured OAuth provider.

Note: just dev（vite dev + @cloudflare/vite-plugin）は本来 HMR 付きで Worker と SPA を 起動する recipe ですが、現状 Bun 環境では起動処理がハングし 5173 が開きません。Bun の WebSocket 実装が ws の upgrade / unexpected-response イベントに未対応で、Vite ↔ workerd 間の dev-time 通信が成立しないためです（[bun] Warning: ws.WebSocket 'upgrade' event is not implemented in bun）。動作確認や E2E テストは just trial（内部的には preview-e2e）を利用して ください。変更を送る前は just verify、Bun.WebView の画面確認は just test-ui-e2e、D1 migration の前方適用確認は just test-db-migrations、backend/schema.sql と migration の 整合性確認は just test-schema-drift を実行します。