結業專案:洛奇旅行(二)功能化(選讀,Node.js 26)

這一篇整篇是選讀,不佔上課時間。切版(上一篇)做完就是課程的結業專案;想把它接上真正的雲端資料,才照這一篇做:課堂還有餘裕時,可以請 AI 代理(例如 Claude Code)對照本文一步步幫你做,否則就留到回家自己完成。

切版做完之後,這一章把同一份洛奇旅行的行程與報名接到雲端。前台用 Google 登入報名,並查詢自己的訂單。後台使用 Firebase Authentication 的 email 與密碼。資料放在 Cloud Firestore。下面的路徑寫 07-project-final。人還在自己的 06-project-init 裡時,資料夾名稱換成那一份,檔案相對位置相同。

選讀:從切版繼續

這一章沿用第 12 篇結束時的畫面、路由與色票。先選定一份專案並啟動,再看清楚哪些讀寫仍停在這次開啟的記憶體裡。後面才一次換一層。

複製並啟動

兩種起點改的是同一套檔案。已經裝過 Node.js 26 與 pnpm 的人直接做下面兩步。剛重灌的電腦先照 Tailwind CSS 4.3:utilities、RWD、深色模式 把 Node 26 與 pnpm 裝好。

步驟 1:選定專案

跟著 結業專案:洛奇旅行(一)切版(React 19、Tailwind 4.3) 做完的人,06-project-init 已經與 05-project-prototype 相同。留在那個資料夾,跳到下一步。

還沒做完、或想直接拿切版完成品的人,在練習倉庫根目錄把切版完成品 05-project-prototype 複製成 07-project-final。目的資料夾還不存在時才複製。切版原件留著對照,後面的修改寫在複本。

macOS(終端機在倉庫根目錄):

cp -R 05-project-prototype 07-project-final

Windows(PowerShell,同樣在倉庫根目錄):

Copy-Item -Recurse 05-project-prototype 07-project-final

資料夾已經在
目的資料夾已經存在時跳過複製,直接做下一步。macOS 的 cp -R 會把來源嵌進既有資料夾。已做完第 12 篇的人直接用 06-project-init。

步驟 2:安裝並啟動

安裝與建置產生的資料夾(node_modules、dist)是這一台電腦的產物,複製之後先刪掉,再安裝並啟動。已經在自己的專案資料夾、依賴也裝過的人,直接啟動開發伺服器即可。

macOS(以複本為例;沿用第 12 篇的人把路徑換成 06-project-init):

rm -rf 07-project-final/node_modules 07-project-final/dist
cd 07-project-final
pnpm install
pnpm dev

解析

  • pnpm install 依 package.json 與鎖定檔裝依賴。pnpm dev 啟動 Vite 開發伺服器。
  • 05-project-prototype 與做完第 12 篇的 06-project-init 是同一份切版,差別只在資料夾從哪裡來。

Windows(PowerShell):

Remove-Item -Recurse -Force 07-project-final\node_modules, 07-project-final\dist -ErrorAction SilentlyContinue
cd 07-project-final
pnpm install
pnpm dev

解析

  • 步驟與 macOS 相同,只是刪資料夾與換路徑的寫法改成 PowerShell。

終端機會印出本機網址。瀏覽器打開之後,畫面應與切版完成品相同。

解析

  • 色票、路由表與切版約定的元素 id(如 site-header、booking-form)維持不變,後面的功能加在這些頁面之上。

記憶體狀態與本章範圍

切版裡的登入、報名與後台儲存只改這次開啟的記憶體。重新整理之後,畫面回到各功能 mock.data.js 的種子。這一章要換掉的是這一層讀寫。版面、色票與路由留在第 12 篇的結果。


graph LR
seed["mock.data.js"] --> mem["store.js 記憶體陣列"]
mem --> loader["loader / action"]
loader --> pages["頁面"]

前台用 Google 登入,報名時寫成一筆訂單,文件帶上登入者的 uid,我的報名只查這個 uid。後台用 email 與密碼登入,行程改從雲端讀寫,新增、修改與刪除都寫進 Firestore。

剩餘名額要掃過所有訂單才算得出來,但旅客不能讀別人的訂單,所以前台改顯示每團名額。訂單不提供實體刪除,把狀態改為已取消就是軟刪。

這一章結束時,頁面的路由資料讀取(loader)與表單處理(action)都呼叫同一組服務函式,服務函式再呼叫 Firestore。登入狀態由根路由讀取,未登入要進報名或後台時,導向登入頁。密碼以外的帳號打開後台時,頁面顯示說明與按鈕,不把人趕去別的網址。


graph LR
page["頁面"] --> api["api.js"]
api --> fs["Cloud Firestore"]
google["前台 Google"] --> authn["Authentication"]
admin["後台 email/密碼"] --> authn
authn --> gate["畫面閘門"]
gate --> api

解析

  • 切版的登入對話框沒有接 Authentication。這一章前台改為 signInWithPopup,後台改為 signInWithEmailAndPassword。
  • 行程文件用原本的 id,例如 hualien-taroko,詳情網址不用改。
  • 訂單由 Firestore 編號。集合名稱是 orders。每筆帶登入者的 uid。
  • 色票與切版的十二條路由維持不變。多出來的是種子頁 /seed 與登出用的 /logout。

選讀:認識 Firebase

Firebase 是 Google 提供的後端服務,專案在瀏覽器裡用它的 JavaScript SDK 呼叫。這一章只用其中兩項:Cloud Firestore 存文件,Authentication 同時用於前台 Google 登入與後台 email/密碼。先知道這兩項各自負責什麼,再建立專案、把設定交給 Vite。

Firestore 與 Authentication

Firestore 是文件資料庫。資料分成集合與文件。集合是一疊文件,文件是一筆欄位。欄位可以是字串、數字、陣列或巢狀物件。這一章的行程集合叫 tours,一筆行程一份文件。訂單集合叫 orders,一筆報名一份文件。


graph LR
tours["集合 tours"] --> doc["文件 hualien-taroko"]
doc --> fields["欄位 title、price、departures"]

讀寫發生在瀏覽器。SDK 送出請求,畫面接著等結果。失敗時(沒有網路、規則拒絕)會丟出錯誤,頁面要自己顯示,不能假設種子還在記憶體裡。

Authentication 管的是「這個人是誰」。前台用 Google 登入,後台用 email 與密碼。它不負責這個人能不能讀某一筆訂單。能不能讀寫是 Firestore 安全規則的事,留到最後一節。規則用 token 裡的 sign_in_provider 分辨這兩種登入。規則生效之前,資料庫先放在測試模式,種子才寫得進去。

這一章只開 email/密碼與 Google 兩種登入,開通前可在 Firebase 的價格頁確認目前的免費額度。不要啟用電話驗證:簡訊按則計費,專案得連結 Cloud Billing 帳戶才能使用。也不要升級 Firebase Authentication with Identity Platform,升級後改用另一套計費方式,這一章用不到多重要素驗證、SAML 與 blocking functions。

金鑰會出現在前端
網頁應用程式的設定會被打包進 JavaScript。任何人打開網站都能看到。真正擋住讀寫的是安全規則。設定出現在前端是預期的。

解析

  • 集合還沒有任何文件時,第一次讀 tours 會得到空陣列,不是例外。
  • 文件 id 可以自己指定,也可以讓 Firestore 產生。種子與編輯既有行程用指定的 id,後台新增的行程與每筆訂單由 Firestore 產生。
  • Authentication 的登入狀態由 SDK 記在這台瀏覽器。loader 會先等 auth.authStateReady(),再讀 currentUser。
  • 測試模式會開放所有人讀寫,主控台還會限期關閉(天數以建立時畫面為準)。它只適合開發,不是這一章的正式規則。

建立專案與初始化

設定只寫在三個地方:Firebase 主控台的專案、本機的環境變數檔 .env.local、初始化檔 src/firebase.js。後面的服務函式只向初始化檔拿資料庫與驗證物件,不再抄金鑰。

步驟 1:建立 Firebase 專案

打開 Firebase 主控台,新增專案。建立時關閉 Google Analytics,這一章用不到。

專案建好後,進入 Firestore Database,建立資料庫。地點建立後不能改,選離自己近的,例如 asia-east1。模式先選測試模式,讓後面的種子頁寫得進去。正式規則在最後一節才貼上,這裡先不要自訂規則。

Authentication 的登入方式先不要開。Google 留到前台登入那一節,電子郵件/密碼留到後台登入那一節,避免同一項設定寫兩次。主控台若出現升級 Identity Platform 的按鈕,不要按。

步驟 2:註冊網頁應用程式

在專案設定裡新增網頁應用程式。這裡先不必勾選 Firebase Hosting,設定寫在本章最後的 firebase.json。註冊完成後,主控台給一份設定物件。先留在主控台,下一步才抄進本機。

步驟 3:環境變數

Vite 只把以 VITE_ 開頭的變數放進瀏覽器端,沒有這個前綴的變數,元件讀不到。範例檔進版控、值留空,真正的金鑰寫在 .env.local,這個檔名已被忽略規則涵蓋。下面的修改再補上其他 .env 開頭的檔名,避免有人把金鑰寫進別的檔名後 commit;範例檔用反向規則排除,而且必須放在後面,才不會被一起忽略。

07-project-final/.gitignore
 *.local
+.env
+.env.*
+!.env.example
.DS_Store
07-project-final/.env.example
# 對照 Firebase 主控台「網頁應用程式」設定物件的同名字段。值留空,真正的金鑰只寫在 .env.local。
VITE_FIREBASE_API_KEY=
VITE_FIREBASE_AUTH_DOMAIN=
VITE_FIREBASE_PROJECT_ID=
VITE_FIREBASE_STORAGE_BUCKET=
VITE_FIREBASE_MESSAGING_SENDER_ID=
VITE_FIREBASE_APP_ID=

複製範例再填值。主控台設定物件的欄位名稱,加上 VITE_FIREBASE_ 前綴並把駝峰改成大寫底線,就是變數名稱,例如 apiKey 對應 VITE_FIREBASE_API_KEY。

cp .env.example .env.local

改完 .env.local 要停掉開發伺服器再執行 pnpm dev。Vite 在啟動時讀環境變數,存檔不會熱更新這一份。

還沒有金鑰也能打包
.env.local 留空時,後面的頁面會顯示尚未設定,pnpm build 也不會因為缺少金鑰失敗。要讓打包後的網站真的連上 Firebase,得在有填好金鑰的電腦上建置。

步驟 4:安裝 SDK 並初始化

在專案資料夾安裝 Firebase。pnpm 12 預設不執行依賴的安裝腳本,除非在 pnpm-workspace.yaml 明確允許。Firebase 依賴的兩個套件各有 postinstall(套件自己的準備步驟),允許之後 pnpm install 才會以成功結束。

