next-app-router-output-crud-api

技術構成

フロントエンド

• typescript: 5.0.0
• next: 15.1.7
• react: 19.0.0
• react-dom: 19.0.0
• react-route: 7.1.5
• react-hook-form: 7.54.2
• zod: 3.24.2
• @hookform/resolvers: 4.0.0
• @fortawesome/react-fontawesom: 0.2.2
• @fortawesome/free-solid-svg-icons: 6.2.2

バックエンド

• go: 1.23.5
• gorm: 1.25.12
• gorilla/mux: 1.8.1
• gorilla/handlers: 1.5.2

その他

• docker
• postgres: 17.2

仕様

• Todo リスト
  • 一覧表示
  • 検索処理
  • 新規登録処理
  • 詳細表示
  • 編集処理
  • 削除処理

環境構築

※docker を使用しているので PC に入っていない場合はインストールをお願いします。

https://matsuand.github.io/docs.docker.jp.onthefly/desktop/mac/install/

1. docker image を作成

• .env.sample をコピーして.env を作成

touch .env

• docker build を実行

docker-compose build

2. コンテナを起動

// バックエンド、DBのコンテナを起動する
docker-compose up -d

3. マイグレーション、シーディング (テーブル、データ作成)

• backend/.env.local.sample をコピーして、backend/.env.local を作成

touch backend/.env.local

• migration 実行

cd backend
make migrate

• データ作成(seeding)

make seed

4. ブラウザに表示

• frontend/.env.sample をコピーして、frontend/.env を作成

touch frontend/.env

• フロントエンドのアプリを起動

cd frontend

npm run dev

url: http://localhost:3000

補足

DB 関連の情報

• 以下の情報を元に「sequel ace」などを用いて DB コンテナにアクセスすれば、DB のデータの状態を確認できる

DBMS: Postgres
host: 127.0.0.1
database: NEXT_APP_ROUTER_OUTPUT_CRUD_API_DB
user: user
password: pass
port: 5432

• DBeaver について
• https://zenn.dev/aiq_dev/articles/2629b53f1298bc

DB のデータを初期化したい場合

cd backend
make rollback

コンテナのログを確認したい場合

バックエンド、DB コンテナのログを確認する方法

1. コンテナ ID を確認

コンテナを起動している状態で、以下のコマンドでコンテナ ID(CONTAINER ID)を確認する。

docker ps

各イメージに対応する コンテナ ID を確認

• バックエンド: next-app-router-output-crud-api-backend
• DB: postgres:17.2

以下のコマンドで各コンテナのログを確認

docker logs -f [コンテナID]