注意: 本プロジェクトは学習・技術検証を目的とした 架空のプロジェクト です。 実在する組織・製品・申請データとは一切関係ありません。
製品・申請・タスク・販売国を横断して進捗・遅延を可視化し、医療機器の規制申請業務を支援するシステム。
| レイヤー | 技術 |
|---|---|
| フロントエンド | React (CSR + MUI) + TypeScript / Vite |
| ルーティング | TanStack Router |
| サーバー状態管理 | TanStack Query |
| クライアント状態管理 | Zustand |
| バックエンド | Node.js + NestJS + TypeScript |
| ORM | Prisma |
| データベース | SQL Server |
| バリデーション | zod(全レイヤー共通) |
設計方針: オフラインファースト / Local-first データ管理
仕様の Single Source of Truth は docs/ です。
| パス | 内容 |
|---|---|
docs/requirements/ |
要件定義 |
docs/design/ |
設計書(基本設計・詳細設計・DB) |
docs/flows/ |
フロー設計 |
docs/guides/ |
開発ガイド |
docs/decisions/ |
設計判断記録 (ADR) |
docs/reviews/ |
アーキテクチャレビュー記録 |
| ファイル | 内容 |
|---|---|
development.md |
セットアップ・開発コマンド・CI |
code-review-checklist.md |
コードレビューチェックリスト(SSOT) |
first-feature-tutorial.md |
最初の機能を作るチュートリアル |
glossary.md |
ドメイン用語・技術用語の定義 |
test-plan.md |
テスト計画・テスト種別と範囲 |
| パス | 内容 |
|---|---|
.github/GUIDE.md |
チーム開発ガイド(人間向け・AI ツール利用法) |
.github/copilot-instructions.md |
Copilot 用ルール設定(AI 自動読み込み) |
.github/instructions/ |
タスク別手順書(AI + 人間参照可) |
.github/agents/ |
AI エージェント定義 |
.github/prompts/ |
再利用可能プロンプト(/scaffold 等) |
.github/skills/ |
AI 専門知識モジュール |
.github/hooks/ |
Git フック設定(L1 パターンチェック等) |
.github/CHANGELOG.md |
.github/ 規約変更履歴 |
ドキュメントの整備順序は
docs/guides/development.md「ドキュメント整備ロードマップ」を参照してください。
前提条件: Node.js v22 以上・pnpm v9 以上・SQL Server が起動済みであること。 初回セットアップの詳細(Docker・環境変数設定を含む)は
docs/guides/development.mdを参照してください。
pnpm install # 依存パッケージをインストール(初回のみ)
pnpm dev # バックエンド (port 3001) とフロントエンド (port 5173) を同時起動起動後、ブラウザで http://localhost:5173 を開いてください。
全コマンド(個別起動・テスト・Lint・Prisma 等)は
docs/guides/development.mdを参照してください。
task-manager/
├── .github/ # Copilot instructions・ワークフロー設定
├── docs/ # 仕様・設計書(要件・設計・ADR・ガイド等)
├── scripts/ # L1/L2 パターンチェックスクリプト
└── azure-pipelines.yml # CI パイプライン定義(TFS Gated Check-in)
実装フェーズ以降の構成予定
task-manager/ ├── packages/ │ ├── shared/ # Zod スキーマ・共有型定義 │ ├── backend/ # Node.js + NestJS REST API(Prisma + SQL Server) │ └── frontend/ # React CSR + MUI(Vite) └── prisma/ # Prisma スキーマ・マイグレーション履歴
本プロジェクトへの参加方法は CONTRIBUTING.md を参照してください。
Private