先安裝套件。

pnpm add firebase

解析

  • 在專案資料夾執行,把 Firebase SDK 加進依賴。

裝完之後,package.json 會多出這項依賴。

07-project-final/package.json
     "@mui/material": "^9.5.0",
+ "firebase": "^13.2.0",
"react": "^19.3.1",
// ...

解析

  • 版本範圍與完成品相同。

pnpm 12 要允許套件的 postinstall,安裝才會成功結束。

07-project-final/pnpm-workspace.yaml
 minimumReleaseAgeExclude:
- '@vitejs/plugin-react@6.2.1'
+allowBuilds:
+ '@firebase/util': true
+ protobufjs: true

解析

  • pnpm-workspace.yaml 明確允許 @firebase/util 與 protobufjs 的安裝腳本。

初始化集中在一個檔。缺少金鑰或專案 id 時不呼叫 initializeApp,開發伺服器就不會在啟動當下因空設定崩潰。熱更新會再執行這個檔,已經建立過的 App 就沿用。

07-project-final/src/firebase.js
import { getApps, initializeApp } from 'firebase/app';
import { getAuth } from 'firebase/auth';
import { getFirestore } from 'firebase/firestore';

const firebaseConfig = {
apiKey: import.meta.env.VITE_FIREBASE_API_KEY,
authDomain: import.meta.env.VITE_FIREBASE_AUTH_DOMAIN,
projectId: import.meta.env.VITE_FIREBASE_PROJECT_ID,
storageBucket: import.meta.env.VITE_FIREBASE_STORAGE_BUCKET,
messagingSenderId: import.meta.env.VITE_FIREBASE_MESSAGING_SENDER_ID,
appId: import.meta.env.VITE_FIREBASE_APP_ID,
};

export const missingFirebaseMessage =
'尚未設定 Firebase。請依 .env.example 建立 .env.local,存檔後重新啟動開發伺服器。';

export const firebaseReady = Boolean(
firebaseConfig.apiKey && firebaseConfig.projectId,
);

const app = firebaseReady
? (getApps()[0] ?? initializeApp(firebaseConfig))
: null;

export const db = app ? getFirestore(app) : null;
export const auth = app ? getAuth(app) : null;

解析

  • firebaseReady 為假時,資料庫與驗證物件都是 null。服務函式被呼叫時才丟出錯誤,錯誤文字只宣告在這個檔。
  • getFirestore 與 getAuth 拿到的是同一份 App 上的兩項服務。
  • 環境變數在建置時被寫進產物。沒有填值的建置,連線用的字串是空的。

選讀:讀寫介面

頁面不要直接呼叫 Firestore。讀寫收成 src/api.js 的服務函式,路由的 loader 呼叫它們,頁面用 useLoaderData 接結果。非預期的失敗交給錯誤頁,讀取中的提示由版型顯示。

服務函式

src/api.js 是這一章唯一讀寫 Firestore 文件的檔。每次讀寫都先檢查資料庫是否已初始化,沒有就丟出上面那句錯誤,呼叫端用 try/catch 接。

服務函式主要用到下面幾個 Firestore 方法,另有 query、where、orderBy 組出查詢條件,deleteDoc 刪除文件。

  • getDocs 讀整個集合,getDoc 讀一份文件。
  • setDoc 寫到指定 id。種子與編輯既有行程用它,id 就是切版裡的 tour.id。
  • addDoc 讓 Firestore 產生 id。訂單與後台新增的行程用它。
  • updateDoc 只改帶上去的欄位。
  • serverTimestamp 由伺服器填寫入時間,清單依它由新到舊。

種子函式走訪 src/features/tours/mock.data.js。文件已經存在就略過,所以按鈕可以重複按,不會蓋掉主控台裡改過的欄位。回傳值是這次新寫入的筆數。主題選項仍寫在程式裡的同一份清單,行程文件只存 theme 字串,不必另做主題資料表。

07-project-final/src/api.js
import {
addDoc,
collection,
deleteDoc,
doc,
getDoc,
getDocs,
orderBy,
query,
serverTimestamp,
setDoc,
updateDoc,
where,
} from 'firebase/firestore';
import { tours } from './features/tours/mock.data.js';
import { db, missingFirebaseMessage } from './firebase.js';

const database = () => {
if (!db) throw new Error(missingFirebaseMessage);
return db;
};

export const listTours = async () => {
const snap = await getDocs(collection(database(), 'tours'));
return snap.docs
.map((item) => ({ id: item.id, ...item.data() }))
.sort((a, b) => a.title.localeCompare(b.title, 'zh-Hant'));
};

export const getTour = async (id) => {
const snap = await getDoc(doc(database(), 'tours', id));
return snap.exists() ? { id: snap.id, ...snap.data() } : null;
};

export const seedTours = async () => {
const base = database();
let created = 0;
for (const tour of tours) {
const ref = doc(base, 'tours', tour.id);
if ((await getDoc(ref)).exists()) continue;
await setDoc(ref, tour);
created += 1;
}
return created;
};

export const saveTour = async (editingId, tour) => {
const base = database();
if (editingId) {
await setDoc(doc(base, 'tours', editingId), tour);
} else {
await addDoc(collection(base, 'tours'), tour);
}
};

export const deleteTour = async (id) => {
await deleteDoc(doc(database(), 'tours', id));
};

export const getOrder = async (id) => {
const snap = await getDoc(doc(database(), 'orders', id));
return snap.exists() ? { id: snap.id, ...snap.data() } : null;
};

export const createOrder = async (input) => {
const ref = await addDoc(collection(database(), 'orders'), {
...input,
status: 'pending',
createdAt: serverTimestamp(),
});
return { id: ref.id, status: 'pending', ...input };
};

export const listOrders = async () => {
const snap = await getDocs(
query(collection(database(), 'orders'), orderBy('createdAt', 'desc')),
);
return snap.docs.map((item) => ({ id: item.id, ...item.data() }));
};

export const listMyOrders = async (uid) => {
const snap = await getDocs(
query(collection(database(), 'orders'), where('uid', '==', uid)),
);
return snap.docs
.map((item) => ({ id: item.id, ...item.data() }))
.sort((a, b) => (b.createdAt?.seconds ?? 0) - (a.createdAt?.seconds ?? 0));
};

export const updateOrderStatus = async (id, status) => {
await updateDoc(doc(database(), 'orders', id), { status });
};

解析

  • 回傳的物件把文件編號放進 id,畫面的 key 與網址都用這個欄位。
  • getTour 找不到文件時回傳 null,詳情頁把它畫成找不到頁面。
  • getOrder 讀 orders 集合的一份文件,不存在時回傳 null。規則不允許讀時 getDoc 會失敗,完成頁同樣畫成找不到頁;能不能讀由規則把關,只有主人或管理員讀得到。
  • createOrder 把呼叫端傳來的欄位原樣寫入,其中包含 uid。回傳的物件帶上 Firestore 產生的文件編號,還不含伺服器時間戳;完成頁用這個編號再讀一次訂單。
  • listOrders 的 orderBy('createdAt') 是單一欄位排序,Firestore 會自動建索引。每筆訂單都要有 createdAt,缺了這個欄位的文件不會出現在結果裡。管理員清單用這個函式。
  • listMyOrders 只下 uid 條件。同時加上排序會要求複合索引,所以新到舊的排序放在瀏覽器。

路由上的讀取

切版的 loader 原本呼叫記憶體模組,這一章換成 api.js 並刪掉記憶體模組。換頁讀取中的提示放在 SiteLayout:導覽狀態是 loading 時,在內容區上方顯示「讀取中」。loader 丟出的錯誤仍進到沒有路徑的那層路由上的錯誤頁。

沒有填 Firebase 時,讀取函式回傳 { firebaseReady: false },頁面改渲染 MissingFirebase,顯示未設定的說明。這不是例外,所以不會進到錯誤頁。

先刪掉記憶體模組。

rm src/store.js

解析

  • store.js 刪掉之後,行程與訂單只來自 Firestore。重新整理不會再回到記憶體種子。

沒有設定或沒有權限時,用這兩個畫面說明狀況。

07-project-final/src/AccessNotice.jsx
import { Link } from 'react-router';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import { missingFirebaseMessage } from './firebase.js';

const frame = 'mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24';

export function MissingFirebase() {
return (
<main className={frame}>
<Alert severity="warning">{missingFirebaseMessage}</Alert>
</main>
);
}

export function AdminDenied() {
return (
<main className={frame}>
<Alert severity="warning">
這個帳號不能進入後台。請改用主控台建立的 email 與密碼。
</Alert>
<Button
className="mt-6"
component={Link}
to="/admin/login"
variant="contained"
>
到後台登入
</Button>
</main>
);
}

解析

  • MissingFirebase 與 AdminDenied 都畫在 main 裡,版型的頁首與頁尾還在。

再讓版型在換頁讀取時顯示「讀取中」。

07-project-final/src/layout/SiteLayout.jsx
import { Outlet, ScrollRestoration, useNavigation } from 'react-router';
import SiteHeader from './components/SiteHeader.jsx';
import SiteFooter from './components/SiteFooter.jsx';

export default function SiteLayout() {
const navigation = useNavigation();
return (
<div className="flex min-h-screen flex-col bg-paper font-sans text-ink">
<SiteHeader />
<div className="flex flex-1 flex-col">
{navigation.state === 'loading' ? (
<p className="mx-auto w-full max-w-6xl px-4 pt-4 text-sm text-muted sm:px-6">
讀取中
</p>
) : null}
<Outlet />
</div>
<SiteFooter />
<ScrollRestoration />
</div>
);
}

解析

  • SiteLayout 在 loading 時多一行「讀取中」。送出表單時的 submitting 狀態不在這裡顯示,由按鈕自己依 useNavigation 處理。

選讀:接到畫面

服務函式接上之後,首頁、行程列表與詳情的 loader 改呼叫服務函式讀行程。種子頁把範例行程寫進雲端,而且要先通過管理員檢查。報名與我的報名改走訂單文件,並帶上登入者的 uid。

行程讀取與種子

首頁、列表與詳情的 loader 先看 firebaseReady。還沒設定就回傳空清單或空值,頁面改畫「未設定」的提示。詳情找不到文件時丟 404,導向路由上最近的錯誤頁。

種子頁的 loader 使用 requireAdmin;不是密碼登入時,頁面顯示警告與前往後台登入的按鈕。

先改首頁的 loader 與畫面。

