<?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 Hi Shari Wu on Medium]]></title>
        <description><![CDATA[Stories by Hi Shari Wu on Medium]]></description>
        <link>https://medium.com/@hi.shari.wu?source=rss-f4dd1ca85052------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*RPZH-CR_ez7nk4RNREsMyg.jpeg</url>
            <title>Stories by Hi Shari Wu on Medium</title>
            <link>https://medium.com/@hi.shari.wu?source=rss-f4dd1ca85052------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 18:19:43 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@hi.shari.wu/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[別再邊炒菜邊洗菜：從需求設計 Monorepo]]></title>
            <link>https://medium.com/hello-jkoweb/%E9%96%8B%E7%99%BC%E4%B8%8D%E6%98%AF%E5%A0%86%E6%A8%A1%E6%9D%BF-%E5%BE%9E%E9%9C%80%E6%B1%82%E5%8F%8D%E6%8E%A8-monorepo-%E5%A5%97%E4%BB%B6%E5%BD%A2%E6%85%8B-231b942d43bc?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/231b942d43bc</guid>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[monorepo]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Sat, 13 Sep 2025 06:47:24 GMT</pubDate>
            <atom:updated>2025-09-15T04:09:01.151Z</atom:updated>
            <content:encoded><![CDATA[<p>你有沒有過這樣的經驗？在開發前，花了一大堆時間卡在打包設定上打轉<br>好不容易改了一個設定檔的 key，錯誤訊息消失了，結果執行時卻又冒出新的問題</p><p>對我來說，Monorepo 最難的不是寫功能，而是那段像『備菜』的過程──得先決定要煮什麼，再把食材準備齊全，否則就會邊炒邊跑去洗菜切菜，煮飯的心情一下就沒了😔</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ymZJZoGSzXy_UvdU" /></figure><p>這些卡關的心情，不只是我一個人有，整個生態也面臨類似的問題。</p><p>大家肯定都知道近期的 NPM <a href="https://www.facebook.com/story.php?story_fbid=810878014805734&amp;id=100076506270303&amp;mibextid=wwXIfr&amp;rdid=gUG7oZAABlk5ch9i">資安新聞</a>：這個生態一直很愛用<strong> </strong>Library ，而讓攻擊者有機可趁，我們團隊也快速在晨會討論接下來的方向。</p><ul><li><strong>有些人主張</strong>：既然要用別人的，就務必先鎖版號，或定期用資安工具掃描一次。</li><li><strong>也有人認為</strong>：簡單的程式碼就下載下來，放進自己的專案中維護</li></ul><p><strong>針對第二點，我有個問題──既然你把程式碼放進專案裡了，接下來要怎麼管理、怎麼打包？</strong>這就是本文要往下談的重點。</p><p><em>前段 — 先詢問自己應該導入 Monorepo 嗎？ <br>後段 — 當你學會管理一個 Repo 要具備的知識，那麼 Monorepo 就是管很多個 Repo 的組合技！</em></p><h3>為什麼想要做成 Monorepo</h3><p>有問過自己為什麼需要做 monorepo 嗎？</p><blockquote>大部分的人會回答</blockquote><ul><li><strong>關注點分離（Separation of Concerns）</strong></li><li><strong>版本精準控制，避免無意更新</strong></li><li><strong>有利於測試與回溯</strong></li><li><strong>替未來的擴充性預留彈性</strong></li></ul><blockquote>但我會考慮的是這些，如果其中一個打翻了我就不做 monorepo</blockquote><ol><li><strong>專案規模很小，只是服務一個單純的站台，不太需要分工他人一起完成</strong></li><li><strong>Monorepo 不該因為使用的專案數量增加而變胖<br></strong>Repo 的規模，應該是由「提供多少能力」決定，而不是「有多少專案在使用」。</li><li><strong>不因為分類方便放在同一個 Repo<br></strong>請不要變成一個巨大的共享資料夾</li><li><strong>團隊缺乏流程共識 （build, test, commit, version）還沒定好規範就進行<br></strong>一直往裡放程式碼，在安裝共用時又會互相影響，維護更加複雜</li></ol><blockquote>以上如果你踩到一個，就要問問自己未來打算怎麼面對他了</blockquote><p><strong><em>制定 Monorepo 規範不是形式，而是為了解決「開發完卻交不出去」的根本問題：</em></strong><em>當大家理解這件事的重要性，並一起打造合適的 monorepo 結構，後續的開發與交付流程才會順暢，而不是每次都卡在輸出、打包、版本相容等雜事上</em></p><h3>一個成功能跑的 package 他有幾個斷點</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_ljRewegmi5KsqB_9LOBzA.png" /></figure><blockquote>先從需求出發，反推回來就是 「我需要準備哪些事情」</blockquote><p>例如說：你可能會遇到，同樣一個 package 但需求方使用情境不同，載入跟執行方式的差異，會直接影響我該一包多輸出？還是我該拆兩個包？</p><pre>專案 A, B 安裝相同 package <br>- 專案 A: 需要吃到 package 中的 UI 元件<br>- 專案 B: 需要吃到 package 中的 某 function (但不希望載入該包的 UI，否則專案 B 會報錯)</pre><p>總之，把握在還沒進開發前就準備好，那你的工具箱在使用上會更加方便跟整齊，而不是到了開發中期在做大調整</p><p>這是讓你保持快樂開發很重要的一點！</p><h3>先來談一個 Repo 要具備的知識</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qR_W0so-EcqFZUkoLhwW2Q.png" /><figcaption>來用一個很日常的方式來比喻整個開發到輸出，先在心中有個圖等下就比較不會恍神</figcaption></figure><p>在做基礎建置時，了解打包知識很重要，以下我只抓幾個項目來講</p><blockquote><strong>打包格式 ESM, CJS, UMD</strong></blockquote><p>不理解這三個格式是什麼？ <a href="https://www.dennisokeeffe.com/blog/2023-10-26-explaining-cjs-vs-amd-vs-umd-vs-esm">參考這邊</a></p><p>常見的專案打包工具： webpack, vite, rollup，會自動識別並整合你專案中不同套件出現的不同模組格式，無論你的檔案是：.mjs, .cjs 都能被吃進去</p><p>因此：<strong>在 dev server 的開發環境下聚焦在 bundler config 就能跑</strong></p><p><strong>但打包時，別人的環境不一定跟你的一樣，要正確輸出給面向使用專案的格式，bundler config 得加入兼容考量，並與 package.json 的最終輸出做搭配</strong></p><p>（這就是為什麼你參考很多文件設定，常常沒有生效，但對方在他們自己的專案跑又很順暢）</p><blockquote><strong>面向他人環境考量，來決定輸出</strong></blockquote><ul><li><strong>執行環境</strong>：對方是在 Node.js 還是 Browser 運行</li><li><strong>Bundler</strong>：<br>1. Webpack 4/5 — 不少專案仰賴 package.json main 欄位 + cjs<br>2. Vite/Rollup — 自然地吃 module (ESM)</li><li><strong>NodeJS 版本</strong>：<br>1. Node16+ 正式支援 ESM<br>2. Node12, 14 以 CJS 為主流</li><li><strong>開發者使用方式</strong>：<br>1. Library 開發者 — 使用 import, require 方式引入<br>2. Browser 開發者 — 使用 <em>&lt;script src=”cdn/your-lib.umd.js”&gt;&lt;/script&gt;</em> 掛載<br>3. Next SSR 開發者 — 有時在 server (Node) 有時在 client (Browser) 運行</li></ul><blockquote><strong>設定檔 package.json : 定義 「外部怎麼看，檔案怎麼吃」</strong></blockquote><p>認識一個專案就從這個檔案開始，讀懂就能推敲他會給什麼環境的人使用，以及我可以怎麼使用</p><pre>{<br>  &quot;name&quot;: &quot;@library/ui-component&quot;,<br>  &quot;version&quot;: &quot;1.1.1&quot;,<br>  &quot;description&quot;: &quot;Component library for micro apps&quot;,<br>  &quot;main&quot;: &quot;dist/micro-component-index.cjs.js&quot;,<br>  &quot;type&quot;: &quot;module&quot;, <br>}</pre><h4>name ：專案/套件名稱</h4><p>在 Monorepo 中他便是 workspace 的名稱，團隊也會利用前綴 “@library” 來辨識這個套件是否該打包成 library 讓其他專案使用。</p><p>意思是：在 Monorepo 中，有些 repo 只需要在內部共享，而有些能力是可以開放出去</p><pre>├── apps<br>│   └── cms<br>│   └── client<br>├── libs<br>│   ├── builder-sdk<br>│   │   └── package.json # `name = @library/builder-sdk` ✅<br>│   ├── ui-component<br>│   │   └── package.json # `name = @project/ui-component`</pre><h4>type ：定義執行方式</h4><pre>{<br>  ...<br>  &quot;type&quot;: &quot;module&quot; # 有寫沒寫的差異？<br>}</pre><ul><li>沒有定義： .js使用 cjs 執行，若特定檔案想走 esm 則用 .mjs</li><li>有定義 module： .js 使用 esm 執行，若特定檔案想走 cjs 則用 .cjs <br> — <em>雷點：上面提到 Node12/14 的舊專案還在使用 require() 會爆炸，打包前確認好團隊專案的使用環境真的很重要！</em></li></ul><h4>main, module, exports ：設定執行的進入檔案</h4><pre>- main: cjs 入口<br>- module: esm 入口（webpack, vite, rollup 優先讀取）<br>- exports (Node13+): 除了針對不同環境，還可以細拆不同路徑</pre><p>是否有遇過寫了好像跟沒寫一樣，沒有差別？這很可能是使用的 Framework 他的 Bundler 很聰明，例如：</p><p><strong>NextJS：不是直接吃 node require, 而是跑 Webpack / Turbopack，具有 Fallback 機制<br> — </strong>找 exports -&gt; fallback module -&gt; fallback main -&gt; index.js</p><blockquote>回到原點，如果你的 library 一開始便知道會給其他專案使用，就請乖乖地撰寫入口檔</blockquote><p>➡️ 普遍變成統一多輸出，不要只靠 type 決定</p><pre>{<br>  &quot;main&quot;: &quot;dist/index.cjs&quot;,      // CommonJS 使用 require 時的入口<br>  &quot;module&quot;: &quot;dist/index.mjs&quot;,    // ESModule 使用 import 的入口<br>  &quot;types&quot;: &quot;dist/index.d.ts&quot;     // TypeScript 定義<br>  &quot;exports&quot;: {<br>    &quot;.&quot;: {<br>      &quot;require&quot;: &quot;./dist/index.cjs&quot;,<br>      &quot;import&quot;: &quot;./dist/index.mjs&quot;<br>    }<br>  },<br>}</pre><blockquote><strong>設定檔 tsconfig.json : 決定原始碼編譯後的樣子</strong></blockquote><p>告訴 TypeScript 編譯器 <strong>(tsc)</strong> 怎麼把 .ts / .tsx 編譯成 .js</p><h4>module, target, moduleResolution 決定 <strong>輸出的模組格式與語法</strong></h4><pre>- module: 影響最後的 .js 是哪一種樣子 (import?require?)<br>- target: 轉譯後的 js 語法版本，能否在特定裝置執行（與向下兼容有關）<br>- moduleResolution: TSC 編譯如何尋找模組，能不能解析成功</pre><h4>新的 module: NodeNext</h4><p>從 Node 16 開始，官方 ESM 規則變嚴格<br>新的 NodeNext 會依 Node 的新規則解析 import（包含 exports 與 imports 欄位）</p><h4>依照需求配置建議</h4><ul><li>🔺前端 Static 能直接被丟上 s3 執行的網站：<br>module: &quot;ESNext&quot; + moduleResolution: &quot;Bundler&quot;</li><li>🔺有 SSR 或會跑 Node 環境<br>module: &quot;NodeNext&quot; + moduleResolution: &quot;NodeNext&quot;</li></ul><blockquote>Workspace 配置下的開發</blockquote><p>Monorepo 下會有多個— 子 workspace 只需要內部共享的，可以直接壓上 workspace:* ，省去當該套件升級還要手動升版的麻煩</p><pre>{<br>  &quot;dependencies&quot;: {<br>     &quot;@project/ui-component&quot;: &quot;workspace:*&quot;,<br>  }<br>}</pre><p><strong>下一個問題是，當 @project/ui-component 程式碼異動時，我專案能夠 hot reload 嗎？</strong></p><p>如果在 package.json 的 exports 中直接將路徑指向 src，理論上開發時就能即時吃到修改，但這也代表 <strong>專案與 library 之間存在耦合</strong> —— 兩邊必須使用相同的 bundler 與轉譯方式，才能正確解析程式碼。這在新舊兼容或進行重構時不是行得通的辦法。</p><p>如果完全隔離，就是直接指向打包後的結果 /dist，那使用 watch 的方式會是最普遍：</p><p>推薦使用 <a href="https://turborepo.com/docs/crafting-your-repository/structuring-a-repository">turbo</a>，它能追蹤 workspace 之間的依賴關係，確保誰需要先編譯、誰可以後跑，同時在 watch 模式下只會針對有變動的部分重建，在多個 library + app 的 Monorepo 中效益最大會很有感的加速😙</p><h3>回到需求打造包的特型</h3><p>Monorepo 是需要團隊討論好，有規則下所採取的一種開發形式，因此我認為沒有所謂應該一定得怎樣才是對的規則。</p><blockquote>團隊近期忙於將舊的 Monorepo 專案重構，重新定義使用標準，我們做了以下事情</blockquote><p><strong>1. Folder Design</strong>: 為每個 Folder 重新賦予職責與架構分層，並透過 package name 識別哪些是內部共享還是外部也可使用，沒有人在新舊結構中迷路</p><p><strong>2. 從 yarn 換成 pnpm</strong>: 由於過渡期不會刪除舊的程式碼但會增加新的，可想而知多一包 folder 會增加打包時間與肥度，幸好 pnpm 所有套件只會安裝一次在 root 層，子 workspace 會 symlink 到共用套件，這讓我們省下不少重複安裝套件的成本</p><p><strong>3. 翻寫舊專案中未實踐 typescript 的 code</strong>：過渡期分包，先將這部分 js 抽出，開一個暫時的子 folder，無論子 folder 在重構時使用什麼框架，只要輸出後能與原本母體相容便可以自由開發</p><p><strong>4. 決定 Monorepo 下哪些 Lib 有開放能力</strong>：為開放 Lib 設計共有的版號標準與發布 CICD 流程</p><p><strong>5. 重構的 Lib 每週小輸出至平台使用，小步上版</strong>：在本地與 SIT 測試，都不會比在正式站來的踏實，有人使用毛病就會浮現，使用者的裝置是否能兼容，Monorepo 打包時是否需要增加環境的支援，抱持開放修正的態度，每週的上版都相對來得重要</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*usfZcHs3hXE2xUvnij29Rw.png" /></figure><p>或許 Monorepo 本身不是什麼『必要』的東西，但它能讓開發變得更方便、更輕鬆，就像一個中央廚房：有食材進來時，你清楚知道要放在哪個冰箱或儲藏室；要出菜的時候，也清楚知道該從哪裡拿、要端去哪裡</p><p>流程明確，效率自然提升。</p><h3>開頭提到：「簡單的程式碼下載後放進自己的專案中維護」</h3><p>這句話讓我馬上聯想到，現在很流行的 <a href="https://www.shadcn-vue.com/">ShadCN UI Library</a></p><p>一份「可見的原始碼」，放進自己的 repo，版本不會突然壞掉，Code Review 時也能好好審查</p><p>加上現在強大的 AI，如果一個元件下載後有被修改過，又想要重新拉新版的更新，透過 AI Merge Diff 應該可以省下很多成本，那從前 ShadCN 更版麻煩的缺點也就弱化了👍</p><p>最後～希望大家在做任何 COPY PASTE, 或 CLI Download 動作時，無論如何都好好的定義它要怎麼使用？在哪裡用？還有誰要使用？<br>從需求出發一定不會錯！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=231b942d43bc" width="1" height="1" alt=""><hr><p><a href="https://medium.com/hello-jkoweb/%E9%96%8B%E7%99%BC%E4%B8%8D%E6%98%AF%E5%A0%86%E6%A8%A1%E6%9D%BF-%E5%BE%9E%E9%9C%80%E6%B1%82%E5%8F%8D%E6%8E%A8-monorepo-%E5%A5%97%E4%BB%B6%E5%BD%A2%E6%85%8B-231b942d43bc">別再邊炒菜邊洗菜：從需求設計 Monorepo</a> was originally published in <a href="https://medium.com/hello-jkoweb">Hello, Jkoweb!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[套件中的訂製工坊：我們為客製化做了客製化]]></title>
            <link>https://medium.com/hello-jkoweb/%E5%A5%97%E4%BB%B6%E4%B8%AD%E7%9A%84%E8%A8%82%E8%A3%BD%E5%B7%A5%E5%9D%8A-%E6%88%91%E5%80%91%E7%82%BA%E5%AE%A2%E8%A3%BD%E5%8C%96%E5%81%9A%E4%BA%86%E5%AE%A2%E8%A3%BD%E5%8C%96-29fff6ab2600?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/29fff6ab2600</guid>
            <category><![CDATA[react]]></category>
            <category><![CDATA[monorepo]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Sun, 03 Aug 2025 08:54:54 GMT</pubDate>
            <atom:updated>2025-08-03T09:04:09.525Z</atom:updated>
            <content:encoded><![CDATA[<p>一個需求的價值有多高？往往決定了它該不該被納入共用模組，還是乾脆走客製化路線</p><p>但我們團隊的開發早已不再是單純的 if/else 判斷 ——<br> 不是「只有一個人要用，就不共用」，「三個人要用，就抽成元件」這麼簡單。</p><p>尤其當團隊目標是走向 <strong>No Code / Low Code</strong> 平台時，事情會變得更微妙。<br> No Code 要的是規格穩定、配置明確，但客製化追求的是彈性與自由。<br>這兩者在本質上，其實是衝突的。</p><blockquote>在持續開發共用模組與快樂 Coding 的拉扯中，我們選擇各退一步，尋找一條能彼此滿足的中間路</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*f6N3ZhMqNjN-9QbYuCeYtA.png" /></figure><h3>先聊聊 ‘1/2 Coding’的背景</h3><ol><li><strong>消化來自各方的需求</strong>：公司有分多個業務模組，ex: 支付, 行銷, 會員等等，但 Web Team 只有一個</li><li><strong>前端有 api 就可以串接了，為什麼要一直開會？</strong> 從 pre-kickoff -&gt; prd 馬拉松 -&gt; api design review -&gt; ui design -&gt; test case review -&gt; development</li><li><strong>頻繁來回的溝通</strong>：在還沒有產出後台拖拉平台時， PM 需要畫 wireframe 並且問我們可不可行，那是不是就讓他們一開始就用我們定義好的畫面拉，剩下我們在進 code 寫 api</li></ol><blockquote>超棒的是，前兩個問題真的沒有了</blockquote><p>但 (3) 還是在，雖然 wireframe 問題解決了，但實際進入開發有比較輕鬆嗎？ 可能因為操作者認知不同，即使拉出的畫面差不多，但最終達成目標結果會有執行上的差異</p><ul><li>舉個簡單例子：一個有 pagination 的表格，有些人預期「下一頁」會直接切頁，有些人則希望點擊後跳出彈窗。<br> 彈窗與換頁在畫面結構上看起來差不多，如果能將兩者情境整合變一個那就太好了，但不同模組 PM 是否能接受，只有靠溝通才能釐清。</li><li>而這個差異，就是剩下的 <strong>1/2 Coding</strong> 自由發揮補齊了</li></ul><blockquote>1/2 coding 有什麼不好嗎，聽起來很輕鬆</blockquote><p>除了無法統一管理優化之外，每個人寫的 code 是不可能一樣的，時間一長與主要支線脫離後。有一天 PM 跑來說：「欸～你那個後台，我在原本畫面多加一個下載按鈕喔！你幫我上個版」</p><ul><li>你心想：「好啊小事啦。」結果一合併，Git 衝突炸開、畫面爆掉、功能壞光。</li><li>這時你會想問：「我們有自動化測試嗎？有回歸嗎？」<br>答案是：沒有喔</li></ul><p><em>因此我們要正視客製化，不是為了不衝突而不管 pm 需求，而是思考如何設定自由邊界，接下來讓我們回到正題</em></p><h3>快樂 Coding 的結果</h3><p>關於提案平台帶來的種種便利，在此就不贅述，這裡我們聚焦在它所衍生的一些挑戰與代價。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RlKOi2bwXh_mqXb4M7HuoQ.png" /></figure><p>圖解：從提案平台建立一個後台後，會是獨立 Single SPA 的 Git Repo，意思是長出來的後台與原本的提案平台無關，你想怎麼開發都可以，但只要有新的異動（ex: 元件更新 或 PM 在提案平台上調整了畫面規格），這些異動如果要重新 merge 回已經「獨立出去」的後台，且該後台又有 <em>Happy coding 的痕跡</em>，出現衝突的機率就會提高許多。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zl3mmuIsUFRGD74byRKM8g.png" /><figcaption>異動衝突通知</figcaption></figure><h3>Custom 若是必然的，就讓他變得理所當然</h3><p>以下是我們在實作 Custom 模組時設定的幾個目標與對策：</p><ol><li><strong>一眼看出有沒有「動過手腳」：<br></strong>我們希望每個後台專案一打開，開發者就能快速分辨哪些元件是共用的、哪些是客製過的。<br> 所以我們建立了一套命名與目錄規則，例如 CustomTable 永遠放在 components/custom/ 資料夾中，且以紅色邊框標註在設計圖中。這樣即使專案交接，下一位工程師也能立刻掌握差異。</li><li><strong>統一客製的「寫法」與「範圍」:</strong><br>客製化不代表可以為所欲為。我們針對可覆寫元件制定了一套開發契約（Custom Contract），例如哪些 Props 可以改？哪些邏輯可以抽換？<br> 我們還導入了 BaseComponent pattern，讓共用元件與客製元件共用底層實作，減少重複碼。</li><li><strong>防止 Custom 成為另一個技術債集中營：<br>a. 有限度的客製化：</strong>超過合理客製化就視為新的專案或元件<br><strong>b. 禁用內部調整</strong>：禁止直接改共用元件內部 state 或 hook。</li></ol><h3>一眼看出有沒有「動過手腳」</h3><p>將客製化程式碼放在 plugin/custom Folder 裡面</p><pre>src<br>├── plugin<br>│   ├── custom<br>│   │   ├── fx.js // 檔名任意取，主要吃 template type 判斷 🟢<br>│   │   └── emitHandler.js // 檔名任意取，主要吃 template type 判斷 🟢<br>│   │   └── useCustomRegister.js // 注入 globalContext 🟢</pre><p>（只要是在 custom/ 底下的檔案都不會與 Gencode 產生衝突）</p><h3>統一客製的「寫法」與「範圍」</h3><p>寫法可預期 ：無論是哪一種類型的客製化，都遵循同一套標準，不能各類型隨性的定義 object 或 array</p><pre>const plugin = {<br>  type: &#39;xxx&#39;, // always string<br>  xxxList: [ // always array<br>    { // always object<br>        // object key<br>    }<br>  ],<br>}<br>export default plugin</pre><p>Global Context 參數統一取得：xxxList 物件中的 <em>fn</em></p><pre>{<br>  fn(...params, context) {<br>    // context 一定是最後一個，裡面可以取得你在 useCustomRegister 定義的 globalContext<br>  }<br>}</pre><p>客製化 Global 注入變數</p><ul><li>擴增 globalContext 的變數，在上述 fn 中的 context 變數能取得</li></ul><pre>import { useEffect } from &#39;react&#39;<br>import plugins from &#39;plugin/loadCustom&#39; <br>import { registerPlugin } from &#39;@library/micro-api-engine&#39;<br>import useConfirmModal from &#39;@/models/share/useComfirmModal&#39;</pre><pre>const useCustomRegister = () =&gt; {<br>  const { contextHolder, createModel, createErrorModel } = useConfirmModal()<br>  const globalContext = { // 自己新增 🟢<br>    createErrorModel,<br>    createModel,<br>  }<br>  useEffect(() =&gt; {<br>    const manager = registerPlugin(globalContext) // plugin 動態吃資料夾<br>    plugins.forEach(plugin =&gt; {<br>      manager.load(plugin)<br>    })<br>  }, [])<br>  ...<br>}<br>export default useCustomRegister</pre><h3>防止 Custom 成為另一個技術債集中營</h3><p>依照常見需求開放客製化能力，目前開出：<br>Comonent 元件 / RefineFx 函式 / EmitHandler 呼叫 Api 後執行函式</p><ul><li><strong>Component 元件</strong>：PM 可以在後台上拉出客製化區塊，於是 Gencode 會在後台專案上長出 &lt;Custom /&gt; 元件，並給予一個 name，執行時便會在 runtime 檢查是否有已註冊的客製化元件，最後渲染到 UI 上</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5pYA7CyollZ9vywr9HBekw.png" /><figcaption>主要畫面 產一個動態元件 卡位</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zSxYnahdMTNi5KMLnOdBmw.png" /><figcaption>plugin component 註冊</figcaption></figure><ul><li><strong>RefineFx 函式</strong>：直接在 yaml 上增加 method</li></ul><p>(補充：yaml 是後來為了解決 1/2 coding 帶來的衝突問題，我們開發了自訂 yaml config 來讓畫面中不同元件呼叫 API 與接收 API)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/918/1*_2k83wT4EVczELXthRGcPQ.png" /><figcaption>例如: 我可以客製化 convertDatetime</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LUtEwHHcXu1QhQouPAonBA.png" /></figure><ul><li><strong>EmitHandler</strong>：在 UI 層 呼叫 API 後執行 onSuccess, onError 函式</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fBOmhSxC32-VGMx4y0cnoQ.png" /><figcaption>plugin emitHandler 註冊</figcaption></figure><blockquote>太好了～這樣就暫時解決每次不滿足 PM 需求時，大家總會在統一寫法與客製化中拉扯</blockquote><p>以上都是提及開發者如何在後台使用客製化能力，<br>那 plugin 程式碼又是在哪裡實踐呢？</p><h3>後台共用模組 Monorepo</h3><p>他是一個從後台 Repo 中拉出共用資源的 Monorepo，為了讓資源有版控而不是以往用 Gencode 方式出現，我們長出了新的三小包</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/610/1*GoRp7eIk6MjlnAqb5TxPhA.png" /></figure><p>在配置這三包時也挺費工的，每一包需求不一樣，要如何統一打包方式並選擇適當的輸出類型，兼容給不同後台形式也是一個很大的學問，之後再來補充一篇給你們，這邊就不歪樓了～我們繼續往下說</p><ul><li>api-engine：後台元件之於 API 送出與接收的綁定</li><li>component：ui library 用於拖拉平台的元件預覽 與 後台操作元件</li><li>custom-plugin：本篇文章的邏輯開發</li></ul><p><strong>補充 custom-plugin</strong></p><p>他定義了一個可擴充的客製化入口，讓其他套件中的任意功能若需要被覆寫或調整時，都能透過 custom-plugin 中的 registerPlugin.ts 注入對應的客製邏輯。</p><h3>回到後台 Repo 如何套用 custom-plugin</h3><p><strong>在打包階段，webpack/vite 會去讀取客製化 folder 中的動態檔案(plugin/custom/xxx.js)</strong></p><p>vite 藉由 import.meta.glob 會在 build time 讀動態檔案，否則檔案在沒有正確署名情況下，不可能被打包進去</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hbseal7tMX0UEZTKhUPbtg.png" /><figcaption>custom-plugin-loader</figcaption></figure><p><strong>並在執行時透過前端寫好的 React 腳本 — useCustomRegister.js 載入</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ySHYzbkjgDVi8NT9lr1RrQ.png" /><figcaption>註冊客製化 plugins</figcaption></figure><p><strong>為什麼要動態打包呢？</strong></p><p>目的是降低客製化開發時的規範負擔。畢竟套件的本意是提供便利，而不是施加更多限制。</p><p>有了這個機制，我們就不需要再對客製化檔名做嚴格定義，只要遵守</p><ol><li><strong>Template 格式</strong></li><li><strong>Type 設定正確</strong></li></ol><pre>const plugin = {<br>  type: &#39;xxx&#39;, // always string<br>  xxxList: [ // always array<br>    { // always object<br>        // object key<br>    }<br>  ],<br>}<br>export default plugin</pre><p>如此，開發 custom 的流程就會變得簡單又直覺！</p><h3>假如回到兩年前我會知道怎麼做得更好</h3><h4>不同立場的理解 — 從 gencode 衍生的問題說起</h4><p>在推動 gencode（程式碼產生）這類流程最佳化工具時，往往不是技術本身難，而是需要讓執行團隊理解這背後 <strong>為什麼值得做</strong>、<strong>對誰有幫助，而風險我們能承擔嗎？</strong></p><h4>快樂開發 — 追求的是適度，而非完美</h4><p>重點是「<strong>夠用、可協作、低維運</strong>」。<br> 像是拖拉預覽成果，只要能夠協助 PM 參與會議、理解畫面大致長什麼樣，就足夠，那是不是由很多元件預覽圖組成畫面也可以。不需要每次都做到完美，會耗掉不必要的成本，也削弱團隊的熱情。</p><h4>預留退路 — 客製化終究也有瓶頸</h4><p>當某個需求已經超出原有架構的可承載範圍，那就<strong>勇敢切出去，當成新的後台來開發</strong>。避免落入過度抽象或強行套用的技術</p><h4>衡量風險 — 做與不做，都有成本</h4><p>每一個已知風險的決策背後，其實都有「隱藏成本」。<br>與其逃避風險，不如坦誠評估 — — 做了的代價是什麼？不做會遺留什麼問題？</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=29fff6ab2600" width="1" height="1" alt=""><hr><p><a href="https://medium.com/hello-jkoweb/%E5%A5%97%E4%BB%B6%E4%B8%AD%E7%9A%84%E8%A8%82%E8%A3%BD%E5%B7%A5%E5%9D%8A-%E6%88%91%E5%80%91%E7%82%BA%E5%AE%A2%E8%A3%BD%E5%8C%96%E5%81%9A%E4%BA%86%E5%AE%A2%E8%A3%BD%E5%8C%96-29fff6ab2600">套件中的訂製工坊：我們為客製化做了客製化</a> was originally published in <a href="https://medium.com/hello-jkoweb">Hello, Jkoweb!</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[一張紙，一支筆，一個概念：視覺化思維]]></title>
            <link>https://medium.com/@hi.shari.wu/%E4%B8%80%E5%BC%B5%E7%B4%99-%E4%B8%80%E6%94%AF%E7%AD%86-%E4%B8%80%E5%80%8B%E6%A6%82%E5%BF%B5-%E8%A6%96%E8%A6%BA%E5%8C%96%E6%80%9D%E7%B6%AD-3a69b34c684d?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/3a69b34c684d</guid>
            <category><![CDATA[flowchart-software]]></category>
            <category><![CDATA[thinking]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Fri, 26 Jan 2024 02:32:50 GMT</pubDate>
            <atom:updated>2024-01-26T03:21:22.814Z</atom:updated>
            <content:encoded><![CDATA[<p>畫圖對我來說，是利己利人，利己是幫助自己釐清思路，在面對問題時可以有更多的信心相信自己做了適當的解法，而利他呢？</p><p>你一定遇過與同事討論到工作繁雜的項目，你是不是也會有：</p><blockquote><strong>他一直對我猛點頭，我花了一堆時間解釋最後才發現牛頭不對馬嘴？ 或者他根本從頭到尾不知道我在說什麼</strong></blockquote><blockquote><strong>當討論到一半，我想回到剛剛某個停頓點繼續補充，我該怎麼表達？</strong></blockquote><blockquote><strong>我現在有很急的事情，但是同事似乎還停留在上個議題還沒 fade out 出來，我需要的是馬上畫圖，讓他馬上可以跟我討論</strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/950/1*RR8eREvFhRa02_SyVXOWTA.png" /></figure><p>如果有跟我一樣的疑惑，請善用你的能力<br>透過一支筆一個畫板，讓討論快速聚焦，才有多餘時間討論彼此的觀點！</p><p>讓我先前情提要，才能在下面教學中帶入背景舉例</p><blockquote><strong>我日常工作需要開發 Mobile App 中的網頁（這個網頁稱為 Webview)，我有以下問題：</strong></blockquote><h4><strong>1. 我該怎麼解釋 webview 與 chrome, safari 之間的關係是什麼呢？</strong></h4><h4><strong>2. 印象中的 App 工程師常常跟 web 工程師説，App 裡的 webview 跟外面 safari 瀏覽器/chrome 瀏覽器是不同世界，讓我有很大想像空間，阿到底是哪裡不一樣，為什麼敷衍我～～</strong></h4><h3>Know the purpose?</h3><p>首先，你為了什麼而畫圖，你想傳達什麼，試著用不超過 10 個字來表達你所要訴說的故事。</p><h4>：Webview in App</h4><blockquote>千萬別認為你要畫一個超屌的圖，愈是複雜愈會偏移焦點，如果不能用短短幾個字描述，代表你把這個圖想得太複雜了！請縮小範圍</blockquote><h3>切入情境</h3><p>首先找一個出發點，不用急著把全部情境一次列出來，萬事起頭難，找到入口也是找到方向性，順著方向帶動思維，之後才把細節補齊</p><h4>：一台舊 iphone 手機，為了之後討論聚焦，我押上 iOS 字樣</h4><figure><img alt="12323" src="https://cdn-images-1.medium.com/max/240/1*scGUK8LQXBDenJJjCNW-ew.png" /></figure><blockquote>把自己置身情境裡，把自己跟別人當成笨蛋，為讀者著想，同時讓別人有身在其中的感覺，這樣彼此立足點才會一致。</blockquote><h3>創造物件</h3><p>從切入點想像，即將有哪些人事物的登場，請把它寫下並用方框框起來</p><p>此時不用考慮筆的顏色、粗細、背景等等，他們只是草稿，還不確定會不會用到</p><h4>：與 Browser App 及 webview 相關的物件列舉</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OZd3bBxOcKcYBVN4B6C1fg.png" /></figure><blockquote>嘿嘿 別忘了出發點也算是物件之一喔！</blockquote><blockquote>webview core 是什麼？每台手機有各自的作業系統，而系統本身也會提供預設能力，<strong>其中 webview 是今日討論重點，所以我把 webview 單獨拉出來</strong></blockquote><h3>分類物件</h3><p>將有同質性的物件框起來，並給他們一個新的群組名稱。</p><h4>：分完後就剩下四個大物件 (ios, webview core, app, webview)</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FFNLp7JtcmpFqRGqvAVI1g.png" /></figure><h3>物件關聯</h3><p>從出發點開始連出第一條線吧！不需要想很多，把剛剛物件彼此連起來，不需要真的知道中間發生什麼事，在此時，你可以反問為什麼自己把他連起來了？他們的關係有幾種可能才會想將其做連線？</p><h4>：不同 App 有各自 webview，彼此 webview 不會互相溝通</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*33gsjQ7naPkYn54uXvCbfA.png" /></figure><h3>角色認知</h3><p><strong>主線</strong>：你是故事主角，當然的會從主要的切入情境出發</p><p><strong>支線</strong>：嘗試把第一人稱視角轉給他人，那他又會看到什麼樣的景色，會發生不可思議的事情嗎？有的話請重新審視剛剛的圖，做點配置調整</p><h4>：本次討論目標是對瀏覽器 app 與街口 app 做分析，因此我把原先分類群組拆開並將他指向反方向，做出區別</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Zv2Nqae_MqemJG9-2zyYKw.png" /></figure><h4>：在各自的 app 認知中，補齊應有的能力（列舉的能力需要有同質性，因為一開始我們把他們劃分在同類別，拆散後還是同個體系）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wSVzTjqheaXSbkwQhB9vuw.png" /></figure><blockquote>主線與支線，用多種角色方向理解這份圖，除了幫助思考，不同角色的職責也會更加清晰</blockquote><h3>加入動作</h3><p>再回到主軸 — 出發點，剛剛思考的連線關係有好多種可能，那該用哪一個？</p><p><strong>選不會離題的就對了！</strong></p><p>請寫下你的動作，如果不是特別強烈被提起，可以直接將動作定義在連線上，否則請創建一個新的框框元素表達</p><h4>：安裝 app 時，同時也告訴系統，我要使用哪些能力，而 webview core 就是被叫喚的那位</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7kb9C60IokFn2mwXNDa6eg.png" /></figure><h3>篩選物件</h3><p>前面所建立的物件、情節，是不是有重複性高的？</p><p>重複高的部分，你可以用一個群組代名詞即可，細節部分請刪除，若是必要描述，請你分下一個分鏡圖去描述他</p><h4>：細心的你，會發現 chrome webivew 物件在角色認知階段被刪除了，我們要的是證明不同 app 中的 webview 是不同的，而不是把全部物件都保留，小範圍說故事更好聚焦</h4><blockquote>是否有太多的物件同時在上面？他是不會影響到故事，僅是作為補充的物件，那先把他刪掉吧！</blockquote><h3>限制邊界</h3><p>檢視自己是不是讓主題不斷延伸，說得太長了，聽的人容易飄走，那你可以換一個篇幅，把他畫在下一個故事邊界</p><p>回想在這個邊界裡，我還有哪些想表達的重點尚未提及？</p><h4>：已知渲染過的連結在瀏覽器會被存起來，那我們開開看不同 App 是否會互存，結論是 NO，所以我畫出各自儲存 Disk, 來表示渲染過的 Url 會各自保存</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wOnnYzYUhQQBDkDL_kCXaA.png" /></figure><blockquote>限制不代表一定要刪除，也可能是增加，只要符合題目邊界，能清楚說明才最重要</blockquote><h3>空間思維</h3><p>跳脫故事中的主線，有沒有可以被劃分出來的空間，有可能是不同角色、 不同的時間線…</p><p>如果有，而且很重要，請直接用大刀切割會更快理解</p><h4>：從中間切開，就知道是在講兩種面向了</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lGvNRT5TqWiapsBzNjgpmA.png" /></figure><h3>重點 Highlight</h3><p>標出故事中，你覺得一定要被提到的幾個物件，如果很多很重要，你可以換不同顏色</p><h4>權限大小</h4><p>可以用不同的顏色、邊框、粗細來塗上物件的背景</p><h4>同性質區分</h4><p>同類型的物件，用相同的顏色或框線</p><h4>定位物件</h4><p>靜止或動態（變與不變），用不同樣式區隔</p><h4><strong>主線與支線</strong></h4><p>主線 = 實體線條</p><p>支線 = 虛線線條 / 淺色實現線條</p><h4>線條拉平</h4><p>不要扭曲，不要與過多線條交會</p><h4>：把開頭的主題放在左上角，將主要項目用實體顏色填滿，並依據不同 webivew 來源（ios, chrome）給予不同顏色</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qPv267GHcEAIUDq69keVOQ.png" /></figure><h3>後退三步</h3><p>請用路人視角，看看你剛剛創造的世界，當我是外星人我乘坐飛碟要飛過這個世界時，我可以不看任何故事情節，就能一眼分辨出空間、重要物件、邊界劃分、以及這個世界的老大是誰嗎？</p><blockquote>此時一個細細品味時間，除了感嘆自己畫的好棒棒以外，你可以看著圖再快速走一次流程喔！你的思緒會更加清晰</blockquote><h3>重複閱讀做總結</h3><p>來解讀一下最後的圖吧！</p><h4>：最後的圖被拆成兩半時空，左邊是 各家 App 代表，右邊是常見瀏覽器，由於日常使用瀏覽器太習慣了，根本上也忘了他們其實跟 App 沒有不同啊，最大不同處只有是否出自同門（chrome, ios），了解原理後也沒什麼大不了的啊，街口 webview 與手機 safari 不能拿來比較，他們確實不同，不同的 App 會有自己實作方式，但是核心 ios webview 機制是相同的</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h7mVHoitLzwhy0Cu2yow5Q.png" /></figure><p>經常有人說：「你畫得好漂亮，肯定花了不少時間吧？」</p><p>起初的練習確實花了些時間，一旦成為習慣後只需要短短時間就能開始創作，這份能力不僅是一個快速傳達的工具，更是一個整理思緒的方式。</p><p>當畫出雜亂的圖時，我知道此刻的思緒正在走歪，那就重新修正脈絡，把線條拉平，把非必須的物件移除，讓圖回朔到前幾步，不斷重新開始</p><h4>推薦畫圖工具</h4><ul><li><a href="https://excalidraw.com/">Excalidraw</a>：靈活的排版，適合啟發性不喜框架的創作</li><li><a href="https://whimsical.com/">Whimsical</a>：乾淨快速，有許多樣本範例，適合節省時間有效率的繪圖</li></ul><p><em>以上是我工作最常用的兩個，當然還有很多很好用的工具，有不錯的也可以推薦給我！</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3a69b34c684d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[從 0 開始的開放生態圈 — OAuth 篇]]></title>
            <link>https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-oauth-%E7%AF%87-c4d13f61db2e?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/c4d13f61db2e</guid>
            <category><![CDATA[login]]></category>
            <category><![CDATA[oauth]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Fri, 17 Jun 2022 06:18:35 GMT</pubDate>
            <atom:updated>2022-06-17T06:31:59.532Z</atom:updated>
            <content:encoded><![CDATA[<h3>從 0 開始的開放生態圈 — OAuth 篇</h3><p>相信大家一定串過各種的第三方 OAuth，而我們也打算有一套 OAuth 讓第三方在我們生態圈建立服務時，可以直接使用我們的登入機制，這有什麼好處呢？</p><ul><li>登入成功後，可以向街口拿取使用者資訊</li><li>提供綁定第三方使用者帳戶與街口帳戶的功能（當街口登入時，也代表該平台也被登入）</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6GD-InDf-aw58skgR04PrQ.png" /></figure><p>接下來與各位分享有關 OAuth 被建制的過程</p><h4>OAuth 還沒有納入開發者平台之前</h4><p>首先建立一張 ISV 表紀錄有哪些三方，其中也包括該三方權限配置等等重要資訊。其中最重要的是 clientID、scope (想要拿取的授權範圍)。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Hkgn3k_v0xawtdlxYOVFhA.png" /></figure><blockquote>ClientID 是什麼呢？</blockquote><p>在第三方要登入街口時，我們提供一個 function 叫做 <em>getAuthCode</em>，當三方帶入 clientID 及 scope 就能喚起授權頁面。</p><p>這部分完全沒有問題，但如果今天他要納入開發者平台，我們該怎麼去思考設計方式？</p><h4>OAuth 如何加入開發者平台</h4><p>起初我們定義第三方一定會使用 OAuth 服務，所以一開始在開發者平台建立應用程式時，就直接幫三方申請好 OAuth 服務了。</p><p>這讓後面的服務嵌入變得綁手綁腳的，於是乎我們將兩者位置調換一下：</p><blockquote>後端與開發者平台的主控權反轉</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/881/0*y978pORT2Fymc34v.png" /><figcaption>橘色：開發者平台 / 紫色：後端 Gateway</figcaption></figure><p>太好了，由上圖很明顯看到，權限由後端主控轉移到了開發者平台本身，如此一來，每次新增一個服務時，不會被綁死，所有服務都能由開發者平台開始決定要不要啟用這項服務。</p><h4>授權頁怎麼來的？</h4><p>不就是一個單純的靜態頁面嗎？起初我也這樣想，不過事情發展超乎我的想像。</p><p>觀察下方版本一跟二差異：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Gj6S8d5Kob0taGRcHxv3Nw.png" /></figure><blockquote>在版本一時，PM 說：</blockquote><p>我要一個描述 scope 區域加上條款說明區塊，而且有固定挖空內容位置</p><blockquote>在版本二時，PM 又說：</blockquote><p>除了版本一之外，我還想要更多能力描述區塊，甚至我還想要 “更彈性挖空內容位置” 。</p><p>大家可能想什麼是更彈性挖空？ 就是 全部挖空就好拉！ＸＤＤＤ</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/210/0*Ysm1O_e7QSAN404Q.png" /><figcaption>框起來的部分要挖空</figcaption></figure><p>這樣有挖跟沒挖一樣，如果今天不同人填寫就有不同的樣板，那還要樣板幹什麼呢？</p><p>OK，現在不是抱怨的時候，我們來想想有什麼辦法解決。</p><h4>區塊分析</h4><p><strong>什麼是一定不變？區塊內的大方向不變</strong></p><p>我們將上述區塊拿出來抽象化，就跟寫 Component 依樣開心～</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/887/0*bpUitHpUVW1zQ5BX.png" /></figure><p>此時用這個概念去跟 PM 博弈</p><blockquote>確認每個區塊內部都是一樣的大架構，要怎麼變隨便你們，例如：</blockquote><ul><li>注意事項 可能不會有條款</li><li>綠色勾勾項目 可能不會有要 寫死的項目</li></ul><blockquote>每個區塊雖然都一樣，但是名字不一樣，意義也不一樣，例如：</blockquote><ul><li>第一個區塊 開放能力區塊：例如街口帳號與平台帳號綁定</li><li>第二個區塊 個人區塊：專門顯示第三方要授權的 scope</li><li>第三個區塊 註冊條件區塊：顯示特殊使用者等級註冊條件</li></ul><p><em>在相同區塊架構下，我們可以有足夠的靈活度。</em></p><h4>讓區塊（單元） 變成 組件（多個單元）</h4><p>假設組件 json 長這樣</p><pre>&quot;blocks&quot;: [<br>    {<br>      &quot;type&quot;: &quot;userTerm&quot;,<br>      &quot;typeValue&quot;: &quot;{{typeValue}}&quot;,<br>      &quot;description&quot;: &quot;A&quot;,<br>      &quot;items&quot;: [<br>        &quot;xxxx&quot;<br>      ],<br>      &quot;cautions&quot;: {<br>        &quot;title&quot;: &quot;注意事項&quot;,<br>        &quot;content&quot;: [<br>          &quot;oooooooo&quot;<br>        ]<br>      }<br>    },<br>    {<br>      &quot;type&quot;: &quot;functional&quot;,<br>      &quot;description&quot;: &quot;{{客製化欄位}}&quot;,<br>      &quot;cautions&quot;: {<br>        &quot;title&quot;: &quot;街口帳戶功能注意事項&quot;,<br>        &quot;term&quot;: &quot;{{客製化欄位}}&quot;,<br>        &quot;content&quot;: [<br>          &quot;{{客製化欄位}}&quot;<br>        ]<br>      }<br>    },<br>    {<br>      &quot;type&quot;: &quot;information&quot;,<br>      &quot;description&quot;: &quot;&quot;,<br>      &quot;cautions&quot;: {<br>        &quot;title&quot;: &quot;&quot;,<br>        &quot;term&quot;: &quot;&quot;,<br>        &quot;content&quot;: [<br>          &quot;ooo&quot;,<br>        ]<br>      }<br>    }<br>  ]<br>}</pre><p>如何決定組件中某區塊要不要出現？</p><ol><li>靜態：在樣板組件中一開始就不要放入單元區塊</li><li>動態：透過 url query 帶入該 type 的值且不為 false 則要出現<br>ex: 以上面例子為例，如果 url = <a href="https://ooxx/?userTerm=cC_B">https://ooxx?userTerm=cC_B</a> ，因滿足第一個 userTerm block，則要顯示</li></ol><h4>Template Rendering Pattern</h4><p>PM 可以開始建立樣板，用組件客製化不同版本的樣板</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*anVscWdAf7k0IOy3.png" /><figcaption>右側灰色區塊，由 PM 客製化</figcaption></figure><pre>每個區塊可填寫都一樣，但是內部的樣子可以長得很不一樣！</pre><p><strong>舉例</strong></p><p>問：當有了樣板 (v1) 之後，如果哪天 PM 又要針對特殊的廠商有不同樣板怎麼辦？</p><p>答：那就再建立第二個樣板叫做 (v2)</p><h4><strong>授權頁生命週期</strong></h4><ol><li>由 Controller 呼叫 “api-v1” (可呼叫不同的版本，他會對應不同樣板)</li><li>建立完授權頁 Json Schema 後用 clientID 為這份檔案命名</li><li>當前台要顯示授權頁時只要抓對應的 clientID 就可以拿到資料。</li><li>若特定第三方（clientID) 要吃不同樣板 (v2)，就打 api-v2，其他第三方不會被影響到。</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*gLvsOigKeGk6FBR7.png" /></figure><p>這樣好處是</p><ul><li><strong>樣版與真正的 config file 不互相依賴</strong></li><li><strong>彈性變更樣板</strong>：當樣版從 v1 -&gt; v2，view 不需要更動</li></ul><h4>延伸探討</h4><p>這個概念在前端其實廣泛應用在開發元件上，即是 view 與 logic 分離，如果有時候可以跳脫思考，那這個概念就可以被應用在很多地方。</p><p>先說這麼做不一定是最好的解法，同時我們也一直在思考文案系統要怎麼做可以最彈性，當已上線的專案又要一直改文案，對 RD 來說是很浪費時間的事情。</p><p><em>How to make it easy?</em></p><p>讓事情變簡單好上手，之後才不會有煩惱～</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c4d13f61db2e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-oauth-%E7%AF%87-c4d13f61db2e">從 0 開始的開放生態圈 — OAuth 篇</a> was originally published in <a href="https://medium.com/jkopay-frontend">jkopay@frontend</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[從 0 開始的開放生態圈 — Openweb 篇]]></title>
            <link>https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-openweb-%E7%AF%87-7419ac54c25d?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/7419ac54c25d</guid>
            <category><![CDATA[miniapp]]></category>
            <category><![CDATA[ide]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Fri, 10 Jun 2022 03:07:38 GMT</pubDate>
            <atom:updated>2022-06-10T03:11:33.411Z</atom:updated>
            <content:encoded><![CDATA[<h3>從 0 開始的開放生態圈 — Openweb 篇</h3><h4>哪天用街口不再只是為了付錢？</h4><p>我猜大部分的人進來街口就是幾秒的時間馬上刷掉</p><p>那如果街口有了繳費以外的功能，例如：商城、售票等等，大家進來的時間鐵定可以超過 1 分鐘吧ＸＤ</p><p>但是今天街口不想一直自己做產品，要怎麼快速擴展不同業務啊！最懶惰方式就是請別人做，前提是你需要具備足夠的核心價值和導流，讓別人想在你家產品上上架他的產品是嗎？</p><p>倘若我們能開發一整套系統，裡面有我們自己的語言、模組、IDE，讓第三方開發的小程序 App 能嵌入街口 App 中，街口的服務產品就會變得多元。</p><h4>Openweb 前身，JKOMA 小程序起源</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ApEzqhL-Bv4K2Q9w6LLOQQ.png" /><figcaption>圖為第一版小程序 IDE Prototype (Jkoma = Jkos Mini App)</figcaption></figure><p>為了讓使用者體驗小程序時，可以更逼近真實的 App，我們期望開發者不是實作一個 webview 而已，而是逼近一個真正的 App，那我們要做哪些事情呢？</p><blockquote>For Mobile</blockquote><ul><li>Mini app Life cycle</li><li>Multi-Thread Workers</li><li>Template analyzer</li><li>Allocate Mini app project</li><li>Same layer rendering</li><li>Data binding</li><li>SDK</li><li>Api for Javascript</li></ul><blockquote>For Web</blockquote><ul><li>Mini app DSL Script</li><li>Mini app IDE (desktop app by electron)</li><li>Mini app Component library Injection</li><li>Package Mini app (upgrade, downgrade)</li><li>Debug Tool</li></ul><p>and more…</p><p>上面任何一個都是一個研究項目，非常有趣兼具跳戰性，我們也努力了半年左右，考慮到各個層面的因素（ex: 人力、現實考量），我們決定先從 <strong>Openweb</strong> 開始，逐步實現不要貪心。</p><h4>Openweb 登場</h4><p>一個 Miniapp 小程序的簡單版，其實就是 <strong>webview</strong>。</p><p>未來我們也希望 openweb 可以更加豐富，慢慢趨近小程序的目標。</p><p>像是 Openweb 可引入的東西除了 js-bridge 外，還可以擴充很多 library，再加入友善的 IDE 模擬器，減少人力成本協助三方快速 Debug，從開發到部署串成一線。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*L-Ius2HXV0QIED7Y.png" /></figure><blockquote><strong>什麼是 js bridge ?</strong><br>與 App 溝通的管道，每個 webview 會建立一個管道，這個管道有很多功能，web 可以透過執行這些功能來達到目的。</blockquote><h4>Openweb SDK 開發</h4><p>SDK 就是我們對外開放的能力，他們可以在 openweb 使用街口登入授權，或是拉起付款頁面，又或者調整 UI 介面。</p><blockquote><strong><em>首先製作 SDK 有哪些考量呢？</em></strong></blockquote><p>起初第一版主要是串接成功就收工，但是後續不好維護及擴張，於是有了第二版本：</p><ul><li>統一核心共用模組 Bridge Model</li><li>統一 function 的參數順序</li><li>定義 function params schema</li><li>建立 params validator</li><li>建立 params refiner</li><li>可彈性注入外部 function ex: url formater</li><li>定義可使用 function 的最小環境版本</li><li>檢查 Openweb 當下進入的 webview 是否正確，才可以啟用</li><li>定義 error code 與 App error 做區隔</li><li>打包產出 umd, cjs 格式</li></ul><p>假如我們都開發好了！那我們要怎麼 demo 給 QA 測試呢？</p><h4>Openweb Playground</h4><p>來建立一個 demo playground 吧！原本想說就簡單做一個給 QA Demo 用的平台就好，後來想想不對… 這樣每次新增一個 function 我就要重新上版這個 playground，實在太麻煩了。</p><p>剛好那時候聽到主管 Kim 哥說有一個 headless CMS — <strong>Strapi</strong>，要拿來做 mock data。</p><p>這時候突然想到似乎也可以利用這個當作後台，來上下架 sdk。</p><blockquote><em>我認為的 Playground 功能列點有</em></blockquote><ul><li>可以 動態切換：不同 版本、格式、環境、分類的 SDK</li><li>可以 動態填寫 input 的內容並塞進 function</li><li>可以 看到最後組好的完整 function script</li><li>可以 看到 callback 結果</li><li>可以 同時執行多個 function（快速測試）</li></ul><p>登愣！！🥳🥳🥳🥳🥳 這樣以後我們不需要每次更新 SDK 就得重新部署 Playground 拉。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*6fzZ3DOgV8_1Xwnf.png" /></figure><blockquote><em>如何添加新的 function 到 Playground</em></blockquote><p>我們使用 Strapi 的主要功能是，他可以透過操作後台設定來建立 CRUD 的 Api：</p><ul><li><strong>version</strong>: 提供幾種版本切換</li><li><strong>category</strong>：function 分類</li><li><strong>functions</strong>: 所有 function</li></ul><blockquote><em>再建立 function 樣板</em></blockquote><ul><li>利用建立好的樣板產生前台的 form 表單及 function script</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/996/0*wPMiDZHXZu7rU1Rr.png" /></figure><p>花短短的時間，我們的 playground 已經很完整了。</p><p>有了這一套 SDK 建立方式，從此我們只要專注在 SDK 溝通正確即可，以及將新的 function 放進 strapi 裡。</p><p>如果也想把別的 webview 的 sdk 更新成這個模式是可行的嗎？</p><p>可以的，只要把舊的 sdk 更新，並重啟一台 playground 注入不同 sdk library 就可以 0 成本啟用一個全新 playground。</p><p><em>太好了，這下子又減少不少時間可以準時下班拉～～～～</em></p><h4>Openweb 有什麼難？</h4><p>多數人提及 Openweb 就說，喔！不就是 webview + sdk，是這樣沒錯，但實際接觸後會有很多你所不知道的細節在裡面。</p><p>除了前端，你需要了解 App 甚至了解第三方。</p><blockquote>對於街口方 而言</blockquote><ol><li>App 針對三方 webview 開放使用的權限能力評估</li><li>App 的版本與 SDK 是否符合 Openweb 需要</li><li>不同 Openweb 進入方式的處理，ex: Url scheme, Deeplink</li><li>當第三方 Openweb 掛掉時，處理風險的方式</li><li>把關不同進入的網址連結是否為被允許的網址</li><li>評估第三方提出的需求是否要納入未來版圖去實作</li><li>如何快速開發並測試 SDK</li></ol><blockquote>對第三方而言</blockquote><ol><li>缺乏線上文件與第三方溝通，需提供一個開放文件管道</li></ol><p><em>（low-code to no-code 讓所有不懂程式的人也能共同編輯文件）</em></p><p>2. 三方在撰寫 javascript 語法 與 框架方式各有不同，總會遇到千奇百怪的問題。</p><p><em>(例如：當第三方直接把他們官網放進來，你要怎麼讓他能 work，而且在 webview 要兼容各種手機有很多雷點可以說…）</em></p><p>3. 測試資料與開發工具需要窗口協調處理</p><p>4. 上線後的維護處理，發生問題時街口要如何第一時間告知</p><p>5. 當有 SDK 要升級時，許多流程要再重新 loop</p><p><em>在與三方串接過程中，每次都讓我們認知到現階段有哪些不足，並開始規劃下階段我們能怎麼突破</em></p><h4>Miniapp 時期的產品不會白廢</h4><p>雖然之前實作到一半的 Miniapp 相關產品最後並沒有繼續，但是讓我在學習過程中獲得不少啟發。</p><p>期待能將 Openweb 用在第二版的 Miniapp IDE 🤩 我相信可以解決當前多數的問題，我們仍需要點時間。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*nxG0fRWaPckiTlLx.png" /><figcaption>圖為第二版的 Miniapp IDE</figcaption></figure><p>套一句主管常說的話：</p><p><strong>需求有時候不一定是 PM 提出，發現問題用有趣的方式解決，也是一個讓工作不無聊的方法之一 ！</strong></p><p>如果你在工作上做過什麼酷東西，也歡迎和我們分享～～</p><p><em>接下來還有最後一篇，有興趣的人請不吝嗇的大力拍手手～ 😝😝😝</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7419ac54c25d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-openweb-%E7%AF%87-7419ac54c25d">從 0 開始的開放生態圈 — Openweb 篇</a> was originally published in <a href="https://medium.com/jkopay-frontend">jkopay@frontend</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[從 0 開始的開放生態圈]]></title>
            <link>https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-1db1402a550d?source=rss-f4dd1ca85052------2</link>
            <guid isPermaLink="false">https://medium.com/p/1db1402a550d</guid>
            <category><![CDATA[service-design]]></category>
            <category><![CDATA[console]]></category>
            <dc:creator><![CDATA[Hi Shari Wu]]></dc:creator>
            <pubDate>Thu, 02 Jun 2022 09:59:05 GMT</pubDate>
            <atom:updated>2022-06-02T10:09:44.753Z</atom:updated>
            <content:encoded><![CDATA[<p>本篇主要講述建立公司對外服務的開放生態圈的心路歷程，以及我們為什麼要做整合？</p><p>身為工程師每次都在使用各種平台的 console，什麼時候才能自己做一個呢？ 這是我在協助串接第三方時，常常會問自己的問題。</p><p>也就是有這樣的想法，才會有今天的小成果，那就讓我們來瞧瞧從 0 開始會遇到哪些挑戰吧！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uK0Yi91BsYBP6aESpI2Msw.png" /></figure><blockquote>很特別的是這個產品是由工程師們啟發並規劃設計的，因為以往 RD 都是接收需求方，所以能夠有此次規劃實驗產品經驗是很寶貴的。</blockquote><blockquote>接下來就開始摟！</blockquote><h4>開放平台是什麼？</h4><p>簡單來說，就是為了拆除大家一直認為街口就等於支付的印象標籤，開始打造更多外部服務的串接，並逐步將需求統整歸類，因而誕生開放平台。</p><blockquote>核心目標</blockquote><p><strong>如何讓第三方快速串接並減少人力成本是本次探討的重點。</strong></p><p>當接入的第三方愈多，我們擁有的樣本數愈多，此時我們可以：</p><ol><li>檢視開發與測試上的不足。</li><li>不斷修正產品服務的價值定位。</li></ol><p><em>有了開放服務，不就可以串接第三方了，那為什麼要特地做一個平台呢？</em></p><h4>沒有平台下的服務如何讓外部串接？</h4><p>假設某天 PM 提出擴增以下兩個服務需求</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*skheN-iop7xZEl8ig1nmxw.png" /></figure><p>當 RD 快速做完需求後，我們開始要跟第三方拉扯：</p><ol><li><strong>如何申請服務？</strong> 需要找到窗口並有一系列人工簽署流程才能申請</li><li><strong>如何串接服務？</strong> PM / RD 緊急產出應急的 PDF 文件，每當文件一改變需重新傳新的文檔給對方</li><li><strong>如何順利開發與測試？</strong> 給與各項測資及工具，並在雙方 RD 一來一往後完成</li><li><strong>如何上線至街口 App？</strong> 開發辛苦一波後，口頭告知窗口，幾月幾號要上線</li><li><strong>上線後發生問題？</strong> 對方窗口互相知會後，手動下架</li><li>隨著有新服務的誕生及突發狀況，（步驟 2,3,4,5) 會出現不斷 loop 地獄</li></ol><pre>為什麼我們沒有在當下思考後續問題，原因可能是新服務需要搶先釋出，測試市場反應與可不可行，這導致許多服務都是這樣來的。</pre><pre>當新服務過了一年後，也就成了無法隨意割捨的歷史包袱，可能有著嚴重耦合的關係，未來要整合會非常辛苦。</pre><p>依照目前流程，串接一個服務都得耗費大量人工成本來解決問題</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*plLku0EiNWyZ1Tzz.png" /></figure><p><em>於是乎為了解決一直被擺爛的問題，開始思考如何建置一個平台讓外部使用者可以無障礙串接。</em></p><h4>列出開放平台有哪些要素？</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*DgsWmh3szbHITUKJ.png" /></figure><ul><li><strong>開放能力蒐集:</strong> 豐富開放能力，吸引他們與我們串接，擴增生態圈</li><li><strong>服務解耦:</strong> 無論是舊有服務的依賴，或是新服務的擴建，需要避免嚴重耦合</li><li><strong>開發者平台:</strong> 開發者擁有的專屬空間，自定義其所有服務從申請、開發至上線</li><li><strong>沙箱測試:</strong> 快速完成測試並且確保覆蓋度</li><li><strong>開放文件:</strong> 順利且快速開發須具備完善的文件，減少窗口間的溝通成本</li><li><strong>串接格式統一:</strong> 將各項服務的串接方式統一化，快速接入新的服務</li></ul><p>太讚了，可以開始逐步實現上述功能以達到快速開發快速上架。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ePGEeYF2F8h_5THv.png" /></figure><blockquote>這麼多項目裡我們要從哪裡開始呢？</blockquote><p>我認為是 “<strong>開發者平台”</strong>。</p><p>有了平台可以讓外部方有更好的服務窗口，並趁機釐清一下我們有哪些服務需要提供並整合。</p><h4>開始畫出開發者平台輪廓</h4><p>首先我們有已知的兩項服務</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cIT4_RubkRXf2wq7oR3uSQ.png" /></figure><p>先列出腦中的功能，感覺列得煞有其事就可以開始畫一下：</p><pre>商品   <br><br>+ openweb<br>  - 個人<br>    - 通知設定<br>    - 信箱<br>  - 應用程式<br>    - app1 (test)<br>      - 狀態：開發中 /  已發布<br>      - 設定<br>        - 基礎<br>          - 應用程式編號<br>          - 應用程式密鑰<br>          - 應用程式網域<br>          - 顯示名稱<br>          - 應用程式類別 tag<br>        - 進階<br>          - API 版本<br>          - 允許最低版本設定（checkbox 功能打勾 自動配置)<br>          - 安全性<br>            - 伺服器 ip 許可清單<br>            - 允許內開外來網域<br>            - 用戶端權杖<br>      - 角色<br>        - 管理員<br>        - 測試人員<br>        - 開發人員<br>        - 測試用戶<br>      - manifest<br>      - 發布<br>      - 服務 provider<br>        - 埋點數據追蹤<br>        - 要求授權頁面<br>      - 收件夾<br>      - 申請核可上版<br>        - 上線位置(街口 UAT APP / 街口 APP)<br>        - 審核流程<br>          - 審核要求列點<br>            - 打勾<br>            - 按確認<br>          - 成功/失敗：送通知信到收件夾及 email<br>      - 快速入門<br>    - app2 (prod) - 可以 clone 一份出來<br>+ OAuth</pre><p>此時自己在腦中走一遍圖像流程，也許會看到一些問題：</p><ul><li><strong>服務的應用程式底下是否會用到其他服務？</strong> ex: Openweb 底下可能會用到 OAuth Login</li><li><strong>畫這張圖時，是否仍然在用既有功能的角度規劃？</strong> 應該跳脫原有方向，假想自己是開發者的角度</li><li><strong>在有限時間下我能全部功能做完嗎？</strong> 先切割階段性需求，再產出 prototype 不斷往回修正</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/851/0*KnuDxGgpEYOZ4phq.png" /></figure><p>此時我們需要簡化需求，確認我們的方向是成功的，努力才不會白費。</p><pre>應用程式   +新增應用程式<br>---<br>+ 設定<br> - 基本<br>+ 發布<br> - 最新發布<br> - 歷史發布<br>+ 服務<br> - Openweb<br>  - 基本<br> - OAuth<br>  - 基本<br>  - 安全性</pre><blockquote>新的 wireframe，不但解決了上述問題，看起來更加合理，應用程式之於服務可以做更多事情</blockquote><ul><li>假如我是第三方開發者，我想在我應用裡開啟 Openweb, 並在任何時候使用 OAuth 登入，且加入購買商品功能時可以用 OnlinePay 付款。</li><li>當所有服務不再衝突而且可以用一句話完美呈現，我認為他就是一個正確的方向。</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*eBMZY468z2r6fFQo.png" /></figure><h4>為開發者平台加入登入機制</h4><p>講登入前我們先想一下這個產品定位是 b2b or b2c ??</p><p>我的想法是，如果目標是人人都可以是開發者，那沒有比用自家帳號做登入還棒的事了，既然有 App 又有掃 Qrcode 的功能，何樂而不為呢！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/961/0*alhW56X69NX6nvmF.png" /></figure><p>登入使用街口帳號的好處是，我們可以掌控開發者平台接下來的操作都是屬於這隻手機的帳戶，意思是將來任何與街口 App 的服務都可以與開發者平台的帳號做連動。</p><h4>開發環境的多樣性</h4><p>當登入開發者平台時，我們可以開始開發，並在測試街口 APP 上看到開發中的服務，當我們希望這個服務可以上架到正式站 APP 時，我們需要走部署正式環境流程，也就是：</p><p><strong>開發模式 to 發布模式</strong></p><p>(以上這兩個模式，需要打的 API 環境是不相同的）</p><p>以下可以看出新的方式開發者平台取代窗口，且平台能同時處理兩種環境，即是：開發與正式環境</p><p>對外的開發者平台不會分兩個平台環境，因此可以想像平台環境複雜度是高的。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*xw4nQZwhJs9keeOx.png" /></figure><blockquote>正式站即開發站</blockquote><p>會有上述的環境複雜度，是由於舊有流程若有支付的需求無法動到正式站資料，因此我們需要保留空間，即使開發與正式分離，也可以透過不同模式處理不同環境下的處理，但未來最好方式是：</p><ul><li>一個開發者平台</li><li>一個街口 App</li></ul><p>當我們可以使用一個街口 APP 進行開發至上架，不但減少很多開發成本，也能讓開發流程更加順暢，but 前提是所有服務都能有效整合。</p><h4>正式流程的發布</h4><p>當開發者完成開發，會需要一個發布正式站功能，不需要讓開發者直接對窗口，我們為開發者每次發佈的版本做個紀錄，視情況需求還可以做個 rollback (當然這還不在本次規劃中)</p><p>首先需要有個畫面：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/682/0*5b7L3fZjgOLw7R2U.png" /></figure><p>側選單為</p><pre>- 發布<br>  - 最新發布 (建立新發布，審核成功後，由後台部署)<br>  - 歷史發布（存放每個版本的版號，及要部署內容）</pre><blockquote>正式發佈流程</blockquote><p>發布審核通過後，需要做一系列的 clone 行為， 將原先在開發環境有過的流程，在開發者平台的 deploy mode 也走一次，才算完成部署。</p><ul><li>模式切換：dev mode -&gt; deploy mode</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/892/0*AGW6kHY_2lz8DEWd.png" /></figure><p>看到這邊的讀者們，是否有個疑問，這樣後台也要再做一次前台要做的事情，豈不是要維護兩套機制？？</p><p>是的，接下會為大家解釋我們怎麼解決的。</p><h4>前後台業務邏輯相似</h4><p>在開發後台時，常常有些功能會與前台重疊。舉例來說：</p><blockquote>如果看了上述的正式發布流程，我們要怎麼實作比較好？</blockquote><blockquote>讓後台可以 clone 原本開發者在前台的操作行為</blockquote><ol><li>後台再開發一次要上正式部署的主要幾隻 function ？</li><li>前台開 api 給後台呼叫？ (可惜的是有些特定 api 前台是沒有權限呼叫的)</li><li>部分用前台 api，部分後台自己開發？</li><li>開一個共用服務 service?</li></ol><p>答：我選擇 (4) 的變形</p><p>那我不希望維護更多的機器，是不是有辦法做一個共用模組呢？</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*1Kw-sitolxlkg-Pd.png" /><figcaption>模組與平台互動大概是這樣的模式</figcaption></figure><blockquote>共用模組的定位</blockquote><ol><li>建立 db setting/migration</li><li>操作所有 db function</li><li>商業邏輯 api</li></ol><pre>DB 集中管理：原先不管是前台還是後台，都需要有各自 db 設定<br>商業邏輯抽離：各自專案不會存在各自維護的邏輯，或是兩專案沒有同步到的問題</pre><p>剩下的是我們要用什麼工具呢？</p><p>最後選擇是 <a href="https://typegraphql.com/"><strong>typegraphql</strong></a></p><p>到這邊很多人會問，咦？這樣不是多一個 service 要維護嗎？<br>因為 graphql 通常會跑在一個 server, ex: apollo server</p><p>沒錯，但是何嘗不能把 graphql 當成一個 library 呢？<br>讓前後台依賴這個套件，我們就不需要特別開啟一個服務多一個成本了。<br>太好了這個想法看起來實驗成功！也是我們現在的 @jk/opendql</p><blockquote>如果今天 QA 要測試業務邏輯，也可以透過 apollo server，並且前後台也一起測到了，因為他們都吃同一隻 api 呀！實在是太方便了</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*9zvGLmJMEtEeK0Vg.png" /></figure><p>有了 @jk/opendql 我們的分層更加清晰，彼此專案不會不知道彼此在做什麼事，你今天需要什麼東西你就去模組拿取，並且當模組的開發模式建立完畢後，與你一同開發的夥伴也會很好上手。</p><h4>管理服務多樣化，沒有結束的一天</h4><p>講到服務，這算是想解決也很困難的一環，從街口公司創立開始的服務，到現在新開發的服務，你要怎麼樣才能夠將其整合，想到就十分頭痛啊…</p><p>假設以下是目前要整合的服務</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fpv-4tPco__chUpLv5PoyA.png" /></figure><p><strong>歸納問題</strong></p><blockquote>1. 不是所有服務都有 Gateway，有的話：</blockquote><ul><li>申請服務時需要填寫 IP 白名單</li><li>前端實作不同 Gateway 註冊/更新方法</li><li>不同服務之間，可能使用相同 Gateway</li><li>不同開發模式 mode (dev/deploy) 實作</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/652/0*ylNXn9YsPeeCRnsC.png" /></figure><blockquote>2. 依賴項目完全不同</blockquote><ul><li>各項服務無法共用邏輯</li><li>需區分服務 table</li></ul><blockquote>3. 後端 Gateway 重構</blockquote><ul><li>統一呼叫及回傳邏輯</li><li>釐清內部商業邏輯依賴複雜關係</li></ul><blockquote>4. 既有後台的服務定位</blockquote><ul><li>(理想) 從既有後台拔除，整併至開發者平台</li><li>(實際) 部分拔除，部分整併</li></ul><p>上述講得很簡單其實有很多是現在做不到的，也是我們為什麼一直沒好好做整合的原因之一，此時推行者就扮演很重要的角色了。</p><p>講到這邊相信很多讀者快睡著了ＸＤＤ</p><p>來一點 Demo 吧！</p><blockquote>登入開發者平台</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*U3fcOniXtdUzjvK-.png" /></figure><blockquote>建立新應用程式</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*oXy1MBTxAodBe_Sb.gif" /></figure><blockquote>發佈到正式站</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*C2e3b69eX4GnfaJE.gif" /></figure><p>簡單的幾個功能，其實背後卻耗費了我們很多心力整合，在開發者體驗上呢，我們先致力於將所有人工處理自動化，並在未來新的服務加入時，可以建立在相同的規範底下。</p><p>未來的開發者平台，我們將有更多串接服務，並添加自動化測試項目，提高街口開發者的人數，讓街口生態圈可以逐步建立起來。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*e9-_pdWYpqcBwgNt.jpg" /><figcaption>努力了五個多月，我們是不是快看到曙光了ＸＤＤ</figcaption></figure><p><em>之後還會有相關文章，有興趣的人可以繼續 follow 呦！</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1db1402a550d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/jkopay-frontend/%E5%BE%9E-0-%E9%96%8B%E5%A7%8B%E7%9A%84%E9%96%8B%E6%94%BE%E7%94%9F%E6%85%8B%E5%9C%88-1db1402a550d">從 0 開始的開放生態圈</a> was originally published in <a href="https://medium.com/jkopay-frontend">jkopay@frontend</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>