[Feature] install breeze

.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: Laravel Tests
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  laravel-tests:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:15
+        ports:
+          - 5432:5432
+        env:
+          POSTGRES_DB: laravel
+          POSTGRES_USER: laravel
+          POSTGRES_PASSWORD: secret
+        options: >-
+          --health-cmd="pg_isready"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+    env:
+      DB_CONNECTION: pgsql
+      DB_HOST: 127.0.0.1
+      DB_PORT: 5432
+      DB_DATABASE: laravel
+      DB_USERNAME: laravel
+      DB_PASSWORD: secret
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+
+      - name: Install Composer dependencies
+        run: composer install --no-progress --prefer-dist
+
+      - name: Copy .env
+        run: cp .env.example .env
+
+      - name: Generate key
+        run: php artisan key:generate
+
+      - name: Run migrations
+        run: php artisan migrate --force
+
+      - name: Run tests
+        run: ./vendor/bin/phpunit

.github/workflows/deploy.yml

@@ -0,0 +1,16 @@
+name: Deploy to Render
+
+on:
+  push:
+    branches:
+      - master  # 或你設定的部署分支
+
+jobs:
+  deploy:
+    name: Trigger Render Deploy Hook
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Call Render deploy webhook
+        run: |
+          curl -X POST ${{ secrets.RENDER_DEPLOY_HOOK_URL }}

.github/workflows/flow.yml

@@ -0,0 +1,13 @@
+            ┌────────────┐
+            │   Push     │
+            │   to Git   │
+            └────┬───────┘
+                 │
+      ┌──────────▼──────────┐
+      │      GitHub         │
+      │  自動觸發兩件事：     │
+      │                      │
+      │ 1. CI: ci.yml 執行   │─→ 測試 Laravel + DB
+      │                      │
+      │ 2. CD: deploy.yml     │─→ curl Deploy Hook URL → Render 開始部署
+      └─────────────────────┘

Dockerfile

@@ -2,6 +2,9 @@ FROM richarvey/nginx-php-fpm:3.1.6
 
 COPY . .
 
+# 安裝 Node.js + npm（for Alpine）
+RUN apk add --no-cache nodejs npm
+
 # Image config
 ENV SKIP_COMPOSER 1
 ENV WEBROOT /var/www/html/public

README.md

@@ -1,22 +1,167 @@
-# Laravel 11 with a Docker PHP Image
+# Mini ERP System
 
-A demo repo for deploying a Laravel PHP application on [Render](https://render.com) using Docker. You can follow the getting started tutorial [here](https://render.com/docs/deploy-php-laravel-docker).
+A lightweight ERP system for Sales and Inventory Management.
 
+Built with Laravel 11, PostgreSQL, and Docker.
 
-## Deployment
+## Tech Stack
 
-1. [Create](https://dashboard.render.com/new/database) a new PostgreSQL database on Render and copy the internal DB URL to use below.
+* Laravel 11
+* PostgreSQL
+* Docker Compose
+* Bootstrap 5
+* Chart.js
 
-2. Fork this repo to your own GitHub account.
+---
 
-3. Create a new **Web Service** on Render, and give Render's GitHub app permission to access your new repo.
+## Dashboard
 
-4. Select `Docker` for the environment, and add the following environment variable under the *Advanced* section:
+> Dashboard Screenshot Here
 
-   | Key             | Value           |
-   | --------------- | --------------- |
-   | `APP_KEY`  | Copy the output of `php artisan key:generate --show` |
-   | `DATABASE_URL`  | The **internal database url** for the database you created above. |
-   | `DB_CONNECTION`  | `pgsql` |
+![Dashboard](docs/images/dashboard.png)
 
-That's it! Your Laravel 11 app will be live on your Render URL as soon as the build finishes. You can test it out by registering and logging in.
+---
+
+## Order Workflow
+
+```mermaid
+flowchart TD
+
+A["Create Order"]
+--> B["Pending Approval"]
+
+B --> C["Approved"]
+
+C --> D["Ship Order"]
+
+D --> E["Reduce Inventory"]
+
+E --> F["Create Stock Movement"]
+```
+
+---
+
+## Sample Sales Order
+
+| Field     | Value     |
+| --------- | --------- |
+| Order No. | SO0001    |
+| Customer  | Company A |
+| Status    | Approved  |
+| Total     | 60,000    |
+
+### Order Items
+
+| Product | Qty | Unit Price | Subtotal |
+| ------- | --- | ---------- | -------- |
+| Laptop  | 2   | 30,000     | 60,000   |
+
+---
+
+## Stock Movement Example
+
+| Date       | Product | Type | Qty | Balance | Reference |
+| ---------- | ------- | ---- | --- | ------- | --------- |
+| 2026-06-24 | Laptop  | OUT  | -2  | 18      | SO0001    |
+
+---
+
+## Modules
+
+### Sales Order Module
+
+* Create sales orders
+* Order approval workflow
+* Order status management
+
+### Inventory Module
+
+* Inventory tracking
+* Automatic stock deduction
+* Stock movement history
+
+### Dashboard Module
+
+* Revenue statistics
+* Order statistics
+* Inventory overview
+
+---
+
+## Database ER Diagram
+
+> ER Diagram Screenshot Here
+
+![ERD](docs/images/erd.png)
+
+---
+
+## System Architecture
+
+```text
+Browser
+   │
+   ▼
+Laravel Application
+   │
+   ├── Controllers
+   ├── Services
+   ├── Models
+   └── Repositories
+   │
+   ▼
+PostgreSQL
+```
+
+### Docker Environment
+
+```text
+Docker
+├── nginx
+├── php-fpm
+└── postgres
+```
+
+---
+
+## Technical Highlights
+
+* Transaction handling for inventory consistency
+* Service Layer architecture
+* Approval workflow implementation
+* Dockerized development environment
+* Dashboard analytics with Chart.js
+
+---
+
+## Installation
+
+```bash
+git clone https://github.com/your-account/mini-erp.git
+
+cd mini-erp
+
+cp .env.example .env
+
+docker compose up -d
+
+docker compose exec app composer install
+
+docker compose exec app php artisan key:generate
+
+docker compose exec app php artisan migrate --seed
+```
+
+---
+
+## Project Goals
+
+This project simulates a lightweight ERP system focusing on sales and inventory workflows.
+
+Key business scenarios include:
+
+* Sales order management
+* Approval workflow
+* Inventory deduction
+* Stock movement tracking
+* Dashboard reporting

app/Http/Controllers/Auth/AuthenticatedSessionController.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Auth\LoginRequest;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\View\View;
+
+class AuthenticatedSessionController extends Controller
+{
+    /**
+     * Display the login view.
+     */
+    public function create(): View
+    {
+        return view('auth.login');
+    }
+
+    /**
+     * Handle an incoming authentication request.
+     */
+    public function store(LoginRequest $request): RedirectResponse
+    {
+        $request->authenticate();
+
+        $request->session()->regenerate();
+
+        return redirect()->intended(route('product.list', absolute: false));
+    }
+
+    /**
+     * Destroy an authenticated session.
+     */
+    public function destroy(Request $request): RedirectResponse
+    {
+        Auth::guard('web')->logout();
+
+        $request->session()->invalidate();
+
+        $request->session()->regenerateToken();
+
+        return redirect('/');
+    }
+}

app/Http/Controllers/Auth/ConfirmablePasswordController.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Validation\ValidationException;
+use Illuminate\View\View;
+
+class ConfirmablePasswordController extends Controller
+{
+    /**
+     * Show the confirm password view.
+     */
+    public function show(): View
+    {
+        return view('auth.confirm-password');
+    }
+
+    /**
+     * Confirm the user's password.
+     */
+    public function store(Request $request): RedirectResponse
+    {
+        if (! Auth::guard('web')->validate([
+            'email' => $request->user()->email,
+            'password' => $request->password,
+        ])) {
+            throw ValidationException::withMessages([
+                'password' => __('auth.password'),
+            ]);
+        }
+
+        $request->session()->put('auth.password_confirmed_at', time());
+
+        return redirect()->intended(route('product.list', absolute: false));
+    }
+}

app/Http/Controllers/Auth/EmailVerificationNotificationController.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+
+class EmailVerificationNotificationController extends Controller
+{
+    /**
+     * Send a new email verification notification.
+     */
+    public function store(Request $request): RedirectResponse
+    {
+        if ($request->user()->hasVerifiedEmail()) {
+            return redirect()->intended(route('dashboard', absolute: false));
+        }
+
+        $request->user()->sendEmailVerificationNotification();
+
+        return back()->with('status', 'verification-link-sent');
+    }
+}