07-project-final/src/features/home/HomePage.jsx
import { useLoaderData } from 'react-router';
import Alert from '@mui/material/Alert';
import FeaturedTours from './components/FeaturedTours.jsx';
import HeroSearch from './components/HeroSearch.jsx';
import HeroSlider from './components/HeroSlider.jsx';
import IntroBanner from './components/IntroBanner.jsx';
import ReasonSection from './components/ReasonSection.jsx';
import ReviewSection from './components/ReviewSection.jsx';
import ThemeSection from './components/ThemeSection.jsx';
import { listTours } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { firebaseReady } from '../../firebase.js';

export const loader = async () => {
if (!firebaseReady) return { firebaseReady: false, tours: [] };
return { firebaseReady: true, tours: await listTours() };
};

export default function HomePage() {
const { firebaseReady: ready, tours } = useLoaderData();
const featured = tours.filter((tour) => tour.featured);
if (!ready) return <MissingFirebase />;

return (
<main>
<title>洛奇旅行</title>
{tours.length ? null : (
<div className="mx-auto w-full max-w-6xl px-4 pt-10 sm:px-6">
<Alert severity="info">還沒有行程。請先打開 /seed 寫入種子。</Alert>
</div>
)}
<HeroSlider slides={featured.length ? featured : tours.slice(0, 4)} />
<HeroSearch />
<IntroBanner />
<FeaturedTours tours={featured} />
<ThemeSection />
<ReasonSection />
<ReviewSection />
</main>
);
}

解析

  • 資料改由 listTours() 讀取。還沒設定時畫 MissingFirebase。
  • 首頁在沒有行程時顯示「還沒有行程。請先打開 /seed 寫入種子。」輪播仍用精選,沒有精選就拿前四筆。

列表頁同樣改走 listTours()。

07-project-final/src/features/tours/ToursPage.jsx
import { useLoaderData, useSearchParams } from 'react-router';
import Typography from '@mui/material/Typography';
import TourCard from './components/TourCard.jsx';
import TourEmpty from './components/TourEmpty.jsx';
import TourFilters from './components/TourFilters.jsx';
import { listTours } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { firebaseReady } from '../../firebase.js';
import { matchPrice } from '../../format.js';

export const loader = async () => {
if (!firebaseReady) return { firebaseReady: false, tours: [] };
return { firebaseReady: true, tours: await listTours() };
};

export default function ToursPage() {
const { firebaseReady: ready, tours } = useLoaderData();
const [params, setParams] = useSearchParams();

const region = params.get('region') ?? '';
const days = params.get('days') ?? '';
const price = params.get('price') ?? '';
const theme = params.get('theme') ?? '';
const sort = params.get('sort') || 'price-asc';
const list = tours.filter(
(tour) =>
(!region || tour.region === region) &&
(!days || String(tour.days) === days) &&
(!theme || tour.theme === theme) &&
matchPrice(tour.price, price),
);
const rank = {
'price-asc': (a, b) => a.price - b.price,
'price-desc': (a, b) => b.price - a.price,
'days-asc': (a, b) => a.days - b.days || a.price - b.price,
};
const visible = [...list].sort(rank[sort] || rank['price-asc']);
if (!ready) return <MissingFirebase />;

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>行程 · 洛奇旅行</title>
<Typography variant="h1">行程</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
依地區、天數與預算挑選。價格為每人,以新台幣計。
</p>
<TourFilters />
<div id="tour-list">
{visible.length ? (
<>
<Typography variant="h2" className="mt-10">
{visible.length} 筆行程
</Typography>
<div className="mt-6 grid grid-cols-1 gap-6 sm:grid-cols-2 lg:grid-cols-3">
{visible.map((tour) => (
<TourCard key={tour.id} tour={tour} showTheme />
))}
</div>
</>
) : (
<TourEmpty
onClear={() => setParams(new URLSearchParams())}
message={
tours.length
? '換一個地區或天數,或清掉價格條件。'
: '還沒有行程。請先打開 /seed 寫入種子。'
}
/>
)}
</div>
</main>
);
}

解析

  • 列表的篩選仍讀查詢字串。資料來源從 getTours() 改成 listTours()。還沒設定時畫 MissingFirebase。

詳情頁的 loader 改呼叫 getTour。

07-project-final/src/features/tours/TourDetailPage.jsx
import { useState } from 'react';
import { data, useLoaderData } from 'react-router';
import Typography from '@mui/material/Typography';
import BookingCard from './components/BookingCard.jsx';
import FareBox from './components/FareBox.jsx';
import Gallery from './components/Gallery.jsx';
import Itinerary from './components/Itinerary.jsx';
import MobileBookingBar from './components/MobileBookingBar.jsx';
import MobileDepartures from './components/MobileDepartures.jsx';
import TourHeader from './components/TourHeader.jsx';
import TourHighlights from './components/TourHighlights.jsx';
import { getTour } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { firebaseReady } from '../../firebase.js';

export const loader = async ({ params }) => {
if (!firebaseReady) return { firebaseReady: false, tour: null };
const tour = await getTour(params.id);
if (!tour) throw data('找不到頁面', { status: 404 });
return { firebaseReady: true, tour };
};

export default function TourDetailPage() {
const { firebaseReady: ready, tour } = useLoaderData();
const [departureId, setDepartureId] = useState(tour?.departures[0]?.id ?? '');
if (!ready) return <MissingFirebase />;

const selected =
tour.departures.find((item) => item.id === departureId) ??
tour.departures[0];
const bookTo = `/booking?tourId=${tour.id}&departureId=${selected.id}`;

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 pb-28 sm:px-6 md:py-24 lg:pb-24">
<title>{`${tour.title} · 洛奇旅行`}</title>
<div className="lg:grid lg:grid-cols-[minmax(0,1.6fr)_minmax(20rem,24rem)] lg:items-start lg:gap-10">
<div className="min-w-0">
<TourHeader tour={tour} />
<Gallery images={tour.images} title={tour.title} />
<TourHighlights intro={tour.intro} highlights={tour.highlights} />
<Itinerary days={tour.itinerary} />
<FareBox includes={tour.includes} excludes={tour.excludes} />
<MobileDepartures tour={tour} />
<Typography variant="h2" className="mt-14">
取消與退款
</Typography>
<p className="mt-3 text-base leading-relaxed text-muted">
出團前以 email
確認。未成行全額退回。成行後若要改期,請來信或來電,由我們為你調整。常見問題也寫在關於頁。
</p>
</div>
<BookingCard
tour={tour}
selected={selected}
onSelect={setDepartureId}
bookTo={bookTo}
/>
</div>
<MobileBookingBar price={tour.price} bookTo={bookTo} />
</main>
);
}

解析

  • 詳情的 loader 只回傳這一筆行程。對不到 id 時丟 404,導向路由上最近的 errorElement。還沒設定時畫 MissingFirebase。

種子頁把 mock.data.js 寫進 tours,而且要先通過管理員檢查。

07-project-final/src/features/admin/SeedPage.jsx
import {
Form,
Link,
useActionData,
useLoaderData,
useNavigation,
} from 'react-router';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import Typography from '@mui/material/Typography';
import { seedTours } from '../../api.js';
import { AdminDenied, MissingFirebase } from '../../AccessNotice.jsx';
import { requireAdmin } from '../../auth.js';
import { missingFirebaseMessage } from '../../firebase.js';

export const loader = async ({ request }) => {
const gate = await requireAdmin(request);
return { firebaseReady: gate.firebaseReady, denied: Boolean(gate.denied) };
};

export const action = async ({ request }) => {
const gate = await requireAdmin(request);
if (!gate.firebaseReady) return { error: missingFirebaseMessage };
if (gate.denied) return { error: '請先用後台帳號登入。' };
try {
return { created: await seedTours() };
} catch (err) {
return { error: err.message };
}
};

export default function SeedPage() {
const { firebaseReady: ready, denied } = useLoaderData();
const result = useActionData();
const navigation = useNavigation();
const busy = navigation.state === 'submitting';
if (!ready) return <MissingFirebase />;
if (denied) return <AdminDenied />;
const message =
result?.created == null
? ''
: result.created
? `已寫入 ${result.created} 筆行程。`
: '行程都已存在,沒有覆寫。';

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>寫入行程種子 · 洛奇旅行</title>
<Typography variant="h1">寫入行程種子</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
把專案裡的行程寫進 Firestore 的
tours。已經存在的文件會略過,可以重複按。規則允許管理員寫入後才能按,請先用後台帳號登入。
</p>
{message ? (
<Alert className="mt-8" severity="success">
{message}
</Alert>
) : null}
{result?.error ? (
<Alert className="mt-8" severity="error">
{result.error}
</Alert>
) : null}
<Form method="post" className="mt-8 flex flex-wrap gap-3">
<Button type="submit" variant="contained" disabled={busy}>
{busy ? '寫入中…' : '寫入種子'}
</Button>
<Button component={Link} to="/tours" variant="outlined">
看行程
</Button>
</Form>
</main>
);
}

解析

  • 種子頁的 action 呼叫 seedTours,已存在的文件略過。未登入會被 requireAdmin 帶到登入頁。
  • Google 帳號進得了種子網址,但 denied 為真,畫面停在說明,不會呼叫寫入。

詳情頁的名額不再掃訂單,出發日列表、報名卡與手機出發日三處都改顯示每團名額。先改出發日列表。

07-project-final/src/features/tours/components/DepartureList.jsx
import { Link } from 'react-router';
import Button from '@mui/material/Button';

export default function DepartureList({ tour }) {
return (
<ul className="rounded-card bg-white shadow-card mt-4 max-w-3xl divide-y divide-line overflow-hidden px-5">
{tour.departures.map((departure) => (
<li
key={departure.id}
className="flex flex-col gap-3 py-4 sm:flex-row sm:items-center sm:justify-between"
>
<div>
<p className="font-medium">{departure.date}</p>
<p className="text-muted">名額 {departure.capacity} 人</p>
</div>
<Button
component={Link}
to={`/booking?tourId=${tour.id}&departureId=${departure.id}`}
variant="contained"
className="w-full sm:w-auto"
>
立即報名
</Button>
</li>
))}
</ul>
);
}

解析

  • 不再呼叫 seatsLeft 去掃訂單。畫面上的名額改讀梯次自己的 capacity。

報名卡改法相同。

07-project-final/src/features/tours/components/BookingCard.jsx
import { Link } from 'react-router';
import Button from '@mui/material/Button';
import { ntd } from '../../../format.js';

