Skip to content

BlackDonut/task-manager-ts

Repository files navigation

医療機器国際申請管理システム

注意: 本プロジェクトは学習・技術検証を目的とした 架空のプロジェクト です。 実在する組織・製品・申請データとは一切関係ありません。

製品・申請・タスク・販売国を横断して進捗・遅延を可視化し、医療機器の規制申請業務を支援するシステム。

概要

レイヤー 技術
フロントエンド 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/ アーキテクチャレビュー記録

docs/guides/ の主要ファイル

ファイル 内容
development.md セットアップ・開発コマンド・CI
code-review-checklist.md コードレビューチェックリスト(SSOT)
first-feature-tutorial.md 最初の機能を作るチュートリアル
glossary.md ドメイン用語・技術用語の定義
test-plan.md テスト計画・テスト種別と範囲

.github/ — AI 駆動開発の設定

パス 内容
.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

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors