[11/30] mainへ (収支管理ダウンロード機能実装など)

Makefile

@@ -1,4 +1,5 @@
 # アプリコンテナ=view,api、DBコンテナ=db,minio
+include finansu.env
 
 # アプリコンテナのイメージのビルド
 build:
@@ -22,12 +23,20 @@ down:
 run-db:
 	docker compose -f compose.db.yml up -d
 
+# dbコンテナの起動 + マイグレーション + シードデータ投入
+run-db-init:
+	docker compose -f compose.db.yml up -d
+	./scripts/wait-for-mysql.sh
+	make migrate
+	make seed-db
+	@echo "Database initialization completed!"
+
 # dbコンテナの停止(ずっと起動したくない時はこっちで停止)
 stop-db:
 	docker compose -f compose.db.yml down
 
-# ビルドと起動
 build-run:
+# ビルドと起動
 	docker compose -f compose.db.yml up -d
 	docker compose up --build
 
@@ -37,7 +46,7 @@ del-vol:
 
 # 生成したコンテナ、イメージ、ボリューム、ネットワークを一括削除
 del-all:
-	compose down --rmi all --volumes --remove-orphans
+	docker compose down --rmi all --volumes --remove-orphans
 
 # ボリューム削除→ビルド→起動
 run-rebuild:
@@ -46,7 +55,7 @@ run-rebuild:
 
 # dbとminioの停止とボリューム削除(dbを初期化したい時)
 del-db:
-	compose -f compose.db.yml down --volumes
+	docker compose -f compose.db.yml down --volumes
 
 # apiの起動(db起動後)
 run-api:
@@ -97,7 +106,7 @@ run-swagger:
 	docker compose -f compose.swagger.yml up -d
 
 run-all:
-	make run-db
+	make run-db-init
 	make run
 	make run-swagger
 
@@ -106,3 +115,26 @@ gen-er:
 
 format:
 	docker compose run --rm view npm run format
+
+# マイグレーションの実行
+migrate:
+	docker compose -f compose.migrate.yml run --rm migrate \
+		--path /migrations \
+		--database "mysql://${NUTMEG_DB_USER}:${NUTMEG_DB_PASSWORD}@tcp(${NUTMEG_DB_HOST}:${NUTMEG_DB_PORT})/${NUTMEG_DB_NAME}" \
+		up
+
+# マイグレーションの実行(ダウングレード)
+migrate-down:
+	docker compose -f compose.migrate.yml run --rm migrate \
+		--path /migrations \
+		--database "mysql://${NUTMEG_DB_USER}:${NUTMEG_DB_PASSWORD}@tcp(${NUTMEG_DB_HOST}:${NUTMEG_DB_PORT})/${NUTMEG_DB_NAME}" \
+		down
+
+# マイグレーションファイルの作成
+create-migration:
+	./scripts/create_migration.sh
+
+# シードデータの投入
+seed-db:
+	docker compose -f compose.db.yml run --rm db bash ./scripts/seed.sh
+

README.md

@@ -1,43 +1,49 @@
 # FinanSu
 
-FinanSuは、NUTFes/NUTMegの財務管理システムです。OpenAPI駆動開発により、Go + Next.jsで構築されています。
+FinanSu は、NUTFes/NUTMeg の財務管理システムです。OpenAPI 駆動開発により、Go + Next.js で構築されています。
 
 ## 技術スタック (Tech Stack)
 
 ### Backend (API)
+
 - **Language**: Go 1.23+ with Echo framework
 - **Database**: MySQL 8.0 + GORM
 - **Storage**: MinIO (S3-compatible)
 - **Code Generation**: oapi-codegen (OpenAPI)
 - **Testing**: Go test with testfixtures
 
 ### Frontend (View)
+
 - **Framework**: Next.js 14 + React 18 + TypeScript
 - **UI**: Chakra UI + Tailwind CSS
 - **State Management**: Recoil with persistence
 - **Data Fetching**: SWR with generated hooks
 - **Code Generation**: Orval (OpenAPI to TypeScript)
 
 ### Infrastructure
+
 - **Container**: Docker + Docker Compose
 - **Development**: Hot reload with Air (Go) + Next.js dev server
 - **API Documentation**: Swagger UI
 
 ## 環境構築 (set up)
 
 ### 基本セットアップ
+
 ```bash
-make run-db      # データベース起動 (MySQL + MinIO)
+make run-db-init # データベース起動 (MySQL + MinIO)、マイグレーション実行、シードデータ追加
 make build       # アプリケーションビルド
 make run         # アプリケーション起動
 ```
 
 ### 全て一括起動
+
 ```bash
 make run-all     # DB + アプリ + Swagger UI
 ```
 
-### 直接Docker Composeを使用する場合
+### 直接 Docker Compose を使用する場合
+
 ```bash
 docker compose -f compose.db.yml up -d
 docker compose build
@@ -47,20 +53,23 @@ docker compose up
 ## 開発コマンド (Development Commands)
 
 ### コード生成 (重要)
+
 ```bash
 make gen         # OpenAPI仕様からAPI/フロントエンドコード生成
 make gen-api     # Go serverコード生成
 make gen-front-api # TypeScript hooks生成
 ```
 
 ### テスト・品質チェック
+
 ```bash
 make run-test    # Go APIテスト実行
 make run-eslint  # フロントエンドLint実行
 make format      # コードフォーマット
 ```
 
 ### その他の便利コマンド
+
 ```bash
 make run-sb      # Storybook起動
 make ent-db      # MySQLシェルへ接続