export default function BookingCard({ tour, selected, onSelect, bookTo }) {
return (
<aside className="rounded-card bg-white shadow-card sticky top-24 mt-12 hidden self-start p-8 lg:mt-0 lg:block">
<p className="flex items-baseline gap-1.5 whitespace-nowrap font-serif text-4xl">
<span className="inline-block rounded-full bg-accent text-ink font-bold leading-[1.15] py-[0.12em] px-[0.55em]">
{ntd(tour.price)}
</span>
<span className="font-sans text-base font-normal text-muted">/ 人</span>
</p>
{tour.id === 'kyoto-nara' ? (
<p className="mt-3 text-base text-muted">不含國際機票</p>
) : null}
<dl className="mt-6 grid gap-3 text-base">
<div className="flex justify-between gap-4">
<dt className="text-muted">天數</dt>
<dd>{tour.days} 天</dd>
</div>
<div className="flex justify-between gap-4">
<dt className="text-muted">團體上限</dt>
<dd>{tour.departures[0]?.capacity ?? 8} 人</dd>
</div>
</dl>
<div className="mt-6 divide-y divide-line border-y border-line">
{tour.departures.map((departure) => {
const on = departure.id === selected.id;
return (
<button
key={departure.id}
type="button"
onClick={() => onSelect(departure.id)}
aria-pressed={on}
className={`block w-full px-3 py-3 text-left ${on ? 'bg-mist text-action' : ''}`}
>
<span className="block font-medium">{departure.date}</span>
<span className="text-base text-muted">
名額 {departure.capacity} 人
</span>
</button>
);
})}
</div>
<Button
component={Link}
to={bookTo}
variant="contained"
className="mt-8 w-full"
>
立即報名
</Button>
</aside>
);
}

解析

  • 名額來源與出發日列表相同,改讀該梯的 capacity。

手機出發日最後對齊。

07-project-final/src/features/tours/components/MobileDepartures.jsx
import Typography from '@mui/material/Typography';
import DepartureList from './DepartureList.jsx';

export default function MobileDepartures({ tour }) {
return (
<div className="mt-14 lg:hidden">
<Typography variant="h2">出發日</Typography>
<p className="mt-3 text-base text-muted">
最近一梯 {tour.departures[0].date},每團 {tour.departures[0].capacity}{' '}
人。名額不在前台計算。
</p>
<DepartureList tour={tour} />
</div>
);
}

解析

  • 窄螢幕的出發日也改顯示每團名額,不再掃訂單。

登入、頁首與報名

根路由取名為 root,它的 loader 是 rootLoader:等驗證狀態確定後,回傳目前的使用者快照。

頁首用 useRouteLoaderData('root') 讀這份結果。登出是對 /logout 的 fetcher POST,action 呼叫 signOut 再導回首頁。

未登入時,requireUser 丟出重新導向到前台登入頁 /login(後台也一樣),網址帶 next 記住原本要去的頁面。safeNext 只接受以單斜線開頭、且不是 // 的路徑,避免被導去外部網站。

登入頁的 action 呼叫 signInWithPopup,成功後導向 next。這個彈出視窗要先在主控台啟用 Google 登入:Authentication 的「登入方式」新增提供者 Google,開啟後選一個專案支援電子郵件並儲存。本機測試時,授權網域需含 localhost(見最後一節)。

報名頁的 loader 同樣先 requireUser。表單改為唯讀的姓名與 email,電話仍手填。送出時 action 呼叫 createOrder,帶上登入者的 uid,再導向以訂單編號為網址的完成頁。

先寫驗證相關的服務函式。

07-project-final/src/auth.js
import { redirect } from 'react-router';
import { signOut } from 'firebase/auth';
import { auth, firebaseReady } from './firebase.js';

const snapshot = (user) =>
user
? {
uid: user.uid,
displayName: user.displayName,
email: user.email,
provider: user.providerData?.[0]?.providerId ?? null,
}
: null;

export const session = async () => {
if (!firebaseReady || !auth) return { firebaseReady: false, user: null };
await auth.authStateReady();
return { firebaseReady: true, user: snapshot(auth.currentUser) };
};

export const requireUser = async (request) => {
const current = await session();
if (!current.firebaseReady) return current;
if (!current.user) {
const url = new URL(request.url);
throw redirect(
`/login?next=${encodeURIComponent(`${url.pathname}${url.search}`)}`,
);
}
return current;
};

export const requireAdmin = async (request) => {
const current = await requireUser(request);
if (!current.firebaseReady) return { ...current, denied: false };
if (current.user.provider !== 'password') return { ...current, denied: true };
return { ...current, denied: false };
};

export const safeNext = (value) =>
typeof value === 'string' && value.startsWith('/') && !value.startsWith('//')
? value
: '/';

export const rootLoader = () => session();

export const logoutLoader = () => redirect('/');

export const logoutAction = async () => {
if (auth) await signOut(auth);
return redirect('/');
};

解析

  • session 在沒有初始化時回傳 firebaseReady: false 與 user: null。有初始化才等 auth 狀態。
  • requireUser 未登入時丟出重新導向到登入頁。requireAdmin 先做同樣的登入檢查,再確認登入方式是密碼(provider === 'password')。
  • safeNext 只接受以單斜線開頭、且不是 // 的路徑。rootLoader 回傳目前的使用者快照。登出的 action 呼叫 signOut 再導回首頁。

根路由補上 id、rootLoader,並加上 /logout 這條路由。

07-project-final/src/App.jsx
import { createBrowserRouter } from 'react-router';
import { RouterProvider } from 'react-router/dom';
import { logoutAction, logoutLoader, rootLoader } from './auth.js';
import SiteLayout from './layout/SiteLayout.jsx';
import HomePage, { loader as homeLoader } from './features/home/HomePage.jsx';
import ToursPage, {
loader as toursLoader,
} from './features/tours/ToursPage.jsx';
import TourDetailPage, {
loader as tourLoader,
} from './features/tours/TourDetailPage.jsx';
import BookingPage, {
action as bookingAction,
loader as bookingLoader,
} from './features/booking/BookingPage.jsx';
import BookingResultPage, {
loader as bookingResultLoader,
} from './features/booking/BookingResultPage.jsx';
import MyBookingsPage, {
loader as myBookingsLoader,
} from './features/booking/MyBookingsPage.jsx';
import AboutPage from './features/about/AboutPage.jsx';
import LoginPage, {
action as loginAction,
loader as loginLoader,
} from './features/auth/LoginPage.jsx';
import SeedPage, {
action as seedAction,
loader as seedLoader,
} from './features/admin/SeedPage.jsx';
import AdminLoginPage, {
action as adminLoginAction,
loader as adminLoginLoader,
} from './features/admin/AdminLoginPage.jsx';
import AdminToursPage, {
action as adminToursAction,
loader as adminToursLoader,
} from './features/admin/AdminToursPage.jsx';
import AdminBookingsPage, {
action as adminBookingsAction,
loader as adminBookingsLoader,
} from './features/admin/AdminBookingsPage.jsx';
import NotFoundPage from './pages/NotFoundPage.jsx';
import RouteErrorPage from './pages/RouteErrorPage.jsx';

const router = createBrowserRouter([
{
id: 'root',
loader: rootLoader,
Component: SiteLayout,
children: [
{
errorElement: <RouteErrorPage />,
children: [
{ index: true, loader: homeLoader, Component: HomePage },
{ path: 'tours', loader: toursLoader, Component: ToursPage },
{ path: 'tours/:id', loader: tourLoader, Component: TourDetailPage },
{
path: 'booking',
loader: bookingLoader,
action: bookingAction,
Component: BookingPage,
},
{
path: 'booking/:id',
loader: bookingResultLoader,
Component: BookingResultPage,
},
{ path: 'me', loader: myBookingsLoader, Component: MyBookingsPage },
{ path: 'about', Component: AboutPage },
{
path: 'login',
loader: loginLoader,
action: loginAction,
Component: LoginPage,
},
{
path: 'seed',
loader: seedLoader,
action: seedAction,
Component: SeedPage,
},
{
path: 'admin/login',
loader: adminLoginLoader,
action: adminLoginAction,
Component: AdminLoginPage,
},
{
path: 'admin',
loader: adminToursLoader,
action: adminToursAction,
Component: AdminToursPage,
},
{
path: 'admin/bookings',
loader: adminBookingsLoader,
action: adminBookingsAction,
Component: AdminBookingsPage,
},
{ path: 'logout', loader: logoutLoader, action: logoutAction },
{ path: '*', Component: NotFoundPage },
],
},
],
},
]);

export default function App() {
return <RouterProvider router={router} />;
}

解析

  • 頁首稍後用 useRouteLoaderData('root') 讀這份結果。/logout 的 loader 把直接打開這個網址的人送回首頁,action 才真正登出。

頁首改讀根路由的使用者,並加上登出。後台選單仍沿用第 12 篇那份 SiteHeader 的切換:pathname.startsWith('/admin') 決定站名與導覽。

07-project-final/src/layout/components/SiteHeader.jsx
import { useState } from 'react';
import {
Link,
NavLink,
useFetcher,
useLocation,
useRouteLoaderData,
} from 'react-router';
import AppBar from '@mui/material/AppBar';
import Avatar from '@mui/material/Avatar';
import Button from '@mui/material/Button';
import Drawer from '@mui/material/Drawer';
import Menu from '@mui/material/Menu';
import MenuItem from '@mui/material/MenuItem';
import SiteNav from './SiteNav.jsx';
import Icon from '../../_shared/Icon.jsx';

const item = ({ isActive }) =>
`inline-flex min-h-11 items-center rounded-full px-3 font-bold ${isActive ? 'bg-action text-white' : 'text-ink hover:bg-mist'}`;

export default function SiteHeader() {
const { user } = useRouteLoaderData('root');
const fetcher = useFetcher();
const { pathname } = useLocation();
const admin = pathname.startsWith('/admin');
const [open, setOpen] = useState(false);
const [anchor, setAnchor] = useState(null);
const close = () => {
setOpen(false);
setAnchor(null);
};
const logout = () => {
close();
fetcher.submit({ intent: 'logout' }, { method: 'post', action: '/logout' });
};
const session = admin ? user?.provider === 'password' : Boolean(user);
const label = user?.displayName || user?.email || '';

const account = (extra = '') =>
session ? (
<Button
type="button"
aria-expanded={Boolean(anchor)}
onClick={(event) => setAnchor(event.currentTarget)}
className={`gap-2 text-ink ${extra}`}
>
<Avatar className="h-8 w-8 bg-action text-base font-bold text-white">
{label.slice(0, 1).toUpperCase()}
</Avatar>
{label}
</Button>
) : (
<Button
component={Link}
to={admin ? '/admin/login' : '/login'}
onClick={close}
>
{admin ? '後台登入' : '登入'}
</Button>
);

const links = (id) =>
admin ? (
<nav id={id} className="flex flex-col gap-1 md:flex-row md:items-center">
<NavLink to="/admin" end className={item} onClick={close}>
行程管理
</NavLink>
<NavLink to="/admin/bookings" className={item} onClick={close}>
報名清單
</NavLink>
</nav>
) : (
<SiteNav onNavigate={close} id={id} />
);

return (
<AppBar id="site-header" position="sticky" component="header">
<div className="relative mx-auto flex w-full max-w-6xl items-center justify-between gap-3 px-4 py-2 sm:px-6">
<Link
to={admin ? '/admin' : '/'}
className="font-serif text-2xl font-semibold text-ink"
>
{admin ? '洛奇旅行 · 後台' : '洛奇旅行'}
</Link>
<Button
id="nav-toggle"
className="md:hidden"
variant="outlined"
startIcon={<Icon name="menu" />}
aria-expanded={open}
aria-controls="site-drawer"
onClick={() => setOpen(true)}
>
選單
</Button>
<div className="hidden items-center gap-1 md:flex">
{links('site-nav')}
{account()}
</div>
</div>
<Menu
anchorEl={anchor}
open={Boolean(anchor)}
onClose={() => setAnchor(null)}
>
{admin ? null : (
<MenuItem component={Link} to="/me" onClick={close}>
我的報名
</MenuItem>
)}
<MenuItem onClick={logout}>登出</MenuItem>
</Menu>
<Drawer anchor="right" open={open} onClose={close}>
<div id="site-drawer" className="flex flex-col gap-2 p-4">
{links(undefined)}
{account('justify-start')}
</div>
</Drawer>
</AppBar>
);
}

