0. プロジェクトフォルダ構成

joinup/ ├── README.md ├── docker-compose.yml # Docker Compose設定 ├── init.sql # データベース初期化 ├── frontend/ # Next.jsフロントエンド │ ├── Dockerfile │ ├── package.json │ ├── next.config.js │ ├── tailwind.config.js │ ├── postcss.config.js │ └── src/ │ ├── app/ # App Router │ │ ├── layout.js # 共通レイアウト │ │ ├── page.js # トップページ │ │ ├── register/ # ユーザー登録 │ │ ├── matching/ # マッチング・検索 │ │ ├── profile/ # プロフィール表示 │ │ ├── mypage/ # マイページ │ │ ├── freelancers/ # フリーランサー詳細 │ │ └── communities/ # コミュニティ詳細 │ ├── components/ # 共通コンポーネント │ │ ├── Header.js │ │ └── Footer.js │ └── lib/ │ └── api.js # APIクライアント └── backend/ # FastAPI バックエンド ├── Dockerfile ├── requirements.txt ├── main.py # FastAPIアプリケーション ├── database.py # データベース設定 ├── models/ # データモデル │ ├── user.py │ └── matching.py └── routers/ # APIルーター ├── users.py ├── communities.py └── matching.py

1. Dockerインストール（Mac用）

• brew install docker （実行失敗する場合：arch -arm64 brew install docker）

2. Colimaインストール（Mac用）

• brew install colima （実行失敗する場合：arch -arm64 brew install colima）

Colima起動

• colima start --cpu 4 --memory 8　# メモリ指定バージョン （メモリ未指定での実行：colima start）

2. Docker操作

アプリケーション起動

docker compose up -d （プロジェクトルートディレクトリに移動して実行）

Webリンクにアクセスしてアプリケーション起動確認

http://localhost:3000

アプリケーション停止

docker compose down

完全リセット（ボリュームも削除）

docker compose down -v

Docker操作チートシート（おまけ）

ログ確認

docker compose logs -f [frontend|backend|db]

q 再ビルド

docker compose up --build -d

キャッシュクリア

docker system prune -f

実行確認

docker compose ps

API確認（おまけ）

ヘルスチェック

curl http://localhost:8000/health

フリーランサー一覧

curl http://localhost:8000/api/users/freelancers

コミュニティ一覧

curl http://localhost:8000/api/users/communities

注目のコミュニティ

curl http://localhost:8000/api/communities/featured

データベース操作（おまけ）

データベース接続

docker compose exec db psql -U joinup -d joinup_db

テーブル確認

docker compose exec db psql -U joinup -d joinup_db -c "\dt"

サンプルデータ確認

docker compose exec db psql -U joinup -d joinup_db -c "SELECT * FROM users;"