Laravel製のフリマアプリです。プログラミングスクールの卒業課題として、要件定義から設計・実装、 Docker環境構築、本番環境へのデプロイまで一通り制作しました。
- URL:https://flea-market-hfk0.onrender.com
- ログインせずに商品一覧・検索・商品詳細は閲覧できます。
- 出品・購入・チャット等の機能を試す場合は、下記「ダミーデータ」のアカウントでログインしてください。
(準備中。画面キャプチャやGIFを追加予定です)
| 商品一覧 | 商品詳細 | 取引チャット |
|---|---|---|
| (準備中) | (準備中) | (準備中) |
- 会員登録・ログイン(Laravel Fortify)
- 商品一覧表示・キーワード検索
- 商品詳細表示・コメント投稿・いいね(お気に入り)
- 商品出品(画像アップロード)
- 商品購入(配送先住所の一時変更、購入完了までの導線)
- マイページ(プロフィール編集・アイコン画像アップロード、出品/購入/いいね商品一覧)
- 取引チャット(メッセージの送信・編集・削除、取引完了操作、未読通知)
- 取引完了後の相手ユーザーへの評価(5段階評価)
商品閲覧から出品・購入・取引チャット・評価まで、画面がどうつながっているかの全体像です。
flowchart TD
Register[会員登録] --> Login[ログイン]
Login --> List[商品一覧 / 検索]
List -->|商品をクリック| Detail[商品詳細]
Detail -->|コメント投稿・いいね| Detail
Detail -->|購入する| Purchase[購入手続き]
Purchase -->|購入する| MypageBuy[購入完了 / マイページ]
Detail -->|出品者にチャット| Chat[取引チャット]
MypageBuy -.->|取引チャットへ| Chat
Chat -->|取引を完了する + 評価| Complete[評価登録 / 完了通知メール]
List -->|出品する| Sell[商品出品]
Sell --> List
特に処理が複雑な「商品購入」と「取引チャット〜評価完了」は、二重送信防止のための
行ロック(lockForUpdate)を挟んでいるため、シーケンス図で流れを示します。
sequenceDiagram
actor Buyer as 購入者
participant View as 購入画面
participant Ctrl as PurchaseController
participant DB as DB (items / purchases)
Buyer->>View: 商品詳細から「購入手続きへ」
View->>Ctrl: GET /purchase/{item_id}
Ctrl->>DB: 商品情報を取得
DB-->>Ctrl: 商品情報
Ctrl-->>Buyer: 購入画面を表示(配送先・支払い方法)
Buyer->>Ctrl: 「購入する」をクリック(POST /purchase/{item_id})
activate Ctrl
Ctrl->>DB: トランザクション開始 + items行をロック取得
alt 既に売却済み(連打・多重送信)
Ctrl->>DB: 何もせずロールバック
else 未売却
Ctrl->>DB: purchasesにレコード作成
Ctrl->>DB: items.is_sold を true に更新してコミット
end
deactivate Ctrl
Ctrl-->>Buyer: マイページ(購入した商品一覧)へリダイレクト
sequenceDiagram
actor Buyer as 購入者
actor Seller as 出品者
participant Ctrl as ChatController
participant DB as DB (chats / chat_messages / ratings)
participant Mail as メール送信
Buyer->>Ctrl: メッセージ送信
Ctrl->>DB: chat_messages作成 / 未読通知を更新
Ctrl-->>Seller: 未読通知バッジを表示
Seller->>Ctrl: 返信メッセージ送信
Ctrl->>DB: chat_messages作成 / 未読通知を更新
Ctrl-->>Buyer: 未読通知バッジを表示
Buyer->>Ctrl: 「取引を完了する」+ 評価スコア送信
activate Ctrl
Ctrl->>DB: トランザクション開始 + chats行をロック取得
alt 既に評価済み(連打・多重送信)
Ctrl->>DB: 何もせずロールバック
else 未評価
Ctrl->>DB: ratingsにレコード作成
Ctrl->>DB: chats.is_completed を true に更新してコミット
Ctrl->>Mail: 相手ユーザーに完了通知メールを送信
opt メール送信に失敗した場合
Ctrl->>Ctrl: エラーログに記録するのみで処理は継続(500エラーにしない)
end
end
deactivate Ctrl
Ctrl-->>Buyer: トップページへリダイレクト
- 出品→購入→取引チャット→評価まで、実際のフリマサービスに近い一連の取引の流れを一通り実装しました。
- 購入・評価は連打や通信の遅延・リトライで多重登録されないよう、
DB::transaction+lockForUpdateによる行ロックで二重送信を防止しています(上記シーケンス図の分岐部分)。仕様書には無い対応です。 - バリデーションはコントローラに直書きせず、
FormRequest(ItemRequest、PurchaseRequest、CommentRequestなど)に分離し、見通しを良くしています。 - 取引チャットはメッセージの編集・削除や取引完了操作、未読通知まで含めて実装し、単なる一覧・詳細のCRUDで終わらないようにしました。
- 案件シートのテストケース一覧・機能要件をもとにしたFeatureテスト(71件)を整備し、GitHub Actionsで push・PR時に自動実行するようにしています。
- ローカル開発はDocker(nginx + PHP-FPM + MySQL)で環境差異なく再現できるようにし、本番はRender + Neon(PostgreSQL)で無料の範囲で公開できる構成にしています。
- 本番用の接続情報やAPP_KEYはコードに含めず、すべて環境変数経由で読み込む形にしています。
| 分類 | 技術 |
|---|---|
| 言語 | PHP 8.2 |
| フレームワーク | Laravel 9.52.18 |
| 認証 | Laravel Fortify |
| ローカルDB | MySQL 8.0.26(Docker) |
| 本番DB | PostgreSQL(Neon) |
| Webサーバー | nginx(ローカル) / Apache(本番Dockerイメージ) |
| インフラ(ローカル) | Docker / docker-compose |
| インフラ(本番) | Render(Dockerデプロイ) |
| その他 | MailHog(開発時のメール確認) |
erDiagram
users ||--o{ items : "出品する"
users ||--o{ likes : "いいねする"
items ||--o{ likes : "いいねされる"
users ||--o{ comments : "投稿する"
items ||--o{ comments : "コメントされる"
users ||--o{ purchases : "購入する"
items ||--o{ purchases : "購入される"
categories ||--o{ item_categories : ""
items ||--o{ item_categories : ""
users ||--o{ chats : "buyer"
users ||--o{ chats : "seller"
items ||--o{ chats : ""
chats ||--o{ chat_messages : ""
users ||--o{ chat_messages : "sender"
chats ||--o{ chat_notifications : ""
users ||--o{ chat_notifications : "receiver"
users ||--o{ ratings : "evaluator"
users ||--o{ ratings : "evaluated"
items ||--o{ ratings : ""
users {
bigint id PK
string user_name
string email
string password
string profile_image
string postal_code
string address
string building
}
items {
bigint id PK
bigint user_id FK
string item_name
text description
int price
string brand_name
tinyint status
string item_image
boolean is_sold
}
likes {
bigint id PK
bigint user_id FK
bigint item_id FK
}
comments {
bigint id PK
bigint user_id FK
bigint item_id FK
text content
}
purchases {
bigint id PK
bigint user_id FK
bigint item_id FK
string shipping_postal_code
string shipping_address
string shipping_building
tinyint payment_method
}
categories {
bigint id PK
string category_name
}
item_categories {
bigint id PK
bigint item_id FK
bigint category_id FK
}
chats {
bigint id PK
bigint buyer_id FK
bigint seller_id FK
bigint item_id FK
boolean is_completed
}
chat_messages {
bigint id PK
bigint chat_id FK
bigint sender_id FK
text message
string image
}
chat_notifications {
bigint id PK
bigint receiver_id FK
bigint chat_id FK
int message_count
boolean is_read
}
ratings {
bigint id PK
bigint evaluator_id FK
bigint evaluated_id FK
bigint item_id FK
tinyint score
}
- git clone リンク
- docker-compose up -d --build
* MySQLは、OSによって起動しない場合があるのでそれぞれのPCに合わせてdocker-compose.ymlファイルを編集してください。
- docker-compose exec php bash
- composer install
- .env.exampleファイルから.envを作成し、環境変数を構築(MAILは以下のように修正)
MAIL_HOST=mail
MAIL_FROM_ADDRESS=info@example.com
- php artisan key:generate
- php artisan migrate
- php artisan db:seed
- php artisan storage:link
- 開発環境:http://localhost/
- phpMyAdmin:http://localhost:8080/
- MailHog:http://localhost:8025/
- メールアドレス;mercari@coachtech.com
- パスワード:password
- メールアドレス;amazon@coachtech.com
- パスワード:password
- メールアドレス;rakuten@coachtech.com
- パスワード:password
ローカルはMySQLですが、本番はRender(Dockerデプロイ)+ Neon(PostgreSQL)で無料の範囲で構築しています。
- ビルドにはリポジトリ直下の
Dockerfileを使用します(ローカルのdocker/php/Dockerfileとは別物で、Apache + PHPの単一コンテナ構成です)。 - コンテナ起動時(
docker/render/entrypoint.sh)に設定キャッシュの生成、migrate --force、storage:linkを自動実行します。 - 必要な環境変数の一覧は
src/.env.production.exampleにまとめています(値は空のテンプレートです)。実際の値はRenderの環境変数設定画面から入力してください。 .envファイルや接続パスワード、APP_KEYはリポジトリにコミットしていません。すべて環境変数経由で渡す想定です。- NeonはSSL接続が必須のため、PostgreSQL接続には
sslmode=requireをデフォルトで付与しています(DB_SSLMODEで上書き可能)。
- Renderの無料プランは一定時間アクセスが無いとスリープするため、しばらく使われていない状態からの初回アクセスは表示までに数十秒かかることがあります。
- Renderの無料プランはファイルシステムが永続化されないため、アップロードした商品画像・アイコン画像はデプロイや再起動のタイミングで消える可能性があります。
- 本番のメール送信は未設定です(
MAIL_MAILER=log)。会員登録時のメール認証を有効化する場合は別途SMTP等の設定が必要です。