解析

  • 頁首在前台看有沒有 user,在 /admin 底下還要求 provider === 'password'。未登入時的按鈕仍依路徑顯示「登入」或「後台登入」。
  • 登出是對 /logout 的 fetcher POST,不先換頁;網址留在原處,直到 redirect 把人送回首頁。

前台登入頁的按鈕改成這條路由的 Form。

07-project-final/src/features/auth/LoginPage.jsx
import {
Form,
redirect,
useActionData,
useNavigate,
useNavigation,
useSearchParams,
} from 'react-router';
import { GoogleAuthProvider, signInWithPopup } from 'firebase/auth';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import Dialog from '@mui/material/Dialog';
import DialogActions from '@mui/material/DialogActions';
import DialogContent from '@mui/material/DialogContent';
import DialogTitle from '@mui/material/DialogTitle';
import { safeNext, session } from '../../auth.js';
import { auth, missingFirebaseMessage } from '../../firebase.js';

export const loader = async ({ request }) => {
const current = await session();
if (!current.firebaseReady) return current;
if (current.user) {
const next = new URL(request.url).searchParams.get('next');
throw redirect(safeNext(next));
}
return current;
};

export const action = async ({ request }) => {
const form = await request.formData();
const next = safeNext(String(form.get('next') ?? ''));
if (!auth) return { error: missingFirebaseMessage };
try {
await signInWithPopup(auth, new GoogleAuthProvider());
return redirect(next);
} catch (err) {
const closed =
err.code === 'auth/popup-closed-by-user' ||
err.code === 'auth/cancelled-popup-request';
return {
error: closed
? '已關閉登入視窗。'
: err.code === 'auth/popup-blocked'
? '瀏覽器擋住了登入視窗。'
: err.message,
};
}
};

export default function LoginPage() {
const navigate = useNavigate();
const navigation = useNavigation();
const actionData = useActionData();
const [params] = useSearchParams();
const back = safeNext(params.get('next'));
const submitting =
navigation.state === 'submitting' &&
new URL(navigation.formAction, 'http://localhost').pathname === '/login';

return (
<main className="flex-1">
<title>用 Google 帳號繼續 · 洛奇旅行</title>
<Dialog open onClose={() => navigate('/')} fullWidth maxWidth="xs">
<DialogTitle className="font-serif text-4xl leading-tight">
用 Google 帳號繼續
</DialogTitle>
<DialogContent>
<p>
報名和我的報名會使用 Google 的姓名與 email。我們不另外設定密碼。
</p>
{actionData?.error ? (
<Alert className="mt-4" severity="error">
{actionData.error}
</Alert>
) : null}
</DialogContent>
<Form method="post">
<input type="hidden" name="next" value={back} />
<DialogActions className="flex flex-col items-stretch gap-3 px-6 pb-6">
<Button type="submit" variant="contained" disabled={submitting}>
{submitting ? '登入中…' : '用 Google 帳號繼續'}
</Button>
<Button type="button" onClick={() => navigate('/')}>
返回首頁
</Button>
</DialogActions>
</Form>
</Dialog>
</main>
);
}

解析

  • Google 視窗由 signInWithPopup 打開。取消或失敗時 action 回傳錯誤,useActionData 顯示在對話框裡。成功後導向 next,頁面沒有在 effect 裡手動換頁。

報名頁的 loader 先 requireUser。

07-project-final/src/features/booking/BookingPage.jsx
import { data, redirect, useLoaderData } from 'react-router';
import Typography from '@mui/material/Typography';
import BookingForm from './components/BookingForm.jsx';
import BookingSteps from './components/BookingSteps.jsx';
import BookingSummary from './components/BookingSummary.jsx';
import { createOrder, getTour } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { requireUser } from '../../auth.js';
import { missingFirebaseMessage } from '../../firebase.js';

export const loader = async ({ request }) => {
const gate = await requireUser(request);
if (!gate.firebaseReady)
return { firebaseReady: false, tour: null, departure: null, user: null };
const url = new URL(request.url);
const tour = await getTour(
url.searchParams.get('tourId') || 'hualien-taroko',
);
const departure =
tour?.departures?.find(
(item) => item.id === url.searchParams.get('departureId'),
) || tour?.departures?.[0];
if (!tour || !departure) throw data('找不到頁面', { status: 404 });
return { firebaseReady: true, tour, departure, user: gate.user };
};

export const action = async ({ request }) => {
const gate = await requireUser(request);
if (!gate.firebaseReady) return { error: missingFirebaseMessage };
const form = await request.formData();
const phone = String(form.get('phone') ?? '').trim();
const name = gate.user.displayName || '';
const email = gate.user.email || '';
if (!name.trim() || !email.includes('@') || !phone)
return {
error:
name.trim() && email.includes('@')
? '請填電話,此欄必填'
: '請確認 Google 帳號帶有姓名與 email,並填電話',
};
const row = await createOrder({
uid: gate.user.uid,
tourId: String(form.get('tourId')),
tourTitle: String(form.get('tourTitle')),
departureId: String(form.get('departureId')),
date: String(form.get('date')),
people: Number(form.get('people')),
name: name.trim(),
email: email.trim(),
phone,
subtotal: Number(form.get('subtotal')),
});
return redirect(`/booking/${row.id}`);
};

export default function BookingPage() {
const { firebaseReady: ready, tour, departure, user } = useLoaderData();
if (!ready) return <MissingFirebase />;

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>報名 · 洛奇旅行</title>
<BookingSteps activeStep={1} />
<Typography variant="h1">報名</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
姓名與 email 來自 Google 帳號。請留下電話,送出後會寫進訂單。
</p>
<div className="mt-10 grid items-start gap-8 lg:grid-cols-[minmax(0,1.15fr)_minmax(18rem,22rem)]">
<BookingForm tour={tour} departure={departure} user={user} />
<BookingSummary tour={tour} departure={departure} />
</div>
</main>
);
}

解析

  • 未登入會被帶到登入頁,網址帶 next。action 呼叫 createOrder 並帶上 uid,再導向完成頁(/booking/ 加訂單編號)。

報名表的姓名與 email 改成唯讀。

07-project-final/src/features/booking/components/BookingForm.jsx
import { useState } from 'react';
import { Form, useActionData, useNavigation } from 'react-router';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import TextField from '@mui/material/TextField';
import Typography from '@mui/material/Typography';
import { ntd } from '../../../format.js';
import FieldSelect from '../../../_shared/FieldSelect.jsx';

export default function BookingForm({ tour, departure, user }) {
const actionData = useActionData();
const navigation = useNavigation();
const [people, setPeople] = useState('2');
const [phone, setPhone] = useState('');
const [submitted, setSubmitted] = useState(false);
const name = user?.displayName || '';
const email = user?.email || '';
const subtotal = tour.price * Number(people);
const error = actionData?.error ?? '';
const submitting =
navigation.state === 'submitting' &&
new URL(navigation.formAction, 'http://localhost').pathname === '/booking';

return (
<Form
id="booking-form"
method="post"
replace
noValidate
className="rounded-card bg-white shadow-card grid gap-4 p-6 md:p-8"
onSubmit={() => setSubmitted(true)}
>
<Typography variant="h2">填寫資料</Typography>
<input type="hidden" name="tourId" value={tour.id} />
<input type="hidden" name="tourTitle" value={tour.title} />
<input type="hidden" name="departureId" value={departure.id} />
<input type="hidden" name="date" value={departure.date} />
<input type="hidden" name="people" value={people} />
<input type="hidden" name="subtotal" value={subtotal} />
<div className="grid gap-4 sm:grid-cols-2">
<TextField
label="姓名"
value={name}
slotProps={{ input: { readOnly: true } }}
error={submitted && !name.trim()}
/>
<TextField
label="Email"
type="email"
value={email}
slotProps={{ input: { readOnly: true } }}
error={submitted && !email.includes('@')}
/>
</div>
<FieldSelect
id="people"
label="人數"
value={people}
onChange={setPeople}
options={[1, 2, 3, 4, 5, 6, 7, 8].map((count) => ({
value: String(count),
label: String(count),
}))}
/>
<TextField
name="phone"
label="電話"
type="tel"
required
placeholder="0912000111"
value={phone}
error={submitted && !phone.trim()}
helperText=" "
onChange={(event) => setPhone(event.target.value)}
/>
{error ? <Alert severity="error">{error}</Alert> : null}
<p>
小計{' '}
<span className="font-serif text-2xl font-bold text-action">
{ntd(subtotal)}
</span>
</p>
<p className="text-muted">小計會依人數更新。送出後我們用 email 確認。</p>
<Button type="submit" variant="contained" disabled={submitting}>
{submitting ? '送出中…' : '送出報名'}
</Button>
</Form>
);
}

解析

  • 這兩個欄位來自 loader 的使用者。電話仍手填;空著時 action 回傳「請填電話,此欄必填」。

完成頁改讀 Firestore 的訂單。

07-project-final/src/features/booking/BookingResultPage.jsx
import { data, Link, useLoaderData } from 'react-router';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import Chip from '@mui/material/Chip';
import Typography from '@mui/material/Typography';
import BookingReceipt from './components/BookingReceipt.jsx';
import BookingSteps from './components/BookingSteps.jsx';
import { getOrder } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { requireUser } from '../../auth.js';
import { statusLabel } from '../../format.js';

export const loader = async ({ request, params }) => {
const gate = await requireUser(request);
if (!gate.firebaseReady) return { firebaseReady: false, row: null };
const row = await getOrder(params.id).catch(() => null);
if (!row || row.uid !== gate.user.uid)
throw data('找不到頁面', { status: 404 });
return { firebaseReady: true, row };
};

