<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by wei Tsao 學習紀錄 on Medium]]></title>
        <description><![CDATA[Stories by wei Tsao 學習紀錄 on Medium]]></description>
        <link>https://medium.com/@a578ff6?source=rss-815a6f17f603------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*Gx9-wyIXGlIsSfZLhUUM3w.jpeg</url>
            <title>Stories by wei Tsao 學習紀錄 on Medium</title>
            <link>https://medium.com/@a578ff6?source=rss-815a6f17f603------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 16:46:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@a578ff6/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[C78.用 Swift 解 LeetCode 的學習與紀錄]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/c78-%E7%94%A8-swift-%E8%A7%A3-leetcode-%E7%9A%84%E5%AD%B8%E7%BF%92%E8%88%87%E7%B4%80%E9%8C%84-6203dc4c1f4e?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/6203dc4c1f4e</guid>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[swift]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Sat, 05 Apr 2025 13:01:21 GMT</pubDate>
            <atom:updated>2025-04-06T06:08:18.628Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XMUUFxUyqoQJa8E-KN3PRg.png" /></figure><h3>目錄</h3><pre>· <a href="#46c2">1.想法</a><br>· <a href="#4e63">2.參考文章</a><br>· <a href="#be52">3.搭配工具</a><br>· <a href="#7c13">4.題型分類與練習紀錄</a><br>· <a href="#8ad3">5.每一題的練習方式與筆記格式</a><br>· <a href="#8ad3">6.心得與學習觀察</a><br>· <a href="#0f92">7.GitHub</a></pre><h3>1.想法</h3><ul><li>看了許多文章，覺得還是需要準備一下用 LeetCode 練習程式邏輯與 Swift 語法，一步步建立自己的刷題節奏與筆記系統。</li><li>所以在專案實作之餘，也想提升自己的邏輯思維。</li><li>因此請 AI 幫我歸類整理出「<strong>轉職時練習的題型</strong>」，作為練習補強的一環。</li></ul><pre>- 更熟悉 Swift 的語法、邏輯與資料結構<br><br>- 面試時對常見題型不陌生<br><br>- 建立自己的問題分析能力與解題筆記習慣</pre><h3>2.參考文章</h3><ul><li><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E5%95%8F%E9%A1%8C%E8%A7%A3%E7%AD%94%E9%9B%86/%E5%BE%9E-leetcode-%E8%A8%93%E7%B7%B4-swift-%E7%A8%8B%E5%BC%8F%E6%8A%80%E8%A1%93-%E6%BA%96%E5%82%99%E9%9D%A2%E8%A9%A6%E8%80%83%E9%A1%8C-6f634120f53e">從 LeetCode 訓練 Swift 程式技術 &amp; 準備面試考題</a></li><li><a href="https://medium.com/@hooy123456_58230/https-www-notion-so-1-two-sum-8ebbc65dadda437596cbdf87fcc90d1e-pvs-4-c9d7934fc95e">給各位前端大大們的 Leetcode 刷題指引</a></li><li><a href="https://tw.alphacamp.co/blog/leetcode-introduction#two-sum-%e9%80%99%e9%a1%8c%e8%a9%b2%e6%80%8e%e9%ba%bc%e7%9c%8b%e5%be%85">Leetcode 是什麼？誰需要刷題？必考題有哪些 - ALPHA Camp</a></li></ul><h3>3.搭配工具</h3><pre>1.先在 playground 輸入並測試，然後再貼到 LeetCode 上。<br><br>2.完成後再製作 README.md 記錄下來，並上傳至 GitHub 整理。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Xiy58aXHNrbZ_LPFH17oeA.png" /></figure><h3>4.題型分類與練習紀錄</h3><ul><li>主要請 AI 整理出的題型，並且將目前練過的題目依照題型與練習重點分類， 幫助自己釐清：「每題到底在練什麼？」</li><li>當然過程中也會延伸去做其他題型，加強觀念。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yfukt77L5KdWc2gSFwtuwg.png" /><figcaption>範例</figcaption></figure><h3>5.每一題的練習方式與筆記格式</h3><ul><li>依照以下的結構練習並紀錄：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tfRhxraEyGeipLqprdUbpA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4CCUlZlV8KbhVR2H4G1hsw.png" /></figure><pre>1.用自己的話對題目進行說明<br><br>2.解法方式的紀錄<br><br>3.語法複習<br><br>4.自己的理解筆記與註解</pre><ul><li>範例</li></ul><p><a href="https://github.com/a578ff6/leetcode-swift-solutions/blob/main/ReverseString/README.md">leetcode-swift-solutions/ReverseString/README.md at main · a578ff6/leetcode-swift-solutions</a></p><h3>6.心得與學習觀察</h3><ul><li>一開始常寫不出來，但參考 → 改寫 → 理解 → 成功記住</li></ul><pre>- 先從理解題目的方向開始，然後請 AI 逐步給我提示，讓我理解該題目的方向。</pre><ul><li>想出來後在去參考其他人的想法，解題思路。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DNkP5qSXtwOWrlTN4Df5jA.png" /></figure><ul><li>而且有一些題目是有重複的邏輯<strong>（雙指標、字典統計）</strong>，也可以藉此強化思考的不同面向。</li><li>然後在透過 Markdown 紀錄，讓我可以有系統的複習。</li></ul><h3>7.GitHub</h3><p><a href="https://github.com/a578ff6/leetcode-swift-solutions/tree/main">GitHub - a578ff6/leetcode-swift-solutions: 用 Swift 解 LeetCode 題目的筆記與程式碼，iOS 轉職刷題紀錄</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6203dc4c1f4e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/c78-%E7%94%A8-swift-%E8%A7%A3-leetcode-%E7%9A%84%E5%AD%B8%E7%BF%92%E8%88%87%E7%B4%80%E9%8C%84-6203dc4c1f4e">C78.用 Swift 解 LeetCode 的學習與紀錄</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp 系列總覽｜iOS Firebase 點餐 App 完整開發指南]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-%E7%B3%BB%E5%88%97%E7%B8%BD%E8%A6%BD-ios-firebase-%E9%BB%9E%E9%A4%90-app-%E5%AE%8C%E6%95%B4%E9%96%8B%E7%99%BC%E6%8C%87%E5%8D%97-85019f23c130?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/85019f23c130</guid>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[firebase]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:27:44 GMT</pubDate>
            <atom:updated>2025-03-26T16:11:37.328Z</atom:updated>
            <content:encoded><![CDATA[<h3>## App 預覽（操作影片）</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FLXBmJX9aTqE%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DLXBmJX9aTqE&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FLXBmJX9aTqE%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/2330d1ca94f44698ec98caa70268ea75/href">https://medium.com/media/2330d1ca94f44698ec98caa70268ea75/href</a></iframe><h3>目錄</h3><pre>· <a href="#7183">1.引言</a><br>  ∘ <a href="#da98">1–1.目標</a><br>  ∘ <a href="#2cd8">1–2.想法</a><br>· <a href="#c6ca">2.專案總覽</a><br>  ∘ <a href="#065f">2–1.主要功能亮點</a><br>  ∘ <a href="#9a55">2–2.技術總覽</a><br>· <a href="#906f">3.Medium 系列文章導覽（核心重點）</a><br>  ∘ <a href="#26c6">3–1.專案架構設計</a><br>  ∘ <a href="#59d4">3–2.Firebase 認證與使用者登入</a><br>  ∘ <a href="#2146">3–3.菜單與飲品展示</a><br>  ∘ <a href="#4ebb">3–4.訂單與購物車管理</a><br>  ∘ <a href="#1bc5">3–5.店鋪選擇功能</a><br>  ∘ <a href="#e52f">3–6.個人資料相關</a><br>  ∘ <a href="#29e8">3–7.訂單歷史相關</a><br>  ∘ <a href="#4b24">3–8.我的最愛相關</a><br>  ∘ <a href="#0d9a">3–9.搜尋相關</a><br>· <a href="#0688">4.GitHub</a></pre><h3>1.引言</h3><ul><li>這篇統整文章的目的是為了<strong>快速掌握整體專案結構與學習重點</strong>，可以藉由這篇文章：</li></ul><pre>1.總覽 OrderCoffeeApp 全貌<br><br>2.根據需求，快速跳轉到對應的 Medium 文章<br><br>3.了解各篇文章如何互相串聯，藉此完善對該專案的互動模式</pre><h4>1–1.目標</h4><ul><li>核心目標是模擬一款具備 <strong>星巴克點餐體驗 </strong>的 iOS App。</li><li>藉此<strong>完整用戶體驗，</strong>涵蓋：</li></ul><pre>1.登入<br><br>2.商品瀏覽<br><br>3.訂單管理<br><br>4.個人化設定<br><br>5.數據同步</pre><h4>1–2.想法</h4><ul><li>在這個專案中，我將實作過程中涉及的技術細節、架構思路、UI 設計、Firebase 整合等內容，拆解成以下文章。</li></ul><pre>1.如何搭建專案架構、模型設計<br><br>2.Firebase Authentication、Firestore、Storage 等服務整合<br><br>3.Swift UIKit 界面的拆分與模組化<br><br>4.訂單流程、個人頁面、搜尋功能到歷史紀錄的完整設計<br><br>5.各種使用者體驗細節（如動畫、資料同步、跨頁更新等）</pre><h3>2.專案總覽</h3><ul><li><strong>OrderCoffeeApp</strong> 是一款模擬 <strong>星巴克點餐體驗</strong> 的 iOS 應用，具備 <strong>飲品瀏覽、</strong><strong>訂單管理、</strong><strong>店鋪選擇、</strong><strong>個人化設定、</strong><strong>歷史訂單與我的最愛</strong> 等功能，並整合 <strong>Firebase</strong> 服務來實現使用者登入、資料儲存與同步。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*eJfrSozX3s22eQoj7yqO0A.png" /></figure><h4>2–1.主要功能亮點</h4><ul><li>完整結合 Firebase Authentication、Firestore、Storage</li></ul><pre>1.多元登入：<br><br>  - 支援 Apple Sign-In、Google Sign-In、Email 註冊與登入<br><br>2.飲品瀏覽與點餐：<br><br>  - 分類、子分類瀏覽，飲品詳情、購物車管理<br><br>3.訂單流程：<br><br>  - 動態管理購物車與訂單內容<br>  - 顧客資料填寫<br>  - 門市地圖選擇與外送選項<br>  - 訂單確認與提交<br><br>4.搜尋與收藏：<br><br>  - 即時飲品搜尋、本地快取與我的最愛功能<br><br>5.個人化設定：<br><br>  - 個人資料查看與編輯<br><br>6.訂單歷史紀錄：<br><br>  - 查看與管理過去訂單、排序與詳情頁<br><br>7.跨頁資料同步：<br><br>  - 收藏、訂單等數據即時同步 Firebase</pre><h4>2–2.技術總覽</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BxKXSi4ZMhA5JU4q--vhsA.png" /></figure><h3>3.Medium 系列文章導覽（核心重點）</h3><ul><li>為了系統地參考，整個 Medium 系列文章按照功能模組分類，以下為完整導覽。</li></ul><h4>3–1.專案架構設計</h4><blockquote><strong><em>OrderCoffeeApp #1</em></strong></blockquote><ul><li>專案架構與 Firebase 設計</li></ul><pre>- 全專案技術思考、資料結構與架構概述。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-1-%E5%B0%88%E6%A1%88%E6%9E%B6%E6%A7%8B%E8%88%87-firebase-%E8%A8%AD%E8%A8%88-32be1ec0e669">OrderCoffeeApp #1：專案架構與 Firebase 設計</a></p><blockquote><strong><em>OrderCoffeeApp #6</em></strong></blockquote><ul><li>設計啟動畫面_使用 Lottie 與 Firebase Auth</li></ul><pre>- 設計 Lottie 動畫啟動畫面。<br><br>- 結合 Firebase 驗證是否登入，來判別是否採用啟動畫面。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-6-%E8%A8%AD%E8%A8%88%E5%95%9F%E5%8B%95%E7%95%AB%E9%9D%A2-%E4%BD%BF%E7%94%A8-lottie-%E8%88%87-firebase-auth-14dee312e139">OrderCoffeeApp #6：設計啟動畫面_使用 Lottie 與 Firebase Auth</a></p><blockquote><strong><em>OrderCoffeeApp #7</em></strong></blockquote><ul><li>Firebase 鉗套結構下的模型設計</li></ul><pre>- 探討模型層設計與 Firebase Firestore 整合方式。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-7-firebase-%E9%89%97%E5%A5%97%E7%B5%90%E6%A7%8B%E4%B8%8B%E7%9A%84%E6%A8%A1%E5%9E%8B%E8%A8%AD%E8%A8%88-f3b538a74d86">OrderCoffeeApp #7：Firebase 鉗套結構下的模型設計</a></p><h4>3–2.Firebase 認證與使用者登入</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lm9YJgU40WYKaWZcCODroQ.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #2</em></strong></blockquote><ul><li>在專案中整合 Firebase Auth（Email、Google、Apple 登入）</li></ul><pre>- 詳細介紹如何設定 Firebase Auth，整合多元登入方式。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-2-%E5%9C%A8%E5%B0%88%E6%A1%88%E4%B8%AD%E6%95%B4%E5%90%88-firebase-auth-email-google-apple-%E7%99%BB%E5%85%A5-70f4f18c2657">OrderCoffeeApp #2：在專案中整合 Firebase Auth（Email、Google、Apple 登入）</a></p><blockquote><strong><em>OrderCoffeeApp #3</em></strong></blockquote><ul><li>設計 LoginViewController，結合 Firebase 登入</li></ul><pre>- 設計登入頁面 UI 與帳號驗證流程。<br><br>- 提供 Apple、Google 登入方式。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-3-%E8%A8%AD%E8%A8%88-loginviewcontroller-%E7%B5%90%E5%90%88-firebase-%E7%99%BB%E5%85%A5-aa06ea50c6a4">OrderCoffeeApp #3：設計 LoginViewController，結合 Firebase 登入</a></p><blockquote><strong><em>OrderCoffeeApp #4</em></strong></blockquote><ul><li>設計 SignUpViewController，實作 Firebase 註冊</li></ul><pre>- 實作註冊流程與表單驗證。<br><br>- 提供 Apple、Google 註冊方式。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-4-%E8%A8%AD%E8%A8%88-signupviewcontroller-%E5%AF%A6%E4%BD%9C-firebase-%E8%A8%BB%E5%86%8A-92db6f369100">OrderCoffeeApp #4：設計 SignUpViewController，實作 Firebase 註冊</a></p><blockquote><strong><em>OrderCoffeeApp #5</em></strong></blockquote><ul><li>ForgotPasswordViewController 設計與 Firebase 密碼重設</li></ul><pre>- 提供忘記密碼功能，實作 Email 密碼重設。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-5-forgotpasswordviewcontroller-%E8%A8%AD%E8%A8%88%E8%88%87-firebase-%E5%AF%86%E7%A2%BC%E9%87%8D%E8%A8%AD-07da6e016cb9">OrderCoffeeApp #5：ForgotPasswordViewController 設計與 Firebase 密碼重設</a></p><h4>3–3.菜單與飲品展示</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YDdqt8T0O2J7DbJRgysE1w.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #8</em></strong></blockquote><ul><li>菜單數據模型與 Firestore 整合（Data Layer）</li></ul><pre>- 架構菜單數據模型，串接 Firestore 取得飲品資料。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-8-%E8%8F%9C%E5%96%AE%E6%95%B8%E6%93%9A%E6%A8%A1%E5%9E%8B%E8%88%87-firestore-%E6%95%B4%E5%90%88-data-layer-99e1f3266545">OrderCoffeeApp #8：菜單數據模型與 Firestore 整合（Data Layer）</a></p><blockquote><strong><em>OrderCoffeeApp #9</em></strong></blockquote><ul><li>MenuViewController — 顯示飲品分類</li></ul><pre>- 顯示飲品分類，促銷活動等<br><br>- UI 設計飲品分類列表，實現分類瀏覽功能。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-9-menuviewcontroller-%E9%A1%AF%E7%A4%BA%E9%A3%B2%E5%93%81%E5%88%86%E9%A1%9E-a2cf64cc0f72">OrderCoffeeApp #9：MenuViewController — 顯示飲品分類</a></p><blockquote><strong><em>OrderCoffeeApp #10</em></strong></blockquote><ul><li>DrinkSubCategoryViewController — 子分類與飲品清單</li></ul><pre>- 展示子分類下的飲品清單項目<br><br>- 可切換網狀格式、列表格式</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-10-drinksubcategoryviewcontroller-%E5%AD%90%E5%88%86%E9%A1%9E%E8%88%87%E9%A3%B2%E5%93%81%E6%B8%85%E5%96%AE-73b74d63b6b7">OrderCoffeeApp #10：DrinkSubCategoryViewController — 子分類與飲品清單</a></p><blockquote><strong><em>OrderCoffeeApp #11</em></strong></blockquote><ul><li>DrinkDetailViewController — 顯示單一飲品詳情</li></ul><pre>- 設計飲品詳細頁，支援尺寸與數量選擇。<br><br>- 可添加至我的最愛、分享飲品資訊。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-11-drinkdetailviewcontroller-%E9%A1%AF%E7%A4%BA%E5%96%AE%E4%B8%80%E9%A3%B2%E5%93%81%E8%A9%B3%E6%83%85-d2d5a98f994d">OrderCoffeeApp #11：DrinkDetailViewController — 顯示單一飲品詳情</a></p><h4>3–4.訂單與購物車管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OFcsxWb9eEBGPVpjmews6A.jpeg" /><figcaption><strong>訂單飲品項目 &amp; 編輯訂單項目</strong></figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*O3vdemVFprM8X7ri5rpp4Q.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yy7ctUv-Q3DAYlubzfTzFw.jpeg" /><figcaption>左至右：<strong>訂單顧客資料</strong> /<strong> 確認訂單完成</strong></figcaption></figure><blockquote><strong><em>OrderCoffeeApp #13</em></strong></blockquote><ul><li>訂單飲品項目 — 設計與管理</li></ul><pre>- 設計購物車頁面，管理已選飲品。<br><br>- 會根據購物車狀態，動態啟用/禁止按鈕。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-13-%E8%A8%82%E5%96%AE%E9%A3%B2%E5%93%81%E9%A0%85%E7%9B%AE-%E8%A8%AD%E8%A8%88%E8%88%87%E7%AE%A1%E7%90%86-c9dd2057f863">OrderCoffeeApp #13：訂單飲品項目 — 設計與管理</a></p><blockquote><strong><em>OrderCoffeeApp #14</em></strong></blockquote><ul><li>編輯訂單項目 — 調整飲品尺寸與數量</li></ul><pre>- 點擊位於購物車中的飲品，藉此前往編輯頁面調整飲品尺寸與數量。<br><br>- 編輯調整完畢後會自動回到購物車頁面。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-14-%E7%B7%A8%E8%BC%AF%E8%A8%82%E5%96%AE%E9%A0%85%E7%9B%AE-%E8%AA%BF%E6%95%B4%E9%A3%B2%E5%93%81%E5%B0%BA%E5%AF%B8%E8%88%87%E6%95%B8%E9%87%8F-d306385be9de">OrderCoffeeApp #14：編輯訂單項目 — 調整飲品尺寸與數量</a></p><blockquote><strong><em>OrderCoffeeApp #15</em></strong></blockquote><ul><li>訂單顧客資料 — 訂單填寫與驗證</li></ul><pre>- 顧客資訊表單設計與必填欄位驗證。<br><br>- 會自動填入顧客在「個人頁面」中的個人資料到相對應的欄位上。讓使用者可以更方便。<br><br>- 提供門市、外送服務選項</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-15-%E8%A8%82%E5%96%AE%E9%A1%A7%E5%AE%A2%E8%B3%87%E6%96%99-%E8%A8%82%E5%96%AE%E5%A1%AB%E5%AF%AB%E8%88%87%E9%A9%97%E8%AD%89-4ceba22d2f13">OrderCoffeeApp #15：訂單顧客資料 — 訂單填寫與驗證</a></p><blockquote><strong><em>OrderCoffeeApp #16</em></strong></blockquote><ul><li>確認訂單完成 — 顯示訂單資訊與返回主畫面</li></ul><pre>- 訂單提交後的確認頁設計與流程。<br><br>- 明確讓使用者知道訂單已經完成。<br><br>- 並讓使用者可以再次觀看訂單資訊。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-16-%E7%A2%BA%E8%AA%8D%E8%A8%82%E5%96%AE%E5%AE%8C%E6%88%90-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%B3%87%E8%A8%8A%E8%88%87%E8%BF%94%E5%9B%9E%E4%B8%BB%E7%95%AB%E9%9D%A2-1806a8ab2fdf">OrderCoffeeApp #16：確認訂單完成 — 顯示訂單資訊與返回主畫面</a></p><h4>3–5.店鋪選擇功能</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OWuPpWpZLNjtGWdXUMHyoQ.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #17</em></strong></blockquote><ul><li>店鋪選擇頁面（StoreSelectionViewController）</li></ul><pre>- 地圖選擇門市與 FloatingPanel 使用。<br><br>- 提示使用者點擊選取門市。<br><br>- 透過定位功能，抓取使用者與門市的距離。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-17-%E5%BA%97%E9%8B%AA%E9%81%B8%E6%93%87%E9%A0%81%E9%9D%A2-storeselectionviewcontroller-cf5807f20ca7">OrderCoffeeApp #17：店鋪選擇頁面（StoreSelectionViewController）</a></p><blockquote><strong><em>OrderCoffeeApp #18</em></strong></blockquote><ul><li>店鋪詳情頁面（StoreInfoViewController）</li></ul><pre>- 顯示門市詳細資訊，支援撥打電話等功能。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-18-%E5%BA%97%E9%8B%AA%E8%A9%B3%E6%83%85%E9%A0%81%E9%9D%A2-storeinfoviewcontroller-547358dd70a6">OrderCoffeeApp #18：店鋪詳情頁面（StoreInfoViewController）</a></p><h4>3–6.個人資料相關</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5aIcbY0_gPwPg2BeAtxbLg.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4tE0X6yCvxMAkEjq5KCFNw.jpeg" /><figcaption>左至右：<strong>個人資料頁面</strong> / <strong>個人資料編輯頁面</strong></figcaption></figure><blockquote><strong><em>OrderCoffeeApp #19</em></strong></blockquote><ul><li>個人資料頁面 — 顯示與管理使用者資訊</li></ul><pre>- 設計個人資訊頁面，顯示頭像與帳號資訊。<br><br>- 並提供「編輯個人資料」、「歷史訂單」、「我的最愛」等選項。<br><br>- 此外可以前往「星巴克」相關社群。<br><br>- 以及可在「個人資料頁面」執行「登出」。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-19-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA%E8%88%87%E7%AE%A1%E7%90%86%E4%BD%BF%E7%94%A8%E8%80%85%E8%B3%87%E8%A8%8A-ff78ed0d061b">OrderCoffeeApp #19：個人資料頁面 — 顯示與管理使用者資訊</a></p><blockquote><strong><em>OrderCoffeeApp #20</em></strong></blockquote><ul><li>個人資料編輯 — 顯示與更新</li></ul><pre>- 考量到「註冊」時，只有「姓名」資訊，為了讓使用者在下訂單時，可以在訂單顧客資訊快速填入個人資訊。<br><br>- 因此提供「個人資料編輯」，讓使用者可以選擇是否要補充個人資料。<br><br>- 編輯姓名、頭像、聯絡資訊、地址、生日、性別等<br><br>- 並與 Firebase 進行同步。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-20-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E7%B7%A8%E8%BC%AF-%E9%A1%AF%E7%A4%BA%E8%88%87%E6%9B%B4%E6%96%B0-3c9599c38138">OrderCoffeeApp #20：個人資料編輯 — 顯示與更新</a></p><h4>3–7.訂單歷史相關</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rbvMyQSm6ZPxslCEYa9OHA.jpeg" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ex2vALIowDLB6EoS-qU8jw.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #21</em></strong></blockquote><ul><li>訂單歷史頁面 — 顯示、管理與排序歷史訂單</li></ul><pre>- 訂單紀錄列表，支援排序、單一刪除、批量刪除。<br><br>- 方便使用者可以查詢、整理自己過往的訂單資訊，</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-21-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA-%E7%AE%A1%E7%90%86%E8%88%87%E6%8E%92%E5%BA%8F%E6%AD%B7%E5%8F%B2%E8%A8%82%E5%96%AE-0ee828e7854d">OrderCoffeeApp #21：訂單歷史頁面 —顯示、管理與排序歷史訂單</a></p><blockquote><strong><em>OrderCoffeeApp #22</em></strong></blockquote><ul><li>訂單歷史詳情頁 — 顯示訂單詳情、顧客資訊與分享功能</li></ul><pre>- 訂單詳細內容展示，支援分享訂單。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-22-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E8%A9%B3%E6%83%85%E9%A0%81-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%A9%B3%E6%83%85-%E9%A1%A7%E5%AE%A2%E8%B3%87%E8%A8%8A%E8%88%87%E5%88%86%E4%BA%AB%E5%8A%9F%E8%83%BD-109619427373">OrderCoffeeApp #22：訂單歷史詳情頁 — 顯示訂單詳情、顧客資訊與分享功能</a></p><h4>3–8.我的最愛相關</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xEx1I5WhJjmZ5LN-BHdmmQ.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #23</em></strong></blockquote><ul><li>我的最愛頁面 — 收藏管理、跨頁同步與動態 UI</li></ul><pre>- 收藏飲品功能設計，資料同步與 UI 實作。<br><br>- 使用者可以透過點擊「飲品詳細頁面」中的「愛心」，將飲品添加到「我的最愛頁面」中。<br><br>- 使其以後要下訂相同飲品時，可以快速取得其資訊。<br><br>- 而「我的最愛」狀態，可以在「飲品詳細頁面」、「我的最愛頁面」去相互控制。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-23-%E6%88%91%E7%9A%84%E6%9C%80%E6%84%9B%E9%A0%81%E9%9D%A2-%E6%94%B6%E8%97%8F%E7%AE%A1%E7%90%86-%E8%B7%A8%E9%A0%81%E5%90%8C%E6%AD%A5%E8%88%87%E5%8B%95%E6%85%8B-ui-2ad97de47bf4">OrderCoffeeApp #23：我的最愛頁面 — 收藏管理、跨頁同步與動態 UI</a></p><h4>3–9.搜尋相關</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mn2QyTJYHLMn-vjwoGRbxQ.jpeg" /></figure><blockquote><strong><em>OrderCoffeeApp #12</em></strong></blockquote><ul><li>設計搜尋功能 — 本地快取與 Firebase 整合</li></ul><pre>- 本地快取搜尋功能設計，結合 Firebase 資料來源。<br><br>- 考量到「Firestore」本身提供的搜尋功能受限、搜尋時的順暢度。<br><br>- 以及透過直接對「Firestore」進行搜尋時，會有用量限制的影響。<br><br>- 因此採用「本地快取」方式，優化搜尋功能。</pre><p><a href="https://medium.com/@a578ff6/ordercoffeeapp-12-%E8%A8%AD%E8%A8%88%E6%90%9C%E5%B0%8B%E5%8A%9F%E8%83%BD-%E6%9C%AC%E5%9C%B0%E5%BF%AB%E5%8F%96%E8%88%87-firebase-%E6%95%B4%E5%90%88-66b616c28a6c">OrderCoffeeApp #12：設計搜尋功能 — 本地快取與 Firebase 整合</a></p><h3>4.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=85019f23c130" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-%E7%B3%BB%E5%88%97%E7%B8%BD%E8%A6%BD-ios-firebase-%E9%BB%9E%E9%A4%90-app-%E5%AE%8C%E6%95%B4%E9%96%8B%E7%99%BC%E6%8C%87%E5%8D%97-85019f23c130">OrderCoffeeApp 系列總覽｜iOS Firebase 點餐 App 完整開發指南</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #23：我的最愛頁面 — 收藏管理、跨頁同步與動態 UI]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-23-%E6%88%91%E7%9A%84%E6%9C%80%E6%84%9B%E9%A0%81%E9%9D%A2-%E6%94%B6%E8%97%8F%E7%AE%A1%E7%90%86-%E8%B7%A8%E9%A0%81%E5%90%8C%E6%AD%A5%E8%88%87%E5%8B%95%E6%85%8B-ui-2ad97de47bf4?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/2ad97de47bf4</guid>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swift]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:15:51 GMT</pubDate>
            <atom:updated>2025-03-26T16:13:01.997Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>OrderCoffeeApp #23：我的最愛頁面 — 收藏管理、跨頁同步與動態 UI</strong></h3><h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FZ6vN6JToH3g%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DZ6vN6JToH3g&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FZ6vN6JToH3g%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/59076741efa600d6b99c18387e3abe2a/href">https://medium.com/media/59076741efa600d6b99c18387e3abe2a/href</a></iframe><pre>· <a href="#addd">1.介紹</a><br>  ∘ <a href="#a56a">1–1.核心功能亮點</a><br>  ∘ <a href="#97e5">1–2.結構概覽</a><br>· <a href="#5cf0">2.核心架構</a><br>  ∘ <a href="#9942">2–1.架構模式</a><br>  ∘ <a href="#eff5">2–2.我的最愛資料流</a><br>  ∘ <a href="#7c19">2–3.跨頁同步與收藏切換</a><br>· <a href="#4802">3.我的最愛資料層設計</a><br>  ∘ <a href="#98d6">3–1.Firestore 收藏資料文件結構範例</a><br>  ∘ <a href="#e72c">3–2.FavoriteDrink 模型</a><br>  ∘ <a href="#e9e5">3–3.FavoritesRepository 資料來源管理</a><br>  ∘ <a href="#6cf0">3–4.資料層設計優勢總結</a><br>· <a href="#9c86">4.我的最愛業務層設計</a><br>  ∘ <a href="#7cbf">4–1.FavoriteManager（業務核心管理器）</a><br>  ∘ <a href="#6614">4–2.FavoritesRepository（資料擁有者）</a><br>  ∘ <a href="#9d9a">4–3.我的最愛狀態切換與同步設計</a><br>· <a href="#2739">5.我的最愛 UI 層設計</a><br>  ∘ <a href="#a83c">5–1.FavoritesViewController 架構</a><br>  ∘ <a href="#f75d">5–2.DiffableDataSource 分組設計</a><br>  ∘ <a href="#f061">5–3.CollectionView Cell 與 Section Header 設定</a><br>  ∘ <a href="#f965">5–4.刪除與 UI 同步邏輯</a><br>  ∘ <a href="#4bd1">5–5.空狀態提示（NoFavoritesViewManager）</a><br>  ∘ <a href="#4e25">5–6.UI 與資料層分工設計小結</a><br>· <a href="#42b1">6.收藏狀態跨頁同步設計</a><br>  ∘ <a href="#b79a">6–1.目的</a><br>  ∘ <a href="#9642">6–2.實作收藏狀態跨頁同步的方法與流程</a><br>  ∘ <a href="#77d9">6–3.程式碼結構的注意點</a><br>  ∘ <a href="#0251">6–4.Summary 小結</a><br>· <a href="#7d8d">7.總結</a><br>  ∘ <a href="#2ba6">7–1.職責分層</a><br>  ∘ <a href="#e53c">7–2.收藏同步性，狀態即時反映</a><br>  ∘ <a href="#c730">7–3.動態 UI</a><br>· <a href="#ab8b">8.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9PaKXzGs5ry8APzEKYYvdw.png" /></figure><h3>1.介紹</h3><ul><li>「我的最愛」頁面是提供使用者快速查看與管理個人收藏飲品的重要功能，透過此功能，使用者可以：</li></ul><pre>1.瀏覽已收藏的飲品，並依照飲品子分類分區顯示，方便快速尋找。<br><br>2.刪除已收藏的飲品，或點擊進入飲品詳細頁查看更多資訊。<br><br>3.在其他頁面（如飲品詳細頁）新增或移除收藏後，回到「我的最愛」頁面時，收藏清單會即時同步更新，確保資料一致性。<br><br>4.當收藏清單為空時，自動顯示提示背景視圖，提升使用者體驗。</pre><h4>1–1.核心功能亮點</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1018/1*igFFLbP5iJt41SMD95EI0Q.png" /></figure><ul><li>收藏資料管理</li></ul><pre>1.使用 FavoriteManager 統一處理收藏的新增、刪除與獲取操作。<br><br>2.結合 Firebase Firestore 儲存並同步收藏資料，支援 Codable 解碼以簡化資料轉換。<br><br>3.透過 FavoritesRepository 作為資料層，確保資料操作的單一責任原則。</pre><ul><li><strong>跨頁同步</strong></li></ul><pre>1.收藏狀態變更時，確保 飲品詳情頁 (DrinkDetailViewController) 與 我的最愛頁 (FavoritesViewController) 保持同步。<br><br>2.利用 DrinkDetailFavoriteStateCoordinator 與 DrinkDetailFavoritesHandler，協調按鈕狀態與後端同步，避免 UI 與資料不一致問題。</pre><ul><li>動態 UI 處理</li></ul><pre>1.當收藏清單為空時，自動顯示「沒有收藏」提示背景（由 NoFavoritesViewManager 控制）。<br><br>2.使用 UICollectionViewDiffableDataSource 與分區設計，讓收藏飲品依子分類動態呈現。<br><br>3.收藏狀態與 UI 即時切換，提供刪除、點選查看詳情、收藏按鈕動態切換等直觀互動。</pre><h4>1–2.結構概覽</h4><ul><li>資料模型設計</li></ul><pre>- FavoriteDrink<br><br>  - 資料結構與 Firebase Firestore 整合</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li>資料層設計</li></ul><pre>- FavoritesRepository 與 Firebase 數據操作</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li>業務邏輯層設計</li></ul><pre>- FavoriteManager <br><br>  - 作為業務邏輯中介，封裝資料操作<br>  - 收藏管理，收藏同步邏輯與跨頁一致性設計</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li>UI 層設計</li></ul><pre>- FavoritesViewController 及 FavoritesHandler 資料呈現動態更新收藏清單。<br><br>- 空清單提示顯示 (NoFavoritesViewManager)</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><ul><li>跨頁同步邏輯</li></ul><pre>- DrinkDetailFavoritesHandler + DrinkDetailFavoriteStateCoordinator 協作，實現跨頁收藏狀態同步</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>2.核心架構</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hnU_2ojlYoyrNiA6bSzlxQ.png" /></figure><h4>2–1.架構模式</h4><ul><li>本頁面採用 <strong>MVC 架構模式</strong>，明確劃分 <strong>Data Layer（</strong><strong>資料層）</strong>、<strong>Business Layer（</strong><strong>業務邏輯層）</strong> 與 <strong>UI Layer（</strong><strong>介面層）</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G76_5toKM091n3iL4DmBSQ.png" /></figure><h4>2–2.我的最愛資料流</h4><p><strong>1.</strong><strong>Firebase Firestore</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vXRM9LMzBfGFax3XZn2wIg.png" /></figure><pre>- 使用者的收藏清單儲存在 users/{userId}/favorites 路徑下的子集合。<br><br>- 每一筆收藏飲品資料皆對應到一個 document，包含飲品分類、名稱、圖片網址與時間戳等欄位。</pre><p>2.<strong>FavoriteDrink 模型</strong></p><pre>- 採用 Codable 進行 Firestore 資料與 Swift 模型間的映射。<br><br>- 同時實作 Hashable，方便用於 CollectionView DiffableDataSource 與 Set 操作。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>FavoritesRepository</strong></p><pre>- 專注 Firestore 資料操作，包含：<br><br>  1.取得指定使用者的收藏清單<br>  2.按時間戳升序排列<br>  3.使用 document.data(as:) 轉換為 FavoriteDrink，避免手動解析。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>4.<strong>FavoriteManager</strong></p><pre>- 統一提供新增、刪除與獲取收藏的對外介面。<br><br>- 包裝資料層 FavoritesRepository，處理與 Firestore 的所有交互。<br><br>- 採用 Singleton 單例模式，確保收藏邏輯唯一入口，方便跨頁同步。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>5.<strong>FavoritesViewController 與</strong><strong>相關 UI 組件</strong></p><pre>- 呼叫 FavoriteManager 取得收藏清單並顯示於 CollectionView。<br><br>- 使用 FavoritesHandler 管理資料來源與分區顯示。<br><br>- 搭配 NoFavoritesViewManager 處理空清單時的提示 UI。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>2–3.跨頁同步與收藏切換</h4><ul><li>為確保收藏狀態跨頁同步，在 <strong>DrinkDetailViewController</strong> 設置與 <strong>FavoritesViewController</strong> 的數據一致性機制：</li></ul><p>1.<strong>DrinkDetailFavoritesHandler</strong></p><pre>- 檢查當前飲品是否已加入我的最愛。<br><br>- 提供切換收藏狀態的方法，直接調用 FavoriteManager。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>DrinkDetailFavoriteStateCoordinator</strong></p><pre>- 協調收藏按鈕 UI 狀態與後端同步。<br><br>- 點擊收藏時，先立即切換 UI，再由後端確認最終狀態。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>FavoritesViewController</strong></p><pre>- 每次 viewWillAppear 會重新呼叫 FavoriteManager.fetchFavorites() 確保回到頁面時狀態是最新的。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>3.<strong>我的最愛資料層設計</strong></h3><ul><li>「我的最愛」頁面的資料層，負責處理與 Firebase Firestore 之間的數據同步，確保收藏飲品的正確讀取、排序與結構管理。本節將說明核心模型 FavoriteDrink 以及資料操作的核心類別 <strong>FavoritesRepository</strong> 的設計與實作。</li></ul><h4>3–1.Firestore 收藏資料文件結構範例</h4><ul><li>以下是實際從 Firestore 取得的「我的最愛」收藏資料 JSON 範例，位於路徑：</li></ul><pre>/users/{userId}/favorites/{drinkId}</pre><p>1.JSON範例</p><pre>{<br>  &quot;name&quot;: &quot;projects/myorderapp-5bfa7/databases/(default)/documents/users/Ad5hJSmaYSdSNCSPqSAiW3z186G3/favorites/BrewedCoffee&quot;,<br>  &quot;fields&quot;: {<br>    &quot;subName&quot;: { &quot;stringValue&quot;: &quot;Brewed Coffee&quot; },<br>    &quot;subcategoryId&quot;: { &quot;stringValue&quot;: &quot;DailySpecialsCoffeeSeries&quot; },<br>    &quot;drinkId&quot;: { &quot;stringValue&quot;: &quot;BrewedCoffee&quot; },<br>    &quot;timestamp&quot;: { &quot;timestampValue&quot;: &quot;2025-02-27T18:18:42.691937Z&quot; },<br>    &quot;imageUrlString&quot;: { &quot;stringValue&quot;: &quot;https://...&quot; },<br>    &quot;categoryId&quot;: { &quot;stringValue&quot;: &quot;CoffeeBeverages&quot; },<br>    &quot;name&quot;: { &quot;stringValue&quot;: &quot;每日精選咖啡&quot; }<br>  },<br>  &quot;createTime&quot;: &quot;2025-02-27T18:18:43.245045Z&quot;,<br>  &quot;updateTime&quot;: &quot;2025-02-27T18:18:43.245045Z&quot;<br>}</pre><p>2.對應到 FavoriteDrink 屬性</p><ul><li>這樣的文件結構經由 Firebase SDK 的 .data(as:) 方法，自動轉換為 FavoriteDrink 模型物件，省去手動解析步驟，讓資料層邏輯更加簡潔。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Z2BImW15MQ15IxwMj_c8pw.png" /></figure><h4>3–2.FavoriteDrink 模型</h4><ul><li>使用 <strong>FavoriteDrink</strong> 作為每一筆收藏飲品的數據模型，<strong>Codable</strong> 與 <strong>Hashable</strong> 協議，讓資料結構既能方便地與 Firestore 進行自動編解碼，同時支援 <strong>UICollectionViewDiffableDataSource</strong> 快速更新 UI。</li></ul><p><strong>1.主要屬性</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RLmffZpOyKifQTdtHUvaUw.png" /></figure><p><strong>2.設計想法</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*R0q7otPPw0HTfxlz3sEqOg.png" /></figure><pre>1.Firestore 友善格式<br><br>  - Codable 自動解碼 Firestore 文件，減少手動轉換工作量。<br><br>2.支援 Hashable<br><br>  - 方便用於 Diffable DataSource 進行資料驅動更新。<br><br>3.易於排序與顯示<br><br>  - 透過 timestamp 控制顯示順序，確保收藏呈現時間一致性。<br><br>4.方便 UI 使用<br><br>  - 簡化 UI 層顯示邏輯，設置計算屬性 imageUrl，方便在 UI 層直接使用 URL 顯示圖片。<br><br>  - 直接將 imageUrlString 轉換為 URL?，供圖片載入器如 Kingfisher 使用。</pre><p><strong>3.GitHub</strong></p><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Models/FavoriteDrink.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–3.FavoritesRepository 資料來源管理</h4><ul><li>FavoritesRepository 是與 Firebase Firestore 直接交互的資料層，負責讀取使用者收藏清單，並將 Firestore 文件轉換為應用內的 FavoriteDrink 模型。</li></ul><p><strong>1.核心功能</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*eWHTY1VWd1T1s4Y8rjz_4A.png" /></figure><pre>1.功能特色：<br><br>  - 從 Firestore 獲取收藏清單<br>  - 透過 document.data(as:) 自動解碼<br><br>2.簡化 Firestore 文件轉換為 FavoriteDrink 模型的過程。<br><br>  - 無需手動 Mapping，減少程式碼冗長。<br><br>3.依據 timestamp 排序<br>  <br>  - 預設以 timestamp 升序排列，確保收藏列表呈現時順序一致（從最舊到最新）。<br><br>4.捕捉異常<br><br>  - 透過 try await 處理 Firestore 非同步請求，若出現讀取或解碼失敗，會傳回錯誤讓上層進行適當處理。</pre><p><strong>2.GitHub</strong></p><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–4.資料層設計優勢總結</h4><pre>1.分層清晰<br><br>  - 所有與 Firestore 相關操作集中在 FavoritesRepository<br><br>  - 業務邏輯則交給上層 FavoriteManager 處理，降低耦合。<br><br>2.易於擴展與維護<br><br>  - 日後若 Firestore 資料結構有變動，只需修改 FavoritesRepository 和 FavoriteDrink 模型，不影響上層邏輯。<br><br>3.異常處理完善<br><br>  - 保留 throws 錯誤傳遞機制，確保異常可以被上層或 UI 層適當提示。</pre><h3>4.我的最愛業務層設計</h3><ul><li>本節會紀錄「我的最愛」功能的業務層架構，涵蓋核心組件設計理念、與 Firebase Firestore 的數據交互流程，以及實現<strong>跨頁面的同步收藏狀態</strong>，確保<strong>列表頁</strong>與<strong>詳情頁</strong>的<strong>收藏動態保持一致</strong>。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VZSfMlUYdGSTuke-9km7vg.png" /></figure><h4>4–1.FavoriteManager（業務核心管理器）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fKKxLyuSVWxSDeb5GCt6Uw.png" /></figure><p><strong>1.設計想法</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rGyid0ZblnHJYIzOcI3mwA.png" /></figure><pre>- 採用 Singleton 單例模式，集中統一管理所有與「我的最愛」相關的數據操作。<br><br>- 將 Firebase 的資料操作與 UI 層明確分離，避免 UI 直接與 Firebase 耦合。</pre><p><strong>2.功能概覽</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VQwkAANE1fUnQkB5Dgq-UQ.png" /></figure><p><strong>3.資料交互流程</strong></p><pre>- 執行資料操作前，先透過 Firebase Auth 驗證使用者 UID。<br><br>- 依賴 FavoritesRepository 與 Firestore 進行新增、讀取、刪除操作。<br><br>- 取得原始資料後，封裝為 FavoriteDrink 模型，提供給 UI 使用，確保資料結構統一。</pre><p><strong>4.跨頁同步設計</strong></p><pre>- FavoriteManager 作為數據單一來源（Single Source of Truth），掌控所有收藏數據操作。<br><br>- 無論是 FavoritesViewController 或 DrinkDetailViewController，皆透過 FavoriteManager 取得同一份收藏清單，避免資料來源分散導致不同步。<br><br>- 收藏狀態變動後，兩頁面均可透過重新呼叫 fetchFavorites()，同步更新 UI 狀態。</pre><p><strong>5.GitHub</strong></p><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–2.FavoritesRepository（資料擁有者）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/536/1*0KonCacAjpHS29XTxonZaQ.png" /></figure><p><strong>1.設計理念</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*R8FNk27AQOSK21b5IlAwGA.png" /></figure><pre>- 專責處理 Firestore 的讀寫與排序邏輯，封裝底層資料操作細節。<br><br>- 使用 Firebase SDK 的 .data(as:) 方法，將 Firestore 取得的 JSON 自動轉換為 FavoriteDrink 資料模型。</pre><p><strong>2.功能特點</strong></p><pre>- 集中所有 Firestore 操作，讓 UI 或上層業務層無需關心 Firestore API 細節。</pre><p><strong>3.GitHub</strong></p><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoritesRepository.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–3.我的最愛狀態切換與同步設計</h4><p><strong>1.</strong><strong>FavoritesViewController — 列表頁刪除邏輯與同步</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jrX0uKQGDhfz3QfTF0Y5cw.png" /></figure><ul><li>實作原理</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cC8KmFhy9X8jdSbdXDwklQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*e5OVp9ns-x53F4PiFi5h5A.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gtALqso6_kqL2DTnTZGUng.png" /><figcaption>左至右：管理刪除動作 / 刪除指定收藏 / 重新 fetchFavorites() 更新列表</figcaption></figure><pre>- 透過 FavoritesHandler 管理刪除 / context menu 刪除動作。<br><br>- FavoritesHandler 通知 FavoritesViewController 執行刪除邏輯。<br><br>- 透過 FavoriteManager 刪除指定收藏，並重新 fetchFavorites() 更新列表。</pre><ul><li>同步效果</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iC_ADtOT1B7moJOiSP3xzw.png" /><figcaption><strong>刪除後即時 fetch，確保 Firestore 與 UI 同步</strong> / <strong>viewWillAppear 重新 fetch</strong></figcaption></figure><pre>- 每次刪除後即時呼叫 fetchFavorites()，確保 Firestore 與 UI 同步。<br><br>- 若從詳情頁返回，FavoritesViewController 也會在 viewWillAppear 重新 fetch，確保刪除/新增變動即時顯示。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.</strong><strong>DrinkDetailViewController — 詳情頁收藏邏輯與同步</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cyUmuPg9--iK3fJHgK9u6g.png" /></figure><ul><li>實作原理</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Vkz0Xg2Ae95lvaueHttXOw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d4i9O5Nf8EZtrLOUlhZoLA.png" /></figure><pre>- 透過 DrinkDetailFavoritesHandler 處理「加入 / 移除我的最愛」動作。<br><br>- DrinkDetailFavoriteStateCoordinator 專責協調收藏按鈕 UI 狀態與後端同步。</pre><ul><li>UI 狀態同步流程</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-A-mENJnLB1qdka7rwwcaw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kTSEkVlbNk4zHZa8UyCq6w.png" /><figcaption>左至右：DrinkDetailFavoriteStateCoordinator 專責協調 UI 狀態與後端資料同步 / 每次返回詳情頁前，會先重新 fetchFavorites()</figcaption></figure><pre>- DrinkDetailFavoriteStateCoordinator 專責協調 UI 狀態與後端資料同步：<br><br>  - 使用者點擊收藏按鈕，UI 立即切換按鈕圖示。<br><br>  - 同步呼叫 FavoriteManager 更新 Firestore 收藏狀態。<br><br>  - Firestore 操作完成後，校正按鈕狀態，確保與後端同步一致。<br><br>  - 整體過程執行在 MainActor，確保 UI 更新在主執行緒上完成。<br><br>  - 每次返回詳情頁前，會先重新 fetchFavorites()，確保收藏按鈕顯示最新狀態。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/ViewControllers/DrinkDetailViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/ViewControllers/DrinkDetailViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>3.資料同步設計總結</strong></p><pre>1.兩個頁面皆透過 FavoriteManager 作為單一資料來源，確保跨頁資料一致。<br><br>2.無論刪除或新增，最終都會呼叫 fetchFavorites() 來同步最新 Firestore 狀態。<br><br>3.優勢：<br><br>  - UI 與後端資料保持同步。<br>  - 列表與詳情頁間資料一致，避免狀態不同步問題。</pre><h3><strong>5.我的最愛 UI 層設計</strong></h3><h4>5–1.FavoritesViewController 架構</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*grEa2lIBlqmSJ7Z9_QGC0g.png" /></figure><p><strong>1.</strong><strong>FavoritesViewController</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UEN9V5pgt_9pT6tvPmQFDw.png" /></figure><pre>- 使用自定義的 FavoritesView 組裝主要 UI<br><br>- 包含一個自訂的 FavoritesCollectionView 負責展示收藏飲品清單。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.</strong><strong>FavoritesHandler</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MfnmuT7QFlOswzXaiih_2Q.png" /></figure><pre>- 採用 UICollectionViewDiffableDataSource 設計<br><br>- 管理資料源與 Cell 的更新，同時實作 delegate 以處理使用者的選取與刪除動作。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>3.</strong><strong>FavoritesNavigationBarManager</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*449sSnOIunyUf8NIQN0ryA.png" /></figure><pre>- 專職設置導航欄標題，將導航邏輯與主控制器分離，讓控制器聚焦在資料與交互邏輯。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/FavoritesNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/FavoritesNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>4.</strong><strong>NoFavoritesViewManager</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2oaoQVE89c181GAUshkI_w.png" /></figure><pre>- 監控收藏清單是否為空，決定是否顯示「目前沒有收藏」提示畫面。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–2.DiffableDataSource 分組設計</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EAMsKRQAymv20QYD8t3bng.png" /></figure><pre>1.FavoritesHandler 根據 FavoriteDrink 的 subcategoryId 分組，將不同子分類的飲品顯示於對應的 Section 中。<br><br>2.使用 NSDiffableDataSourceSnapshot 更新資料，確保 每次刪除或切換收藏狀態時，畫面更新具備平滑動畫，優化用戶體驗。</pre><ul><li>流程：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HGFliyjVsOgwrp7E-aOPJg.png" /></figure><pre>1.從 Firestore 獲取最新收藏數據。<br><br>2.依照子分類 ID（subcategoryId）分組數據。<br><br>3.將子分類分組結果排序，確保視覺呈現一致。<br><br>4.根據排序後的分組結果，創建新的 Snapshot。<br><br>6.將 Snapshot 應用至 DiffableDataSource，使 CollectionView 呈現平滑的 UI 更新效果。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–3.CollectionView Cell 與 Section Header 設定</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h6fPGway3XQLu5JFTmoixw.png" /></figure><ul><li>FavoritesHandler 透過 configureDataSource() 與 configureSectionHeaders()，來設定 CollectionView 的視覺呈現與資料來源。</li><li>透過此設定，FavoritesHandler 明確劃分<strong>資料設定（Cell、Header）與資料更新（Snapshot）邏輯：</strong></li></ul><pre>1.configureDataSource()<br><br>  - 建立 UICollectionViewDiffableDataSource 作為資料來源。<br>  - 透過 closure 提供每個 Cell 的內容設定邏輯，將收藏飲品數據模型（FavoriteDrink）顯示到對應的 FavoriteDrinkCell 中。<br><br>2.configureSectionHeaders()<br><br>  - 使用 supplementaryViewProvider 設定 Section Header 的視覺呈現邏輯。<br>  - 將每個 Section（子分類）的標題顯示在自定義的 FavoritesDrinkHeaderView 中。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–4.刪除與 UI 同步邏輯</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wuECss1-GPnE9fNdrMySGw.png" /></figure><ul><li>流程：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jDIDKH3aUewPhJSeGiqcGg.png" /></figure><pre>1.當使用者透過 滑動刪除 或 ContextMenu 執行刪除操作時，會由 FavoritesHandlerDelegate 通知 FavoritesViewController，進而呼叫 FavoriteManager 更新 Firestore 中的資料。<br><br>2.刪除完成後，FavoritesViewController 會重新呼叫 fetchFavorites()，取得最新收藏資料，再透過 FavoritesHandler 更新 CollectionView，確保資料同步。<br><br>3.若刪除後清單為空，NoFavoritesViewManager 會即時顯示空狀態提示，保持 UI 與資料同步。</pre><ul><li>特別注意：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hJ7StFK-AkiWSI6DQjdWYQ.png" /></figure><pre>1.每次返回頁面時 (viewWillAppear)，FavoritesViewController 也會觸發 fetchFavorites()，確保跨頁面操作後，最新收藏狀態能即時反映，維持資料一致。<br><br>2.整體邏輯設計上，所有 Firestore 更新與 UI 更新保持一致，避免狀態不一致問題。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Handler/FavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–5.空狀態提示（NoFavoritesViewManager）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/855/1*WCGf0yQ9MXTN-XYEdvXd-Q.png" /></figure><ul><li>NoFavoritesViewManager 負責根據收藏清單狀態自動更新背景提示視圖，以提供明確的視覺反饋：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EG5a3ja00Sl0nw9zmVTj_A.png" /></figure><pre>1.當收藏清單為空時，自動顯示「No Favorites」提示視圖，並禁用 CollectionView 滑動功能。<br><br>2.當收藏清單非空時，自動移除提示視圖，並恢復 CollectionView 正常操作。<br><br>3.每當用戶刪除收藏項目時，NoFavoritesViewManager 即時同步背景視圖，以確保 UI 與資料狀態的一致性。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Managers/NoFavoritesViewManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–6.UI 與資料層分工設計小結</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yChegJ5izjFEZnavmf4fhA.png" /></figure><ul><li>模組化設計，讓主控制器職責單純易於維護與擴充，同時確保 UI 與後端資料同步流暢一致：</li></ul><pre>1.FavoritesViewController 將 UI 組裝、導航欄設置、資料處理與空狀態提示 解耦，讓：<br><br>  - 收藏清單展示 → FavoritesHandler 專責<br>  - 導航欄標題邏輯 → FavoritesNavigationBarManager 負責<br>  - 空狀態提示 → NoFavoritesViewManager 控管<br>  - Firestore 資料操作 → 交由 FavoriteManager 單一管理</pre><h3><strong>6.收藏狀態跨頁同步設計</strong></h3><ul><li>收藏狀態跨頁同步設計，指的是當使用者在飲品詳情頁面（DrinkDetailViewController）點擊收藏按鈕時，該飲品的收藏狀態能夠立即同步反映到其他相關頁面（如「<strong>FavoritesViewController</strong>」頁面），確保跨頁資料狀態的一致性。</li></ul><h4>6–1.目的</h4><ul><li>提升使用者體驗：</li></ul><pre>- 立即反映收藏狀態變化，使用者不會感到混亂或誤解。<br><br>- 避免使用者需要手動刷新頁面來確認狀態變更。</pre><ul><li>維護數據一致性：</li></ul><pre>- 降低資料錯亂、顯示錯誤的可能性。避免收藏狀態在不同頁面呈現不一致。<br><br>- 明確後端資料與 UI 狀態的統一性，便於維護和擴充。</pre><h4>6–2.實作收藏狀態跨頁同步的方法與流程</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-tHxM036oHeFKApon8gIkg.png" /></figure><blockquote><strong><em>1.核心元件</em></strong></blockquote><ul><li><strong>DrinkDetailFavoritesHandler</strong></li></ul><pre>- 負責處理飲品詳情頁面的收藏狀態切換，與 Firebase 資料互動（新增、移除收藏）。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Managers/DrinkDetailFavoritesHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li><strong>DrinkDetailFavoriteStateCoordinator</strong></li></ul><pre>- 統一處理 DrinkDetailViewController UI 狀態更新（如導航欄收藏按鈕圖示變化），確保 UI 和資料即時同步。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/Coordinator/DrinkDetailFavoriteStateCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li><strong>FavoriteManager（Singleton）</strong></li></ul><pre>- 中央化管理與 Firebase 資料互動，確保資料層的單一性與即時性。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/Services/FavoriteManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li><strong>FavoritesViewController</strong></li></ul><pre>- 使用 viewWillAppear()，每次進入「我的最愛」頁面時，都會重新加載收藏清單，從 Firestore 獲取最新收藏狀態，確保頁面顯示與資料同步。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Favorites/ViewControllers/FavoritesViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><ul><li><strong>DrinkDetailViewController</strong></li></ul><pre>- 也使用 viewWillAppear()，每次進入詳情頁時重新查詢 Firebase 收藏狀態，更新收藏按鈕</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/DrinkDetail/ViewControllers/DrinkDetailViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/DrinkDetail/ViewControllers/DrinkDetailViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><blockquote><strong><em>2.流程細節</em></strong></blockquote><ul><li><strong>在 </strong><strong>DrinkDetailViewController 點擊收藏按鈕</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WhC81cP20nv9Ng4IYmIxyA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2R_UdjnAWmZfC8qXLUhAxA.png" /><figcaption>左至右：<strong>DrinkDetailViewController、DrinkDetailFavoriteStateCoordinator</strong> / <strong>DrinkDetailFavoriteStateCoordinator、DrinkDetailFavoritesHandler</strong></figcaption></figure><pre>1.使用者點擊收藏按鈕。<br><br>2.DrinkDetailFavoriteStateCoordinator：<br><br>  - 先立即切換按鈕 UI。<br><br>  - 呼叫 DrinkDetailFavoritesHandler → 使用 FavoriteManager 更新 Firestore 收藏狀態。</pre><ul><li><strong>Firestore 資料更新完成</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zBMWb4t5M-hXSxczIHsvRA.png" /></figure><pre>- Firestore 即時更新資料，保持資料層狀態。收藏資料已變更。</pre><ul><li><strong>當使用者前往「我的最愛」頁面（</strong><strong>FavoritesViewController）時</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h4XiMwzJj9sn_SIC0V0azw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hxhMdmBAGX4de2ax59Ia8g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*F3r4k490lCDTp1x8WdgCGQ.png" /><figcaption>左至右：<strong>FavoriteManager</strong> / <strong>FavoritesHandler</strong> / <strong>NoFavoritesViewManager</strong></figcaption></figure><pre>- viewWillAppear() 呼叫 FavoriteManager.fetchFavorites()，取得最新收藏資料。<br><br>- 更新收藏清單 → FavoritesHandler.updateSnapshot() 重新渲染 UI，確保收藏清單即時刷新。<br><br>- 若清單為空，透過 NoFavoritesViewManager 顯示空狀態提示。</pre><ul><li><strong>當前往</strong><strong>DrinkDetailViewController 時</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*t4s4SF-W0UteetBGHRV7bQ.png" /></figure><pre>- 同樣在 viewWillAppear() 呼叫 DrinkDetailFavoriteStateCoordinator.refreshFavoriteState()。<br><br>- 從 Firebase 查詢收藏狀態 → 更新收藏按鈕的圖示狀態，確保正確性。</pre><h4><strong>6–3.程式碼結構的注意點</strong></h4><pre>1.Singleton 模式<br><br>  - 使用 FavoriteManager.shared 作為單例，維持全局資料一致性。<br><br>2.使用協調器模式（ DrinkDetailFavoriteStateCoordinator ）<br><br>  - 以協調器模式統一管理 UI 和資料邏輯，將收藏按鈕狀態與資料邏輯解耦<br>  - 減少 DrinkDetailViewController 的負擔。<br><br>3.異步加載與 UI 即時反饋<br><br>  - 使用 Swift 的 async/await 確保異步 Firebase 操作不會阻塞 UI<br>  - 同時確保 UI 與後端資料一致。<br><br>4.每次進入頁面時刷新資料<br><br>  - FavoritesViewController 使用 viewWillAppear 確保資料刷新，使用者每次進入都看到最新狀態。</pre><h4>6–4.Summary 小結</h4><ul><li>此設計透過以下關鍵點，雙向確保跨頁同步：</li></ul><pre>1.DrinkDetailViewController → 收藏按鈕<br><br>  - 使用 DrinkDetailFavoriteStateCoordinator 與 DrinkDetailFavoritesHandler 即時切換 UI、更新 Firebase 收藏狀態。<br><br>2.切回 FavoritesViewController<br><br>  - 使用 viewWillAppear() 從 Firebase 重新拉取收藏清單，更新列表 UI。<br><br>3.再進入 DrinkDetailViewController<br><br>  - 同樣在 viewWillAppear() 查詢 Firebase，確保收藏按鈕呈現正確狀態。</pre><ul><li><strong>達成效果</strong>：</li></ul><pre>- 無論在哪個頁面改變收藏狀態，切回任何頁面時，資料與 UI 均保持同步，避免資料殘留或錯誤，讓使用者體驗順暢無縫。</pre><h3>7.總結</h3><h4>7–1.職責分層</h4><ul><li>本頁面依循 <strong>MVC 架構</strong>，將功能劃分為：</li></ul><pre>1.資料層 (Data Layer)：<br><br>  - FavoritesRepository 負責與 Firebase Firestore 交互，取得最新收藏清單。<br><br>2.業務層 (Business Layer)：<br><br>  - FavoriteManager 統一管理收藏邏輯，並提供易用 API 供 UI 呼叫，與 DrinkDetailFavoritesHandler 共同協作。<br><br>3.UI 層 (UI Layer)：<br><br>  - FavoritesViewController 搭配 FavoritesHandler 與 NoFavoritesViewManager，專注於 UI 呈現與用戶互動。</pre><h4>7–2.收藏同步性，狀態即時反映</h4><ul><li>無論在哪一頁更動收藏，回到任何頁面皆能反映最新狀態。</li><li>跨頁同步設計透過以下機制實現：</li></ul><pre>1.DrinkDetailViewController <br><br>  - 使用 viewWillAppear()，每次進入詳情頁時重新檢查 Firebase 收藏狀態，確保收藏按鈕正確。<br><br>2.FavoritesViewController <br><br>  - 同樣於 viewWillAppear() 重新從 Firestore 獲取收藏清單，避免舊資料殘留。<br><br>3.FavoriteManager <br><br>  - 單例模式統一資料來源，確保所有頁面狀態一致。<br><br>4.收藏按鈕操作<br><br>  - 透過 DrinkDetailFavoriteStateCoordinator 即時切換 UI，搭配 Firebase 更新，避免延遲感。</pre><h4>7–3.動態 UI</h4><pre>1.DiffableDataSource <br><br>  - 實作動態收藏清單刷新，搭配分區顯示 (subcategory 分組)，確保切換流暢無閃爍。<br><br>2.空清單提示<br><br>  - 透過 NoFavoritesViewManager 動態判斷清單是否為空，自動顯示提示視圖，避免死板空畫面。<br><br>3.刪除、點擊動畫與回饋 <br><br>  - 皆使用輕量、流暢的過場與震動回饋，提升互動細節。</pre><h3>8.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2ad97de47bf4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-23-%E6%88%91%E7%9A%84%E6%9C%80%E6%84%9B%E9%A0%81%E9%9D%A2-%E6%94%B6%E8%97%8F%E7%AE%A1%E7%90%86-%E8%B7%A8%E9%A0%81%E5%90%8C%E6%AD%A5%E8%88%87%E5%8B%95%E6%85%8B-ui-2ad97de47bf4">OrderCoffeeApp #23：我的最愛頁面 — 收藏管理、跨頁同步與動態 UI</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #22：訂單歷史詳情頁 — 顯示訂單詳情、顧客資訊與分享功能]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-22-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E8%A9%B3%E6%83%85%E9%A0%81-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%A9%B3%E6%83%85-%E9%A1%A7%E5%AE%A2%E8%B3%87%E8%A8%8A%E8%88%87%E5%88%86%E4%BA%AB%E5%8A%9F%E8%83%BD-109619427373?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/109619427373</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[uikit]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:15:18 GMT</pubDate>
            <atom:updated>2025-03-26T16:13:27.787Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>OrderCoffeeApp #22：訂單歷史詳情頁 — 顯示訂單詳情、顧客資訊與分享功能</strong></h3><h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FRlfe5r5IFNw%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DRlfe5r5IFNw&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FRlfe5r5IFNw%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/1bb6d9a6e40798521b23d56dd4aa4226/href">https://medium.com/media/1bb6d9a6e40798521b23d56dd4aa4226/href</a></iframe><h3>目錄</h3><pre>· <a href="#4ac1">1.介紹</a><br>  ∘ <a href="#2af0">1–1.主要功能</a><br>  ∘ <a href="#3689">1–2.設計思路</a><br>· <a href="#f344">2.頁面架構概覽</a><br>  ∘ <a href="#5fea">2–1.模組拆分原則</a><br>  ∘ <a href="#b2b5">2–2.數據來源設計</a><br>· <a href="#89b9">3.資料層設計（Data Layer）</a><br>  ∘ <a href="#2369">3–1.訂單數據</a><br>  ∘ <a href="#9639">3-2.訂單數據模型設計</a><br>  ∘ <a href="#8fbb">3–3.訂單詳細資料獲取 - OrderHistoryDetailManager</a><br>· <a href="#aa18">4.業務邏輯層設計（Business Logic Layer）</a><br>  ∘ <a href="#57c2">4–1.CollectionView 資料與互動管理 - OrderHistoryDetailHandler</a><br>  ∘ <a href="#dbd6">4–2.Section 展開/收起管理</a><br>  ∘ <a href="#c522">4–3.分享功能處理 - OrderHistoryDetailSharingHandler</a><br>· <a href="#d417">5.UI 層設計（UI Layer）</a><br>  ∘ <a href="#dcc6">5–1.ViewController - OrderHistoryDetailViewController</a><br>  ∘ <a href="#e223">5–2.導航欄管理（OrderHistoryDetailNavigationBarManager）</a><br>  ∘ <a href="#ca57">5–3.自訂 View（OrderHistoryDetailView &amp; CollectionView）</a><br>  ∘ <a href="#799a">5–4.Cell 設計 - 訂單詳情專用 Cell 與 Header</a><br>· <a href="#0423">6.總結</a><br>  ∘ <a href="#0933">6–1.MVC 分層清晰，責任劃分明確</a><br>  ∘ <a href="#984c">6–2.解耦設計</a><br>· <a href="#9edf">7.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-k3h15l-rr_dmEY4eqPp_A.png" /></figure><h3>1.介紹</h3><h4>1–1.主要功能</h4><pre>1.顯示單一歷史訂單的完整詳細資訊，涵蓋：<br><br>  - 飲品項目清單（品名、尺寸、數量、價格）。<br>  - 顧客基本資料（姓名、電話、取件方式、地址/門市）。<br>  - 訂單摘要資訊（訂單編號、建立時間、總金額、準備時間）。<br><br>2.提供 Section 展開/收起 功能，讓使用者可自由展開飲品明細，簡化頁面呈現。<br><br>3.支援 分享功能，使用者可一鍵將訂單資訊透過社群或其他方式快速分享。</pre><h4>1–2.設計思路</h4><ul><li>本頁面遵循 <strong>MVC 架構模式</strong>，並強調 <strong>模組化與職責分離</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IEuwNsO_A8YR1eB_GRlzeQ.png" /></figure><h3><strong>2.頁面架構概覽</strong></h3><ul><li>本頁面採用 <strong>MVC (Model-View-Controller)</strong> 架構，並搭配多層模組拆分，確保 <strong>UI 展示</strong>、<strong>業務邏輯</strong> 與 <strong>數據管理</strong> 之間責任劃分清楚，方便後續維護與擴展。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7p-_jxjxHJIGuDiwQrCMnA.png" /></figure><h4>2–1.模組拆分原則</h4><p>1.<strong>ViewController：</strong><strong>OrderHistoryDetailViewController</strong></p><pre>- 負責：<br><br>  - 控制整體頁面流程<br>  - 綁定數據源與 UI<br>  - 呼叫數據管理與分享邏輯<br>  - 響應使用者互動（如展開 Section、分享）</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/View%20Controllers/OrderHistoryDetailViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/View Controllers/OrderHistoryDetailViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.View 層</strong></p><ul><li>由以下自訂 View 組成，專注於顯示歷史訂單的細節內容，避免包含過多邏輯：</li></ul><pre>1.OrderHistoryDetailView：<br><br>  - 內含自訂 UICollectionView，負責呈現訂單詳細內容。<br><br>2.Cell 與 Header 包含：<br><br>  - OrderrHistoryDetailItemCell — 飲品細項顯示<br>  - OrderHistoryDetailCustomerInfoCell — 顧客資訊<br>  - OrderrHistoryDetailCell — 訂單概要<br>  - OrderHistoryDetailSectionHeaderView — 區塊標題與展開箭頭<br><br>3.OrderHistoryDetailCollectionView<br><br>  - 專用 CollectionView，結合 Compositional Layout，保持布局彈性。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailItemCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailItemCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderHistoryDetailCustomerInfoCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderHistoryDetailCustomerInfoCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailSectionHeaderView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailSectionHeaderView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Components/OrderHistoryDetailCollectionView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Components/OrderHistoryDetailCollectionView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>3.Handler / Manager 層</strong></p><ul><li><strong>數據管理</strong></li></ul><pre>OrderHistoryDetailManager：<br><br>  - 負責從 Firestore 獲取特定訂單詳細資料，專注數據存取與解析，與 UI 解耦。</pre><ul><li><strong>業務邏輯</strong></li></ul><pre>1.OrderHistoryDetailHandler：<br><br>  - 集中管理 CollectionView 資料來源與委託方法，包含 Section 展開/收起狀態。<br><br>2.OrderHistoryDetailSectionExpansionManager：<br><br>  - 負責記錄與切換每個 Section 的展開狀態。<br><br>3.OrderHistoryDetailHeaderGestureHandler：<br><br>  - 處理 Header 的點擊手勢，將展開/收起操作與狀態切換解耦。<br><br>4.OrderHistoryDetailNavigationBarManager：<br><br>  - 設置導航欄標題與分享按鈕，保持 ViewController 簡潔。<br><br>5.OrderHistoryDetailSharingHandler：<br><br>  - 封裝分享訂單的邏輯，透過 UIActivityViewController 實現。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Services/OrderHistoryDetailManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Services/OrderHistoryDetailManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailSharingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailSharingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p>4.Delegate 協議層</p><ul><li>透過 OrderHistoryDetailHandlerDelegate 與 OrderHistoryDetailSectionDelegate 讓 Handler 與 ViewController 間解耦，確保：</li></ul><pre>1.Handler 僅專注於資料與行為處理。<br><br>2.視圖刷新與 UI 控制集中於 ViewController 管理。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>2–2.數據來源設計</h4><ul><li><strong>數據來源</strong></li></ul><pre>- 訂單詳細資料由 Firebase Firestore 提供<br><br>- 存放於 users/{userId}/orders/{orderId} 路徑下。<br><br>- 使用者進入詳情頁面時，透過 OrderHistoryDetailManager 的 fetchOrderDetail(for:) 方法，以目前登入用戶的 userId 與目標 orderId 拉取對應訂單詳細資料。</pre><ul><li><strong>數據解析</strong></li></ul><pre>- 使用 Firebase 的 getDocument(as:) 方法，直接將 Firestore 文件轉換為模型 OrderHistoryDetail。</pre><ul><li><strong>OrderHistoryDetail 結構體</strong></li></ul><pre>- 訂單 ID<br><br>- 顧客資訊 (OrderHistoryDetailCustomerInfo)<br><br>- 訂單飲品項目 (OrderHistoryItemDetail)<br><br>- 建立時間、總準備時間與總金額等資訊。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Models/OrderHistoryDetail.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Models/OrderHistoryDetail.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>3.資料層設計（Data Layer）</h3><ul><li>在訂單歷史詳情頁，採用 <strong>清晰結構化的數據模型</strong> 及 <strong>職責單一的數據管理器</strong>，確保資料獲取、解析與顯示過程的清晰。</li></ul><h4>3–1.訂單數據</h4><ul><li>對應文章開頭的封面的資料JSON：</li></ul><pre>{<br>  &quot;id&quot;: &quot;5685E571-4A62-4475-8B58-2B58289ACABA&quot;,<br>  &quot;timestamp&quot;: &quot;2025-03-18T03:52:37Z&quot;,<br>  &quot;totalPrepTime&quot;: 35,<br>  &quot;totalAmount&quot;: 795,<br>  &quot;customerDetails&quot;: {<br>    &quot;fullName&quot;: &quot;查理布朗&quot;,<br>    &quot;phoneNumber&quot;: &quot;0912345678&quot;,<br>    &quot;storeName&quot;: &quot;三峽學成門市&quot;,<br>    &quot;address&quot;: &quot;&quot;,<br>    &quot;pickupMethod&quot;: &quot;In-Store Pickup&quot;,<br>    &quot;notes&quot;: &quot;分開包裝&quot;<br>  },<br>  &quot;orderItems&quot;: [<br>    {<br>      &quot;id&quot;: &quot;3E4C9063-1AB7-47B9-A8FD-A4B32913DA57&quot;,<br>      &quot;price&quot;: 155,<br>      &quot;quantity&quot;: 2,<br>      &quot;size&quot;: &quot;Large&quot;,<br>      &quot;drink&quot;: {<br>        &quot;name&quot;: &quot;夏日冰柚冷萃咖啡&quot;,<br>        &quot;subName&quot;: &quot;Honey Ruby Grapefruit Cold Brew&quot;,<br>        &quot;imageUrl&quot;: &quot;https://...&quot;<br>      }<br>    },<br>    {<br>      &quot;id&quot;: &quot;31C4769B-7515-4285-B7A0-69CB31BB980E&quot;,<br>      &quot;price&quot;: 145,<br>      &quot;quantity&quot;: 1,<br>      &quot;size&quot;: &quot;Medium&quot;,<br>      &quot;drink&quot;: {<br>        &quot;name&quot;: &quot;太妃核果風味冷萃咖啡&quot;,<br>        &quot;subName&quot;: &quot;Toffee Nut Crunch Cold Brew Coffee&quot;,<br>        &quot;imageUrl&quot;: &quot;https://...&quot;<br>      }<br>    },<br>    {<br>      &quot;id&quot;: &quot;07762432-A927-4E2E-979F-D2D286D0895D&quot;,<br>      &quot;price&quot;: 85,<br>      &quot;quantity&quot;: 4,<br>      &quot;size&quot;: &quot;Medium&quot;,<br>      &quot;drink&quot;: {<br>        &quot;name&quot;: &quot;草莓巴西莓檸檬風味星沁爽&quot;,<br>        &quot;subName&quot;: &quot;Strawberry Acai with Lemonade Starbucks Refreshers&quot;,<br>        &quot;imageUrl&quot;: &quot;https://...&quot;<br>      }<br>    }<br>  ]<br>}</pre><h4>3-2.訂單數據模型設計</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/909/1*PqnTKtoDMhvG5dXvQ3kxHw.png" /></figure><ul><li>程式碼：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tC8Pc5V1izNqkMiHMrh7lA.png" /></figure><ul><li><strong>OrderHistoryDetail</strong></li></ul><pre>1.對應 Firestore 中的單一訂單文件，包含該訂單的完整資訊。<br><br>2.屬性說明：<br><br>  - id: 訂單唯一標識符（便於查找與分享）。<br>  - customerDetails: 顧客詳細資料結構。<br>  - orderItems: 飲品項目陣列，每個項目為一筆飲品訂單。<br>  - timestamp: 訂單建立時間。<br>  - totalPrepTime: 總準備時間。<br>  - totalAmount: 訂單總金額。</pre><ul><li><strong>OrderHistoryDetailCustomerInfo</strong></li></ul><pre>1.專門描述 顧客資訊。<br><br>2.設計上考量不同取件方式需求（外送 or 到店），因此額外提供：<br><br>  - address (宅配地址)<br>  - storeName (門市名稱)<br>  - 透過 pickupMethod 來控制顯示邏輯。</pre><ul><li><strong>OrderHistoryItemDetail</strong></li></ul><pre>- 描述訂單中的 每一筆飲品項目，包括飲品名稱、尺寸、數量、單價。<br><br>- 內嵌 Drink 結構，清楚劃分飲品資料。</pre><ul><li>OrderHistoryDetailPickupMethod</li></ul><pre>1.使用 枚舉型態 (Enum)，確保取件方式資料一致性與可擴展性。<br><br>2.目前分為：<br><br>  - .homeDelivery：宅配<br>  - .inStore：到店取件</pre><ul><li><strong>設計重點</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SXq4KOdvQrZEGYVVs1T9CA.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Models/OrderHistoryDetail.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Models/OrderHistoryDetail.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–3.訂單詳細資料獲取 — OrderHistoryDetailManager</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BZeHLmRWXcDIvYybjQa42g.png" /></figure><p><strong>1.核心功能</strong></p><ul><li>OrderHistoryDetailManager 是專責處理訂單詳細數據的管理器，具備以下功能：</li></ul><pre>1.驗證登入用戶身份<br><br>  - 透過 Firebase Authentication 確認目前用戶已登入，防止未授權訪問。<br><br>2.從 Firestore 查詢指定訂單<br><br>  - 依據 userId 及 orderId 準確定位對應 Firestore 文件，取得該用戶的特定訂單。<br><br>3.數據解析簡化<br><br>  - 使用 getDocument(as:) 方法，自動將 Firestore 中的訂單數據轉為 OrderHistoryDetail 物件，無需額外 JSON 解析程式碼。<br><br>4.異步處理<br><br>  - 採用 async/await 確保非同步操作的易讀性與穩定性。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Services/OrderHistoryDetailManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Services/OrderHistoryDetailManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.設計原則</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7SQJXgLAB_-9kZdUSk7ONg.png" /></figure><h3>4.<strong>業務邏輯層設計（Business Logic Layer）</strong></h3><ul><li>在訂單歷史詳情頁，將頁面行為邏輯清晰拆分成多個 <strong>Handler</strong> 與 <strong>Manager</strong>，確保每個模組都符合 <strong>單一職責原則 (SRP)</strong>，同時透過 <strong>Delegate 模式</strong> 與 ViewController 解耦，提升可維護性與擴展性。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rBiD8jaBQgkK0JvTMvAyjA.png" /></figure><h4>4–1.CollectionView 資料與互動管理 — OrderHistoryDetailHandler</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Z3gyC_LdtC8gwdaLlekF-A.png" /></figure><ul><li><strong>負責核心</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*voLnlaH5DJfDKZWJttjJPw.png" /></figure><pre>1.管理 CollectionView 的 DataSource &amp; Delegate<br><br>  - 集中處理 Section 內容顯示，包含：<br>    <br>      - 訂單飲品項目<br>      - 顧客資訊<br>      - 訂單摘要<br><br>2.依據 Section 分類展示資料<br><br>  - 使用 Enum Section 清楚定義三大區塊。<br>  - 透過 numberOfSections 與 numberOfItemsInSection 確保資料來源一致。<br><br>3.整合 Section 展開/收起邏輯<br><br>  - 搭配 OrderHistoryDetailSectionExpansionManager 與 OrderHistoryDetailHeaderGestureHandler。<br>  - 實現用戶點擊 Header 來展開或收起特定區塊。</pre><ul><li>設計亮點</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xlxxTu1_7dQsAV8qpSMOow.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–2.Section 展開/收起管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FPYh05S8iDy627tYoTyxfQ.png" /></figure><ul><li>程式碼</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mwrDwDHyRZGr8uz7VbUMEA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2ZSsh7Z3BXHESJZXHz34jQ.png" /><figcaption>左至右：OrderHistoryDetailHandler、OrderHistoryDetailHeaderGestureHandler、OrderHistoryDetailSectionExpansionManager / OrderHistoryDetailViewController</figcaption></figure><ul><li>OrderHistoryDetailSectionExpansionManager</li></ul><pre>1.集中管理 Section 展開狀態<br><br>  - 使用 Set 儲存展開中的 Section 索引，避免重複並提升效能。<br><br>2.提供查詢 &amp; 切換展開狀態的方法<br><br>  - 供外部 Handler 查詢是否展開與控制展開/收起。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DWMkjcdO-FKR3BDOLPfcGA.png" /></figure><ul><li>OrderHistoryDetailHeaderGestureHandler</li></ul><pre>1.專門處理 Section Header 點擊手勢<br><br>2.綁定 tapGestureRecognizer 到 Header。<br><br>3.點擊後透過 OrderHistoryDetailSectionExpansionManager 切換展開狀態。<br><br>4.透過 OrderHistoryDetailSectionDelegate 通知 ViewController 刷新 UI。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Nk7moTvbN5O76ALk27NjjQ.png" /></figure><ul><li>Delegate 設計</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PJ9GhiBibd8y2mRFHN_14w.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/View%20Controllers/OrderHistoryDetailViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/View Controllers/OrderHistoryDetailViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–3.分享功能處理 — OrderHistoryDetailSharingHandler</h4><ul><li>核心職責</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lS_ZAxyEic285u-SyPff-A.png" /></figure><pre>1.集中管理分享邏輯<br><br>  - 使用 UIActivityViewController 將訂單資訊以文字形式分享。<br><br>2.解耦分享邏輯與 ViewController<br><br>  - OrderHistoryDetailViewController 只需呼叫 handler 方法，不需關心分享實作細節。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailSharingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Handlers/OrderHistoryDetailSharingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>5.UI 層設計（UI Layer）</h3><ul><li>在本頁面中，UI 層主要負責 <strong>視覺呈現、使用者操作處理</strong>，並透過多個自訂 View 與 Handler 模組化各元件，確保畫面簡潔且維護性高。</li></ul><h4>5–1.ViewController — <strong>OrderHistoryDetailViewController</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cflUUPX3cL1E90fKtbTAIQ.png" /></figure><ul><li><strong>核心職責</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*J_vs_sdE7YRHUvE2lblsXg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*388ITxVxyvFCF2uG4xQBQg.png" /></figure><pre>1.負責頁面的 生命週期管理 與 UI 初始化。<br><br>2.呼叫 OrderHistoryDetailManager 取得特定訂單詳細資料。<br><br>3.初始化 OrderHistoryDetailHandler，並設置 CollectionView 的 delegate/dataSource。<br><br>4.設置 OrderHistoryDetailNavigationBarManager，配置標題與分享功能。<br><br>5.實作 OrderHistoryDetailHandlerDelegate 及 OrderHistoryDetailSectionDelegate，串接數據與 UI 更新。</pre><ul><li><strong>特色</strong>：</li></ul><pre>1.採用 Handler 與 Delegate 解耦，避免 ViewController 本身過於臃腫。<br><br>2.分享功能透過 OrderHistoryDetailSharingHandler 獨立處理，保持單一職責。<br><br>3.負責處理 CollectionView Section 展開與收起狀態更新。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/View%20Controllers/OrderHistoryDetailViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/View Controllers/OrderHistoryDetailViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Delegates/OrderHistoryDetailSectionDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–2.導航欄管理（<strong>OrderHistoryDetailNavigationBarManager）</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/676/1*JcD7EyIz0zkO9pNcgacLVQ.png" /></figure><ul><li><strong>設計目的</strong>：</li></ul><pre>- 集中管理導航欄邏輯，避免 ViewController 直接操控 UINavigationItem，符合 SRP。</pre><ul><li><strong>功能內容</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5TMYBCBbMPzvsbr3SVQhng.png" /></figure><pre>1.設置頁面標題文字與大標題模式。<br><br>2.配置分享按鈕，指定 target 與 action。<br><br>3.可靈活調整是否顯示大標題，提升 UI 客製化彈性。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Manager/OrderHistoryDetailNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–3.自訂 View（<strong>OrderHistoryDetailView &amp; CollectionView）</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/413/1*7KZ3vAKB0RWnJCNsVFq-rg.png" /></figure><ul><li>功能描述</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*shWepJ-RB8HWjbTIDJzdNQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5TMYBCBbMPzvsbr3SVQhng.png" /></figure><ul><li><strong>OrderHistoryDetailView</strong></li></ul><pre>1.作為整體頁面 UI 容器，內含自訂的 OrderHistoryDetailCollectionView。<br><br>2.統一進行 Cell、Header 的註冊與 AutoLayout 設定。<br><br>3.隔離 ViewController 與 CollectionView 直接交互，增強分層清晰度。</pre><ul><li><strong>OrderHistoryDetailCollectionView</strong></li></ul><pre>1.使用 OrderHistoryDetailLayoutProvider 提供 Compositional Layout，方便管理三大 Section：<br><br>  - Item Details — 訂單飲品詳情<br>  - Customer Info — 顧客資料<br>  - Order Summary — 訂單概要<br><br>2.設定背景色、滾動效果、隱藏滾動條等視覺屬性，保持與整體介面風格一致。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Components/OrderHistoryDetailCollectionView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Components/OrderHistoryDetailCollectionView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Layouts/OrderHistoryDetailLayoutProvider.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Layouts/OrderHistoryDetailLayoutProvider.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–4.Cell 設計 — <strong>訂單詳情專用 Cell 與 Header</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qchP0rN2VcrBxJsJluZrsw.png" /></figure><ul><li>功能</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oGBWF3wV7M5MTM6o-kxr8g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rr8uHFgG6qNlUooLU3SpRA.png" /><figcaption>左至右：<strong>OrderrHistoryDetailItemCell、OrderHistoryDetailCustomerInfoCell、OrderrHistoryDetailCell / OrderHistoryDetailSectionHeaderView</strong></figcaption></figure><ul><li><strong>OrderrHistoryDetailItemCell</strong></li></ul><pre>1.顯示飲品資訊，包括名稱、副標題、尺寸、數量、價格、圖片。<br><br>2.使用 StackView 統一排列結構，提升可讀性與擴展性。</pre><ul><li><strong>OrderHistoryDetailCustomerInfoCell</strong></li></ul><pre>1.顯示顧客姓名、電話、取件方式、門市或地址。<br><br>2.支援根據取件方式 動態隱藏無關欄位，如外送則隱藏門市，門市取件則隱藏地址。</pre><ul><li><strong>OrderrHistoryDetailCell</strong></li></ul><pre>1.顯示訂單基本資訊：<br><br>  - 訂單編號、時間戳、準備時間、總金額。</pre><ul><li><strong>OrderHistoryDetailSectionHeaderView</strong></li></ul><pre>1.顯示每個區塊標題，如 &quot;Item Details&quot;、&quot;Customer Info&quot;、&quot;Order Summary&quot;。<br><br>2.支援展開/收起箭頭圖示，並透過 OrderHistoryDetailHeaderGestureHandler 綁定手勢。<br><br>3.使用 prepareForReuse 清除狀態，確保重複利用不受影響。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailItemCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailItemCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderHistoryDetailCustomerInfoCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderHistoryDetailCustomerInfoCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Cell/OrderrHistoryDetailCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailSectionHeaderView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistoryDetail/Views/OrderHistoryDetailSectionHeaderView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>6.總結</h3><h4>6–1.MVC 分層清晰，責任劃分明確</h4><ul><li><strong>資料層（Data Layer）</strong></li></ul><pre>1.透過 Firestore 數據模型設計 (OrderHistoryDetail 等結構體) 搭配 Firebase 的 getDocument(as:) 方法，簡化 JSON 解析與數據轉換流程。<br><br>2.使用 OrderHistoryDetailManager 集中負責 Firestore 取資料邏輯，確保資料讀取過程單純、乾淨。<br><br>3.明確限制僅允許已登入用戶查詢自身訂單，提升安全性。</pre><ul><li><strong>業務邏輯層（Business Logic Layer）</strong></li></ul><pre>1.採用多個 Handler 與 Manager 模組化處理業務邏輯：<br><br>  - OrderHistoryDetailHandler<br><br>     - 專職管理 CollectionView 的數據來源與展開行為。<br> <br>  - OrderHistoryDetailSectionExpansionManager <br><br>    - 集中管理 Section 展開收起狀態，避免狀態邏輯分散。<br>  <br>  - OrderHistoryDetailHeaderGestureHandler <br><br>    - 單一負責 Header 手勢事件處理。<br>  <br>  - OrderHistoryDetailSharingHandler <br><br>    - 單純處理分享功能，確保分享邏輯與主控制器解耦。<br><br>2.透過 Delegate 與 Handler 線性分工，避免 fat controller，讓每個模組各司其職、方便測試與維護。</pre><ul><li><strong>UI 層（UI Layer）</strong></li></ul><pre>1.自訂 View 如 OrderHistoryDetailView、OrderHistoryDetailCollectionView，保持視圖元件 高度可重用性與易讀性。<br><br>2.UICollectionView 的 Cell 與 Header（例如 OrderrHistoryDetailItemCell、OrderHistoryDetailCustomerInfoCell、OrderHistoryDetailSectionHeaderView 等）皆採用 StackView + 明確布局設計，確保在不同資料或螢幕尺寸下皆維持良好顯示。<br><br>3.配合 OrderHistoryDetailLayoutProvider 使用 Compositional Layout 模組化佈局設計，讓版型結構一致、易擴展。</pre><h4>6–2.解耦設計</h4><pre>1.採用 Handler + Delegate、Manager 模式，清楚把 數據處理、UI 展示、手勢互動、分享邏輯 各自拆分，減少彼此相依性。<br><br>2.Controller 僅作為各元件間的橋樑，避免控制器過胖，方便日後功能擴充與單元測試。</pre><h3>7.<strong>GitHub</strong></h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=109619427373" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-22-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E8%A9%B3%E6%83%85%E9%A0%81-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%A9%B3%E6%83%85-%E9%A1%A7%E5%AE%A2%E8%B3%87%E8%A8%8A%E8%88%87%E5%88%86%E4%BA%AB%E5%8A%9F%E8%83%BD-109619427373">OrderCoffeeApp #22：訂單歷史詳情頁 — 顯示訂單詳情、顧客資訊與分享功能</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #21：訂單歷史頁面 —顯示、管理與排序歷史訂單]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-21-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA-%E7%AE%A1%E7%90%86%E8%88%87%E6%8E%92%E5%BA%8F%E6%AD%B7%E5%8F%B2%E8%A8%82%E5%96%AE-0ee828e7854d?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/0ee828e7854d</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[uikit]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:14:38 GMT</pubDate>
            <atom:updated>2025-03-26T16:13:52.770Z</atom:updated>
            <content:encoded><![CDATA[<h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F9zTV7IKnQqA%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D9zTV7IKnQqA&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2F9zTV7IKnQqA%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/76186c81d116f2fbd9304db0bdf271a5/href">https://medium.com/media/76186c81d116f2fbd9304db0bdf271a5/href</a></iframe><h3>目錄</h3><pre>· <a href="#d495">1.介紹</a><br>  ∘ <a href="#b361">1–1.訂單歷史頁面的核心功能</a><br>  ∘ <a href="#23dd">1–2.訂單歷史頁面與 Firebase Firestore 整合概述</a><br>  ∘ <a href="#97cd">1–3.架構概述</a><br>· <a href="#7680">2.核心架構</a><br>  ∘ <a href="#2f37">2–1.架構模式：MVC</a><br>  ∘ <a href="#d45e">2–2.UI 分層設計與模組化</a><br>  ∘ <a href="#dc9f">2–3.主要的管理類別與處理器（Manager &amp; Handler）</a><br>· <a href="#b041">3.訂單歷史頁面 UI 設計</a><br>  ∘ <a href="#cfa9">3–1.頁面結構</a><br>  ∘ <a href="#770a">3–2.主要 UI 元件</a><br>  ∘ <a href="#c417">3–3.導航欄管理</a><br>  ∘ <a href="#07bc">3–4.訂單顯示與操作</a><br>· <a href="#c705">4.訂單歷史頁面的業務層設計</a><br>  ∘ <a href="#6647">4–1.訂單數據管理</a><br>  ∘ <a href="#7208">4–2.表單數據管理</a><br>  ∘ <a href="#7824">4–3.訂單排序與篩選</a><br>  ∘ <a href="#c51a">4–4.導航與按鈕管理</a><br>  ∘ <a href="#2e25">4–5.離開頁面時的狀態重置</a><br>· <a href="#b01c">5.訂單管理與交互邏輯</a><br>  ∘ <a href="#d8c1">5–1.Firebase 訂單獲取與排序流程</a><br>  ∘ <a href="#717a">5–2.一般模式功能</a><br>  ∘ <a href="#3480">5–3.編輯模式功能詳解</a><br>  ∘ <a href="#a185">5–4.CRUD 與排序操作總覽</a><br>· <a href="#c8b5">6.總結</a><br>  ∘ <a href="#ad7a">6–1.訂單歷史頁面的 UI 設計與業務邏輯分工</a><br>  ∘ <a href="#cba4">6–2.確保 UI 變更與數據狀態同步</a><br>  ∘ <a href="#b8ba">6–3.提升用戶在訂單管理中的體驗</a><br>· <a href="#1cfa">7.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4zP9JbD_xd_mqO7igD9xlQ.png" /></figure><h3>1.介紹</h3><h4>1–1.訂單歷史頁面的核心功能</h4><ul><li>訂單歷史頁面是應用程式中負責展示用戶過去訂單的功能模組，核心功能包括：</li></ul><pre>1.訂單列表顯示：<br><br>  - 顯示用戶過去的訂單，包含訂單編號、時間、金額、取件方式等關鍵資訊。<br><br>2.訂單管理：<br><br>  - 使用者可以刪除單筆或多筆歷史訂單，管理自己的訂單紀錄。<br><br>3.訂單排序：<br><br>  - 支援多種排序方式，如時間先後、金額高低、取件方式分類，提升用戶查閱效率。<br><br>4.Firebase Firestore 整合：<br><br>  - 即時從 Firebase Firestore 獲取訂單數據，確保數據同步。</pre><h4>1–2.訂單歷史頁面與 Firebase Firestore 整合概述</h4><ul><li>訂單歷史頁面與 Firebase Firestore 整合的核心概念包括：</li></ul><pre>1.即時數據同步：<br><br>  - 透過 OrderHistoryManager 來存取 Firebase Firestore，獲取用戶的歷史訂單。<br><br>2.數據結構：<br><br>  - Firestore 中的訂單資料存儲在 users/{userId}/orders 路徑下，每筆訂單包含 id、customerDetails、timestamp、totalPrepTime 和 totalAmount 等屬性。<br><br>3.數據獲取與排序：<br><br>  - 訂單獲取：<br><br>    - 從 Firestore 讀取訂單數據，並透過 fetchOrderHistory(sortOption: OrderHistorySortOption) 取得排序後的訂單列表。<br><br>  - 訂單排序：<br><br>    - 使用 OrderHistorySortOption 進行本地排序，確保 UI 能即時呈現用戶選擇的排序方式。<br><br>4.刪除機制：<br><br>  - 透過 deleteOrder(orderId:) 及 deleteMultipleOrders(orderIds:) 方法，可單筆或批量刪除歷史訂單，並在 Firestore 同步移除對應數據。</pre><h4>1–3.架構概述</h4><ul><li>訂單歷史頁面的設計與實作，主要分為以下幾個部分：</li></ul><blockquote><strong><em>UI 設計</em></strong></blockquote><pre>1.訂單歷史頁面的視圖結構 (OrderHistoryViewController、OrderHistoryView)<br><br>2.訂單列表的顯示 (UITableView 及 OrderHistoryCell)<br><br>3.空狀態提示 (OrderHistoryEmptyStateView)</pre><blockquote><strong><em>業務邏輯實作</em></strong></blockquote><pre>1.Firebase Firestore 整合 (OrderHistoryManager)<br><br>2.訂單數據的獲取與管理<br><br>3.訂單排序 (OrderHistorySortOption)<br><br>4.編輯模式與多選刪除 (OrderHistoryEditingHandler)</pre><blockquote><strong><em>導航與互動邏輯</em></strong></blockquote><pre>1.導航欄管理 (OrderHistoryNavigationBarManager)<br><br>2.訂單詳細頁面 (navigateToOrderHistoryDetail)<br><br>3.訂單選擇狀態 (OrderHistorySelectionDelegate)</pre><h3>2.核心架構</h3><h4>2–1.架構模式：MVC</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4IVlTYPo_AVg7Cd4L8J95w.png" /></figure><ul><li>在 <strong>OrderHistoryViewController</strong> 中，採用 <strong>MVC（Model-View-Controller）</strong> 架構來處理訂單歷史資料的顯示與管理。</li></ul><pre>1.Model 層：<br><br>  - 負責處理訂單歷史資料，包含 OrderHistory 結構、OrderHistoryManager 負責與 Firebase Firestore 交互。<br><br>2.View 層：<br><br>  - 包含 OrderHistoryView，負責呈現 UI 結構，內部使用 OrderHistoryTableView 來顯示訂單列表。<br><br>3.Controller 層：<br><br>  - OrderHistoryViewController 作為主控制器，負責接收使用者操作，並與 OrderHistoryManager 及 OrderHistoryHandler 等管理類別協作。</pre><h4>2–2.UI 分層設計與模組化</h4><ul><li>為了提升程式的可維護性與清晰度，將 <strong>訂單歷史頁面</strong> 的 UI 分成以下幾個獨立模組：</li></ul><pre>1.OrderHistoryViewController：<br><br>  - 主控制器，負責管理訂單歷史的顯示、排序、刪除等操作。<br><br>2.OrderHistoryView：<br><br>  - 作為 ViewController 的主視圖，包含 OrderHistoryTableView。<br><br>3.OrderHistoryTableView：<br><br>  - 負責顯示訂單列表。<br><br>4.OrderHistoryCell：<br><br>  - 自訂 UITableViewCell，負責顯示單筆訂單資訊。<br><br>5.OrderHistoryEmptyStateView：<br><br>  - 當訂單列表為空時顯示。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Views/OrderHistoryView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Views/OrderHistoryView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryTableView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryTableView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryEmptyStateView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryEmptyStateView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>2–3.主要的管理類別與處理器（Manager &amp; Handler）</h4><ul><li><strong>Manager &amp; Handler</strong> 各自負責不同的功能，使 OrderHistoryViewController 專注於頁面邏輯，而不必處理過多細節。</li><li>將業務邏輯拆分至不同的 <strong>Manager</strong>（管理類）與 <strong>Handler</strong>（處理器）：</li></ul><p>1.<strong>OrderHistoryManager</strong></p><pre>- 與 Firebase Firestore 溝通，負責獲取、排序與刪除訂單資料。<br><br>- 對 fetchOrderHistory() 提供異步處理，確保流暢的用戶體驗。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderHistoryHandler</strong></p><pre>- 處理 UITableView 的 DataSource 及 Delegate 相關邏輯。<br><br>- 控制 UITableView 的選取狀態與互動邏輯。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>OrderHistoryNavigationBarManager</strong></p><pre>- 負責導航欄按鈕的管理，包含排序、編輯模式切換、刪除等操作。<br><br>- 確保 UI 狀態能根據當前頁面模式（正常/編輯）動態更新。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>4.<strong>OrderHistoryEditingHandler</strong></p><pre>- 負責管理 UITableView 的編輯模式與多選刪除邏輯。<br><br>- 透過 toggleEditingMode() 切換編輯模式，並確保 UI 同步更新。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>5.<strong>OrderHistorySortMenuHandler</strong></p><pre>- 負責生成排序選單，提供不同的排序選項（例如按時間、金額、取件方式）。<br><br>- 透過 OrderHistorySortMenuDelegate 回傳排序選擇，確保 ViewController 只需關心結果。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>3.訂單歷史頁面 UI 設計</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JR6mfWFpNndu-q8UnE6yXQ.png" /></figure><h4>3–1.頁面結構</h4><ul><li>訂單歷史頁面主要由 <strong>訂單列表 (UITableView)</strong> 組成，當沒有歷史訂單時，則顯示 <strong>空狀態畫面</strong> 提示用戶目前無訂單記錄。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jY5qYaxe2HY-cSS2xjT38Q.png" /></figure><p><strong>1.訂單列表 (</strong><strong>UITableView)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*b2SPyop1bt6uBsWEjBI2hg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-RPhBZfjyEBpbiI0IXhHRw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Y9fnYPS2cDc4SWQ41Lef9A.png" /><figcaption>左至右：<strong>OrderHistoryTableView</strong> / <strong>OrderHistoryCell</strong> / <strong>OrderHistoryView</strong></figcaption></figure><pre>- 顯示過去的訂單紀錄，每筆訂單佔據一個 UITableViewCell，包含顧客名稱、訂單金額、取件方式與時間等資訊。<br><br>- 提供 排序、編輯模式、刪除、詳細頁面導航 等功能。</pre><p><strong>2.空狀態畫面 (</strong><strong>OrderHistoryEmptyStateView)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4gF7BWhq4wnE6FTBOnZjbg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Xu7uC-oTlC0FoyvjfO8wIA.png" /><figcaption>左至右：<strong>OrderHistoryEmptyStateView / OrderHistoryView</strong></figcaption></figure><pre>- 當用戶尚未建立訂單，或所有訂單都被刪除時，顯示「沒有訂單記錄」的提示 UI。</pre><h4>3–2.主要 UI 元件</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ghly7gw3rfOAz4BcUZMPWg.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Views/OrderHistoryView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Views/OrderHistoryView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryTableView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryTableView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryEmptyStateView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Components/OrderHistoryEmptyStateView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–3.導航欄管理</h4><ul><li>OrderHistoryViewController 透過 <strong>OrderHistoryNavigationBarManager</strong> 管理導航欄按鈕，使 <strong>排序、編輯、刪除</strong> 操作的 UI 顯示與行為更有一致性。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*C5CfvgteLXSdjWVBCIfOmQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*RYlsBpT-71HmxT8nbD-Szg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*wGT5XGjPi1SPCeco-jWOQA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*QRGKLFpKX6_9_tsu3k5BfQ.png" /><figcaption>左至右：<strong>正常模式（有歷史訂單）</strong> / <strong>正常模式（無歷史訂單）</strong>/ <strong>編輯模式（無選取狀態）</strong>/ <strong>編輯模式（選取狀態）</strong></figcaption></figure><p>1.OrderHistoryNavigationBarManager</p><ul><li>負責導航欄按鈕切換，根據當前狀態 (正常模式 / 編輯模式) 動態更新 UI。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Wd-j9PCRehvotwQpLH9W2w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9BzFcKm-4fvfrGQ7OHVFjg.png" /></figure><pre>1.正常模式 (.normal)：<br><br>  - 顯示 「排序」與「編輯」 按鈕。<br><br>2.編輯模式 (.editing)：<br><br>  - 顯示 「完成」與「刪除」 按鈕，且根據選取狀態啟用/禁用「刪除」按鈕。<br><br>3.內部整合 OrderHistorySortMenuHandler，處理「排序按鈕」點擊後的選單顯示與回應。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.OrderHistorySortMenuHandler</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VXbFnu71SkKY7MD3lcE5jQ.png" /></figure><pre>1.負責生成排序選單 (UIMenu)，提供 依時間、金額、取件方式排序 的選項。<br><br>2.當使用者選擇排序條件時，透過 OrderHistorySortMenuDelegate 回傳結果至 OrderHistoryViewController，重新整理畫面。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p>3.OrderHistoryEditingHandler</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SMqM293aV-4PC4JvqXFdtA.png" /></figure><pre>1.負責編輯模式 (刪除功能)，處理「進入 / 離開編輯模式」、「檢查是否有選取行」等邏輯。<br><br>2.當有選擇行時，啟用「刪除」按鈕；當無選擇行時，禁用「刪除」按鈕。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–4.訂單顯示與操作</h4><ul><li><strong>歷史訂單的管理，支援以下操作：</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9BulBLJVzvKfJ8xngGMNuw.png" /></figure><p>1.顯示訂單資訊</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*Ev9JI99FPwpn9EkqCuLlJA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*mhUuLt7m4SRELBLkkmMnWA.png" /></figure><pre>透過 OrderHistoryCell 顯示：<br><br>  - 顧客姓名<br>  - 訂單時間<br>  - 取件方式<br>  - 訂單金額<br>  - 訂單編號</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Cell/OrderHistoryCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.切換排序方式</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*uEfPd9cpG_R8ZZXL-Uio4g.png" /></figure><pre>- 透過 OrderHistorySortMenuHandler 提供 「依時間、金額、取件方式」 等排序方式。<br><br>- 預設排序方式為 「依時間由新到舊」 (.byDateDescending)。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>3.一般模式</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*29-SQdJcG8xCDv2oWGDOGA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*oH4jKbYCw46zB6plhdy2rg.png" /></figure><pre>- 支援滑動刪除（左滑即可刪除單筆訂單）<br><br>- 點擊進入訂單詳情頁面<br><br>- 可透過「排序」按鈕改變列表順序</pre><p><strong>4.進入編輯模式</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*EZQUHUAii7utMKzVF3tmIA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*S7MKYxFZv7YNXvJmm9qFCg.png" /></figure><pre>1.點擊「編輯」按鈕，進入多選模式：<br><br>  - 不提供滑動刪除（與一般模式不同）<br>  - 支援「多選刪除」（用戶需先選取多筆訂單，才能點擊「刪除」按鈕）<br><br>2.刪除成功後，自動更新畫面。</pre><p><strong>5.查看訂單詳細內容</strong></p><pre>- 點擊任一 OrderHistoryCell，導航至 OrderHistoryDetailViewController，顯示該筆訂單的詳細資訊。</pre><p><strong>6.無訂單時的 UI 處理</strong></p><pre>- 當 orders 陣列為空時，自動顯示 OrderHistoryEmptyStateView，提供視覺提示。</pre><h3>4.訂單歷史頁面的業務層設計</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zSwKc85ka55NxAxNehfH-A.png" /></figure><h4>4–1.訂單數據管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IwZ_yBg2lfTGm7MkGsCRTA.png" /></figure><ul><li>OrderHistoryManager</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FIdaXghTAnVZHRbXeiInRQ.png" /></figure><pre>- 負責從 Firebase Firestore 加載歷史訂單，並提供排序與篩選功能。<br><br>- 支援單筆刪除與批量刪除訂單，確保數據同步更新。<br><br>- 提供異步（async/await）方法，確保 UI 運行流暢。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–2.表單數據管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xBRo5IrshamgnQCPev2_qQ.png" /></figure><p><strong>1.</strong><strong>OrderHistoryHandler</strong>（負責 UITableView 的 DataSource &amp; Delegate）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*22gYHnIMve1RoqTXNmr4xQ.png" /></figure><pre>1.提供歷史訂單的數據來源，負責顯示訂單列表。<br><br>2.根據模式處理點擊行為<br><br>  - 正常模式 → 點選行會進入 OrderHistoryDetailViewController。<br>  - 編輯模式 → 點選行僅影響選取狀態，不會觸發導航。<br><br>3.處理滑動刪除單筆訂單的邏輯，確保數據與 UI 同步。<br><br>4.與 OrderHistoryNavigationDelegate 搭配，實現點選訂單跳轉到詳情頁面。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderHistoryEditingHandler</strong>（負責<strong>編輯模式與多選刪除</strong>）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Zka3mBoCj3KC3ziArnDr3g.png" /></figure><pre>1.管理編輯模式，包括開啟/關閉編輯模式、檢查選取狀態、切換按鈕狀態等。<br><br>2.負責多選刪除，允許使用者在編輯模式下選取多筆訂單一次刪除。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>OrderHistorySortMenuHandler</strong>（<strong>負責排序選單</strong>）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CvlRxuvhhNra-BguR62PzQ.png" /></figure><pre>1.提供歷史訂單的排序選單，允許使用者選擇不同的排序條件（例如依時間、金額排序）。<br><br>2.與 OrderHistorySortMenuDelegate 協作，處理使用者的排序選擇並通知 OrderHistoryViewController 更新 UI。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–3.訂單排序與篩選</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Hr4sZpze7TR4AxXxCQQAog.png" /></figure><p><strong>1.</strong><strong>OrderHistorySortOption</strong>（定義不同的<strong>排序條件</strong>）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YZdfd9_nN4a0yZMGv72e6A.png" /></figure><pre>- byDateDescending（依時間從新到舊）<br><br>- byDateAscending（依時間從舊到新）<br><br>- byAmountDescending（依金額從高到低）<br><br>- byAmountAscending（依金額從低到高）<br><br>- byPickupMethod（依取件方式排序）</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistorySortOption.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistorySortOption.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderHistorySortMenuDelegate</strong>（回傳使用者選擇的排序方式）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r2D3YQamcrYi-47voQ2ffg.png" /></figure><pre>- 使用者在 UI 上選擇排序方式後，透過 delegate 通知 OrderHistoryViewController 更新訂單顯示順序。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–4.導航與按鈕管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CvLSxbsepv-xoueP3IhVvg.png" /></figure><p><strong>1.</strong><strong>OrderHistoryNavigationBarManager</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oYH3s9i4ezNvm30OW8FuAw.png" /></figure><ul><li><strong>動態管理導航欄的按鈕</strong>，根據是否進入編輯模式顯示不同的 UI：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HIbgc0a-JTqPJIfvPaslzg.png" /></figure><pre>1.正常模式（normal）：<br><br>  - 顯示排序與編輯按鈕。<br><br>2.編輯模式（editing）：<br><br>  - 顯示完成與刪除按鈕，並根據是否有選取訂單來啟用/禁用「刪除」按鈕。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.</strong><strong>OrderHistoryEditingState（表示導航欄的編輯狀態）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uNGuGfKU8NLDTCCN6OkMmQ.png" /></figure><pre>1.normal：<br><br>  - 顯示排序與編輯按鈕。<br><br>2.editing(hasSelection: Bool)：<br><br>  - 顯示完成與刪除按鈕，並根據是否選取訂單來決定刪除按鈕是否啟用。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–5.離開頁面時的狀態重置</h4><ul><li>在用戶離開 OrderHistoryViewController 時，確保：</li></ul><pre>1.若當前處於編輯模式 → 自動退出編輯狀態<br><br>2.導航欄上的按鈕重置 → 顯示為一般模式下的排序、編輯按鈕<br><br>3.這樣可以避免用戶回到主頁或切換其他頁面時，編輯模式意外保留，導致狀態不一致。</pre><ul><li>透過 viewWillDisappear 方法進行狀態檢查與重置：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7SruWIZ_xUrDdbJTzpvHNw.png" /></figure><ul><li>設計目的：</li></ul><pre>1.當用戶離開訂單歷史頁面時，若處於「編輯模式」，自動 退出編輯模式，避免：<br><br>  - 表格視圖仍停留在多選狀態<br>  - 導航欄仍顯示「完成」與「刪除」按鈕</pre><ul><li>搭配說明：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/953/1*O_RRzMTHu4TFGl2EU2NMdA.png" /></figure><pre>1.OrderHistoryEditingHandler：<br><br>  - 使用 toggleEditingMode() 切換狀態<br><br>2.OrderHistoryNavigationBarManager：<br><br>  - 使用 updateNavigationBar(for:) 重設按鈕</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>5.訂單管理與交互邏輯</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GsNAF0ZCrRZdjWwQNNY_xw.png" /></figure><ul><li>歷史訂單頁面除了展示過往訂單，還具備完整的 <strong>CRUD 操作</strong>、<strong>編輯模式管理</strong> 以及 <strong>詳細歷史訂單導航</strong> 功能，讓用戶可以靈活管理訂單紀錄。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1jec-KhaYYsvlX5aIeMoig.png" /></figure><h4>5–1.Firebase 訂單獲取與排序流程</h4><p><strong>1.從 Firebase 獲取訂單列表</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zYsaj8jVYYCq7EY6sALePw.png" /></figure><ul><li>頁面加載時，呼叫 OrderHistoryManager 的 fetchOrderHistory(sortOption:) 方法，將當前排序條件傳入，從 Firebase Firestore 獲取訂單</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_MR6YVdjeENpSXXzIySYng.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2nhCJ5XRj1cf8HJsYb-Yww.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CemhfVGZ8wLZBOAr7kRU0Q.png" /><figcaption>左至右：頁面加載時，傳入排序條件 / 從 Firebase Firestore 獲取訂單 / 導航欄按鈕狀態</figcaption></figure><ul><li><strong>重點設計</strong>：</li></ul><pre>1.資料獲取完成後，更新本地訂單列表，並透過 OrderHistoryHandler 通知 TableView 更新。<br><br>2.若無訂單資料，則禁用編輯按鈕。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.排序功能交互</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SEWPHZEZ2j6oN-kJZ6a6hg.png" /></figure><ul><li>排序邏輯集中於 <strong>OrderHistorySortMenuHandler</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5XfkeUkmq1kXbYt54LDXWA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_cQGgOahYn6RO0hOCwwyog.png" /><figcaption>左至右：<strong>生成 UIMenu 排序選單</strong> / <strong>使用者選擇排序後，更新顯示順序。</strong></figcaption></figure><pre>1.點擊導航欄上的排序按鈕，會顯示由 OrderHistorySortMenuHandler.createSortMenu() 生成的 UIMenu 排序選單。<br><br>️2.使用者選擇排序條件後，透過 OrderHistorySortMenuDelegate.didSelectSortOption() 回傳排序選項。<br><br>️3.OrderHistoryViewController 接收到回傳的排序選項後，呼叫 OrderHistoryManager.fetchOrderHistory(sortOption:) 重新獲取並排序訂單資料，更新顯示順序。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistorySortMenuDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–2.一般模式功能</h4><p><strong>1.顯示排序與編輯按鈕</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_VbaoXD9NiKb8Jtf2gzuRg.png" /></figure><ul><li>流程</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UtSaXZizrve0YJOpIqR0Ow.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-XpP-5ZEOsNpwOZYSIoBTw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0Xc3fIArqLXqrvpKfCyfPA.png" /><figcaption>左至右：<strong>updateNavigationBar(for: .normal) </strong>/ <strong>isOrderListEmpty()</strong> / <strong>createSortMenu()</strong></figcaption></figure><pre>1.導航欄右側顯示 排序 與 編輯 按鈕，控制元件由 OrderHistoryNavigationBarManager 負責。<br><br>  - 排序：搭配上面提到的排序流程，更新顯示。<br>  - 編輯：切換至編輯模式。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistorySortMenuHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.滑動刪除單筆訂單</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WnSWs996zKgkAtMLK93m6g.png" /></figure><ul><li>流程</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Po2rUFqyBgyb0aP1rIcQTA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YJic0UuTBpviYp7UqWJieA.png" /><figcaption>左至右：觸發 commit editingStyle / 刪除 Firestore 訂單資料</figcaption></figure><pre>1.滑動某行 ➔ 觸發 commit editingStyle，呼叫：<br><br>  - OrderHistoryManager.deleteOrder(orderId:)<br><br>2.刪除後自動刷新列表，並根據列表狀態更新編輯按鈕。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Services/OrderHistoryManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>3.點擊訂單查看詳情</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PkcC7ll4Sbwj51HB7VI6tw.png" /></figure><ul><li>流程</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*akj8Ohl0S6D1VjxmoJ1knQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VY9u125681gHmXOSXgSpPg.png" /><figcaption>左至右：<strong>呼叫 didSelectRowAt</strong> / <strong>執行 navigateToOrderHistoryDetail</strong></figcaption></figure><pre>1.點選訂單行 ➔ 透過 OrderHistoryNavigationDelegate 導向詳細頁：<br><br>  - navigateToOrderHistoryDetail(with: order)</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistoryNavigationDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Delegates/OrderHistoryNavigationDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>4.進入編輯模式按鈕</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EDG7n8wa7QF_lvkSHXnIeQ.png" /></figure><ul><li>流程</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JALbIIq4ZkuKN8Maeai_8A.png" /><figcaption>分別為：OrderHistoryEditingState / OrderHistoryNavigationBarManager / OrderHistoryEditingHandler</figcaption></figure><pre>1.OrderHistoryNavigationBarManager<br><br>  - 接收到點擊事件，會呼叫 OrderHistoryEditingHandler.toggleEditingMode()，切換訂單歷史頁面的編輯狀態。<br><br>2.OrderHistoryEditingHandler 會根據目前是否處於編輯模式，反轉狀態：<br><br>  - 如果是「一般模式」→ 切換為「編輯模式」。<br>  - 如果已經是「編輯模式」→ 切換回「一般模式」。<br><br>3.切換後，EditingHandler 會回傳一個 NavigationBarState 狀態，告知 NavBarManager：<br><br>  - 當前為 .editing(hasSelection: false)：<br><br>      - 表示目前處於編輯模式。<br>      - hasSelection: false 意味著尚未選取任何訂單（勾選刪除用）。<br><br>4.OrderHistoryNavigationBarManager 依據這個狀態，更新導航欄上的按鈕顯示：<br><br>  - 顯示「完成」按鈕（退出編輯模式）。<br>  - 顯示「刪除」按鈕（預設為 disabled，直到用戶選取訂單）。<br>  - 隱藏排序按鈕，避免編輯狀態與排序衝突。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–3.編輯模式功能詳解</h4><p><strong>1.編輯模式狀態設計</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hMAhROph7VcAYmUdgZMmEg.png" /></figure><ul><li>程式碼</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BLwG9tR6IH6JNV7nRMC7cg.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Models/OrderHistoryEditingState.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.多選刪除</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yFnpYrRb6Q6MrdrkV-BlIg.png" /></figure><ul><li>程式碼：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EomuAaaj7-qpyz2J88rlXA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bRsTCxZUBj4hTpGsEV8W3g.png" /><figcaption>左至右：啟用刪除按鈕 / 刪除多選</figcaption></figure><pre>1.透過 OrderHistoryEditingHandler 記錄選取行，刪除流程：<br><br>  - OrderHistoryEditingHandler.deleteSelectedRows()<br><br>2.刪除後刷新列表並切回 .editing(hasSelection: false)。</pre><ul><li>目的：</li></ul><pre>1.清楚掌控編輯狀態（是否有選取行、是否正在編輯模式）。<br><br>2.解耦資料刪除 &amp; UI 更新：只需調用 deleteSelectedRows()，內部自動處理：<br><br>  - 刪除 Firebase 資料  <br>  - 更新 TableView 刪除<br>  - 重設編輯狀態</pre><ul><li>刪除後會切回 .editing(hasSelection: false)</li></ul><pre>- 原因：<br><br>  - 刪除完成後，還在編輯模式，但因為所有選取行已經刪除 → 目前沒有選取項目，所以狀態切為 .editing(hasSelection: false)，並禁用刪除按鈕。<br><br>- 這樣做的好處：<br><br>  - 保持編輯狀態一致，讓使用者可以繼續選取刪除其他項目，不用每次刪完都強制退出。<br>  - UI (導航欄按鈕) 和 TableView 狀態保持同步。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/View%20Controllers/OrderHistoryViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/View Controllers/OrderHistoryViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>3.完成按鈕退出編輯模式</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Fei6Si4k4U9JFNtNW230ug.png" /></figure><ul><li>程式碼：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QJMXY9dDOi1Lj5tSVQ4uqQ.png" /></figure><pre>- 點擊完成按鈕 ➔ 切回 .normal 狀態，恢復排序與編輯按鈕，清空選取。</pre><ul><li><strong>目的</strong>：</li></ul><pre>1.確保離開編輯模式時 UI 回到初始狀態，避免誤操作。<br><br>2.使用者可重新進行排序或再次進入編輯模式。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>4.禁用滑動刪除與點擊詳情</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NUBoGK-CYMPu46X0NWfHNw.png" /></figure><ul><li>程式碼：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gv2YnXfNwDIxh1FPkf0J1g.png" /></figure><pre>- 編輯模式下，TableView 禁止滑動刪除與 didSelectRow，避免誤操作。</pre><ul><li><strong>目的</strong>：</li></ul><pre>- 防止使用者在批次操作（編輯模式）時誤觸刪除或跳轉詳情，保持操作一致性與安全性。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Manager/OrderHistoryNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryEditingHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderHistory/Handlers/OrderHistoryHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–4.CRUD 與排序操作總覽</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*az8Tts-nHWMm3X30HAmHkg.png" /></figure><ul><li>整體交互邏輯強調 <strong>狀態驅動 + 數據驅動</strong>，透過明確的 OrderHistoryEditingState 管理一般與編輯模式，並將 <strong>Firebase 訂單獲取</strong> 與 <strong>排序功能</strong> 流程完整串聯，確保：</li></ul><pre>1.交互體驗清晰，避免誤操作<br><br>2.CRUD 與排序集中管理，邏輯可擴展<br><br>3.導航、編輯、排序功能彼此解耦，維護容易</pre><h3>6.總結</h3><h4>6–1.訂單歷史頁面的 UI 設計與業務邏輯分工</h4><ul><li>將 <strong>OrderHistoryViewController</strong> 依照 <strong>MVC 架構</strong> 明確拆分為多個模組，強調 <strong>UI 層</strong> 與 <strong>業務層邏輯</strong> 的分離：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*S5i_vr2mLL2O5KQ0XsMnkQ.png" /></figure><h4>6–2.確保 UI 變更與數據狀態同步</h4><ul><li>採用 <strong>資料驅動設計</strong>：</li></ul><pre>- orders 陣列作為單一數據來源<br><br>- 所有 UI 顯示狀態（如 TableView reload、空狀態提示、導航欄按鈕）皆依賴此資料變化。</pre><ul><li>關鍵機制：</li></ul><pre>1.orders didSet <br><br>  - 呼叫 setupNavigationBar() 和 updateEmptyStateView()，確保 UI 與數據同步更新。<br><br>2.OrderHistoryHandler<br><br>  - 透過代理 getOrders() 實時取得最新數據。<br><br>3.編輯狀態切換 <br>  <br>  - 由 OrderHistoryEditingHandler 控制，避免 UI 與編輯邏輯脫鉤。</pre><h4>6–3.提升用戶在訂單管理中的體驗</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EsHLmZfHDFjTuiBZRXyQfw.png" /></figure><h3>7.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=0ee828e7854d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-21-%E8%A8%82%E5%96%AE%E6%AD%B7%E5%8F%B2%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA-%E7%AE%A1%E7%90%86%E8%88%87%E6%8E%92%E5%BA%8F%E6%AD%B7%E5%8F%B2%E8%A8%82%E5%96%AE-0ee828e7854d">OrderCoffeeApp #21：訂單歷史頁面 —顯示、管理與排序歷史訂單</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #20：個人資料編輯 — 顯示與更新]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-20-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E7%B7%A8%E8%BC%AF-%E9%A1%AF%E7%A4%BA%E8%88%87%E6%9B%B4%E6%96%B0-3c9599c38138?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/3c9599c38138</guid>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[swift]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:13:54 GMT</pubDate>
            <atom:updated>2025-03-26T16:14:15.227Z</atom:updated>
            <content:encoded><![CDATA[<h3>OrderCoffeeApp #20：個人資料編輯 — 顯示與更新</h3><h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DbS9EmmuyP0M&amp;type=text%2Fhtml&amp;schema=youtube&amp;display_name=YouTube&amp;src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FbS9EmmuyP0M%3Ffeature%3Doembed" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/d0ee8895696c1ffae8374757ddec7645/href">https://medium.com/media/d0ee8895696c1ffae8374757ddec7645/href</a></iframe><h3>目錄</h3><pre>· <a href="#ea56">1.介紹</a><br>  ∘ <a href="#ee06">1–1.個人資料編輯頁面的核心功能</a><br>  ∘ <a href="#0421">1–2.功能概覽</a><br>  ∘ <a href="#ad68">1–3.概述</a><br>· <a href="#fe33">2.核心架構</a><br>  ∘ <a href="#30be">2–1.架構模式：MVC</a><br>  ∘ <a href="#20b5">2–2.UI 分層</a><br>  ∘ <a href="#cea0">2–3.個人資料數據管理</a><br>· 3.個人資料 UI 設計<br>  ∘ <a href="#de66">3–1.頁面構造</a><br>  ∘ <a href="#b9dc">3–2.表單輸入元件</a><br>  ∘ <a href="#e12b">3–3.大頭照顯示與修改</a><br>  ∘ <a href="#c3ce">3–4.表單驗證</a><br>  ∘ <a href="#d993">3–5.導航欄管理</a><br>· <a href="#e233">4.個人資料的業務層設計</a><br>  ∘ <a href="#e893">4–1.數據獲取</a><br>  ∘ <a href="#5cb5">4–2.數據更新</a><br>  ∘ <a href="#0eea">4–3.照片上傳與管理</a><br>  ∘ <a href="#58ec">4–4.相關組件的職責劃分</a><br>· <a href="#375c">5.UI 交互與表單邏輯</a><br>  ∘ <a href="#7f27">5–1.表單數據的變更與同步</a><br>  ∘ <a href="#f903">5–2.圖片變更流程</a><br>  ∘ <a href="#9d06">5–3.儲存按鈕的行為</a><br>· <a href="#64b2">6.Firebase 整合</a><br>  ∘ <a href="#32b3">6–1.從 Firebase 加載用戶資料</a><br>  ∘ <a href="#ee1a">6–2.同步更新個人資料</a><br>· <a href="#f2c6">7.總結</a><br>  ∘ <a href="#8263">7–1.個人資料 UI 與業務邏輯的分工</a><br>  ∘ <a href="#2895">7–2.確保 UI 變更與業務邏輯同步</a><br>  ∘ <a href="#76cb">7–3.表單驗證與 UI 交互的實踐</a><br>  ∘ <a href="#bca9">7–4.Firebase 與本地數據的同步</a><br>  ∘ <a href="#7f46">7–5.大頭照上傳與管理的挑戰</a><br>· <a href="#cbee">8.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3eMMp44MrCk1DTwNks1nVA.png" /></figure><h3>1.介紹</h3><h4>1–1.個人資料編輯頁面的核心功能</h4><ul><li>畢竟使用者當初註冊的時候，只需要提供姓名、信箱，而考量到使用者在下訂單的時候，會需要額外填寫電話、地址等資訊。</li><li>因此才設置個人資料編輯頁面，讓使用者可以選擇是否要補充這些資訊，讓其在填寫訂單資料時方便填充顧客訂單內容。</li><li>在 <strong>OrderCoffeeApp</strong> 中，個人資料編輯頁面允許使用者管理並更新自己的基本資訊，如 <strong>姓名、</strong><strong>性別、</strong><strong>生日、</strong><strong>電話號碼、</strong><strong>地址</strong> 及 <strong>大頭照</strong>。</li></ul><h4>1–2.<strong>功能概覽</strong></h4><pre>1.顯示使用者基本資訊：<br><br>  - 從 Firebase 加載使用者的個人資料並呈現在 UI 上。<br><br>2.資料輸入與即時驗證：<br><br>  - 確保輸入資料符合格式，例如姓名不可為空，電話號碼格式須符合規範。<br><br>3.照片上傳與更新：<br><br>  - 允許使用者透過 相簿或相機 選取新照片，並上傳至 Firebase Storage。<br><br>4.個人資料儲存：<br><br>  - 使用者編輯完成後，可將更新內容同步至 Firebase Firestore。<br><br>5.導航與操作回饋：<br><br>  - 提供返回按鈕與儲存按鈕，並在處理請求時顯示 HUD 加載指示。</pre><h4>1–3.概述</h4><ul><li>本篇文章將詳細介紹 <strong>個人資料編輯頁面（</strong><strong>EditProfileViewController）</strong> 的實作方式，包括 <strong>UI 設計</strong>、<strong>業務邏輯</strong>、<strong>Firebase 整合</strong> 以及 <strong>照片選擇與上傳</strong> 等內容。</li></ul><blockquote><strong><em>1.UI 設計與組件：</em></strong></blockquote><pre>- EditProfileView：<br><br>  - 整體視圖佈局。<br><br>- ProfileImageViewCell：<br><br>  - 顯示與更新大頭照。<br><br>- ProfileTextFieldCell、GenderSelectionCell、BirthdaySelectionCell、BirthdayDatePickerCell：<br><br>  - 用於編輯不同類型的資料。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/ProfileImageViewCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/ProfileImageViewCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><blockquote><strong><em>2.業務邏輯處理：</em></strong></blockquote><pre>- EditUserProfileManager：<br><br>  - 負責從 Firebase 讀取與更新使用者資料。<br><br>- ProfileImageUploader：<br><br>  - 負責圖片的選擇與上傳。<br><br>- PhotoPickerManager：<br><br>  - 處理照片選擇流程。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><blockquote><strong><em>3.Firebase 整合：</em></strong></blockquote><pre>- 使用 Firestore 讀取與更新使用者資料。<br><br>- 使用 Firebase Storage 儲存與管理大頭照。</pre><h3>2.核心架構</h3><ul><li>個人資料編輯頁面的核心架構遵循 <strong>MVC 設計模式</strong>，並進一步將 <strong>UI 層、業務邏輯層、數據管理層</strong> 明確拆分，以提升可讀性與維護性。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xZxY2FVBdqkMCcDtIimY1A.png" /></figure><h4>2–1.架構模式：MVC</h4><ul><li>此頁面採用 <strong>MVC（Model-View-Controller）</strong> 設計模式，確保：</li></ul><pre>1.數據模型 (Model) 負責存儲與處理使用者個人資料。<br><br>2.視圖層 (View) 負責 UI 顯示與使用者輸入的處理。<br><br>3.控制器 (Controller) 負責管理頁面邏輯、處理用戶交互，並調用業務邏輯來更新 Firebase。</pre><h4>2–2.UI 分層</h4><ul><li>UI 部分拆分為三個主要組件：</li></ul><p>1.<strong>EditProfileViewController（主控制器）</strong></p><pre>- 負責頁面邏輯與用戶交互，調用 EditUserProfileManager 讀取與更新 Firebase 的個人資料數據。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.</strong><strong>EditProfileView（負責 UI 佈局）</strong></p><pre>- 定義 UITableView，確保畫面結構清晰，並允許後續擴展與自訂 UI 元件。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>3.</strong><strong>EditProfileTableHandler（負責 TableView 邏輯）</strong></p><pre>- 將 UITableViewDataSource 與 UITableViewDelegate 分離，降低 ViewController 的負擔，並負責配置不同的 UITableViewCell。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>2–3.個人資料數據管理</h4><p>1.<strong>ProfileEditModel（數據結構）</strong></p><pre>- 使用 Codable 來簡化 Firebase 交互，並確保模型結構與 Firestore 文件對應。<br><br>- 提供 init 方法，確保所有欄位皆有預設值，避免 nil 錯誤。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>EditUserProfileManager（負責 Firebase 數據處理）</strong></p><pre>- 負責：<br><br>  1.讀取 Firestore 內的個人資料數據，轉換為 ProfileEditModel。<br>  2.將使用者更新後的數據上傳至 Firebase。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>3.個人資料 UI 設計</h3><ul><li>在 <strong>「個人資料編輯」</strong> 頁面中，UI 設計的重點是：</li></ul><pre>- 結構清晰，維持一致的 UI 風格<br><br>- 支援表單驗證與互動性，提供最佳使用者體驗<br><br>- 獨立處理大頭照選取、上傳 Firebase 的邏輯（重要）<br><br>- 確保 UI 變更能夠即時反映使用者的輸入</pre><h4>3–1.頁面構造</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oPeoTKx5peL4Em-YoVtvSA.png" /></figure><ul><li>個人資料編輯頁面是由 <strong>視圖層（View）與</strong><strong>控制器層（ViewController）</strong> 組成，確保清楚的架構分層：</li></ul><pre>- EditProfileViewController（主控制器，負責 UI 邏輯與資料處理）<br><br>- EditProfileView（負責管理 UITableView）</pre><ul><li><strong>設計考量</strong></li></ul><pre>- 維持 MVC 分工清晰：<br><br>  - ViewController 只處理邏輯，而 View 負責顯示，避免 Fat ViewController 問題。<br><br>- 使用 UITableView 作為表單：<br><br>  - 方便擴展與管理欄位。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Views/EditProfileView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–2.表單輸入元件</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1KtrdrN8vIX4h42f2BEEyg.png" /></figure><ul><li>使用 UITableView 分別對應個人資料的各個欄位，並確保編輯的流暢性：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*419rSzPmDTIlt_8BGlgI2w.png" /></figure><ul><li>設計考量</li></ul><pre>- 姓名為必填欄位，其他欄位（電話、地址）則是可選填。<br><br>- 生日選擇器使用 UIDatePicker，避免用戶輸入格式錯誤。<br><br>- 性別選擇使用 Segmented Control，提供簡單直覺的互動。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–3.大頭照顯示與修改</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*s4Kog6z7Xbe34ZCMcpCqGw.png" /></figure><ul><li>大頭照是個人資料的重要部分，使用 UIImageView 搭配 UIButton 來進行選取、顯示與上傳。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BveE3-K5OPRxi8MRSmvBRA.png" /></figure><ul><li><strong>設計考量</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5aaBnOyZAaq_pVvI8qzxeQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CNNjx5lRF3ek9u-E6-_jdQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EA9PRPqvXUKvIIzPv_xLiQ.png" /><figcaption>左至右：ProfileImageCoordinator / 選取圖片後，立即更新 UI / 當用戶 點擊「儲存」時 才會上傳圖片</figcaption></figure><pre>1.解耦圖片選取與上傳邏輯：<br><br>  - PhotoPickerManager 處理相簿/相機選取<br>  - ProfileImageUploader 負責上傳 Firebase Storage<br><br>2.UI 變更與上傳解耦：<br><br>  - 選取圖片後，立即更新 UI<br>  - 當用戶 點擊「儲存」時 才會上傳圖片</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/ProfileImageViewCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/ProfileImageViewCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–4.表單驗證</h4><ul><li>用戶輸入時，<strong>應即時提供回饋</strong>，避免提交時才發現錯誤。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ca8gPZ6IQv3agGx3iND1fw.png" /></figure><ul><li><strong>設計考量</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4R4O-itUNr_GEmgj9QfyIw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LKx677dgGblNA-DWFGzxfA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8xUD_CWrYKW1_ZHwn3cZTA.png" /><figcaption>左至右：EditProfileTextField、EditProfileViewController / ProfileEditModel / EditUserProfileManager</figcaption></figure><pre>1.即時顯示錯誤訊息（避免使用者填完後才發現錯誤）。<br><br>2.防止無效數據進 Firebase（如 fullName 不能為空）。<br><br>3.使用 NSNull() 儲存 Firebase：未選擇生日時，Firebase 會存 null 避免資料錯誤。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Components/EditProfileTextField.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Components/EditProfileTextField.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–5.導航欄管理</h4><ul><li>使用 EditProfileNavigationBarManager <strong>統一管理</strong> 導航欄，提升可讀性與維護性：</li></ul><pre>- 標題：「編輯個人資料」<br><br>- 返回按鈕<br><br>- 「儲存」按鈕</pre><ul><li>設計考量</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*j5UhbKVPZgAr5Z3nV9nWBw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dr6T4iq9B0Xtzn4-04iz1w.png" /><figcaption>左至右：EditProfileNavigationBarManager / EditProfileViewController</figcaption></figure><pre>- 避免 ViewController 直接操控 navigationItem，提升結構清晰度。<br><br>- 「儲存」按鈕必須在姓名有值的情況下才可正常運作。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/EditProfileNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/EditProfileNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>4.個人資料的業務層設計</h3><ul><li>在「個人資料編輯」功能中，業務層的核心在於<strong>數據獲取、</strong><strong>數據更新</strong>，以及<strong>照片上傳與管理</strong>，確保用戶能夠順利查看並更新個人資料。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*v-A8pggoy4517g0aYvL5iQ.png" /></figure><h4>4–1.數據獲取</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*htej5_1DV7RZ_d9a4cuZuw.png" /></figure><ul><li><strong>負責組件</strong>：EditUserProfileManager</li><li>當用戶進入 <strong>編輯個人資料頁面</strong> (EditProfileViewController) 時，應該立即載入該用戶的資料，並顯示於 UI 中。這個過程由 EditUserProfileManager 負責：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-AYwrXYUQNpM_vKMPfBqng.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*q1-pHhY-OgtYs7lIwk5aPA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9C0oAOwPMUVDfOA7EdKC2g.png" /><figcaption>左至右：ProfileEditModel / PhotoPickerManager / EditProfileViewController</figcaption></figure><pre>1.從 Firebase 讀取數據（Firestore）<br><br>2.將數據轉換為應用層的 ProfileEditModel<br><br>3.回傳給 EditProfileViewController，並更新 UI</pre><ul><li><strong>細節</strong></li></ul><pre>1.若用戶已登入，則根據 uid 從 Firebase Firestore 取得對應的個人資料文件。<br><br>2.透過 convertToProfileEditModel 方法，將 Firestore 的 JSON 轉換成 ProfileEditModel。<br><br>3.若找不到用戶資料，則拋出錯誤，並在 UI 顯示「加載失敗」。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Models/ProfileEditModel.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–2.數據更新</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nPe0vL8BqQxKH30ebhHxCg.png" /></figure><ul><li><strong>負責組件</strong>：EditUserProfileManager</li><li>當用戶在 <strong>編輯個人資料頁面</strong> 修改個資（如姓名、電話、性別、生日等）並點擊「儲存」時，應該觸發 updateCurrentUserProfile 方法，將新資料寫回 Firebase。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YofNV6iPAs-AfIQyCmru5w.png" /></figure><pre>1.驗證輸入的數據格式<br><br>  - 姓名（fullName）：必填，不能為空<br>  - 電話（phoneNumber）：允許空值，若填寫則需要符合手機號格式<br>  - 生日（birthday）：不得超過當天<br>  - 性別（gender）：必填，預設為「Other」<br><br>2.將變更後的資料轉換為 Firebase 的字典格式<br>  <br>3.透過 updateData 更新 Firestore<br><br>4.確保數據更新後，UI 也同步刷新</pre><ul><li><strong>細節</strong></li></ul><pre>- 若用戶未登入，則阻止數據更新並拋出錯誤。<br><br>- 更新數據時，確保不會覆蓋 Firebase 上的 uid（不可修改）。<br><br>- profileImageURL 可能為 nil，所以要正確處理 null 值避免錯誤。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–3.照片上傳與管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XOMKNW_9kZBI1tlbRoYq8w.png" /></figure><ul><li><strong>負責組件</strong>：</li></ul><pre>- ProfileImageUploader（負責上傳圖片到 Firebase Storage）<br><br>- PhotoPickerManager（負責圖片選取）<br><br>- ProfileImageCoordinator（管理 UI 和圖片上傳流程）</pre><ul><li>在個人資料編輯中，<strong>大頭照的處理是一個獨立的流程</strong>，主要包括：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OkhGFAiWBuaPyUW8B6fkiQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DEan2sK3c6z9nKBqKqYI6A.png" /><figcaption>左至右：用戶點擊更換照片 / 用戶點擊Save按鈕</figcaption></figure><pre>1.用戶點擊「更換照片」<br><br>  - 觸發 ProfileImageCoordinator.handleChangePhotoButtonTapped<br>  - PhotoPickerManager 顯示相簿選擇 UI<br><br>2.用戶選取圖片<br><br>  - ProfileImageUploader.setSelectedImage(selectedImage) → 圖片暫存，不會立即上傳<br><br>3.用戶點擊「儲存 (Save)」按鈕<br><br>  - saveButtonTapped 觸發：<br><br>    a.驗證輸入資料<br>    b.執行 updateProfileImageIfNeeded，將圖片上傳至 Firebase Storage<br>    c.取得下載 URL，更新 profileImageURL<br>    d.呼叫 updateCurrentUserProfile 將新 URL 儲存到 Firebase Firestore<br><br>4.更新 UI 以顯示最新大頭照<br><br>  - ProfileImageViewCell.updateProfileImageWithImage(selectedImage)</pre><ul><li><strong>細節</strong></li></ul><pre>1.傳遞細節：<br><br>  - 圖片並不會在選取時立即上傳，而是等到 點擊「儲存」後才會上傳。<br><br>2.保護機制：<br><br>  - 若圖片上傳失敗，則 Firestore 不會更新 profileImageURL，確保資料一致性。<br><br>3.圖片上傳格式：<br><br>  - 格式轉換為 JPEG，壓縮至 80% 質量，以提高上傳速度。<br><br>4.Firebase Storage 檔案命名格式：<br><br>  - profileImages/{userID}.jpg，避免用戶產生多個不同的檔案。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–4.相關組件的職責劃分</h4><ul><li>這部分的 <strong>業務邏輯與 UI 互動是分開處理的</strong>，確保架構清晰，降低耦合度：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WYLNOoGzdY9B21yCdzhmAw.png" /></figure><h3>5.UI 交互與表單邏輯</h3><ul><li>這一部分的目標是<strong>確保使用者在編輯個人資料時，數據與 UI 變更保持同步</strong>，並且<strong>提供流暢的使用者體驗</strong>。</li></ul><h4>5–1.表單數據的變更與同步</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YE_QBu5NkE5nA_-V2hhDmQ.png" /></figure><pre>1.EditProfileTableHandler <br><br>  - 負責監聽用戶輸入並即時更新 ProfileEditModel。<br><br>2.EditProfileViewController <br><br>  - 負責管理 ProfileEditModel，並將數據同步至 Firebase。</pre><blockquote><strong><em>數據同步機制：</em></strong></blockquote><p><strong>1.一般輸入框（</strong><strong>ProfileTextFieldCell）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*827_V9H14fxAn-chB36jvA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tAvogxx65_EyG9yMFxk44A.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XzVu0ag2qoyzzyKJqjFXew.png" /><figcaption>左至右：EditProfileTableHandler / ProfileTextFieldCell / EditProfileTextField</figcaption></figure><pre>1.ProfileTextFieldCell 內含 UITextField，使用者輸入時，EditProfileTableHandler 透過 delegate.updateProfileEditModel() 即時更新 ProfileEditModel。<br><br>2.使用者輸入時：<br><br>  - UITextField 監聽變更，並將新的值傳遞至 ProfileEditModel。<br>  - 若輸入為空，會即時更新 UI。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/ProfileTextFieldCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Components/EditProfileTextField.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Components/EditProfileTextField.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.性別選擇（</strong><strong>GenderSelectionCell）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rvCJALU67TpV9EImutAD7w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BC1wqVo03oCi1tmTHenXhw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KUTWZufOsBaO0y7OThH3FQ.png" /><figcaption>左至右：EditProfileTableHandler / GenderSelectionCell / EditProfileSegmentedControl</figcaption></figure><pre>1.GenderSelectionCell 內的 UISegmentedControl 讓使用者選擇「男性 / 女性 / 其他」。<br><br>2.當使用者變更 UISegmentedControl：<br><br>  - 即時更新 ProfileEditModel.gender。<br>  - UI 變更同步，例如高亮顯示所選擇的性別。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/GenderSelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Components/EditProfileSegmentedControl.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Components/EditProfileSegmentedControl.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>3.生日選擇（BirthdayDatePickerCell）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rTXZbpIzn-pX3_rAE_nieA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rnz-PRdrunYfhvzNjRbZHA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Exrs56RvN8V46aNl1lYLCA.png" /><figcaption>左至右：EditProfileTableHandler / BirthdaySelectionCell、BirthdayDatePickerCell / EditProfileDatePicker</figcaption></figure><pre>1.BirthdaySelectionCell 負責顯示生日的當前值（若未選擇，顯示「尚未選擇」）。<br><br>2.點擊 BirthdaySelectionCell 會展開 BirthdayDatePickerCell，顯示 UIDatePicker 讓使用者選擇生日。<br><br>3.BirthdayDatePickerCell 監聽 UIDatePicker 值變更：<br><br>  - 即時更新 ProfileEditModel.birthday<br>  - 同步 UI，讓 BirthdaySelectionCell 更新顯示的日期<br>  - 這確保生日資料在 UI 與數據層同步，避免顯示錯誤資訊。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdaySelectionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Cells/BirthdayDatePickerCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Components/EditProfileDatePicker.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Components/EditProfileDatePicker.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–2.圖片變更流程</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cConabSBi-rRIv67LOC4sA.png" /></figure><ul><li><strong>使用者流程</strong>：</li></ul><pre>1.使用者點擊「更換大頭照」<br><br>2.PhotoPickerManager 開啟相簿/相機 <br><br>3.選取圖片後，暫存於 ProfileImageUploader（未上傳）<br><br>4.UI 立即顯示新圖片<br><br>5.按下「儲存」後，才上傳至 Firebase<br><br>6.ProfileEditModel 更新</pre><ul><li>詳細步驟：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UiGpXB7_uu2gB8ADQNYB3w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pqQexpPWY13FeE8Q88yhrw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DEan2sK3c6z9nKBqKqYI6A.png" /><figcaption>左至右：使用者點擊「更換大頭照」 / 使用者選擇照片後 / 使用者按下「儲存」</figcaption></figure><pre>1.使用者點擊「更換大頭照」<br><br>  - ProfileImageViewCell 內的「更換照片」按鈕觸發 photoDelegate.didTapChangePhoto()。<br>  - EditProfileViewController 呼叫 ProfileImageCoordinator.handleChangePhotoButtonTapped()，開啟 PhotoPickerManager 讓使用者選擇新照片。<br>️<br>2.使用者選擇照片後<br><br>  - 圖片不會立即上傳，而是先暫存到 ProfileImageUploader.setSelectedImage(selectedImage)。<br>  - UI 立即更新 ProfileImageViewCell，顯示使用者剛剛選取的圖片。<br>️<br>3.使用者按下「儲存」<br><br>  - saveButtonTapped() 觸發：<br><br>    - 驗證輸入資料<br>    - 執行 updateProfileImageIfNeeded()，將暫存圖片上傳至 Firebase Storage。<br>    - 取得下載 URL，並更新 ProfileEditModel.profileImageURL。<br>    - 呼叫 updateCurrentUserProfile()，將新 URL 存入 Firestore。</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Handlers/EditProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/ViewControllers/EditProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Coordinators/ProfileImageCoordinator.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Managers/PhotoPickerManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/ProfileImageUploader.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>5–3.儲存按鈕的行為</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/918/1*SCZEvpIsFyFAurfpH2M9Mw.png" /></figure><ul><li><strong>點擊「Save」按鈕後的流程</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*y-S8IzhM--QWAWIsS2-fpA.png" /></figure><pre>1.驗證數據<br><br>  - validateRequiredFields() 確保 fullName 不是空值。<br><br>2.處理圖片上傳<br><br>  - 如果使用者變更大頭照，則先上傳至 Firebase Storage，取得 profileImageURL。<br><br>3.更新 Firebase<br><br>  - 調用 EditUserProfileManager.updateCurrentUserProfile()，將 ProfileEditModel 上傳至 Firestore。<br><br>4.UI 更新<br><br>  - 若儲存成功，關閉 HUD 並顯示成功訊息。<br>  - 若失敗，顯示錯誤訊息。</pre><h3>6.Firebase 整合</h3><h4>6–1.從 Firebase 加載用戶資料</h4><ul><li>在 EditUserProfileManager 中，透過 loadCurrentUserProfile() 方法來從 Firestore 取得當前用戶的個人資料。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r8bKe7ehqI7YOsU9gBpgqQ.png" /></figure><ul><li>步驟解析：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DImgtKul2C35B8SLft80LQ.png" /></figure><pre>1.確認使用者是否已登入：<br><br>  - 使用 Auth.auth().currentUser 確保當前有已登入的使用者。<br>  - 若未登入，拋出錯誤並避免後續操作。<br><br>2.讀取 Firestore 中的用戶文件：<br><br>  - 透過 Firestore.firestore().collection(&quot;users&quot;).document(user.uid) 取得對應的用戶文件。<br>  - 使用 getDocument() 方法非同步讀取文件。<br><br>3.解析 Firestore 回傳的數據：<br><br>  - 若文件存在，將 document.data() 轉換為 ProfileEditModel。<br>  - 若數據不存在，則拋出錯誤。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>6–2.同步更新個人資料</h4><ul><li>當用戶完成編輯後，需要將更新後的資料同步至 Firebase。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d7kEQwdOfdtxqkZ7YI2sdQ.png" /></figure><ul><li>步驟解析：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Hd-frTTDleHYllhLIsG3Lg.png" /></figure><pre>1.確認使用者是否已登入：<br><br>  - 同樣使用 Auth.auth().currentUser 確保有登入的使用者。<br><br>2.準備需要更新的資料：<br><br>  - 透過 ProfileEditModel 轉換為 Firestore 可存儲的 Dictionary。<br><br>3.使用 updateData() 更新 Firestore：<br><br>  - 透過 updateData() 方法更新用戶文件。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/EditProfile/Services/EditUserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>7.總結</h3><ul><li>在本篇文章中，探討了 <strong>個人資料編輯（Profile Editing）</strong> 的完整設計與實作，從 <strong>UI 層</strong> 到 <strong>業務邏輯層</strong>，再到 <strong>與 Firebase Firestore 的數據同步</strong>。這個模組的開發涉及 <strong>表單驗證</strong>、<strong>異步數據更新</strong>、<strong>圖片上傳處理</strong> 等核心功能，確保用戶能夠順暢地更新自己的個人資訊。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vepaoLrX0FkeVRd__o7YIQ.png" /></figure><h4>7–1.個人資料 UI 與業務邏輯的分工</h4><ul><li>在 EditProfileViewController 中，將 UI 層與業務邏輯層進行了明確的區隔：</li></ul><p>1.<strong>UI 層</strong></p><pre>1.EditProfileView：<br><br>  - 負責界面佈局，包含 UITableView 來顯示用戶可編輯的資料。<br><br>2.EditProfileTableHandler：<br><br>  - 負責 UITableViewDataSource 及 UITableViewDelegate 的處理，確保 UI 與 ProfileEditModel 資料保持一致。<br><br>3.ProfileImageCoordinator：<br><br>  - 負責處理 用戶大頭照 的選取與更新，包括調用 PhotoPickerManager 及 ProfileImageUploader。</pre><p>2.<strong>業務邏輯層</strong></p><pre>1.EditUserProfileManager：<br><br>  - 負責與 Firebase Firestore 交互，提供 讀取與更新個人資料 的方法。<br><br>2.ProfileImageUploader：<br><br>  - 負責 大頭照的上傳與管理，確保圖片儲存於 Firebase Storage，並返回對應的下載 URL。</pre><h4>7–2.確保 UI 變更與業務邏輯同步</h4><ul><li>當進入用戶編輯個人資料時，採用了 <strong>資料驅動 UI（Data-Driven UI）</strong> 的方式，必須在資料準備好的情況下，才進入頁面。<strong>（避免再進入頁面時，先呈現UI佈局，才載入資料，導致視覺上的困擾）</strong></li></ul><p>1.載入個人資料</p><pre>1.EditProfileViewController<br><br>  - 透過 EditUserProfileManager.loadCurrentUserProfile() 取得 用戶當前的個人資訊，並存入 profileEditModel。<br><br>2.EditProfileTableHandler<br><br>  - 依據 profileEditModel 動態更新 UI。</pre><p>2.用戶修改個人資料</p><pre>- 用戶輸入資料時，EditProfileTableHandler 會觸發 updateProfileEditModel(_:)，即時更新 profileEditModel，確保數據一致。</pre><p>3.點擊「儲存」按鈕</p><pre>1.先執行表單驗證，確保必要欄位完整。<br><br>2.若用戶有更新 大頭照，則透過 ProfileImageUploader 先行上傳圖片。<br><br>3.最後，透過 EditUserProfileManager.updateCurrentUserProfile(_:) 更新 Firestore 中的用戶資料。</pre><h4>7–3.表單驗證與 UI 交互的實踐</h4><ul><li>在處理 <strong>表單輸入與驗證</strong> 時，採用了 <strong>即時回饋（Real-Time Feedback）</strong> 的方式，確保用戶能夠清楚了解當前輸入狀態：</li></ul><p>1.ProfileTextFieldCell</p><pre>- 監聽 UITextField 變更，並透過 onTextChanged 回調即時更新 profileEditModel。<br>- validateRequiredFields(for:) 方法確保 fullName 不能為空，若未填寫則顯示錯誤訊息。</pre><p>2.BirthdaySelectionCell</p><pre>- 點擊後展開 BirthdayDatePickerCell，允許用戶選擇生日日期，並透過 onDateChanged 更新 profileEditModel。</pre><p>3.GenderSelectionCell</p><pre>透過 EditProfileSegmentedControl 提供 Male / Female / Other 選項，並即時同步數據。</pre><h4>7–4.Firebase 與本地數據的同步</h4><ul><li>在個人資料的儲存與同步方面，採用了 <strong>Firebase Firestore</strong> 作為後端數據存儲：</li></ul><p>1.讀取個人資料</p><pre>- 透過 Firestore.collection(&quot;users&quot;).document(userID).getDocument() 取得用戶資料，並轉換為 ProfileEditModel。</pre><p>2.更新個人資料</p><pre>- 透過 Firestore.collection(&quot;users&quot;).document(userID).updateData(userData)，將 本地編輯完成的資料 同步至 Firebase。</pre><p>3.處理異常情境</p><pre>- 若 Firebase 資料讀取失敗，則透過 AlertService.showAlert() 提示用戶。</pre><h4>7–5.大頭照上傳與管理的挑戰</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kcFw19IiL0ep-A3_6R7FXA.png" /></figure><ul><li>用戶的 <strong>大頭照管理</strong> 是本次開發的一大挑戰，主要包含以下幾點：</li></ul><p><strong>1.選取與更新圖片</strong></p><pre>1.PhotoPickerManager<br><br>  - 負責從 相機或相簿 選取圖片，並返回 UIImage。<br><br>2.ProfileImageCoordinator<br><br>  - 負責將選取的圖片存入 ProfileImageUploader，確保後續可上傳。</pre><p><strong>2.上傳 Firebase Storage</strong></p><pre>- ProfileImageUploader 透過 Storage.storage().reference().putDataAsync() 上傳圖片，並獲取下載 URL。<br><br>- 當圖片上傳完成後，才會將新的 profileImageURL 存入 Firebase Firestore。</pre><p><strong>3.即時更新 UI</strong></p><pre>- 當用戶選取新圖片後，不立即上傳，而是先更新 ProfileImageViewCell 內的 UIImageView，提升體驗。<br><br>- 只有當用戶點擊「儲存」時，才會實際上傳新圖片，減少 Firebase Storage 負擔。</pre><h3>8.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3c9599c38138" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-20-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E7%B7%A8%E8%BC%AF-%E9%A1%AF%E7%A4%BA%E8%88%87%E6%9B%B4%E6%96%B0-3c9599c38138">OrderCoffeeApp #20：個人資料編輯 — 顯示與更新</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #19：個人資料頁面 — 顯示與管理使用者資訊]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-19-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA%E8%88%87%E7%AE%A1%E7%90%86%E4%BD%BF%E7%94%A8%E8%80%85%E8%B3%87%E8%A8%8A-ff78ed0d061b?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/ff78ed0d061b</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[xcode]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:13:08 GMT</pubDate>
            <atom:updated>2025-03-26T16:14:40.014Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>OrderCoffeeApp #19：個人資料頁面 — 顯示與管理使用者資訊</strong></h3><h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fr4pzgoWZ-dM%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dr4pzgoWZ-dM&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fr4pzgoWZ-dM%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/c51445cc9821a8dd54a0aba140c219de/href">https://medium.com/media/c51445cc9821a8dd54a0aba140c219de/href</a></iframe><h3>目錄</h3><pre>· <a href="#28ad">1.介紹</a><br>  ∘ <a href="#8321">1–1個人資料頁面的核心功能</a><br>  ∘ <a href="#e89c">1–2.架構概覽</a><br>· <a href="#0e5f">2.核心架構</a><br>  ∘ <a href="#889e">2–1.架構模式</a><br>  ∘ <a href="#d8b7">2–2.UI 分層</a><br>  ∘ <a href="#7bea">2–3.個人資料的數據管理</a><br>· <a href="#1d8a">3.個人資料頁面 UI 設計</a><br>  ∘ <a href="#148c">3–1.頁面結構</a><br>  ∘ <a href="#e0de">3–2.個人資料頁面的分區</a><br>  ∘ <a href="#8c6b">3–3.各區塊的 UI</a><br>· <a href="#a201">4.個人資料的業務邏輯</a><br>  ∘ <a href="#9102">4-1.用戶資料加載流程</a><br>  ∘ <a href="#4f00">4-2.表單數據的管理</a><br>  ∘ <a href="#4f4c">4–3.個人資料頁面的行為</a><br>  ∘ <a href="#254f">4–4.處理登出邏輯</a><br>· <a href="#03eb">5.頁面行為與交互</a><br>  ∘ <a href="#c3a3">5–1.用戶點擊 Cell 的處理（UserProfileTableHandler 回應使用者操作）</a><br>  ∘ <a href="#e84c">5–2.導航至其他頁面的邏輯</a><br>  ∘ <a href="#99ad">5–3.社交連結點擊處理</a><br>  ∘ <a href="#0d3c">5–4.登出按鈕的行為</a><br>· <a href="#6301">6.Firebase 讀取個人資料</a><br>  ∘ <a href="#7829">6–1.Firebase Firestore 的用戶數據結構</a><br>  ∘ <a href="#b9c7">6–2.使用 getDocument(as:) 自動解析 UserProfile</a><br>  ∘ <a href="#78bc">6–3.錯誤處理</a><br>· <a href="#9645">7.總結</a><br>  ∘ <a href="#df65">7–1.個人資料頁面的 UI 設計與數據模型</a><br>  ∘ <a href="#7ac6">7–2.確保 UI 變更與業務邏輯同步</a><br>  ∘ <a href="#ee4f">7–3.登出行為與安全性處理</a><br>· <a href="#175e">8.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CwJDAzkADzJIUZef5mr8hA.png" /></figure><h3>1.介紹</h3><h4>1–1個人資料頁面的核心功能</h4><pre>- 個人資料頁面提供使用者管理自身帳戶資訊與個人化選項的功能，包含：<br><br>  1.使用者基本資料顯示<br>  2.帳戶相關操作<br>  3.社群連結<br>  4.登出功能。</pre><p><strong>1.顯示使用者基本資訊</strong></p><pre>- 展示 使用者姓名、Email 及 大頭照<br><br>- 若使用者未設定大頭照，則顯示預設圖示（SF Symbol: person.circle）<br><br>- 透過 Firebase Firestore 取得最新的個人資料</pre><p><strong>2.個人化選項與帳戶管理</strong></p><pre>- 編輯個人資料：<br><br>  - 允許使用者修改姓名、電話、地址、大頭照等資訊<br><br>- 歷史訂單查詢：<br><br>  - 檢視過去訂單紀錄<br><br>- 收藏清單：<br><br>  - 查看已收藏的飲品</pre><p><strong>3.社群連結與品牌互動</strong></p><pre>- 提供官方社交媒體連結（Facebook、Instagram、YouTube、LINE）<br><br>- 點擊後可透過內建 UIApplication.shared.open(url:) 開啟對應的社交平台</pre><p><strong>4.登出功能</strong></p><pre>- 設計 Logout 按鈕<br><br>- 點擊登出後，清除使用者 Firebase Session，返回登入頁面</pre><h4>1–2.架構概覽</h4><ul><li>為了確保 <strong>UI、業務邏輯與資料管理的分離</strong>，個人資料頁面模組化設計為以下幾個部分：</li></ul><p><strong>1.UI 層</strong></p><pre>- UserProfileViewController：<br><br>  - 負責個人資料頁面的控制邏輯與畫面管理<br><br>- UserProfileView：<br><br>  - 封裝 UITableView，統一管理頁面佈局<br><br>- UserProfileTableHandler：<br><br>  - 負責 UITableView 的 DataSource 及 Delegate</pre><p><strong>2.業務層</strong></p><pre>- UserProfileManager：<br><br>  - 負責從 Firebase Firestore 讀取使用者資訊<br><br>- UserProfileDataSource：<br><br>  - 提供 TableView 各區塊的數據來源</pre><p><strong>3.導航管理</strong></p><pre>- UserProfileNavigationBarManager<br><br>  - 處理導航標題</pre><h3>2.<strong>核心架構</strong></h3><h4>2–1.架構模式</h4><ul><li>個人資料頁面採用 <strong>MVC（Model-View-Controller）</strong> 模式來組織程式碼，將數據管理、視圖顯示及互動邏輯明確區分，提升可讀性與可維護性。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5-fbdI4svuMaYMaw4RpX_g.png" /></figure><h4>2–2.UI 分層</h4><ul><li>個人資料頁面主要由以下幾個 UI 組件組成：</li></ul><pre>1.UserProfileViewController：<br><br>  - 主控制器，負責管理畫面顯示與用戶互動。<br><br>2.UserProfileView：<br><br>  - 頁面的主要視圖，內含 UITableView 顯示個人資訊、設定選項及登出按鈕。<br><br>3.UserProfileTableHandler：<br><br>  - 負責 UITableView 的 delegate &amp; dataSource，解耦 ViewController 內的表格邏輯。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Views/UserProfileView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Views/UserProfileView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>2–3.個人資料的數據管理</h4><ul><li>為了確保數據獨立性與清晰的責任分工，個人資料數據管理由以下幾個元件組成：</li></ul><pre>1.UserProfileManager：<br><br>  - 負責與 Firebase Firestore 互動，獲取與更新用戶資料。<br><br>2.UserProfileDataSource：<br><br>  - 管理 UITableView 內的數據，根據 UserProfileSection 提供對應的表格行數據。<br><br>3.UserProfileTableHandler：<br><br>  - 負責 UITableView 的行為管理，如點擊處理與行顯示設定。<br><br>4.UserProfileNavigationBarManager：<br><br>  - 負責導航欄標題與設定，確保 UI 一致性。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/DataSource/UserProfileDataSource.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/DataSource/UserProfileDataSource.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Managers/UserProfileNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Managers/UserProfileNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>3.個人資料頁面 UI 設計</h3><ul><li>個人資料頁面的設計圍繞著 <strong>UserProfileViewController</strong>，負責顯示<strong>使用者的基本資訊（姓名、Email、頭像）</strong>、<strong>常規選項（編輯個人資料、歷史訂單、我的最愛）</strong>、<strong>社交媒體連結</strong>，以及<strong>登出按鈕</strong>。此部分包含 UI 層的視圖結構及 TableView 的 Cell 設計。</li></ul><h4>3–1.頁面結構</h4><ul><li>個人資料頁面採用 <strong>UITableView 為主架構</strong>，以不同的 <strong>分區 (Section) 與</strong><strong>行 (Row)</strong> 來呈現資料。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*86NWHWyH--YhinM9wDpjCg.png" /></figure><p>1.UserProfileViewController</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*51NwfsTcv59QJOByXGoZ9Q.png" /></figure><pre>- 負責管理個人資料頁面，處理 UI 交互與導航。<br><br>- 使用 UserProfileView 作為主視圖，內含 UserProfileTableView。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>UserProfileView（主視圖）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5Tt9OTOOMYWS2felsm42XA.png" /></figure><pre>- 主要承載 UITableView，並統一管理 UI 結構。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Views/UserProfileView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Views/UserProfileView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>UserProfileTableView（表格）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Q5yUEBn78Alq-3XTSuCW4w.png" /></figure><pre>- 採用 insetGrouped 樣式 (UITableView.Style.insetGrouped)，提升視覺層次感。<br><br>- 自訂 UITableViewCell，確保不同類型的資料能有清楚的視覺區隔。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Components/UserProfileTableView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Components/UserProfileTableView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–2.個人資料頁面的分區</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dOgEzUtAcRsAcODl6Qvnyw.png" /></figure><ul><li>程式碼：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n4Neuzn8jDG7LPCvFMZ2cQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3SLdgir7_qoKuMwa8gWNZw.png" /><figcaption>左至右：UserProfileSection / UserProfileRow</figcaption></figure><ul><li>UserProfileSection 定義了 <strong>四個主要區域</strong>，每個分區內包含不同類型的行數據 (UserProfileRow)，方便後續擴展與維護：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ui_asX7wTb46oeU6V5Q4jQ.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Models/UserProfileSection.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Models/UserProfileSection.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Models/UserProfileRow.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Models/UserProfileRow.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–3.各區塊的 UI</h4><ul><li>為了確保 <strong>一致的設計風格</strong>，個人資料頁面的 UITableViewCell 採用 <strong>客製化的 Cell</strong>，每種類型都具備特定功能與樣式：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*56BdNz9A_aBdD2u0vdkzew.png" /></figure><ul><li>UI 設計原則：</li></ul><pre>1.UserProfileInfoCell <br><br>  - 採用 圖片 + 標籤，讓使用者能清楚看到個人資訊。<br><br>2.UserProfileGeneralOptionCell 及 UserProfileSocialLinkCell <br><br>  - 支援點擊操作，可進行頁面跳轉或開啟外部連結。<br><br>3.UserProfileLogoutCell <br><br>  - 設計為 紅色標題居中顯示，強調登出的重要性。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileInfoCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileInfoCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileGeneralOptionCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileGeneralOptionCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileSocialLinkCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileSocialLinkCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileLogoutCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Cells/UserProfileLogoutCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>4.個人資料的業務邏輯</h3><ul><li>個人資料頁面不僅負責顯示使用者資訊，還包含 <strong>數據管理</strong>、<strong>頁面導航</strong> 以及 <strong>登出處理</strong> 等邏輯，確保使用者能夠順利操作各項功能。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xA3925He0_tPlbkfInM0sQ.png" /></figure><h4>4-1.用戶資料加載流程</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/741/1*asQl6rw6uHI_Gcc4KnrkXw.png" /></figure><ul><li><strong>目標</strong>：</li></ul><pre>- 確保 UserProfileViewController 在畫面載入時，能夠從 Firebase Firestore 獲取使用者資料，並同步更新 UITableView。<br><br>- 藉此將該使用者的姓名、Email、大頭照呈現在 UserProfileInfoCell</pre><ul><li><strong>實現方式</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p-KCtMDKxACxufxJWTeiSQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*etFHiYUxrjr3WwsnVCdZzg.png" /><figcaption>左至右：UserProfileViewController / UserProfileManager</figcaption></figure><pre>1.UserProfileViewController 在 viewWillAppear 觸發 loadUserProfile()。<br><br>2.UserProfileManager 使用 Firebase Firestore 的 getDocument(as:) 方法，將用戶數據解析為 UserProfile 結構。<br><br>3.當數據成功加載時，更新 userProfile 變數並通知 UITableView 重新載入 (reloadData())。</pre><ul><li><strong>主要負責類別</strong>：</li></ul><pre>- UserProfileManager（負責資料存取）<br><br>- UserProfileViewController（觸發數據加載並更新 UI）</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4-2.表單數據的管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/615/1*wyEQA78iZRHmOVzorSaXeQ.png" /></figure><ul><li><strong>目標</strong>：</li></ul><pre>- 透過 數據驅動設計，讓 UITableView 能夠靈活顯示不同類型的資料，而不需要直接寫死 UI。</pre><ul><li><strong>實現方式</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xQa_6OYLtdIG2Ktf1iWzNw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wJIkLgpaFUPvUUnOPbBylQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*of2MNJgex_c3Btf0l14_ZQ.png" /><figcaption>左至右：UserProfileRow / UserProfileSection / UserProfileDataSource</figcaption></figure><pre>1.UserProfileRow：<br><br>  - 定義 每一行 的數據結構（包含標題、圖標、跳轉行為）。<br><br>2.UserProfileSection：<br><br>  - 定義 分區 (Section) 的數據類型（如「使用者資訊區」、「一般選項區」等）。<br><br>3.UserProfileDataSource：<br><br>  - 負責提供 UITableView 的數據來源，確保不同的 Section 有對應的 Row。</pre><ul><li><strong>主要負責類別</strong>：</li></ul><pre>- UserProfileRow（單行數據模型）<br><br>- UserProfileSection（分區結構）<br><br>- UserProfileDataSource（數據來源）</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Models/UserProfileRow.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Models/UserProfileRow.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Models/UserProfileSection.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Models/UserProfileSection.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/DataSource/UserProfileDataSource.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/DataSource/UserProfileDataSource.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–3.個人資料頁面的行為</h4><ul><li>cell點擊行為</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ixkxzAAFbqin8wFTTs9ctg.png" /></figure><ul><li>點擊「一般選項（編輯個人資料、歷史訂單）」行為</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XG9SfMep8edN8864ekfLTw.png" /></figure><ul><li>點擊「社交媒體連結」行為</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lqUVbqYc9AwMXj8yzAZjaw.png" /></figure><ul><li>目標：</li></ul><pre>- 讓 UserProfileViewController 內的 UITableView 能夠支援點擊事件，並透過 NavigationController 進行頁面跳轉。</pre><ul><li><strong>實現方式</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pMkxPHzJmaaJgDLKfLHU8g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VGN86wzuVjpb32sFDIoEzw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4u--lYAs0ZxafFTlK1JWIw.png" /><figcaption>左至右：UserProfileViewController / UserProfileTableHandlerDelegate / UserProfileTableHandler</figcaption></figure><pre>1.點擊「編輯個人資料」<br><br>  - 導航至 EditProfileViewController<br><br>2.點擊「歷史訂單」<br><br>  - 導航至 OrderHistoryViewController<br><br>3.點擊「我的最愛」<br><br>  - 導航至 FavoritesViewController<br><br>4.點擊「社交媒體連結」<br><br>  - 彈出確認視窗，確認後開啟對應網址。</pre><ul><li><strong>主要負責類別</strong>：</li></ul><pre>- UserProfileTableHandler（處理 UITableView 的點擊事件）<br><br>- UserProfileTableHandlerDelegate（定義頁面跳轉邏輯）<br><br>- UserProfileViewController（負責實際的導航）</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Delegates/UserProfileTableHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Delegates/UserProfileTableHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–4.處理登出邏輯</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PueNePhsHrrsHC0SsbgZuQ.png" /></figure><ul><li><strong>目標</strong>：</li></ul><pre>- 確保使用者點擊「登出」時，會彈出確認視窗，避免誤觸。</pre><ul><li><strong>實現方式</strong>：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*z0UwJ3DabUYMrd-Ej4e7Ag.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*alrerkEP3ntXcrZsp7r3pQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xIeR-UDX2nXGQ4XgqfWR4Q.png" /><figcaption>左至右：UserProfileViewController / UserProfileTableHandlerDelegate / UserProfileTableHandler</figcaption></figure><pre>- confirmLogout()：<br><br>  - 顯示登出確認視窗<br><br>- executeLogout()：<br><br>  - 若使用者確認登出，則調用 Firebase Auth.signOut()，並導回登入頁面<br>  - 並且清空OrderItemManager，重置CustomerDetailsManager。</pre><ul><li><strong>主要負責類別</strong>：</li></ul><pre>- UserProfileTableHandler（處理點擊登出按鈕）<br><br>- UserProfileTableHandlerDelegate（觸發登出邏輯）<br><br>- UserProfileViewController（執行登出並導航）</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Handlers/UserProfileTableHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Delegates/UserProfileTableHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Delegates/UserProfileTableHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/ViewControllers/UserProfileViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>5.頁面行為與交互</h3><ul><li>個人資料頁面 (UserProfileViewController) 的行為設計主要圍繞 <strong>使用者互動</strong>，包括 <strong>點擊列表項目</strong>、<strong>導覽到其他頁面</strong>、<strong>處理社交媒體連結點擊</strong> 及 <strong>登出流程</strong>。</li><li>這部分主要由 <strong>UserProfileTableHandler</strong> 負責管理 UITableView 的行為，確保頁面邏輯清晰且易於擴展。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6SGpkLtCeGA8bHL3w-6wMQ.png" /></figure><h4>5–1.用戶點擊 Cell 的處理（UserProfileTableHandler 回應使用者操作）</h4><p>1.UITableView 內的 cellForRowAt 透過 UserProfileDataSource 提供對應的資料。</p><p>2.didSelectRowAt 負責處理點擊事件，並透過 delegate 回傳控制器：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iMR6Q5R2X3mC7G8JE9e2wQ.png" /></figure><pre>1.個人資訊 (userInfo) → 目前無額外點擊行為（僅顯示個人資訊）。<br><br>2.一般選項 (generalOptions) → 點擊後透過 delegate 呼叫對應的導航函式：<br><br>  - 編輯個人資料 → navigateToEditProfile()<br>  - 歷史訂單 → navigateToOrderHistory()<br>  - 我的最愛 → navigateToFavorites()<br><br>4.社交連結 (socialLinks) → 顯示彈窗確認是否前往社群網站（Facebook、Instagram、YouTube、Line）。<br><br>5.登出 (logout) → 顯示 AlertService 來確認是否登出。</pre><h4>5–2.導航至其他頁面的邏輯</h4><ul><li>當使用者點擊「一般選項 (General Options)」的 Cell 時，UserProfileTableHandler 會透過 delegate 來通知 UserProfileViewController 進行導覽：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*b8WcLU4gul1Uez4k-Bim9g.png" /></figure><pre>- 編輯個人資料 (Edit Profile) → navigateToEditProfile()<br><br>- 歷史訂單 (Order History) → navigateToOrderHistory()<br><br>- 我的最愛 (Favorites) → navigateToFavorites()</pre><h4>5–3.社交連結點擊處理</h4><ul><li>當使用者點擊 socialLinks 的 Cell（如 Facebook、Instagram），系統會顯示 <strong>確認彈窗</strong> (AlertService)：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tf8QW2wkDlfDgo9wfQPpAg.png" /></figure><pre>1.顯示確認彈窗<br><br>2.若使用者選擇「前往」，則使用 UIApplication.shared.open(url) 開啟網頁。</pre><h4>5–4.登出按鈕的行為</h4><ul><li>UserProfileLogoutCell 的樣式</li></ul><pre>- Logout 這一列採用 紅色文字 標示，並 置中顯示 來提高可視性。<br><br>- 點擊時，會顯示 AlertService 來 確認登出。</pre><ul><li>AlertService 確認登出</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*y6H28uVGGMAqLj6Dm3UbaQ.png" /></figure><pre>1.彈出 AlertController，詢問「是否確定登出？」<br><br>2.若使用者確認：<br><br>  - 執行 Firebase.auth().signOut()<br>  - 清除 OrderItemManager.shared.clearOrder()<br>  - 導回首頁 (NavigationHelper.navigateToHomePageNavigation())</pre><h3>6.Firebase 讀取個人資料</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/720/1*GYaC38QpLyqMpAWobRFOHQ.png" /></figure><h4>6–1.Firebase Firestore 的用戶數據結構</h4><ul><li>在 Firestore 中，每個用戶的個人資料存儲在 users 集合下的一份 Document，以 uid 作為文件 ID，內部包含:</li></ul><pre>- uid: 用戶唯一識別碼<br><br>- fullName: 用戶全名<br><br>- email: 用戶電子郵件<br><br>- profileImageURL: (選填) 用戶大頭貼的 URL<br><br>- loginProvider: 用戶登入方式（如 email、Google、Apple）<br><br>- phoneNumber: (選填) 用戶電話號碼<br><br>- birthday: (選填) 用戶生日（Timestamp）<br><br>- address: (選填) 用戶地址<br><br>- gender: (選填) 用戶性別</pre><ul><li>JSON</li></ul><pre>{<br>  &quot;uid&quot;: &quot;Ad5hJSmaYSdSNCSPqSAiW3z186G3&quot;,<br>  &quot;fullName&quot;: &quot;史努比&quot;,<br>  &quot;email&quot;: &quot;a1202@gmail.com&quot;,<br>  &quot;profileImageURL&quot;: &quot;https://firebasestorage.googleapis.com/...&quot;,<br>  &quot;loginProvider&quot;: &quot;email&quot;,<br>  &quot;phoneNumber&quot;: &quot;0912345678&quot;,<br>  &quot;birthday&quot;: &quot;1950-10-03T16:00:00Z&quot;,<br>  &quot;address&quot;: &quot;台北市中正區重慶南路一段122號&quot;,<br>  &quot;gender&quot;: &quot;Male&quot;<br>}</pre><ul><li>UserProfile Model</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_xn1lnIog3f8SwE7GPWQjg.png" /></figure><pre>- 只提取讓UserProfileInfoCell會呈現的姓名、信箱、大頭照</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Models/UserProfile.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Models/UserProfile.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>6–2.使用 getDocument(as:) 自動解析 UserProfile</h4><ul><li>Firebase Firestore 提供了 getDocument(as:) 方法，直接將 Document 解析為 Codable 結構體，省去手動解析 JSON 的麻煩。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wFN5yhQlsDtDljYIB59mTg.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/UserProfile/Services/UserProfileManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>6–3.錯誤處理</h4><ul><li>在讀取個人資料時，可能會遇到以下錯誤情境：</li></ul><pre>️1.用戶未登入 (UserProfileError.userNotLoggedIn)<br><br>  - 當 Auth.auth().currentUser 為 nil，表示當前沒有已登入的用戶，此時應該拋出錯誤並提醒用戶重新登入。<br><br>️2.Firestore 讀取失敗<br><br>  - Firestore 請求可能會因為網路不穩定、權限不足或其他原因導致失敗，這時應該適當地處理錯誤，顯示提示訊息。</pre><ul><li>在 UserProfileViewController 顯示錯誤</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*X1VQJYZkBO2A_QQO9gBxfw.png" /></figure><pre>- 在 UserProfileViewController 內，透過 loadUserProfile() 來讀取用戶資料，並在 UI 上顯示錯誤訊息。</pre><h3>7.總結</h3><h4>7–1.個人資料頁面的 UI 設計與數據模型</h4><pre>1.採用 UITableView 來呈現個人資料資訊，使畫面具有彈性與可擴展性。<br><br>2.透過 UserProfileViewController 負責顯示與管理個人資料，並與 UserProfileTableHandler 分離職責。<br><br>3.UserProfileSection 枚舉類型，定義不同的資料分區（使用者資訊、一般選項、社交媒體連結、登出按鈕）。<br><br>4.UserProfileRow 負責描述每個 Cell 的數據結構，讓 TableView 的數據來源更加結構化。</pre><h4>7–2.確保 UI 變更與業務邏輯同步</h4><ul><li><strong>Firebase Firestore 整合</strong>：</li></ul><pre>- 透過 UserProfileManager 以 getDocument(as:) 方式讀取使用者個人資料。<br><br>- UserProfileViewController 在 viewWillAppear 內自動載入最新的個人資料。<br><br>- userProfileView.userProfileTableView.reloadData() 確保畫面隨數據更新。</pre><ul><li><strong>資料存取錯誤處理</strong>：</li></ul><pre>- 若 Firestore 載入失敗，則顯示錯誤警示 (AlertService.showAlert(...))。<br><br>- 針對未登入狀況 (UserProfileError.userNotLoggedIn)</pre><h4>7–3.登出行為與安全性處理</h4><pre>1.透過 confirmLogout() 彈出 登出確認視窗，避免使用者誤觸登出。<br><br>2.FirebaseController.shared.signOut() 進行登出，並確保 清除使用者相關暫存數據：<br><br>  - 清除 OrderItemManager.shared.clearOrder() 內存中的訂單項目。<br>  - 清除 CustomerDetailsManager.shared.resetCustomerDetails() 以防止資料殘留。<br><br>3.NavigationHelper.navigateToHomePageNavigation() 確保登出後回到首頁，防止未授權存取個人資料。</pre><h3><strong>8.GitHub</strong></h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ff78ed0d061b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-19-%E5%80%8B%E4%BA%BA%E8%B3%87%E6%96%99%E9%A0%81%E9%9D%A2-%E9%A1%AF%E7%A4%BA%E8%88%87%E7%AE%A1%E7%90%86%E4%BD%BF%E7%94%A8%E8%80%85%E8%B3%87%E8%A8%8A-ff78ed0d061b">OrderCoffeeApp #19：個人資料頁面 — 顯示與管理使用者資訊</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #18：店鋪詳情頁面（StoreInfoViewController）]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-18-%E5%BA%97%E9%8B%AA%E8%A9%B3%E6%83%85%E9%A0%81%E9%9D%A2-storeinfoviewcontroller-547358dd70a6?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/547358dd70a6</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[xcode]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:12:10 GMT</pubDate>
            <atom:updated>2025-03-30T00:53:20.723Z</atom:updated>
            <content:encoded><![CDATA[<h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FcNXQohSBMiY%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DcNXQohSBMiY&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FcNXQohSBMiY%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/cc3dae4ab156e2caf5acfefb6344175f/href">https://medium.com/media/cc3dae4ab156e2caf5acfefb6344175f/href</a></iframe><h3>目錄</h3><pre>· <a href="#d6a6">1.介紹</a><br>  ∘ <a href="#ca79">1–1.店鋪詳情頁面的核心功能</a><br>  ∘ <a href="#5602">1–2.主要技術點：UI 顯示、狀態管理、用戶操作</a><br>· <a href="#f062">2.UI 層（View 層設計）</a><br>  ∘ <a href="#cbb0">2–1.StoreInfoViewController 的 UI 架構</a><br>· <a href="#9e04">3.業務層（Business Logic 層設計）</a><br>  ∘ <a href="#8647">3–1.數據處理與格式化</a><br>  ∘ <a href="#bae5">3–2.用戶交互</a><br>· <a href="#5f23">4.StoreInfoViewController 與其他模組的交互</a><br>  ∘ <a href="#fb46">4-1.與 StoreSelectionViewController 溝通</a><br>  ∘ <a href="#9345">4–2.與 OrderCustomerDetailsViewController 溝通</a><br>· <a href="#8389">5.總結</a><br>  ∘ <a href="#55cb">5–1.UI 層與業務層的分工：讓 StoreInfoViewController 保持簡單且可擴展</a><br>  ∘ <a href="#41b6">5-2.確保門市資訊與用戶操作的同步</a><br>  ∘ <a href="#696e">5–3.實踐升使用者體驗</a><br>· <a href="#33e2">6.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2-_XfcFjrxeZgyQrchMVTg.png" /></figure><h3>1.介紹</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LwkmUQ5ojdxOE81KTQLw7g.png" /></figure><h4>1–1.店鋪詳情頁面的核心功能</h4><ul><li>StoreInfoViewController 負責顯示 <strong>使用者選擇的店鋪詳細資訊</strong>，核心功能包括：</li><li><strong>顯示門市資訊</strong></li></ul><pre>- 包含門市名稱、地址、距離、電話號碼、今日營業時間等基本資訊。</pre><ul><li><strong>支持用戶操作</strong></li></ul><pre>- 使用者可以 撥打電話 至該門市或 選擇該門市作為取件地點。</pre><ul><li><strong>浮動面板（FloatingPanel）整合</strong></li></ul><pre>- StoreInfoViewController 主要作為 FloatingPanelController 的內容視圖，能夠在 StoreSelectionViewController 點選店鋪後彈出。</pre><ul><li><strong>動態更新 UI</strong></li></ul><pre>- StoreInfoViewController 透過 StoreInfoViewModel，將 Store 模型轉換為適合 UI 顯示的格式，並動態更新視圖內容。</pre><h4>1–2.主要技術點：UI 顯示、狀態管理、用戶操作</h4><ul><li>StoreInfoViewController 在實作上涉及幾個關鍵技術點：</li></ul><p><strong>1.UI 顯示</strong></p><pre>- StoreInfoView：<br><br>  - 統一管理店鋪資訊的顯示，包含：<br><br>    - 預設狀態（當使用者尚未選擇店鋪時）<br>    - 詳細資訊狀態（當使用者選擇店鋪後，顯示完整資訊）<br><br>- SelectStoreInfoView：<br><br>  - 當店鋪被選擇時，顯示詳細資訊，如地址、距離、營業時間等。</pre><p><strong>2.狀態管理</strong></p><pre>- StoreInfoState 枚舉類型：<br><br>  - .initial(message: String) → 顯示「請選擇門市」等提示訊息<br>  - .details(viewModel: StoreInfoViewModel) → 顯示選定門市的詳細資訊<br><br>- setState(_:) 方法：<br><br>  - 根據狀態變更 UI 顯示，切換 預設視圖 或 店鋪資訊視圖。</pre><p><strong>3.用戶操作</strong></p><pre>1.撥打電話<br><br>  - 點擊 Call Phone 按鈕後，顯示警告視窗，確認後撥打店鋪電話。<br><br>2.選擇店鋪<br><br>  - 點擊 Select Store 按鈕後，顯示確認視窗，確定後將選擇結果傳回 StoreSelectionViewController。</pre><h3>2.UI 層（View 層設計）</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/848/1*hyzzqaRNsZBrWlYfKGVHjQ.png" /></figure><h4>2–1.StoreInfoViewController 的 UI 架構</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fkiZ9eZHB9yKNIKkzxxLPQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NEGfDjRO20G6FCHD7ZnFtw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fj3s2o-UVPS2c0bxSxLIag.png" /><figcaption>左至右：StoreDefaultInfoView / SelectStoreInfoView / StoreInfoView</figcaption></figure><p><strong>1.</strong><strong>StoreInfoView 的角色與結構</strong></p><ul><li>StoreInfoView 是 StoreInfoViewController 的主要 UI 視圖，負責管理店鋪資訊的顯示，包含以下兩種狀態：</li></ul><pre>1.StoreDefaultInfoView（預設狀態）：<br><br>  - 當使用者尚未選擇門市時顯示，提示用戶點選門市。<br><br>2.SelectStoreInfoView（詳細資訊狀態）：<br><br>  - 當使用者選擇店鋪後，顯示該門市的詳細資訊，例如名稱、地址、電話、營業時間等。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*FxeaQpJaYpuY0-CaAAr70w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*moHuwNFiqGdpfsPpYyp3XQ.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.管理不同狀態的 UI 顯示</strong></p><ul><li>StoreInfoViewController 使用 StoreInfoState 枚舉來管理 UI 狀態的切換：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0T3gJsoUS313Yk19qJculg.png" /></figure><pre>- initial(message:)<br><br>   → 顯示 StoreDefaultInfoView，並隱藏 SelectStoreInfoView。<br><br>- details(viewModel:)<br><br>   → 顯示 SelectStoreInfoView，並填充門市資訊。</pre><p><strong>3.UI 操作與行為設計</strong></p><ul><li>在 SelectStoreInfoView 中，提供兩個主要的用戶交互按鈕：</li></ul><pre>- 撥打電話（Call Phone）<br><br>- 選擇門市（Select Store）</pre><ul><li>這些按鈕的行為被 StoreInfoViewController 設定為回調，確保視圖層與業務邏輯層解耦。確保 SelectStoreInfoView 只負責 UI 顯示，而行為邏輯由 StoreInfoViewController 處理。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-BKmbjAg2cn9J75rqopYPA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uoyVCi-hzfPWzXJmdlAqvw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sKSx8zjWEkfrrV0bYJE2nA.png" /><figcaption>左至右：<strong>SelectStoreInfoView</strong> / <strong>StoreInfoView</strong> / <strong>StoreInfoViewController</strong></figcaption></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/View%20Controllers/StoreInfoViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/View Controllers/StoreInfoViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>3.業務層（Business Logic 層設計）</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EHQl0CicPANH9JjaLQANYQ.png" /></figure><h4>3–1.數據處理與格式化</h4><p><strong>1.</strong><strong>StoreInfoViewModel 負責什麼？</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VH70O5LPntklA3p7y04Qvw.png" /></figure><ul><li>StoreInfoViewModel 負責將 <strong>Store 模型的原始數據格式化</strong>，並提供適合 UI 顯示的資訊，例如：</li></ul><pre>1.門市基本資訊的格式化<br><br>  - 提供 店名、地址、電話號碼、營業時間 等資料，讓視圖能夠直接使用。<br>  - 例如，將 Store 中的原始 phoneNumber 轉換為 台灣常見電話格式（02-1234-5678）。<br><br>2.計算與顯示店鋪距離<br><br>  - 使用 CoreLocation 計算 使用者與門市的距離。<br>  - 轉換距離單位為 公里（km）並保留兩位小數，如 2.35 km。<br><br>3.處理今日營業時間<br><br>  - 根據 Store 內的 openingHours 取出當前日期的營業時間。<br>  - 例如：星期一: 07:00–21:30。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Models/StoreInfoViewModel.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Models/StoreInfoViewModel.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.計算門市距離、營業時間、電話號碼格式化</strong></p><ul><li><strong>計算距離</strong>（使用 CoreLocation）</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/674/1*JG3pMrtn1pQDv1F-DmHwVw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/674/1*gv6IJksYbKQF-zihDjLC1g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/674/1*qp6MDbxXAPATQxXRyf7zNw.png" /></figure><pre>- 根據當前定位與所選取的門市之間的距離。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ts3eOKZXkTKVwS-y2xz_Ug.png" /></figure><ul><li><strong>取得今日營業時間</strong>（根據 DateUtility 獲取今日星期）</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/712/1*W_FNtUfsBnocPEljqD72jw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/712/1*Eizyjbb3rAkxvDXbYljpwg.png" /></figure><pre>- 只顯示當天日期，以及當日的營業時間。<br><br>- 而不是一次呈現出該門市的所有營業時間。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ls0uvbuvM9H0MPQ6_q-KyQ.png" /></figure><ul><li><strong>格式化電話號碼</strong>（使用 PhoneNumberFormatter）</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*hRLcw94NpCDx8uc2ClNcMg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*m7FRIMAiy54OikuKRm0q3g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*r_SDa_Zc6OBI1p68FnetAw.png" /></figure><pre>- 在 Firestore 中存取的電話是純數字，並沒有 [-] ，因爲在撥打電話時，只能純數字。<br><br>- 考量到台灣各地的區碼的不同呈現，為了在頁面呈現電話號碼的可讀性。<br><br>- 因此設置了 PhoneNumberFormatter，來處理。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lJ5-V9BgJJlahDE1F0tf0w.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Services/Tool/PhoneNumberFormatter.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Services/Tool/PhoneNumberFormatter.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/Services/Tool/DateUtility.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/Services/Tool/DateUtility.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–2.用戶交互</h4><p><strong>1.撥打電話按鈕</strong></p><ul><li>使用 UIApplication.shared.open(phoneURL, options: [:]) 來處理 <strong>用戶點擊撥打電話</strong> 的行為。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pakIRiXwqyuTulX0ILTsJw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AJNYpyFckeu71AR9JhDOaw.png" /><figcaption>左至右：StoreInfoViewController / StoreInfoView、SelectStoreInfoView</figcaption></figure><pre>1.StoreInfoViewController 透過 setState(_:) 設定 callPhoneAction。<br><br>2.SelectStoreInfoView 內的按鈕註冊 onCallPhoneTapped。<br><br>3.當用戶點擊按鈕時，執行 handleCallPhone(for viewModel:)。<br><br>4.使用 UIApplication.shared.open(phoneURL) 撥打電話。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d83oi8AXUZKFPw_GN54HQA.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/View%20Controllers/StoreInfoViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/View Controllers/StoreInfoViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/StoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.選擇門市按鈕</strong></p><ul><li>當用戶點擊「選擇門市」按鈕時，需要通知 <strong>StoreSelectionResultDelegate</strong>，並關閉 StoreInfoViewController、StoreSelectionViewController。並且關閉。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Lc16P2iLez2-4XGysKGs1A.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VmBzLDbBx3bEe6LVVgroKQ.png" /><figcaption>左至右：StoreSelectionResultDelegate / StoreInfoViewController、StoreSelectionViewController、OrderCustomerDetailsViewController</figcaption></figure><pre>1.StoreInfoViewController 透過 setState(_:) 設定 selectStoreAction。<br><br>2.SelectStoreInfoView 內的按鈕註冊 onSelectStoreTapped。<br><br>3.當用戶點擊按鈕時，執行 handleSelectStore(for viewModel:)。<br><br>4.storeSelectionResultDelegate?.storeSelectionDidComplete(with: viewModel.name) 傳遞門市資訊。<br><br>5.關閉當前視圖，返回並且關閉 StoreSelectionViewController。<br><br>6.透過 storeSelectionResultDelegate，將選擇的門市資訊傳遞至 OrderCustomerDetailsViewController，更新 UI 顯示已選擇的門市。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PiQ51SegRxENeTX-HQfNUg.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/View%20Controllers/StoreInfoViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/View Controllers/StoreInfoViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Views/SelectStoreInfoView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>4.StoreInfoViewController 與其他模組的交互</h3><h4>4-1.與 StoreSelectionViewController 溝通</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OAE91DlQTv9uh-PsZHmcWw.png" /></figure><p><strong>1.</strong><strong>FloatingPanelController 更新 </strong><strong>StoreInfoViewController</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*daBA-ekbbGUp8S3sV_LISw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DAIjV1SwbcbIc7paj8Z7bQ.png" /><figcaption>左至右： <strong>初始化 </strong><strong>FloatingPanelController</strong> / <strong>StoreSelectionViewController</strong>、<strong>StoreSelectionMapHandler</strong>、<strong>StoreInfoViewController</strong></figcaption></figure><ul><li>StoreSelectionViewController 透過 FloatingPanelHelper 初始化 FloatingPanelController，並將 StoreInfoViewController 設為內容控制器。</li></ul><pre>- 當 StoreSelectionMapHandler 偵測到使用者點選了店鋪標記（annotation），會調用 didSelectStore(_ store:) 方法：<br><br>    1.取得 StoreInfoViewController<br>    2.生成 StoreInfoViewModel<br>    3.調用 setState(.details(viewModel: viewModel))，讓 UI 顯示該店鋪資訊<br>    4.FloatingPanelController 展開 顯示店鋪資訊</pre><p><strong>2.</strong><strong>didSelectStore() 影響 </strong><strong>StoreInfoViewController</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PuYPqtbs1SVA2c10GX9Izw.png" /></figure><ul><li>StoreSelectionViewController 實作 StoreSelectionMapHandlerDelegate，當使用者選擇地圖上的門市時：</li></ul><pre>1.透過 LocationManagerHandler 獲取當前使用者位置<br><br>2.建立 StoreInfoViewModel<br><br>3.設定 StoreInfoViewController 的 storeSelectionResultDelegate = self<br><br>4.setState(.details(viewModel))<br><br>5.FloatingPanelController 展開至 .half 狀態</pre><p><strong>3.GitHub</strong></p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/View%20Controllers/StoreInfoViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/View Controllers/StoreInfoViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–2.與 OrderCustomerDetailsViewController 溝通</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OATTbrV12kGxbHnK5BkdZw.png" /></figure><p><strong>1.</strong><strong>StoreSelectionResultDelegate 回傳選擇的店鋪</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yTCBgkZMaWK20Uz2Cjl_hA.png" /></figure><ul><li>StoreInfoViewController 內部設置 storeSelectionResultDelegate</li><li>當使用者點擊「選擇門市」按鈕時：</li></ul><pre>- 呼叫 storeSelectionResultDelegate?.storeSelectionDidComplete(with: storeName)<br><br>- OrderCustomerDetailsViewController 接收 storeName，並更新 CustomerDetailsManager<br><br>- 重新載入 取件方式的 UI</pre><p>2.OrderCustomerDetailsViewController 接收門市資訊並更新 UI</p><ul><li>OrderCustomerDetailsViewController 實作 StoreSelectionResultDelegate</li><li>當 storeSelectionDidComplete(with storeName:) 被呼叫時：</li></ul><pre>- 更新 CustomerDetailsManager.shared.updateStoredCustomerDetails(storeName: storeName)<br><br>- 重新載入取件方式 reloadSections(IndexSet(integer: pickupSectionIndex))<br><br>- 確保 提交訂單按鈕的狀態同步更新</pre><p>3.GitHub</p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderCustomerDetails/View%20Controllers/OrderCustomerDetailsViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderCustomerDetails/View Controllers/OrderCustomerDetailsViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderCustomerDetails/Managers/OrderCustomerDetailsNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderCustomerDetails/Managers/OrderCustomerDetailsNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>5.總結</h3><h4>5–1.UI 層與業務層的分工：讓 StoreInfoViewController 保持簡單且可擴展</h4><ul><li>在 StoreInfoViewController 中，將 UI 層與業務邏輯進行了明確的拆分，以保持簡潔與可擴展性：</li></ul><blockquote><strong><em>業務層</em></strong></blockquote><pre>1.StoreInfoViewModel <br><br>  - 處理店鋪數據的格式化，確保 StoreInfoViewController 只關心視圖顯示。<br><br>2.StoreSelectionResultDelegate <br><br>  - 確保店鋪選擇結果可以傳回 OrderCustomerDetailsViewController，達成視圖與業務層的解耦。</pre><blockquote><em>UI 層</em></blockquote><pre>1.StoreInfoView <br><br>  - 負責顯示 UI，包含 StoreDefaultInfoView（預設提示）與 SelectStoreInfoView（門市資訊）。<br><br><br>2.StoreInfoViewController<br><br>  - 只負責狀態管理，透過 setState(_:) 來更新 UI，而非直接操作視圖內部元件。</pre><h4>5-2.確保門市資訊與用戶操作的同步</h4><ul><li>為了確保門市資訊的同步，採用了 <strong>事件驅動</strong> 的方式來處理店鋪選擇流程。</li><li>確保了 <strong>門市選擇的狀態變更可以即時同步到業務邏輯</strong>，而 StoreInfoViewController 本身並不需要關心具體的數據流管理，只負責 UI 顯示。</li></ul><blockquote><em>門市選擇觸發 UI 更新</em></blockquote><pre>1.使用 StoreSelectionMapHandlerDelegate，當用戶點選地圖上的店鋪時<br><br>  - 透過 didSelectStore(_:) 通知 StoreSelectionViewController，並更新 FloatingPanelController 的內容。<br><br>2.StoreInfoViewController <br><br>  - 透過 setState(.details(viewModel: StoreInfoViewModel)) 來顯示詳細資訊。</pre><blockquote><em>門市確認後回傳結果</em></blockquote><pre>1.當用戶在 StoreInfoViewController 點擊「選擇門市」按鈕時<br><br>  - 會調用 storeSelectionDidComplete(with:)，並透過 StoreSelectionResultDelegate 回傳結果給 OrderCustomerDetailsViewController。<br><br>2.OrderCustomerDetailsViewController <br><br>  - 會更新 CustomerDetailsManager，並重新載入「取件方式」區域，確保 UI 變更與業務邏輯同步。</pre><h4>5–3.實踐升使用者體驗</h4><ul><li>在 StoreInfoViewController 的設計上，遵循了幾項最佳實踐來提升使用者體驗</li></ul><blockquote><em>即時反饋與清晰狀態顯示</em></blockquote><pre>1.初始狀態：<br><br>  - 當未選擇店鋪時，顯示「請選擇門市」，提供明確指引。<br><br>2.選擇後狀態：<br><br>  - 店鋪名稱、地址、距離、電話號碼、營業時間清晰呈現。</pre><blockquote><em>動作可預測，避免誤操作</em></blockquote><pre>1.「撥打電話」與「選擇門市」按鈕使用明確的 Alert 提示，確保使用者清楚操作結果。<br><br>2.FloatingPanelController 提供 .half 狀態，可快速檢視資訊，同時允許用戶返回地圖。</pre><h3>6.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=547358dd70a6" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-18-%E5%BA%97%E9%8B%AA%E8%A9%B3%E6%83%85%E9%A0%81%E9%9D%A2-storeinfoviewcontroller-547358dd70a6">OrderCoffeeApp #18：店鋪詳情頁面（StoreInfoViewController）</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #17：店鋪選擇頁面（StoreSelectionViewController）]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-17-%E5%BA%97%E9%8B%AA%E9%81%B8%E6%93%87%E9%A0%81%E9%9D%A2-storeselectionviewcontroller-cf5807f20ca7?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/cf5807f20ca7</guid>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[xcode]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:11:13 GMT</pubDate>
            <atom:updated>2025-03-26T16:15:03.783Z</atom:updated>
            <content:encoded><![CDATA[<h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FKR0gaEWj8oo%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DKR0gaEWj8oo&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FKR0gaEWj8oo%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/9c156c3caee5335f8b161a947fef157e/href">https://medium.com/media/9c156c3caee5335f8b161a947fef157e/href</a></iframe><h3>目錄</h3><pre>· <a href="#beb9">1.介紹</a><br>  ∘ <a href="#4b92">1–1.店鋪選擇頁面的核心功能</a><br>  ∘ <a href="#93ec">1–2.架構概覽</a><br>  ∘ <a href="#bd30">1–3.結構</a><br>  ∘ <a href="#d96e">1–4.訂單流程整合</a><br>· <a href="#0a8d">2.UI 層（View 層設計）</a><br>  ∘ <a href="#27ad">2–1.StoreSelectionViewController 的 UI 架構</a><br>  ∘ <a href="#396a">2–2.地圖視圖與交互（StoreSelectionMapView &amp; StoreSelectionMapHandler）</a><br>  ∘ <a href="#54c2">2–3.導航欄管理（StoreSelectionNavigationBarManager）</a><br>  ∘ <a href="#11f9">2–4.浮動面板管理（FloatingPanelHelper）</a><br>· <a href="#b18e">3.業務層（Business Logic 層設計）</a><br>  ∘ <a href="#1380">3–1.店鋪數據管理</a><br>  ∘ <a href="#8005">3–2.Firestore 中 GeoPoint 的特性與使用目的</a><br>  ∘ <a href="#de0b">3–3.店鋪地圖交互</a><br>  ∘ <a href="#884b">3–4.用戶定位</a><br>  ∘ <a href="#a53a">3–5.回傳距離計算</a><br>· <a href="#c9f8">4.StoreSelectionViewController 與其他模組的交互</a><br>  ∘ <a href="#2d99">4–1.與 StoreInfoViewController 溝通</a><br>  ∘ <a href="#5c3b">4–2.與主畫面（OrderCustomerDetailsViewController）溝通</a><br>· <a href="#19f2">5.總結</a><br>  ∘ <a href="#5f71">5-1.UI 層與業務層的分工：讓 StoreSelectionViewController 維持清晰的架構</a><br>  ∘ <a href="#f8a1">5–2.確保地圖交互、店鋪資料、浮動面板的狀態同步</a><br>  ∘ <a href="#132d">5–3.讓 StoreSelectionViewController 具備可擴展性</a><br>· <a href="#8056">6.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ygQ86fIrqP-LrnyLUeWtmQ.png" /></figure><h3>1.介紹</h3><ul><li>在咖啡訂購流程中，顧客需要選擇取件門市，以確保訂單能正確送達。<strong>店鋪選擇頁面（StoreSelectionViewController）</strong> 主要負責：</li></ul><pre>1.顯示所有可選店鋪（地圖標註）<br><br>2.提供使用者定位功能（顯示距離最近的門市）<br><br>3.支援門市詳細資訊查詢（透過浮動面板展示）</pre><h4>1–1.店鋪選擇頁面的核心功能</h4><p>1.店鋪選擇與地圖展示</p><pre>- 使用 MKMapView 顯示所有店鋪位置<br><br>- 點選標註後，顯示店鋪詳細資訊<br><br>- 設計 StoreSelectionMapHandler 來處理地圖交互邏輯</pre><p>2.用戶定位與距離計算</p><pre>- LocationManagerHandler 負責獲取用戶目前位置<br><br>- 計算並顯示用戶與店鋪之間的距離</pre><p>3.浮動面板（Floating Panel）</p><pre>- FloatingPanelHelper<br><br>  - 用於管理 FloatingPanelController<br><br>- StoreInfoViewController<br><br>  - 用於顯示門市資訊（店名、地址、營業時間）</pre><p>4.選擇門市並返回</p><pre>- 用戶選擇門市後，透過 StoreSelectionResultDelegate 回傳門市資訊給 訂單顧客資料頁面（OrderCustomerDetailsViewController）<br><br>- 更新訂單顯示的 取件門市資訊</pre><h4>1–2.架構概覽</h4><ul><li>此模組採用 <strong>「UI 層」</strong> 與 <strong>「業務層」</strong> 分層設計，避免過多業務邏輯耦合至 ViewController。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GFiNQGeXsYr2ErleXqY7wA.png" /></figure><ul><li>組件角色</li></ul><pre>1.UI 層（View）：<br><br>  - StoreSelectionView 負責地圖與 UI 配置<br><br>2.業務層（Business Logic）：<br><br>  - StoreSelectionMapHandler 處理地圖交互，StoreManager 負責數據管理<br><br>3.額外模組：<br><br>  - FloatingPanelHelper：控制 FloatingPanelController<br>  - LocationManagerHandler：負責用戶定位<br>  - StoreSelectionNavigationBarManager：獨立處理導航欄<br>  - StoreSelectionResultDelegate：回傳選擇結果</pre><h4>1–3.結構</h4><ul><li><strong>本篇文章將依照</strong><strong>「UI 層」與「業務層」來剖析 </strong><strong>StoreSelectionViewController 的設計與實作</strong>：</li></ul><blockquote><strong><em>UI 層（View）</em></strong></blockquote><ul><li><strong>主要關注點</strong>：如何透過 UI 讓用戶能夠 <strong>直覺地選擇門市</strong>，以及如何確保地圖與浮動面板之間的順暢交互。</li></ul><p><strong>1.</strong><strong>StoreSelectionView 的設計</strong></p><pre>- 負責地圖的顯示與用戶互動<br><br>- 內含 StoreSelectionMapView，提供地圖標註與縮放功能</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Views/StoreSelectionView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Views/StoreSelectionView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.</strong><strong>FloatingPanelHelper 與 </strong><strong>StoreInfoViewController 的交互</strong></p><pre>- 透過 FloatingPanelHelper 管理 FloatingPanelController<br><br>- 將店鋪資訊顯示在 StoreInfoViewController，並支援選擇門市</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.StoreSelectionNavigationBarManager 之導航欄管理</p><pre>- 設定標題與關閉按鈕，提升 UI 可讀性與操作便利性</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><blockquote><strong><em>業務層（Business Logic）</em></strong></blockquote><ul><li><strong>主要關注點</strong>：如何透過 <strong>數據管理、地圖互動、用戶定位</strong> 來確保門市選擇的準確性與流暢性。</li></ul><p>1.<strong>StoreSelectionMapHandler 處理地圖互動</strong></p><pre>- 使用 MKMapViewDelegate 監聽用戶選取店鋪標註的行為<br><br>- 確保點選地圖標註時能夠準確顯示店鋪資訊</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.</strong><strong>LocationManagerHandler 的定位授權與距離計算</strong></p><pre>- 透過 CoreLocation 檢查定位權限<br><br>- 計算用戶當前位置與門市的距離，並顯示在 UI 上</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>StoreManager 透過 Firestore 加載店鋪數據</strong></p><pre>- 透過 Firestore API 加載 stores 集合<br><br>- 解析店鋪數據並轉換為 Store 模型，以便地圖標註顯示</pre><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p>4.<strong>StoreSelectionResultDelegate 回傳選擇結果</strong></p><pre>- 使用 Delegate 模式，將用戶選擇的門市名稱回傳給 訂單顧客資訊頁面</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>1–4.訂單流程整合</h4><ul><li><strong>主要關注點</strong>：如何讓用戶在選擇門市後，能夠讓 <strong>訂單顧客資訊頁面（OrderCustomerDetailsViewController）</strong> 正確更新 UI。</li></ul><p>1.在 OrderCustomerDetailsViewController 接收門市資訊</p><pre>- 透過 StoreSelectionResultDelegate 接收選擇結果<br><br>- 更新 CustomerDetailsManager，確保數據能夠同步存儲</pre><p>2.取件方式區塊的 UI 更新</p><pre>- 根據用戶選擇的門市，自動更新 UI，顯示對應的門市名稱</pre><p>3.提交按鈕的狀態更新</p><pre>- 確保用戶 選擇門市後，提交按鈕才能啟用<br><br>- 透過狀態管理機制，讓 submitButton 依據填寫完整度變更狀態</pre><h3>2.<strong>UI 層（View 層設計）</strong></h3><ul><li>本章節將詳細說明 StoreSelectionViewController 的 UI 架構，包含地圖視圖、導航欄管理、浮動面板等模組的設計。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NnU6kSSWUwtc2mqV57Q0UQ.png" /></figure><h4>2–1.StoreSelectionViewController 的 UI 架構</h4><p><strong>1.地圖視圖（</strong><strong>MapKit）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vrrTlDsdKYcIsxLD7Tw2gg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1JMdUN89pDFX_wyn1B6hTg.png" /><figcaption>左至右：StoreSelectionView 、StoreSelectionMapView / StoreSelectionMapHandler</figcaption></figure><pre>1.StoreSelectionView <br><br>  - 作為主要的 UI 容器，內含 StoreSelectionMapView，負責顯示店鋪地理位置。<br><br>2.StoreSelectionMapHandler <br><br>  - 負責地圖上的交互，如標註點擊事件。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Views/StoreSelectionView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Views/StoreSelectionView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p><strong>2.導航欄管理（</strong><strong>StoreSelectionNavigationBarManager）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3s04Cvv7d4hXzuBJ_oFsxQ.png" /></figure><pre>- 使用 StoreSelectionNavigationBarManager 來簡化 UINavigationBar 的設定。<br><br>- 可快速設置標題與 Close 按鈕，提升可讀性與可維護性。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>3.浮動面板（</strong><strong>FloatingPanelHelper）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p_7Rp7tuRdJMgAga3P9fqg.png" /></figure><pre>- FloatingPanelHelper 封裝 FloatingPanelController 的初始化與管理。<br><br>- 設置 StoreInfoViewController 為面板內容，根據用戶選擇的店鋪顯示相應資訊。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>2–2.地圖視圖與交互（StoreSelectionMapView &amp; StoreSelectionMapHandler）</h4><p><strong>1.地圖顯示（</strong><strong>StoreSelectionMapView）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kt6u0A7s4aRtRUhFG0cf5w.png" /></figure><pre>- 基於 MKMapView，負責渲染地圖並顯示店鋪標註。<br><br>- 支援顯示用戶當前位置與標註點的交互。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Components/StoreSelectionMapView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p><strong>2.地圖交互邏輯（</strong><strong>StoreSelectionMapHandler）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8ubhJ1btx4rRAX7o6jEkYw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rpPUFG5CXnh9-pFvcaMamQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cvNP29lXsQ6CrThdfGi-wQ.png" /><figcaption>左至右：<strong>StoreSelectionMapHandler</strong> / <strong>StoreSelectionMapHandlerDelegate</strong> / <strong>StoreSelectionViewController</strong></figcaption></figure><pre>- MKMapViewDelegate 實現，負責處理標註點的選取與取消。<br><br>- 點擊標註後，透過 StoreSelectionMapHandlerDelegate 通知 StoreSelectionViewController 更新店鋪詳情。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>2–3.導航欄管理（StoreSelectionNavigationBarManager）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jTLZlCDfe3Nz8pU9gRzRhA.png" /></figure><p>1.功能</p><pre>- configureTitle(_:) <br><br>  - 設置標題。<br><br>- configureCloseButton(target:action:) <br><br>  - 設置 Close 按鈕，支援 dismiss 操作。</pre><p>2.優勢</p><pre>- 將 UINavigationBar 的設定邏輯與 ViewController 分離，提升模組化與可維護性。<br><br>- 若需更改導航欄樣式，只需修改 StoreSelectionNavigationBarManager，無需改動 StoreSelectionViewController。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Managers/StoreSelectionNavigationBarManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>2–4.浮動面板管理（FloatingPanelHelper）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1kBdF4aNYj4EqSVqmjc9kw.png" /></figure><p><strong>1.FloatingPanelHelper 的核心功能</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IhPXbJny0mlzJQ-XRYvjOA.png" /></figure><pre>- 負責 FloatingPanelController 的初始化與設置。<br><br>- 設定 StoreInfoViewController 為面板內容。<br><br>- 根據 StoreSelectionViewController 的狀態動態調整面板的顯示方式。</pre><p><strong>2.主要方法</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*EIDa0O1xQvEWNEexyMLkFA.png" /></figure><pre>- setupFloatingPanel(for parentViewController: UIViewController)<br><br>  - 初始化 FloatingPanelController，並將其附加到 parentViewController。<br>  - 設置 StoreInfoPanelLayout 作為面板佈局，確保最佳的顯示效果。</pre><p><strong>3.浮動面板佈局（</strong><strong>StoreInfoPanelLayout）</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Xnvda_8jsCRsAWsZKoXdQA.png" /></figure><pre>- 定義面板的 初始狀態（tip）與 半展開狀態（half）。<br><br>- 透過 FloatingPanelLayoutAnchoring 設定適當的 UI 位置，避免過度遮擋地圖內容。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Helpers/FloatingPanelHelper.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Layouts/StoreInfoPanelLayout.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Layouts/StoreInfoPanelLayout.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>3.業務層（Business Logic 層設計）</h3><h4>3–1.店鋪數據管理</h4><ul><li><strong>StoreManager</strong> 負責處理 Firestore 交互，拉取 stores 集合中的門市資料。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DRnHpNfTR3g8K7VW4QGGcQ.png" /></figure><p>1.流程</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/884/1*NHAELXkURRTwtEUB-iSNOQ.png" /></figure><pre>1.初始化 Firestore：<br><br>  - 建立 Firestore 連線。<br><br>2.請求門市數據：<br><br>  - 使用 fetchStores() 方法，透過 getDocuments() 取得所有門市文件。<br><br>3.解析數據：<br><br>  - 使用 parseStore(from:) 方法，將 Firestore DocumentSnapshot 轉換為 Store 模型。<br><br>4.回傳門市數據：<br><br>  - 透過 async throws 返回 Store 陣列。</pre><p>2.GitHub</p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–2.Firestore 中 GeoPoint 的特性與使用目的</h4><ul><li>在 Firestore 中，GeoPoint 是一種內建類型，專門用來存儲地理座標（經度與緯度）。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nJIAKbDY6F2aP4UaJIYs5Q.png" /></figure><p><strong>1.選擇 </strong><strong>GeoPoint 而非 </strong><strong>Dictionary { lat: Double, lon: Double } 的原因</strong>：</p><pre>1.官方支持：<br><br>  - Firestore 原生支持 GeoPoint，能與 Firebase 的地理查詢（如 geoFire）無縫整合。<br><br>2.減少轉換成本：<br><br>  - 如果使用 Dictionary 存經緯度，每次讀取時都要手動解析，而 GeoPoint 直接可用。<br><br>3.支持地理索引：<br><br>  - 未來若要做「距離範圍查詢」，如「搜尋 5 公里內的店家」，可以直接搭配 Firestore geoQueries 來提升查詢效能。</pre><p><strong>2.Store 模型對 </strong><strong>GeoPoint 的應用</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5RNWBvyFs7yPkXZCvfbzXQ.png" /></figure><p>3.GitHub</p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Services/StoreManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–3.店鋪地圖交互</h4><ul><li><strong>StoreSelectionMapHandler</strong> 負責地圖的標註管理與互動，核心職責：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*R-DGIbMc9rpMDufI6b3uAA.png" /></figure><p>1.新增標註：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IK66EwqMRnIYgeQEamPjkA.png" /></figure><pre>- 根據 StoreManager 返回的 stores 陣列，為地圖 MKMapView 添加 MKPointAnnotation。</pre><p>2.處理點選事件：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_F7WwGBme82xdLhU41ikSg.png" /></figure><pre>- didSelectStore()：<br><br>  - 當用戶點擊標註時，通知 StoreSelectionViewController，並將選定店鋪資料傳遞至 FloatingPanel 展示詳情。<br><br>- didDeselectStore()：<br><br>   - 當用戶取消選取標註時，重置面板至初始狀態。</pre><p>3.GitHub</p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–4.用戶定位</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/704/1*dF8nTA-lK24GlJogwqcO0Q.png" /></figure><ul><li><strong>LocationManagerHandler</strong> 負責 <strong>用戶定位</strong>，並處理 CLLocationManager 授權及位置更新：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AKA4btP98UlAWYw90axP_w.png" /></figure><p><strong>1.檢查授權狀態</strong>：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*trhLP5J1jxDDymSL55avsg.png" /></figure><pre>- .notDetermined → 請求授權<br><br>- .denied/.restricted → 通知 StoreSelectionViewController 顯示權限警告<br><br>- .authorizedWhenInUse/.authorizedAlways → 啟動位置更新</pre><p>2.<strong>處理用戶定位</strong>：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jCCxEbQ6b2J4TGNCaljKKA.png" /></figure><pre>- 透過 CLLocationManager 持續監聽位置變化，並將最新座標存入 currentUserLocation。</pre><p><strong>3.GitHub</strong></p><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/LocationManagerHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4><strong>3–5.回傳距離計算</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/690/1*WEovSjOCgh1IUqQYaZIpSw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/690/1*YVwzlk0XJ10SytZ5z7-p-g.png" /></figure><p><strong>1.流程圖</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*99isjICqfU4Cl0hi29_8gQ.png" /></figure><p><strong>2.相關方法</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5n3jQSRhm6zzo1LbkeAPLg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bsomcprSLy08d6rEmPS3hg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JJST89dkd22PeP-Kh00r1w.png" /><figcaption>左至右：<strong>Store</strong> / <strong>StoreInfoViewModel</strong> / <strong>StoreSelectionViewController</strong></figcaption></figure><ul><li>Store.distance(from userLocation:)：</li></ul><pre>1.計算方式：<br><br>  - 透過 `CLLocation.distance(from:)` 方法計算兩個經緯度之間的直線距離（單位：公尺）。<br><br>2.結果單位轉換：<br><br>  - 除以 `1000.0`，將公尺轉換為公里（km），並保留小數點 2 位數。</pre><p><strong>3.應用場景</strong></p><pre>- 當 `StoreSelectionViewController` 使用 `didSelectStore(_ store:)` 顯示店鋪資訊時<br><br>- 會將用戶的 `currentUserLocation` 代入 `Store.distance(from:)` 計算距離，並顯示於 `StoreInfoView`。</pre><p><strong>4.GitHub</strong></p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Models/Store.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/Models/StoreInfoViewModel.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/Models/StoreInfoViewModel.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3><strong>4.StoreSelectionViewController 與其他模組的交互</strong></h3><h4>4–1.與 StoreInfoViewController 溝通</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*E2b96n28vKj89RcTNvSlsA.png" /></figure><p><strong>1.</strong><strong>FloatingPanelController 切換 </strong><strong>StoreInfoViewController 的狀態</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*v68FGXicXiu6JymoxaFlrg.png" /></figure><pre>1.StoreSelectionViewController<br><br>  - 透過 FloatingPanelController 來顯示 StoreInfoViewController<br><br>    - 當用戶選取店鋪時，會將 StoreInfoViewController 的狀態更新為 details，顯示店鋪詳細資訊。<br>    - 若用戶取消選取店鋪，則 StoreInfoViewController 會被重置為 initial 狀態。</pre><p><strong>2.交互流程</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9Zplm-Y7DLrG04Amk0-nDQ.png" /></figure><pre>1.StoreSelectionViewController 設置 FloatingPanelController 並初始化 StoreInfoViewController。<br><br>2.當用戶在地圖上點選門市時，StoreSelectionMapHandler 觸發 didSelectStore(store)，通知 StoreSelectionViewController。<br><br>3.StoreSelectionViewController 取得 userLocation，並使用 StoreInfoViewModel 建立門市資訊。<br><br>4.StoreSelectionViewController 調用 setState(.details(viewModel)) 更新 StoreInfoViewController 的狀態。<br><br>5.FloatingPanelController 變更為 .half，顯示門市資訊。<br><br>6.若用戶取消選取門市，則 StoreSelectionViewController 調用 setState(.initial(message))，恢復初始狀態。</pre><p><strong>3.GitHub</strong></p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Handler/StoreSelectionMapHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–2.與主畫面（OrderCustomerDetailsViewController）溝通</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zKyd084_jYaHkH5RB9-PIw.png" /></figure><p><strong>1.</strong><strong>StoreSelectionResultDelegate回傳選擇的店鋪</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1SpwJlkSpzjJOiWE-Rf6Og.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TNxy10joeFv4lwwGTbS7YQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LSbQlnI6voDeTZ0bdDEp4w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hv6Q0l6qjgKNw2qB-RM9hg.png" /><figcaption>左至右：<strong>StoreSelectionResultDelegate</strong> / <strong>StoreSelectionViewController</strong> / <strong>StoreInfoViewController</strong> / <strong>OrderCustomerDetailsViewController</strong></figcaption></figure><pre>1.StoreSelectionViewController <br><br>  - 使用 StoreSelectionResultDelegate 來通知 OrderCustomerDetailsViewController 用戶選擇的店鋪。<br><br>2.OrderCustomerDetailsViewController<br><br>  - 會透過 storeSelectionDidComplete(with storeName: String) 接收結果，並更新 CustomerDetailsManager 內的 storeName。<br>  - UI 也會同步更新，重新整理取件方式區域並啟用提交按鈕。</pre><p><strong>2.交互流程</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NV6W0iE6G5N8vsah-_a7NQ.png" /></figure><pre>1.StoreSelectionViewController 在用戶選擇店鋪後，調用 storeSelectionResultDelegate?.storeSelectionDidComplete(with: storeName)。<br><br>2.OrderCustomerDetailsViewController 接收回傳的 storeName，更新 CustomerDetailsManager。<br><br>3.OrderCustomerDetailsViewController 重新整理取件方式區域的 UI。<br><br>4.更新提交按鈕狀態，確保所有必填資訊完整。</pre><p><strong>3.GitHub</strong></p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/Delegates/StoreSelectionResultDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreSelection/View%20Controllers/StoreSelectionViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreSelection/View Controllers/StoreSelectionViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/StoreInfo/View%20Controllers/StoreInfoViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/StoreInfo/View Controllers/StoreInfoViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderCustomerDetails/View%20Controllers/OrderCustomerDetailsViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderCustomerDetails/View Controllers/OrderCustomerDetailsViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>5.總結</h3><h4>5-1.UI 層與業務層的分工：讓 StoreSelectionViewController 維持清晰的架構</h4><ul><li>在 <strong>StoreSelectionViewController</strong> 的設計中，透過 <strong>模組化拆分</strong> 來達成 <strong>清晰的責任劃分</strong>，確保 UI 層與業務層的分離：</li></ul><p>1.<strong>地圖交互</strong><strong>（Map Interaction）</strong></p><pre>- 交由 StoreSelectionMapHandler 負責地圖標註的管理（如 addAnnotations()）。<br><br>- 透過 StoreSelectionMapHandlerDelegate 回傳事件給 StoreSelectionViewController。</pre><p>2.<strong>店鋪數據管理</strong><strong>（Data Management）</strong></p><pre>- StoreManager 處理 Firestore 資料的讀取與解析。<br><br>- Store 模型封裝店鋪數據，並提供額外的業務邏輯（如 todayOpeningHours()、distance(from:)）。</pre><p>3.<strong>位置管理</strong><strong>（Location Management）</strong></p><pre>- LocationManagerHandler 獨立負責用戶定位權限管理與位置更新。<br><br>- 透過 LocationManagerHandlerDelegate 回傳錯誤狀態或用戶位置。</pre><p><strong>4.UI 與導航管理</strong><strong>（UI &amp; Navigation Management）</strong></p><pre>- StoreSelectionNavigationBarManager 負責導航欄的標題與按鈕設置。<br><br>- FloatingPanelHelper 處理 FloatingPanel 的初始化與內容控制器。</pre><h4>5–2.確保地圖交互、店鋪資料、浮動面板的狀態同步</h4><ul><li><strong>為確保</strong><strong>地圖交互、</strong><strong>店鋪資料與</strong><strong>浮動面板的同步，主要透過「狀態管理」與「事件回調機制」進行協調</strong>。</li></ul><p>1.<strong>地圖交互與店鋪資料同步</strong></p><pre>- 透過 StoreSelectionMapHandlerDelegate，當使用者點擊標註時，回傳選定的 Store。<br><br>- StoreSelectionViewController 會接收 didSelectStore(_:) 事件，並進一步更新 UI。</pre><p>2.<strong>浮動面板內容與選定店鋪同步</strong></p><pre>- 當 StoreSelectionViewController.didSelectStore(_:) 觸發時，<br><br>  - 透過 StoreInfoViewModel 格式化店鋪資訊。<br>  - 傳遞 viewModel 給 StoreInfoViewController，更新 UI。<br>  - FloatingPanelController 從 tip 狀態展開到 half 狀態，顯示門市資訊。</pre><p>3.<strong>當使用者取消選擇時</strong></p><pre>- 透過 didDeselectStore()，回到初始狀態。<br><br>- FloatingPanelController 收回到 tip 狀態，顯示預設訊息。</pre><h4>5–3.讓 StoreSelectionViewController 具備可擴展性</h4><p>1.<strong>關注單一職責</strong><strong>（Single Responsibility Principle, SRP）</strong></p><pre>- StoreSelectionViewController 僅作為「協調者」，負責調用 StoreSelectionMapHandler、StoreManager、FloatingPanelHelper 等。<br><br>- 這確保每個模組都能獨立測試與修改，而不影響核心控制器。</pre><p>2.<strong>使用委派模式</strong><strong>（Delegate Pattern）</strong></p><pre>- StoreSelectionMapHandlerDelegate &amp; LocationManagerHandlerDelegate 提供低耦合的方式來管理 地圖點擊 與 位置權限。<br><br>- StoreSelectionResultDelegate 提供 選擇結果的回傳機制，讓 OrderCustomerDetailsViewController 可以獨立更新 UI。</pre><p>3.<strong>採用 ViewModel 進行數據封裝</strong></p><pre>- StoreInfoViewModel 讓 StoreInfoViewController 只關心格式化後的數據，避免直接操作 Store 模型。</pre><h3>6.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cf5807f20ca7" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-17-%E5%BA%97%E9%8B%AA%E9%81%B8%E6%93%87%E9%A0%81%E9%9D%A2-storeselectionviewcontroller-cf5807f20ca7">OrderCoffeeApp #17：店鋪選擇頁面（StoreSelectionViewController）</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[OrderCoffeeApp #16：確認訂單完成 — 顯示訂單資訊與返回主畫面]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-16-%E7%A2%BA%E8%AA%8D%E8%A8%82%E5%96%AE%E5%AE%8C%E6%88%90-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%B3%87%E8%A8%8A%E8%88%87%E8%BF%94%E5%9B%9E%E4%B8%BB%E7%95%AB%E9%9D%A2-1806a8ab2fdf?source=rss-815a6f17f603------2</link>
            <guid isPermaLink="false">https://medium.com/p/1806a8ab2fdf</guid>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[uikit]]></category>
            <category><![CDATA[ios]]></category>
            <dc:creator><![CDATA[wei Tsao 學習紀錄]]></dc:creator>
            <pubDate>Wed, 26 Mar 2025 09:10:34 GMT</pubDate>
            <atom:updated>2025-03-26T16:15:25.612Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>OrderCoffeeApp #16：</strong>確認訂單完成 — 顯示訂單資訊與返回主畫面</h3><h3>## 操作影片</h3><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FOg3Dkaefs5s%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DOg3Dkaefs5s&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FOg3Dkaefs5s%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/d40e54b0236212dedb96455e469d0704/href">https://medium.com/media/d40e54b0236212dedb96455e469d0704/href</a></iframe><h3>目錄</h3><pre>· <a href="#6179">1.介紹</a><br>  ∘ <a href="#3f49">1–1.訂單確認頁面的角色</a><br>  ∘ <a href="#8b1d">1–2.訂單確認頁面的主要功能</a><br>· <a href="#2fca">2.訂單確認的架構設計</a><br>  ∘ <a href="#498b">2–1.架構模式：MVC</a><br>  ∘ <a href="#a04c">2–2.主要組件的職責劃分</a><br>  ∘ <a href="#062f">2–3.設計目的</a><br>· <a href="#cdfa">3.訂單確認頁面的 UI 設計</a><br>  ∘ <a href="#c8b2">3–1.頁面結構</a><br>  ∘ <a href="#a0b0">3–2.視圖組件</a><br>  ∘ <a href="#ab7d">3–3.區塊設計</a><br>  ∘ <a href="#317a">3–4.設計要點</a><br>  ∘ <a href="#c85e">3–5.交互流程</a><br>  ∘ <a href="#dc92">3–6.設計優勢</a><br>· <a href="#2a89">4.訂單確認頁面的業務邏輯</a><br>  ∘ <a href="#9513">4–1.訂單數據管理</a><br>  ∘ <a href="#8831">4–2.展開與收起區域</a><br>  ∘ <a href="#823e">4–3.導航管理</a><br>  ∘ <a href="#df9a">4–4.總結</a><br>· <a href="#79e4">5.訂單流程與頁面切換</a><br>  ∘ <a href="#2b22">5–1.進入「確認訂單」頁面</a><br>  ∘ <a href="#cbe3">5–2.清空訂單</a><br>  ∘ <a href="#be33">5–3.重置主頁導航</a><br>  ∘ <a href="#b46e">5–4.關閉訂單確認頁面</a><br>  ∘ <a href="#1db2">5–5.總結</a><br>· <a href="#3216">6.UI 與業務層的最佳實踐</a><br>  ∘ <a href="#b839">6–1.確保 UI 變更與業務邏輯同步</a><br>  ∘ <a href="#03d9">6–2.表單驗證與 UI 交互的最佳實踐</a><br>· <a href="#7610">7.總結</a><br>  ∘ <a href="#e07f">7–1.UI 層與業務層的分工</a><br>  ∘ <a href="#d7cf">7–2.確保訂單數據與 UI 顯示一致</a><br>  ∘ <a href="#cd72">7-3.避免緊耦合，提升可維護性</a><br>  ∘ <a href="#0591">7-4.利用 OrderConfirmationNavigationHandler 處理導航清空堆疊</a><br>  ∘ <a href="#f753">7–5.透過 OrderConfirmationSectionExpansionManager 簡化展開邏輯</a><br>· <a href="#8880">8.GitHub</a></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*a2WH94EVYvOTnGig4o6BbA.png" /></figure><h3>1.介紹</h3><h4>1–1.訂單確認頁面的角色</h4><ul><li>「確認訂單完成」頁面是 <strong>訂單流程的最後一個關鍵步驟</strong>，主要用來通知用戶 <strong>訂單是否成功提交</strong>，並提供返回首頁或查看訂單的選項。在這個階段，UI 和業務層設計必須確保：</li></ul><pre>- 訂單數據的顯示是即時且準確的（從 Firebase 獲取最新訂單資訊）。<br><br>- 用戶能夠直覺地了解訂單狀態，避免產生「訂單是否成功」的疑問。<br><br>- 用戶可以輕鬆地選擇「回到首頁」或「查看訂單詳情」，不會因為不確定下一步該做什麼而感到困惑。</pre><h4>1–2.訂單確認頁面的主要功能</h4><ul><li>顯示訂單提交結果</li></ul><pre>- 呈現用戶剛剛提交的訂單資訊，包括訂單編號、購買品項、總金額等。<br><br>- 顯示訂單提交成功的視覺標記（✅ 訂單成功圖示）。</pre><ul><li>提供訂單資訊的瀏覽方式</li></ul><pre>- 讓用戶查看訂單詳細內容，包括購買飲品、顧客資訊、付款方式等。<br><br>- 可選擇展開或收起特定資訊區塊，提升閱讀體驗。</pre><ul><li>訂單流程管理</li></ul><pre>- 確保 UI 顯示的訂單資訊與 Firebase 資料同步。<br><br>- 透過 OrderConfirmationManager 管理訂單數據，避免 UI 直接與 Firebase 交互。</pre><h3><strong>2.訂單確認的架構設計</strong></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*N1Mml84stBYLR_RMHkBShg.png" /></figure><h4>2–1.架構模式：MVC</h4><pre>- UI 層：<br><br>  - 負責視覺呈現與使用者互動。<br><br>- 業務層：<br><br>  - 負責訂單數據管理與 Firebase 交互。</pre><h4>2–2.主要組件的職責劃分</h4><p>1.<strong>OrderConfirmationViewController</strong>（頁面控制）</p><pre>- 負責管理訂單確認頁面的數據加載、顯示和使用者互動。<br><br>- 與 Firebase 交互，獲取最新訂單數據。<br><br>- 處理視圖的關閉與返回主畫面。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/View%20Controllers/OrderConfirmationViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/View Controllers/OrderConfirmationViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderConfirmationManager</strong>（訂單數據管理）</p><pre>- 從 Firebase 獲取並解析訂單數據。<br><br>- 轉換 Firestore 數據為 OrderConfirmation 模型。<br><br>- 定義與處理可能的錯誤情境。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>OrderConfirmationHandler</strong>（UI 訂單展示邏輯）</p><pre>- 管理 UICollectionView 的數據源與展示邏輯。<br><br>- 訂單內容的動態顯示，如顧客資訊、飲品項目、總金額等。<br><br>- 與 OrderConfirmationSectionExpansionManager 配合，處理區域展開/收起邏輯。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>4.<strong>OrderConfirmationNavigationHandler</strong>（導航邏輯）</p><pre>- 統一處理視圖控制與導航堆疊的操作。<br><br>- 負責返回主畫面或清空當前訂單數據。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>5.<strong>OrderConfirmationSectionExpansionManager</strong>（Section 展開管理）</p><pre>- 集中管理 OrderConfirmationViewController 的 UICollectionView 中的區域展開狀態。<br><br>- 確保 UI 展示符合用戶需求。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>2–3.設計目的</h4><ul><li>本設計確保 OrderConfirmationViewController 專注於頁面控制，而數據管理、導航與 UI 展示則由專門的組件處理。</li></ul><pre>1.單一職責原則（SRP）：<br><br>  - 每個類別僅專注於一個職責，降低耦合性，提升可維護性。<br><br>2.低耦合高內聚：<br><br>  - 視圖層、業務層、導航邏輯各自獨立，互不干擾。<br><br>3.可擴展性：<br><br>  - 透過 OrderConfirmationHandler 與 OrderConfirmationSectionExpansionManager，可以輕鬆擴展 UI 展示邏輯。</pre><h3>3.訂單確認頁面的 UI 設計</h3><h4>3–1.頁面結構</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AvVCAodOlsEOgJv568zkOA.png" /></figure><ul><li>訂單確認頁面採用 UICollectionView 作為主要內容呈現方式，以模組化方式顯示不同的訂單資訊區塊。頁面包含以下主要區塊：</li></ul><pre>- 訂單確認（顯示成功的圖示）<br><br>- 訂單成功訊息（顯示成功提交訂單的文字訊息）<br><br>- 訂單詳細資訊（展示飲品列表、價格、數量）<br><br>- 顧客資訊（姓名、電話、取件方式）<br><br>- 訂單摘要（訂單編號、總金額、準備時間）<br><br>- 返回按鈕（關閉頁面並返回主畫面）</pre><h4>3–2.視圖組件</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pXsOF5BKGUwIzptDtoxyXA.png" /></figure><p>1.<strong>OrderConfirmationView</strong></p><pre>- 訂單確認頁面的主要容器，負責管理 UICollectionView。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_EGI1sl7o2V1uza51ekS6A.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderConfirmationCollectionView</strong></p><pre>- 專為訂單確認頁面設計的 UICollectionView，負責呈現所有區塊內容。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Components/OrderConfirmationCollectionView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Components/OrderConfirmationCollectionView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.<strong>OrderConfirmationSectionHeaderView</strong></p><pre>- 各區塊的標題視圖，支援展開/收起功能。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*awOVR5nK3VOCOI9dpOaFhQ.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>4.<strong>OrderConfirmationLayoutProvider</strong></p><pre>- 提供 UICollectionViewCompositionalLayout，確保不同區塊的佈局一致。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*d7gJbcZY2K46Gug_jHNCCg.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Layouts/OrderConfirmationLayoutProvider.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Layouts/OrderConfirmationLayoutProvider.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>3–3.區塊設計</h4><ul><li><strong>每個區塊均由專屬 </strong><strong>UICollectionViewCell 顯示，提升可讀性與可維護性：</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FoKAX8f-Cie2EYMl8xACkA.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationCheckmarkCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationCheckmarkCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationMessageCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationMessageCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationItemDetailsCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationItemDetailsCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationCustomerInfoCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderConfirmationCustomerInfoCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationDetailsCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationDetailsCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationCloseButtonCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationCloseButtonCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–4.設計要點</h4><p><strong>1.</strong><strong>UICollectionView 的使用</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MKJn7qCry1HleRT1O0OH1A.png" /></figure><pre>- 採用 UICollectionViewCompositionalLayout 提供動態佈局。<br><br>- OrderConfirmationLayoutProvider 定義不同區塊的佈局，確保一致性。<br><br>- 支援 HeaderView 作為區塊標題，增強結構層次。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Layouts/OrderConfirmationLayoutProvider.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Layouts/OrderConfirmationLayoutProvider.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>SectionHeader 的展開與收起</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hE1pL3_d-cVFEDak6xB0zA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*C89G-zlNZ0Qm3dscwkvNIw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hroZUbh-F7709pEsn5gi9A.png" /><figcaption>左至右：<strong>OrderConfirmationSectionHeaderView</strong> / <strong>OrderConfirmationSectionExpansionManager</strong> / <strong>OrderConfirmationHeaderGestureHandler</strong></figcaption></figure><pre>- OrderConfirmationSectionHeaderView 負責顯示區塊標題。<br><br>- OrderConfirmationSectionExpansionManager 管理展開/收起狀態，確保 UI 與用戶互動一致。<br><br>- OrderConfirmationHeaderGestureHandler 負責監聽 HeaderView 點擊事件，切換展開狀態。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/560/1*k1YqKp1sFJoEhTYSxT6a4g.png" /></figure><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><p>3.<strong>訂單資訊的載入</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KtBkzlwIngLW7JaedKlyvQ.png" /></figure><pre>- OrderConfirmationManager 負責從 Firebase 取得最新訂單。<br><br>- fetchLatestOrderData() 在 viewDidLoad() 執行，確保進入頁面時自動載入訂單。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>4.<strong>關閉按鈕行為</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9d3jU2nHjCej5NBVPaex-A.png" /></figure><pre>- OrderConfirmationCloseButtonCell <br><br>  - 提供 onCloseButtonTapped 回調，通知 ViewController 執行返回操作。<br><br>- OrderConfirmationNavigationHandler <br><br>  - 處理返回主畫面邏輯，確保清空訂單資料並重置導航堆疊。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationCloseButtonCell.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Cell/OrderrConfirmationCloseButtonCell.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>3–5.交互流程</h4><pre>1.用戶進入 OrderConfirmationViewController，系統自動載入最新訂單。<br><br>2.訂單內容透過 UICollectionView 顯示，區塊支援展開/收起。<br><br>3.點擊 關閉按鈕，顯示確認提示，確保用戶知曉返回將清空訂單。<br><br>4.確認返回後，執行 OrderConfirmationNavigationHandler，清空訂單並回到主畫面。</pre><h4>3–6.設計優勢</h4><pre>1.模組化架構：<br><br>  - 各區塊獨立，提升可維護性。<br><br>2.動態佈局：<br><br>  - 採用 Compositional Layout，確保不同裝置上的適應性。<br><br>3.清晰的交互邏輯：<br><br>  - 透過 OrderConfirmationSectionExpansionManager 管理展開/收起，提高可讀性。<br><br>4.與 Firebase 整合：<br><br>  - OrderConfirmationManager 提供數據載入與解碼，確保數據一致性。<br><br>5.提升用戶體驗：<br><br>  - 使用 HUDManager 處理載入指示，避免界面卡頓。</pre><h3>4.訂單確認頁面的業務邏輯</h3><h4>4–1.訂單數據管理</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*STmbswcrJLyoIdN0P7qifQ.png" /></figure><ul><li><strong>OrderConfirmationManager</strong>（負責從 Firebase 讀取訂單資料）</li></ul><pre>- fetchLatestOrder() 讀取最近的訂單<br><br>- decodeOrderConfirmation() 解碼 Firestore 訂單數據</pre><ul><li><strong>訂單數據結構</strong></li></ul><pre>1.OrderConfirmation：<br><br>  - 訂單主結構，包括 ID、顧客資料、飲品項目、時間戳、總準備時間、總金額。<br><br>2.OrderConfirmationCustomerDetails：<br><br>  - 顧客資料，如姓名、電話、取件方式、地址、備註。<br><br>3.OrderConfirmationItem：<br><br>  - 訂單項目，包括飲品名稱、子名稱、尺寸、數量、價格。<br><br>4.OrderConfirmationPickupMethod：<br><br>  - 取件方式（外送或到店取件）。</pre><ul><li><strong>進入訂單確認頁面</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bVCK-HkT7lrW_KO0jO5yiQ.png" /></figure><pre>- OrderConfirmationViewController 呼叫 fetchLatestOrderData()<br><br>- OrderConfirmationManager 讀取 Firestore 的最新訂單數據<br><br>- decodeOrderConfirmation() 解析數據並更新 orderConfirmation 屬性<br><br>- 呼叫 setupOrderConfirmationHandler()，配置 UICollectionView</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Services/OrderConfirmationManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Models/OrderConfirmation.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Models/OrderConfirmation.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–2.展開與收起區域</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9ao_zqn5IoAub93QRxS5PA.png" /></figure><p>1.本部分描述 <strong>點擊標題後展開/收起區域的完整交互過程</strong>，涉及 <strong>UI 層（顯示與手勢處理）、</strong><strong>業務邏輯層（展開狀態管理）、以及</strong><strong> UI 更新（刷新畫面）</strong>。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7nLEiglyfOU_atm-9jSTgA.png" /></figure><p>2.核心方法</p><ul><li><strong>OrderConfirmationSectionExpansionManager</strong>（負責管理展開與收起的狀態）</li></ul><pre>- isSectionExpanded(_ section: Int) -&gt; Bool<br><br>  - 確認指定區域是否展開<br><br>- toggleSection(_ section: Int)<br><br>  - 切換區域的展開狀態，並通知 UI 更新</pre><ul><li><strong>OrderConfirmationHandler</strong>（負責處理 UI 展示的邏輯）</li></ul><pre>- 管理 UICollectionViewDataSource 和 UICollectionViewDelegate<br><br>- 處理 OrderConfirmationSectionExpansionManager 的展開狀態變更<br><br>- 配置 UICollectionViewCell 以顯示訂單資訊</pre><p>3.點擊展開與收起的流程</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MCOMP3EUr6pvpgmc1rFMBA.png" /></figure><pre>️1.使用者點擊 OrderConfirmationSectionHeaderView<br>️<br>2.手勢被 OrderConfirmationHeaderGestureHandler 捕捉，並透過 toggleSection(section) 通知 OrderConfirmationSectionExpansionManager<br>️<br>3.OrderConfirmationSectionExpansionManager 切換狀態（展開/收起），並回應新的狀態<br>️<br>4.OrderConfirmationHandler 透過 didToggleSection(section) 通知 ViewController<br>️<br>5.ViewController 調用 UICollectionView.reloadSections(section)，讓畫面更新</pre><p>4.GitHub</p><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Views/OrderConfirmationSectionHeaderView.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/View%20Controllers/OrderConfirmationViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/View Controllers/OrderConfirmationViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h4>4–3.導航管理</h4><ul><li><strong>返回主畫面與清空訂單</strong></li></ul><pre>- 點擊 關閉 按鈕，觸發 didTapCloseButton()<br><br>- 彈出確認提示，確保用戶知悉清空訂單與顧客資料<br><br>- OrderConfirmationNavigationHandler 執行 dismiss(viewController:)<br><br>- 清空 OrderItemManager 與 CustomerDetailsManager 的數據<br><br>- resetNavigationStacks(with:targetTab:) 重設導航堆疊</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8lIYLottzhMGPZiW_H-www.png" /></figure><ul><li><strong>OrderConfirmationNavigationHandler</strong>（處理返回主畫面與清空訂單）</li></ul><pre>- dismiss(viewController:completion:)：<br><br>  - 關閉當前頁面並回到主畫面<br><br>- resetNavigationStacks(with:targetTab:)：<br><br>  - 重置所有導航堆疊並切換到目標 Tab</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rSV4c4ecXJfTC9lpuAiHbg.png" /></figure><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>4–4.總結</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h8UyKn1dTmlOluNKducp5w.png" /></figure><pre>1.訂單確認頁面負責顯示最新訂單資訊，並允許用戶查看詳細內容。<br><br>2.透過 OrderConfirmationManager 讀取 Firestore 訂單數據，並解析為 Swift 模型。<br><br>3.OrderConfirmationHandler 管理 UICollectionView 顯示邏輯，確保用戶能展開/收起區域。<br><br>4.OrderConfirmationNavigationHandler 處理關閉頁面與導航的重置，確保返回主畫面時數據已清空。<br><br>5.採用 OrderConfirmationSectionExpansionManager 控制區域展開狀態，使 UI 交互更直觀。<br><br>6.確保 didTapCloseButton() 具備確認步驟，避免用戶誤觸導致訂單數據遺失。</pre><h3>5.訂單流程與頁面切換</h3><h4>5–1.進入「確認訂單」頁面</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ktJ-ly72xd_FXtqHc1kc9w.png" /></figure><ul><li>當用戶提交訂單後，會自動導向「確認訂單」頁面，該頁面負責顯示訂單相關資訊，流程如下：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hW-49bZlm6YofEFIZ_4unA.png" /></figure><pre>1.透過 OrderConfirmationManager.fetchLatestOrder() 從 Firestore 讀取最近的訂單。<br><br>2.成功獲取訂單後，更新 orderConfirmation 屬性並刷新 UI。<br><br>3.初始化 OrderConfirmationHandler，負責管理 UICollectionView 的數據源與交互。<br><br>4.顯示訂單的詳細資訊，包括顧客資料、訂單項目、總金額等。</pre><h4>5–2.清空訂單</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1023/1*AJx4NRoB0rI-m0nV1IXOmQ.png" /></figure><ul><li>當用戶確認訂單後，可選擇關閉頁面並返回主畫面，這將會清空訂單數據：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*049GQ3umq8FwPXMmhL8jdw.png" /></figure><pre>1.透過 OrderConfirmationNavigationHandler.dismiss(viewController:) 關閉 OrderConfirmationViewController。<br><br>2.執行 CustomerDetailsManager.shared.resetCustomerDetails()，重置顧客資料。<br><br>3.執行 OrderItemManager.shared.clearOrder()，清空訂單項目。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/View%20Controllers/OrderConfirmationViewController.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/View Controllers/OrderConfirmationViewController.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–3.重置主頁導航</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*95Dm5unDag1GTtSJt7tWsA.png" /></figure><ul><li>當訂單確認後，為確保用戶回到主頁時，導航狀態清晰且不會遺留其他頁面，需執行 resetNavigationStacks()：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*g3gK4lZKwgJlDPcJhr0L4A.png" /></figure><pre>1.OrderConfirmationNavigationHandler.resetNavigationStacks(with: tabBarController, targetTab: .menu) 會清空所有 Tab 內的 Navigation Stack。<br><br>2.預設導向 Menu 分頁，確保用戶回到飲品選單。<br><br>3.透過 UIView.transition 增強視覺效果，避免視圖跳轉突兀。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>5–4.關閉訂單確認頁面</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/664/1*abG6__w7sl0oAFImtlyeIA.png" /></figure><ul><li>由於 OrderConfirmationViewController 採用 modal 方式顯示，因此直接返回時需確認用戶是否確實要離開：</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8pyf2Z5f5ZVLi94JhryeGQ.png" /></figure><pre>1.當用戶點擊「關閉」按鈕時，觸發 didTapCloseButton() 方法。<br><br>2.顯示 AlertService.showAlert()，詢問用戶是否確認返回主頁。<br><br>3.若用戶選擇「確定」，則執行 proceedWithClosing()：<br><br>  - 清空訂單與顧客數據。<br>  - 執行 dismiss(viewController:)，關閉 OrderConfirmationViewController。<br>  - 透過 resetNavigationStacks()，確保導航重置回主頁。</pre><h4>5–5.總結</h4><pre>1.訂單確認頁面 <br><br>  - 主要負責讀取並顯示最近的訂單。<br><br>2.清空訂單 <br><br>  - 會重置 CustomerDetailsManager 與 OrderItemManager。<br><br>3.導航重置<br><br> - 確保用戶回到 Menu 分頁，不遺留不必要的 ViewController。<br> - 返回主頁時，彈出確認對話框，避免誤操作導致用戶無法檢視訂單。</pre><h3>6.UI 與業務層的最佳實踐</h3><h4>6–1.確保 UI 變更與業務邏輯同步</h4><p>1.OrderConfirmationHandlerDelegate</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YmfVpU_zuyWrf3eceA_pDg.png" /></figure><pre>- 透過 Delegate 模式，讓 OrderConfirmationViewController 負責業務邏輯。<br><br>- 而 OrderConfirmationHandler 處理 UI，確保業務邏輯與 UI 互相解耦，提升維護性與擴充性。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Delegates/OrderConfirmationHandlerDelegate.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Delegates/OrderConfirmationHandlerDelegate.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.OrderConfirmationHandler</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2sNIQxDdvaO1xAOyzvCK2Q.png" /></figure><pre>- 主要負責 UICollectionViewDataSource 和 UICollectionViewDelegate，將資料綁定至 UI<br><br>- 並與 OrderConfirmationSectionExpansionManager 搭配，確保 UI 展開/收起狀態與資料變更一致。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>3.OrderConfirmationNavigationHandler</p><pre>- 統一管理 返回首頁 及 關閉訂單頁面 的行為，確保頁面導航邏輯集中管理。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>6–2.表單驗證與 UI 交互的最佳實踐</h4><p>1.<strong>OrderConfirmationSectionExpansionManager</strong></p><pre>- 透過 集中管理展開狀態，避免 UI 直接操控展開/收起的邏輯，提升可讀性與解耦性。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><p>2.<strong>OrderConfirmationHeaderGestureHandler</strong></p><pre>- 負責 處理點擊手勢，確保 UI 變更與狀態管理分離<br><br>- 讓 OrderConfirmationViewController 只需負責監聽狀態變更。</pre><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h3>7.總結</h3><h4>7–1.UI 層與業務層的分工</h4><ul><li>在 <strong>OrderConfirmationViewController</strong> 中，UI 層與業務邏輯清楚分離，使程式碼的可讀性與維護性大幅提升。</li></ul><p>1.<strong>UI 層（View &amp; ViewController）</strong></p><pre>- 負責顯示訂單資訊。<br><br>- 監聽使用者互動並傳遞事件。<br><br>- 使用 OrderConfirmationHandler 處理 UICollectionView 顯示邏輯。</pre><p>2.<strong>業務層（Manager &amp; Handler）</strong></p><pre>1.OrderConfirmationManager：<br><br>  - 與 Firebase 互動，獲取訂單數據。<br><br>2.OrderConfirmationHandler：<br><br>  - 處理 UICollectionViewDataSource &amp; UICollectionViewDelegate。<br><br>3.OrderConfirmationNavigationHandler：<br><br>  - 管理返回主畫面的邏輯。<br><br>4.OrderConfirmationSectionExpansionManager：<br><br>  - 管理區域展開/收起狀態。<br><br>5.OrderConfirmationHeaderGestureHandler：<br><br>  - 負責 Section Header 的點擊手勢。</pre><h4>7–2.確保訂單數據與 UI 顯示一致</h4><ul><li>訂單確認頁面需確保數據與 UI 始終同步，避免資訊錯誤或顯示延遲。</li></ul><p>1.<strong>資料獲取流程</strong>：</p><pre>- fetchLatestOrderData() 透過 OrderConfirmationManager 從 Firebase 讀取數據。<br><br>- OrderConfirmationHandler 確保 UICollectionView 在獲取新數據時重新載入。<br><br>- 使用 HUDManager 在加載數據時顯示 Loading 指示。</pre><p>2.<strong>事件驅動更新</strong>：</p><pre>- 透過 OrderConfirmationSectionExpansionManager，確保區域展開狀態與 UI 同步。<br><br>- 使用 didToggleSection(_:) 確保 CollectionView 內容根據區域狀態動態更新。</pre><h4>7-3.避免緊耦合，提升可維護性</h4><ul><li>為降低 ViewController 負擔並提升可擴展性，將 <strong>UI 行為</strong> 與 <strong>數據處理</strong> 分離。</li></ul><p>1.<strong>統一管理 UI 互動</strong>：</p><pre>1.OrderConfirmationHandler：<br><br>  - 作為 UICollectionView 代理，負責顯示數據。<br><br>2.OrderConfirmationHeaderGestureHandler：<br><br>  - 專責 Header 的點擊手勢。</pre><p>2.<strong>獨立處理導航邏輯</strong>：</p><pre>- OrderConfirmationNavigationHandler <br><br>  - 控制關閉畫面及 UITabBarController 切換，避免 ViewController 直接耦合導航。</pre><p>3.<strong>統一處理 Firebase 讀取</strong>：</p><pre>- OrderConfirmationManager<br><br> - 負責 Firestore 資料讀取與解析，並提供錯誤處理機制，避免 ViewController 直接處理數據。</pre><h4>7-4.利用 OrderConfirmationNavigationHandler 處理導航清空堆疊</h4><ul><li>當使用者點擊「關閉」按鈕返回主畫面時，需要確保導航堆疊清除，避免訂單提交後，還留在相同的頁面。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AVhkq7v4ALsrBKYIJx993A.png" /></figure><ul><li><strong>處理步驟</strong>：</li></ul><pre>1.AlertService 提示確認是否返回。<br><br>2.CustomerDetailsManager 與 OrderItemManager 清空用戶填寫的訂單資料。<br><br>3.OrderConfirmationNavigationHandler 執行 dismiss(viewController:)，解散 OrderConfirmationViewController。<br><br>4.若當前 TabBarController 存在，則 resetNavigationStacks()，確保返回主畫面。</pre><ul><li>GitHub</li></ul><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationNavigationHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></p><h4>7–5.透過 OrderConfirmationSectionExpansionManager 簡化展開邏輯</h4><ul><li>OrderConfirmationSectionExpansionManager 提供了一個集中管理 Section 展開狀態的機制，避免 ViewController 直接處理狀態變更：</li></ul><p>1.<strong>邏輯拆分</strong>：</p><pre>- OrderConfirmationSectionExpansionManager：專責管理區域展開/收起狀態。<br><br>- OrderConfirmationHeaderGestureHandler：專責 Section Header 點擊手勢。</pre><p>2.<strong>優勢</strong>：</p><pre>- 降低 UICollectionView 內部狀態管理的複雜度。<br><br>- 透過 toggleSection(_:) 方法，確保 UI 與 expandedSections 狀態同步。<br><br>- 可擴展性高，未來若需支援不同的 Section 展開行為，可輕鬆調整。</pre><ul><li>GitHub</li></ul><ul><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Manager/OrderConfirmationSectionExpansionManager.swift at main · a578ff6/HW_OrderCoffeeApp</a></li><li><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/blob/main/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift">HW_OrderCoffeeApp/HW_OrderCoffeeApp/OrderConfirmation/Handler/OrderConfirmationHeaderGestureHandler.swift at main · a578ff6/HW_OrderCoffeeApp</a></li></ul><h3>8.GitHub</h3><p><a href="https://github.com/a578ff6/HW_OrderCoffeeApp/tree/main">GitHub - a578ff6/HW_OrderCoffeeApp</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1806a8ab2fdf" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/ordercoffeeapp-16-%E7%A2%BA%E8%AA%8D%E8%A8%82%E5%96%AE%E5%AE%8C%E6%88%90-%E9%A1%AF%E7%A4%BA%E8%A8%82%E5%96%AE%E8%B3%87%E8%A8%8A%E8%88%87%E8%BF%94%E5%9B%9E%E4%B8%BB%E7%95%AB%E9%9D%A2-1806a8ab2fdf">OrderCoffeeApp #16：確認訂單完成 — 顯示訂單資訊與返回主畫面</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>