@@ -71,6 +80,7 @@ make seed        # データベースシード実行
 ## 開発環境詳細
 
 ### ポート設定
+
 - **Frontend**: http://localhost:3000
 - **API**: http://localhost:1323
 - **Database**: localhost:3306
@@ -151,12 +161,13 @@ graph TB
 
 ### アーキテクチャの特徴
 
-1. **OpenAPI駆動開発**: 全ての型安全性がOpenAPI仕様から生成
+1. **OpenAPI 駆動開発**: 全ての型安全性が OpenAPI 仕様から生成
 2. **Clean Architecture**: バックエンドは依存関係逆転により保守性を確保
 3. **型安全性**: フロントエンドからバックエンドまで一貫した型チェック
-4. **コンテナ化**: Docker Composeによる一貫した開発環境
+4. **コンテナ化**: Docker Compose による一貫した開発環境
 
 ### プロジェクト構造
+
 ```
 /api/               # Go backend (Clean Architecture)
   ├── main.go       # エントリーポイント
@@ -177,13 +188,15 @@ graph TB
 
 ## 開発ワークフロー
 
-### OpenAPI駆動開発
-1. `/openapi/openapi.yaml` を編集してAPI変更
-2. `make gen` でGo serverコードとTypeScript hooksを再生成
-3. サーバーサイドロジックをcontrollers/use casesで実装
-4. 生成されたhooksをReactコンポーネントで使用
+### OpenAPI 駆動開発
+
+1. `/openapi/openapi.yaml` を編集して API 変更
+2. `make gen` で Go server コードと TypeScript hooks を再生成
+3. サーバーサイドロジックを controllers/use cases で実装
+4. 生成された hooks を React コンポーネントで使用
 
 ### 環境管理
+
 - **開発**: `compose.yml`
 - **ステージング**: `compose.stg.yml`
 - **本番**: `compose.prod.yml`
@@ -192,38 +205,44 @@ graph TB
 ## ドキュメント (Documents)
 
 ### プロジェクト概要
+
 - [FinanSu について](https://www.notion.so/nutfes-nutmeg/FinanSu-6f207506947b475aad3610210016a8a3) - 背景・目的や技術仕様
 - [FinanSu 開発ガイド](https://www.notion.so/nutfes-nutmeg/FinanSu-OK-3a12e725374742608959b6bac61d702c) - 開発全般の情報
 
 ### 開発ルール
-- [Git ワークフロー](https://www.notion.so/nutfes-nutmeg/git-clone-41a4a1a2df324c92a56b6d0b1b244747) - 開発時のGit使用手順
+
+- [Git ワークフロー](https://www.notion.so/nutfes-nutmeg/git-clone-41a4a1a2df324c92a56b6d0b1b244747) - 開発時の Git 使用手順
 - [Git/GitHub 基本操作](https://www.notion.so/nutfes-nutmeg/Git-Github-478cabf96e3e44909e35b3476fe08886)
 - [ブランチルール](https://www.notion.so/nutfes-nutmeg/9d1646b47e184ab1b85b35e02de76e3f)
 - [コミットルール](https://www.notion.so/nutfes-nutmeg/f4ace67ac1c14d849aee084327914c0f)
 
 ### API・技術仕様
+
 - [API 一覧](https://www.notion.so/nutfes-nutmeg/FinanSu-API-92b657ec9ff64157be94486fbfc8382f)
 - [OpenAPI 仕様書](http://localhost:1323/swagger/index.html) - 開発中にアクセス可能
 - [Storybook](http://localhost:6006) - コンポーネントドキュメント
 
 ### 関連記事
+
 - [FinanSu タグ記事一覧](https://www.notion.so/nutfes-nutmeg/FinanSu-db5914909df34786b7f1e4a205ebfea7)
 
 ## AI 開発支援
 
 このプロジェクトは AI アシスタント（Claude Code、GitHub Copilot）による開発を支援しています。
 
 - **CLAUDE.md** - Claude Code 用の開発ガイダンス
-- **GitHub Copilot** - カスタム指示付きコード支援（日本語ITギャル設定）
+- **GitHub Copilot** - カスタム指示付きコード支援（日本語 IT ギャル設定）
 
 ## 重要な注意事項
 
 ### コード生成の依存関係
-- OpenAPI仕様を変更したら必ず `make gen` を実行
+
+- OpenAPI 仕様を変更したら必ず `make gen` を実行
 - 生成されたコードは手動で編集しない
-- 型安全性はOpenAPI仕様からバックエンド・フロントエンドに流れる
+- 型安全性は OpenAPI 仕様からバックエンド・フロントエンドに流れる
 
 ### 品質管理
+
 - フロントエンドコミット前に `make run-eslint` と `make format` を実行
-- APIテストは `make run-test` で実行
-- PRは `.github/pull_request_template.md` テンプレートを使用
+- API テストは `make run-test` で実行
+- PR は `.github/pull_request_template.md` テンプレートを使用