export default function BookingResultPage() {
const { firebaseReady: ready, row } = useLoaderData();
if (!ready) return <MissingFirebase />;

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>報名已送出 · 洛奇旅行</title>
<BookingSteps activeStep={2} />
<Chip color="primary" label={statusLabel[row.status] || '待確認'} />
<Typography variant="h1" className="mt-3 max-w-[10em]">
報名已送出
</Typography>
<Alert className="mt-4 max-w-prose" severity="success">
我們會用 email 再跟你確認。到「我的報名」可以查看這一筆。
</Alert>
<BookingReceipt row={row} />
<div className="mt-8 flex flex-wrap gap-3">
<Button component={Link} to="/me" variant="contained">
看我的報名
</Button>
<Button component={Link} to="/tours" variant="outlined">
回行程
</Button>
</div>
</main>
);
}

解析

  • loader 用 getOrder。找不到、規則不允許讀,或訂單的 uid 不是目前登入者時,都丟 404,導向路由上最近的 errorElement,畫出找不到頁面。

明細跟著改讀這一筆訂單。

07-project-final/src/features/booking/components/BookingReceipt.jsx
import Typography from '@mui/material/Typography';
import { ntd, statusLabel } from '../../../format.js';

export default function BookingReceipt({ row }) {
return (
<>
<Typography variant="h2" className="mt-10">
這筆內容
</Typography>
<dl className="rounded-card bg-white shadow-card mt-4 max-w-prose divide-y divide-line px-5">
{[
['行程', row.tourTitle],
['出發日', row.date],
['人數', row.people],
['姓名', row.name],
['電話', row.phone],
['小計', ntd(row.subtotal)],
['狀態', statusLabel[row.status] || row.status],
].map(([label, value]) => (
<div key={label} className="grid gap-1 py-3 sm:grid-cols-[8rem_1fr]">
<dt className="text-muted">{label}</dt>
<dd
className={
label === '小計'
? 'font-serif text-2xl font-bold text-action'
: undefined
}
>
{value}
</dd>
</div>
))}
</dl>
</>
);
}

解析

  • 欄位仍是行程、出發日、聯絡人與金額,來源改成 loader 拿到的訂單文件。

我的報名改列這位使用者的訂單。

07-project-final/src/features/booking/MyBookingsPage.jsx
import { Link, useLoaderData } from 'react-router';
import Button from '@mui/material/Button';
import Typography from '@mui/material/Typography';
import MyBookingRow from './components/MyBookingRow.jsx';
import { listMyOrders } from '../../api.js';
import { MissingFirebase } from '../../AccessNotice.jsx';
import { requireUser } from '../../auth.js';

export const loader = async ({ request }) => {
const gate = await requireUser(request);
if (!gate.firebaseReady) return { firebaseReady: false, rows: [] };
return {
firebaseReady: true,
rows: await listMyOrders(gate.user.uid),
};
};

export default function MyBookingsPage() {
const { firebaseReady: ready, rows } = useLoaderData();
if (!ready) return <MissingFirebase />;

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>我的報名 · 洛奇旅行</title>
<Typography variant="h1">我的報名</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
這裡列出這個 Google 帳號的訂單。如需改期或取消,請來信或來電。
</p>
{rows.length ? (
<>
<Typography variant="h2" className="mt-10">
你的報名
</Typography>
<div className="rounded-card bg-white shadow-card mt-6 max-w-3xl divide-y divide-line px-5">
{rows.map((item) => (
<MyBookingRow
key={item.id}
status={item.status}
title={item.tourTitle}
date={item.date}
people={item.people}
phone={item.phone}
subtotal={item.subtotal}
/>
))}
</div>
</>
) : (
<section className="mt-10 max-w-3xl">
<Typography id="empty-title" variant="h2">
還沒有報名
</Typography>
<p className="mt-3 max-w-prose">選一個行程,挑一個出發日。</p>
<Button
className="mt-6"
component={Link}
to="/tours"
variant="contained"
>
去看行程
</Button>
</section>
)}
</main>
);
}

解析

  • loader 先 requireUser,再呼叫 listMyOrders(uid),不再讀 mySamples。

報名種子補上 uid,對應 Firestore 訂單的欄位。範例資料仍留在檔裡,但我的報名已改讀雲端訂單,不再使用它。

07-project-final/src/features/booking/mock.data.js
/** 後台清單。姓名與「我的報名」範例不一致,兩頁各自照靜態模板。 */
export const bookings = [
{
id: 'b1',
tourId: 'hualien-taroko',
tourTitle: '花蓮太魯閣與七星潭四日',
departureId: '2026-12-18',
date: '2026-12-18',
people: 2,
name: '林可',
email: 'lin@example.com',
phone: '0912000111',
subtotal: 53600,
uid: 'demo-lin',
status: 'pending',
},
{
id: 'b2',
tourId: 'kyoto-nara',
tourTitle: '京都嵐山、伏見與奈良五日',
departureId: '2027-04-06',
date: '2027-04-06',
people: 1,
name: '陳予安',
email: 'chen@example.com',
phone: '0912000222',
subtotal: 52800,
uid: 'demo-chen',
status: 'confirmed',
},
{
id: 'b3',
tourId: 'tainan-anping',
tourTitle: '台南府城與安平兩日',
departureId: '2026-11-28',
date: '2026-11-28',
people: 3,
name: '周以寧',
email: 'chou@example.com',
phone: '0912000333',
subtotal: 26400,
uid: 'demo-chou',
status: 'cancelled',
},
{
id: 'b4',
tourId: 'taipei-beitou',
tourTitle: '台北大稻埕與北投溫泉三日',
departureId: '2026-12-04',
date: '2026-12-04',
people: 2,
name: '何品',
email: 'ho@example.com',
phone: '0912000444',
subtotal: 37200,
uid: 'demo-ho',
status: 'confirmed',
},
];

/** 我的報名頁照模板:四筆都掛在林可底下,不匯入後台種子。 */
export const mySamples = [
{
status: 'pending',
title: '花蓮太魯閣與七星潭四日',
date: '2026-12-18',
people: 2,
phone: '0912000111',
subtotal: 53600,
},
{
status: 'confirmed',
title: '京都嵐山、伏見與奈良五日',
date: '2027-04-06',
people: 1,
phone: '0912000222',
subtotal: 52800,
},
{
status: 'cancelled',
title: '台南府城與安平兩日',
date: '2026-11-28',
people: 3,
phone: '0912000333',
subtotal: 26400,
},
{
status: 'confirmed',
title: '台北大稻埕與北投溫泉三日',
date: '2026-12-04',
people: 2,
phone: '0912000444',
subtotal: 37200,
},
];

解析

  • 後台那四筆種子補上 uid。mySamples 還在同一份檔裡,但我的報名不會再 import 它。

選讀:管理員、規則與部署

前台已經能讀行程、能以 Google 帳號寫自己的訂單。這一節補上 email/密碼登入,後台清單改讀 Firestore,最後貼上安全規則,並把網站部署到 Firebase Hosting。

登入與受保護畫面

後台帳號要先在主控台準備:Authentication 的「登入方式」啟用「電子郵件/密碼」(不開電子郵件連結登入),再到「使用者」分頁新增一組 email 與密碼,這就是管理員。網站本身沒有註冊表單。

後台登入頁的 action 呼叫 signInWithEmailAndPassword,成功後導向 /admin/bookings。

行程管理與報名清單的 loader 都呼叫 requireAdmin。沒有設定 Firebase 時畫出未設定的提示;已登入但不是密碼登入時畫警告畫面,並留一顆到後台登入的按鈕。

行程的新增、修改與刪除仍是列表上的對話框。useFetcher 把表單送到這一條路由的 action,網址留在 /admin;action 再呼叫服務函式把結果寫進雲端。

先接後台登入頁。

07-project-final/src/features/admin/AdminLoginPage.jsx
import { Form, redirect, useActionData, useNavigation } from 'react-router';
import { signInWithEmailAndPassword } from 'firebase/auth';
import Alert from '@mui/material/Alert';
import Button from '@mui/material/Button';
import Paper from '@mui/material/Paper';
import TextField from '@mui/material/TextField';
import Typography from '@mui/material/Typography';
import { session } from '../../auth.js';
import { auth, missingFirebaseMessage } from '../../firebase.js';

export const loader = async () => {
const current = await session();
if (current.user?.provider === 'password') throw redirect('/admin/bookings');
return current;
};

export const action = async ({ request }) => {
const form = await request.formData();
if (!auth) return { error: missingFirebaseMessage };
try {
await signInWithEmailAndPassword(
auth,
String(form.get('email') ?? '').trim(),
String(form.get('password') ?? ''),
);
return redirect('/admin/bookings');
} catch (err) {
return {
error:
err.code === 'auth/invalid-credential'
? 'email 或密碼不對。請用主控台建立的那一組。'
: err.message,
};
}
};

export default function AdminLoginPage() {
const navigation = useNavigation();
const actionData = useActionData();
const submitting =
navigation.state === 'submitting' &&
new URL(navigation.formAction, 'http://localhost').pathname ===
'/admin/login';

return (
<main className="mx-auto flex w-full max-w-6xl flex-1 flex-col px-4 py-16 sm:px-6 md:py-24">
<title>後台登入 · 洛奇旅行</title>
<Paper
elevation={0}
className="rounded-card bg-white shadow-card max-w-md p-6 md:p-8"
>
<Form method="post" className="grid gap-4">
<Typography variant="h1">後台登入</Typography>
<p className="text-lg leading-relaxed">
使用主控台建立的 email 與密碼。網站上沒有註冊表單。
</p>
<TextField
name="email"
label="Email"
type="email"
autoComplete="username"
required
/>
<TextField
name="password"
label="密碼"
type="password"
autoComplete="current-password"
required
/>
{actionData?.error ? (
<Alert severity="error">{actionData.error}</Alert>
) : null}
<Button type="submit" variant="contained" disabled={submitting}>
{submitting ? '登入中…' : '登入'}
</Button>
</Form>
</Paper>
</main>
);
}

解析

  • 登入表單沒有 effect。錯誤訊息來自 useActionData,送出中用 useNavigation 停用按鈕。成功後 redirect('/admin/bookings')。

行程管理的 loader 改呼叫 requireAdmin,寫入改走 Firestore。

07-project-final/src/features/admin/AdminToursPage.jsx
import { useState } from 'react';
import { Link, useFetcher, useLoaderData } from 'react-router';
import Button from '@mui/material/Button';
import Typography from '@mui/material/Typography';
import DeleteTourDialog from './components/DeleteTourDialog.jsx';
import TourTable from './components/TourTable.jsx';
import TourForm from './components/TourForm.jsx';
import NoticeSnackbar from '../../_shared/NoticeSnackbar.jsx';
import { tourFromDraft } from './components/tourDraft.js';
import { deleteTour, listTours, saveTour } from '../../api.js';
import { AdminDenied, MissingFirebase } from '../../AccessNotice.jsx';
import { requireAdmin } from '../../auth.js';
import { missingFirebaseMessage } from '../../firebase.js';

const gateOr = async (request) => {
const gate = await requireAdmin(request);
if (!gate.firebaseReady) return { error: missingFirebaseMessage };
if (gate.denied) return { error: '這個帳號不能進入後台。' };
return null;
};

/**
* 行程管理頁的 loader。先經過 requireAdmin。Firebase 未備好或沒有權限時回傳旗標與空陣列,通過後呼叫 listTours。
* 回傳值交給頁面的 useLoaderData。
* @param {{ request: Request }} args
* @returns {Promise<{ firebaseReady: boolean, denied: boolean, tours: object[] }>}
*/
export const loader = async ({ request }) => {
const gate = await requireAdmin(request);
if (!gate.firebaseReady || gate.denied)
return {
firebaseReady: gate.firebaseReady,
denied: Boolean(gate.denied),
tours: [],
};
return {
firebaseReady: true,
denied: false,
tours: await listTours(),
};
};

/**
* 接收這一頁的表單。先經過 requireAdmin,未通過就回傳 { error }。
* intent 為 delete 時刪除該筆並回傳 { notice }。
* 否則把 draft 交給 tourFromDraft,再交給 saveTour。失敗回傳 { error },成功回傳 { notice, saved: true }。
* 同一 key 的 useFetcher 可從 fetcher.data 讀到這份結果。
* @param {{ request: Request }} args
* @returns {Promise<{ notice: string, saved?: boolean } | { error: string }>}
*/
export const action = async ({ request }) => {
const blocked = await gateOr(request);
if (blocked) return blocked;
const form = await request.formData();
if (form.get('intent') === 'delete') {
await deleteTour(String(form.get('id')));
return { notice: '已刪除這筆行程' };
}
const editingId = String(form.get('editingId') ?? '');
const { error, tour } = tourFromDraft(JSON.parse(String(form.get('draft'))));
if (error) return { error };
await saveTour(editingId, tour);
return { notice: '已儲存這筆行程', saved: true };
};

/**
* 行程管理頁。未備好或沒有權限時改畫提示。
* useFetcher({ key: 'tour-form' }) 與 TourForm 共用同一個 fetcher。
* 渲染時比對尚未處理的 save.data;有 { saved: true } 就關窗並寫入 notice。
* 打開 Dialog 時呼叫 save.reset(),清掉上一次留下的資料。刪除另用一個沒有 key 的 fetcher。
* @returns {JSX.Element}
*/
export default function AdminToursPage() {
const { firebaseReady: ready, denied, tours } = useLoaderData();
const save = useFetcher({ key: 'tour-form' });
const remove = useFetcher();
const [open, setOpen] = useState(false);
const [tour, setTour] = useState(null);
const [deletingTour, setDeletingTour] = useState(null);
const [notice, setNotice] = useState('');
const [seenSave, setSeenSave] = useState(null);
const [seenRemove, setSeenRemove] = useState(null);
if (save.state === 'idle' && save.data?.saved && save.data !== seenSave) {
setSeenSave(save.data);
setOpen(false);
setNotice(save.data.notice);
}
if (
remove.state === 'idle' &&
remove.data?.notice &&
remove.data !== seenRemove
) {
setSeenRemove(remove.data);
setDeletingTour(null);
setNotice(remove.data.notice);
}
if (!ready) return <MissingFirebase />;
if (denied) return <AdminDenied />;

const close = () => setOpen(false);
const openTour = (item) => {
save.reset();
setTour(item);
setOpen(true);
};

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>行程管理 · 洛奇旅行</title>
<p className="font-bold text-action">管理員</p>
<Typography variant="h1" className="mt-2">
行程管理
</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
新增、修改或下架行程。清單來自
Firestore。還沒有資料時,先寫入種子。兩頁用頁首切換。
</p>
<div className="mt-8 flex flex-wrap gap-3">
<Button variant="outlined" onClick={() => openTour(null)}>
新增行程
</Button>
<Button component={Link} to="/seed" variant="outlined">
寫入種子
</Button>
</div>
{tours.length ? (
<TourTable tours={tours} onEdit={openTour} onDelete={setDeletingTour} />
) : (
<p className="mt-8 text-base text-muted">還沒有行程。</p>
)}
<TourForm
key={open ? (tour?.id ?? 'create') : 'closed'}
open={open}
tour={tour}
onClose={close}
/>
<DeleteTourDialog
tour={deletingTour}
busy={remove.state !== 'idle'}
onClose={() => setDeletingTour(null)}
onConfirm={() =>
remove.submit(
{ intent: 'delete', id: deletingTour?.id },
{ method: 'post' },
)
}
/>
<NoticeSnackbar notice={notice} onClose={() => setNotice('')} />
</main>
);
}

解析

  • requireAdmin 先經過 requireUser。未登入的人會離開這個網址;登入方式不對的人留在原頁,看到警告。
  • 刪除用 remove.submit 送出,帶 intent: 'delete'。儲存由 TourForm 用 key 為 tour-form 的另一個 fetcher 送出草稿。
  • 頁面在渲染時比對尚未處理的結果,成功就關窗並把通知交給 NoticeSnackbar。打開 Dialog 時呼叫 save.reset(),避免重開時還顯示舊的錯誤。

訂單清單與狀態

報名清單的 loader 呼叫 listOrders,改狀態的 action 呼叫 updateOrderStatus。對話框用 fetcher 送出,網址留在 /admin/bookings。訂單沒有實體刪除,狀態改成已取消就從作業流程拿掉,文件還在。

07-project-final/src/features/admin/AdminBookingsPage.jsx
import { useState } from 'react';
import { useFetcher, useLoaderData } from 'react-router';
import Typography from '@mui/material/Typography';
import BookingFilters from './components/BookingFilters.jsx';
import BookingTable from './components/BookingTable.jsx';
import BookingForm from './components/BookingForm.jsx';
import NoticeSnackbar from '../../_shared/NoticeSnackbar.jsx';
import { listOrders, updateOrderStatus } from '../../api.js';
import { AdminDenied, MissingFirebase } from '../../AccessNotice.jsx';
import { requireAdmin } from '../../auth.js';
import { missingFirebaseMessage } from '../../firebase.js';

/**
* 報名清單頁的 loader。先經過 requireAdmin。Firebase 未備好或沒有權限時回傳旗標與空陣列,通過後呼叫 listOrders。
* 回傳值交給頁面的 useLoaderData。
* @param {{ request: Request }} args
* @returns {Promise<{ firebaseReady: boolean, denied: boolean, bookings: object[] }>}
*/
export const loader = async ({ request }) => {
const gate = await requireAdmin(request);
if (!gate.firebaseReady || gate.denied)
return {
firebaseReady: gate.firebaseReady,
denied: Boolean(gate.denied),
bookings: [],
};
return {
firebaseReady: true,
denied: false,
bookings: await listOrders(),
};
};

/**
* 接收明細表單。先經過 requireAdmin,未通過就回傳 { error }。
* 讀 id 與 status,交給 updateOrderStatus。成功回傳 { notice },失敗回傳 { error }。
* 同一 key 的 useFetcher 可從 fetcher.data 讀到這份結果。
* @param {{ request: Request }} args
* @returns {Promise<{ notice: string } | { error: string }>}
*/
export const action = async ({ request }) => {
const gate = await requireAdmin(request);
if (!gate.firebaseReady) return { error: missingFirebaseMessage };
if (gate.denied) return { error: '這個帳號不能進入後台。' };
const form = await request.formData();
try {
await updateOrderStatus(String(form.get('id')), String(form.get('status')));
return { notice: '已更新報名狀態' };
} catch (err) {
return { error: err.message };
}
};

/**
* 報名清單頁。未備好或沒有權限時改畫提示。
* useFetcher({ key: 'booking-form' }) 與 BookingForm 共用同一個 fetcher。
* 渲染時比對尚未處理的 save.data;有 notice 就關窗並寫入提示。
* 打開 Dialog 時呼叫 save.reset(),清掉上一次留下的資料。
* @returns {JSX.Element}
*/
export default function AdminBookingsPage() {
const { firebaseReady: ready, denied, bookings } = useLoaderData();
const save = useFetcher({ key: 'booking-form' });
const [status, setStatus] = useState('all');
const [query, setQuery] = useState('');
const [sort, setSort] = useState('date-desc');
const [open, setOpen] = useState(false);
const [booking, setBooking] = useState(null);
const [notice, setNotice] = useState('');
const [seenSave, setSeenSave] = useState(null);
if (save.state === 'idle' && save.data?.notice && save.data !== seenSave) {
setSeenSave(save.data);
setOpen(false);
setNotice(save.data.notice);
}
if (!ready) return <MissingFirebase />;
if (denied) return <AdminDenied />;

const keyword = query.trim();
const shown = bookings
.filter((item) => status === 'all' || item.status === status)
.filter((item) => !keyword || item.name?.includes(keyword))
.sort((a, b) =>
sort === 'date-asc'
? a.date.localeCompare(b.date)
: b.date.localeCompare(a.date),
);

const close = () => setOpen(false);

return (
<main className="mx-auto w-full max-w-6xl flex-1 px-4 py-16 sm:px-6 md:py-24">
<title>報名清單 · 洛奇旅行</title>
<p className="font-bold text-action">管理員</p>
<Typography variant="h1" className="mt-2">
報名清單
</Typography>
<p className="mt-3 max-w-prose text-lg leading-relaxed text-muted">
查看所有訂單,點一筆看明細並改狀態。兩頁用頁首切換。
</p>
<BookingFilters
status={status}
query={query}
sort={sort}
onStatusChange={setStatus}
onQueryChange={setQuery}
onSortChange={setSort}
/>
{shown.length ? (
<BookingTable
bookings={shown}
onView={(item) => {
save.reset();
setBooking(item);
setOpen(true);
}}
/>
) : (
<p className="mt-8 text-base text-muted">沒有符合的報名。</p>
)}
<BookingForm
key={open ? booking.id : 'closed'}
open={open}
booking={booking}
onClose={close}
/>
<NoticeSnackbar notice={notice} onClose={() => setNotice('')} />
</main>
);
}

解析

  • 篩選、搜尋與排序仍在瀏覽器裡做,對的是 loader 已經拿回來的陣列。
  • 狀態送出後 loader 重跑,列表換成雲端上的新狀態。頁面用 key 為 booking-form 的 fetcher 在渲染時讀取結果,成功就關窗並寫入通知。打開 Dialog 時呼叫 save.reset(),避免重開時還顯示舊的錯誤。
  • 這一頁同樣先看 firebaseReady 與 denied,沒有通過就不會呼叫 listOrders。

安全規則與 Firebase Hosting

規則是伺服器上的判斷,跟 React 的閘門各寫一次。閘門決定畫不畫。規則決定 SDK 的請求過不過。這一節的規則全文只放在 firestore.rules,主控台貼上同一份,不要在別處再寫一套。

步驟 1:貼上規則

tours 任何人可讀,管理員可寫。種子與後台表單都走這條規則,所以要先用後台帳號登入再寫入。

orders 的新增要已登入,而且新文件的 uid 等於登入者的 request.auth.uid,狀態是 pending,姓名、email、電話是字串,人數是 1 到 8 的整數。讀取限文件主人或密碼登入的管理員,更新只限管理員,刪除不開放;把狀態改為已取消就是訂單的軟刪。

07-project-final/firestore.rules
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
function signedIn() {
return request.auth != null;
}
function isAdmin() {
return signedIn() && request.auth.token.firebase.sign_in_provider == 'password';
}
function isOwner() {
return signedIn() && resource.data.uid == request.auth.uid;
}

match /tours/{tourId} {
allow read: if true;
allow write: if isAdmin();
}
match /orders/{orderId} {
allow create: if signedIn()
&& request.resource.data.uid == request.auth.uid
&& request.resource.data.status == 'pending'
&& request.resource.data.name is string
&& request.resource.data.email is string
&& request.resource.data.phone is string
&& request.resource.data.people is int
&& request.resource.data.people >= 1
&& request.resource.data.people <= 8;
allow read: if isOwner() || isAdmin();
allow update: if isAdmin();
allow delete: if false;
}
}
}

Firestore 主控台打開規則分頁,用這份取代測試模式的內容,發布。發布後做這些事確認:

  • 未登入時,行程列表仍看得到。
  • 未登入時,/booking 會到 /login?next=...。Google 登入後送出的訂單帶有自己的 uid。
  • Google 登入者打不開 /admin 的表單,也打不開 /admin/bookings 的清單。email/密碼登入後可以新增、修改、刪除行程,也看得到全部訂單並能改狀態。
  • /me 只列出自己的訂單。未登入打開 /seed 會被帶到登入頁,Google 登入則只看到說明;後台帳號登入後才能寫入種子。

graph TD
guest["未登入"] --> readTours["可讀 tours"]
guest --> deny["不可寫 tours、不可讀 orders"]
google["google.com"] --> own["可新增自己的 uid,可讀自己的訂單"]
google --> denyAdmin["不可寫 tours、不可讀全部、不可改狀態"]
password["password"] --> writeTours["可寫 tours"]
password --> all["可讀全部訂單,可改狀態"]

解析

  • allow write 涵蓋建立、更新與刪除。行程公開可讀,寫入限 isAdmin()。訂單不開放刪除(delete 為 false),因為訂單是帳務紀錄,改為已取消即軟刪。
  • isOwner 比對文件上的 uid 與登入者的 request.auth.uid。isAdmin 再要求登入方式是密碼。
  • request.auth 是 Authentication 帶上來的身分。沒登入時是 null。Google 登入時它不是 null,所以不能再用「有登入」代表管理員。
  • 新增時多檢查 status、姓名、email、電話與人數。表單仍先擋空的電話。規則擋的是直接呼叫 SDK 的請求。

步驟 2:部署到 Firebase Hosting

第 12 篇用 Live Server 打開 dist/ 時,內頁重新整理會拿到伺服器自己的 404,因為磁碟上沒有 /tours 這種實體路徑。React 網站只有一張進入頁 index.html,內頁的網址是前端路由。Firebase Hosting 用轉送把任意路徑都交給它,由前端路由接著畫,這就是單頁應用(SPA)要的設定。

在專案根目錄加上 firebase.json:對外提供的目錄指向打包後的 dist,轉送規則把所有路徑轉到 /index.html。

07-project-final/firebase.json
{
"hosting": {
"public": "dist",
"ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
"rewrites": [
{
"source": "**",
"destination": "/index.html"
}
]
}
}

解析

  • public 是 Hosting 對外提供的目錄,必須是建置產出的 dist/,不是原始碼的 src/。
  • rewrites 的來源 ** 代表所有路徑,目的地是 /index.html,而且只在該路徑沒有對應檔案時才轉送。無論是 /tours 還是 /booking/ 加某段 id,Hosting 都回這張進入頁,不會先回 404。
  • 忽略清單把設定檔、隱藏檔與 node_modules 排除在上傳之外。.env.local 本來就不會進 dist/,發布前仍要確認它沒有被 commit。

第 12 篇打包後的 JS 超過 500 kB,終端機會出現體積警告。這一節把 React、MUI 與 Firebase 拆成獨立檔,畫面不變。chunkSizeWarningLimit 只調整警告門檻,不改變檔案內容。

07-project-final/vite.config.js
 export default defineConfig({
plugins: [
react(),
babel({ presets: [reactCompilerPreset()] }),
tailwindcss(),
],
server: { host: 'localhost' },
preview: { host: 'localhost' },
+ build: {
+ chunkSizeWarningLimit: 600,
+ rolldownOptions: {
+ output: {
+ codeSplitting: {
+ groups: [
+ {
+ test: /node_modules\/(?:react|react-dom|react-router)\//,
+ name: 'react',
+ },
+ {
+ test: /node_modules\/(?:@mui|@emotion)/,
+ name: 'mui',
+ },
+ {
+ test: /node_modules\/firebase/,
+ name: 'firebase',
+ },
+ ],
+ },
+ },
+ },
+ },
});

解析

  • rolldownOptions 的 codeSplitting groups 只拆檔。畫面與規則都不會因為拆檔改變。React、MUI、Firebase 會變成 dist/assets/ 裡分開的 JS。
  • 警告門檻設在 vite.config.js 這一處。Firebase 那包大約 570 kB,所以門檻調到 600。

設定改好之後,再打包一次。

pnpm build

解析

  • 要發布能連線的版本,就在填好 .env.local 的電腦上執行 pnpm build。空的環境變數也能建置成功,那種產物打開後,行程頁會顯示尚未設定。

終端機會印出類似下面的內容。檔名後面的雜湊會隨內容改變。

vite v8.3.5 building client environment for production...
transforming...
✓ 771 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html 1.28 kB │ gzip: 0.59 kB
dist/assets/index-DH4_-ABJ.css 26.92 kB │ gzip: 5.83 kB
dist/assets/rolldown-runtime-WkwZ5CU-.js 0.59 kB │ gzip: 0.36 kB
dist/assets/index-DyVrHxsD.js 110.78 kB │ gzip: 35.10 kB
dist/assets/react-H9wOv-UQ.js 318.42 kB │ gzip: 100.36 kB
dist/assets/mui-BUB7IzpO.js 301.53 kB │ gzip: 90.84 kB
dist/assets/firebase-C_y40IS3.js 569.17 kB │ gzip: 170.63 kB

✓ built in 2.61s

解析

  • 檔名後面的雜湊會隨內容改變,每個拆出來的檔案各有一份。

若專案根目錄還沒有 .firebaserc,先安裝 Firebase CLI(套件 firebase-tools),用 firebase login 登入,再用 firebase use 選定這個專案,最後部署。

firebase deploy

解析

  • 建置產物資料夾已在 .gitignore,不會進版控。更新線上網站時,先 pnpm build 再 firebase deploy。
  • 2025 年 4 月 28 日之後建立的專案,授權網域預設不含 localhost;本機測試登入前,先到 Authentication 的設定頁手動加入。發布後若使用 Firebase 給的網域或自訂網域,再把那個網域加進 Authentication 的授權網域。

本篇重點回顧

  • 前台用 signInWithPopup 做 Google 登入。訂單寫入 uid,我的報名只查自己的 uid。
  • 後台用 signInWithEmailAndPassword。管理員帳號在主控台手動新增。網站沒有 email 註冊表單。
  • 主控台的 Authentication 啟用「Google」與「電子郵件/密碼」。不要啟用電話。不要升級 Identity Platform。
  • Firebase 的網頁設定放在 .env.local,以 VITE_ 開頭。範例檔是 .env.example。金鑰不要 commit。
  • src/api.js 集中 Firestore 讀寫。頁面透過 loader 接結果,非預期錯誤進錯誤頁,讀取中的提示顯示在版型裡。
  • 種子頁把範例行程寫進 tours,loader 要求管理員。已存在的文件略過,Google 帳號只看到說明,不會寫入。
  • 未登入進報名或後台時,loader 重新導向 /login?next=...。密碼以外的帳號留在後台頁,看到警告與按鈕。登出是對 /logout 的 POST。
  • firestore.rules 讓行程公開可讀、管理員可寫。訂單的讀取限主人或密碼登入者,更新只限密碼登入者,刪除不開放;改為已取消即軟刪。
  • 完成頁依網址上的訂單 id 呼叫 getOrder。讀不到、沒有權限或不是自己的訂單,就丟 404,由錯誤頁畫出找不到頁面。
  • 部署使用 Firebase Hosting:firebase.json 的轉送規則把所有路徑交給 /index.html,內頁重新整理才不會先拿到主機的 404。React、MUI 與 Firebase 用 codeSplitting 拆檔。連得上雲端的產物,要在有 .env.local 的電腦上建置。

專有名詞中英對照

從切版繼續

  • 切版(layout)
  • 開發伺服器(dev server)
  • 種子資料(seed data)
  • 記憶體狀態(in-memory state)

認識 Firebase

  • Firebase
  • 雲端文件資料庫(Cloud Firestore)
  • 集合(collection)
  • 文件(document)
  • 欄位(field)
  • 身份驗證(Firebase Authentication)
  • 安全規則(security rules)
  • 測試模式(test mode)
  • 環境變數(environment variable)
  • 網頁應用程式(web app)

讀寫介面

  • 資料層(data layer)
  • 服務函式(service function)
  • 換頁前讀取(loader)
  • useLoaderData
  • 表單送出(action)
  • 導覽狀態(useNavigation)

接到畫面

  • 文件識別碼(document id)
  • 使用者識別碼(uid)
  • 彈出視窗登入(signInWithPopup)
  • Google 登入(Google sign-in)
  • 登入重新導向(redirect to login)
  • 根路由資料(useRouteLoaderData)

管理員、規則與部署

  • 受保護畫面(protected view)
  • 工作階段(session)
  • 登入提供者(sign_in_provider)
  • 密碼登入(password)
  • 授權(authorization)
  • 軟刪除(soft delete)
  • Firebase Hosting
  • 轉送(rewrite)
  • 程式碼分割(code splitting)