只需6步，教你從零開發一個簽到小程式
摘要：針對於具備瞬時流量、業務場景比較簡單的小程式，開發者藉助FunctionGraph，可以方便快捷的搭建一個健壯的小程式後台。
本文分享自華為雲社區《智慧校園想搞好，FunctionGraph少不了——從零開發簽到小程式so easy!》，作者： 一隻程式猿。
背景
華為romalab實驗室在構建智慧教育領域app時，以FunctionGraph為試點，嘗試基於FunctionGraph雲函數開發一個簽到小程式。針對於具備瞬時流量、業務場景比較簡單的小程式，開發者藉助FunctionGraph，可以方便快捷的搭建一個健壯的小程式後台。
免登方案設計與前後端通訊邏輯
方案概述
App在登錄以後，才會打開小程式。如果小程式和app的用戶體系一致，用戶就不用再次登錄。在首次訪問小程式的時候，調用智慧校園app的免登介面，獲取用戶資訊，然後小程式構建自己的登錄狀態。由於雲函數本身屬於無狀態的服務，需要藉助授權伺服器（或者簽發jwt）實現自己的介面認證。
小程式在調用後台業務介面時，攜帶票據。
交互流程圖
(註：智慧校園app是基於華為內部的移動使能平台OneMobile構建，此處的OneMobile就可以理解為智慧校園app)
流程描述
流程描述：
- 打開簽到小程式，調用getToken()獲取ssoTikect票據資訊
- 小程式將ssoTicket傳入到認證函數A中，在A中去調用智慧校園app的開放平台介面，根據ssoTicket獲得當前的用戶資訊
- 拿到用戶資訊以後，根據該用戶資訊，生成票據token ，返還給小程式
- 小程式調用業務函數B，在請求中攜帶token
- 業務函數B在拿到請求以後，校驗token、換取用戶資訊
- 校驗通過，根據獲取的用戶資訊，執行業務功能，返還結果
業務實現
角色許可權管理策略
智慧校園app本身對小程式有著嚴格的許可權控制體系，可以在用戶、組織、崗位等維度，對小程式的可見性進行控制。由於簽到打卡這個業務場景比較簡單，且人員有著明顯的角色特徵，老師設置簽到規則，學生掃碼進行簽到。
結合當前的現狀，此次簽到小程式不再單獨構建自己的許可權管理體系，而是依託於智慧校園app本身的許可權體系。提供兩個小程式，一個是教師使用的「教師上課點名」小程式，用於協助老師生成簽到二維碼。一個是「簽到打卡」小程式，用於學生上課簽到。由智慧校園app在入口處對小程式的使用者進行管控。
App掃碼簽到實現
如何簽到
簽到是通過掃描二維碼進行簽到，在掃碼的時候，將掃碼得到的資訊，傳遞到後台，後台對二維碼中的課程資訊與簽到規則進行比對後，返還簽到結果。小程式根據不同的簽到結果，給用戶展示不同的頁面。
如何掃碼
當前掃碼的入口有兩個，一個在小程式內部，一個在app的右上角。二者調用的都是系統的掃碼能力。
由於在app上掃碼能夠進入簽到小程式並進行簽到，就需要簽到二維碼不僅僅要攜帶課程資訊，同時也要攜帶要打開小程式的資訊。
如何實現掃碼進入小程式
智慧校園app的掃一掃能力，預製了一些通用的能力，當掃碼得到的結果是某一個固定類型的數據格式，就會自動完成一些操作。
如掃碼能識別打開小程式的數據格式為：native://openapp?data={"appid":"88157779"}，而打開小程式的能力，其實是封裝了jssdk的xm.openApp()的能力。xm.openApp()允許開發者能在一個小程式裡面打開另外一個小程式。
App掃碼簽到程式碼實現流程圖
FunctionGraph實現簽到業務
開發函數支援多種語言類型，如nodejs、python、java等。後端邏輯中，除了普通業務邏輯（如跟資料庫交互）之外，最主要的是跟智慧校園app的交互，如獲取用戶資訊。交互形式是介面調用，可以直接引用封裝好的客戶端來實現，以nodejs開發語言為例，直接引入npm包即可。
開發後端函數邏輯
認證函數
App在登錄以後，才會打開小程式。如果小程式和app的用戶體系一致，用戶就不用再次登錄。而小程式如何在不登錄的情況下想要拿到當前使用該App的用戶，就需要藉助app的介面，實現免登。認證函數的作用就是獲取當前app的使用者，並且能夠簽發小程式自己的自定義登錄狀態，如簽發一個jwt
認證函數的入參為小程式前台從app獲取到的ssoTicket。
具體實現如下：
1. 獲取智慧校園app的api調用SDK程式碼，執行npm pack打包，生成OneMobileSDK-0.0.1.tgz, 在新項目中安裝該依賴npm install OneMobileSDK-0.0.1.tgz，然後將node-modules文件壓縮成zip，上傳到FunctionGraph的依賴倉庫中去。在創建函數時添加該依賴。
a.創建依賴包
b.上傳依賴文件
c.添加依賴
2. 參照步驟1，將mysql-node的依賴，加入到FG的依賴倉庫中去，在創建函數時添加該依賴。
3.調用OneMobileBaseSDK裡面的getUserInfoBySsoTicket(ssoTicket)，獲取用戶資訊
a.在程式碼中引用SDK
b.調用介面
4. 校驗用戶資訊。
5. 根據獲取到的用戶資訊，生成業務介面的調用憑證，返還給小程式前台。
簽到函數
關於簽到函數，在操作流程上面和認證函數相似，這裡不做過多的闡述。其主體的流程如下：
1. 創建函數時，添加mysql-node相關依賴
2. 校驗簽到資訊
3. 將簽到結果入庫
4. 返還簽到結果給小程式
介面開放
函數開發完成以後，需要將函數開放給小程式使用，具體操作步驟如下。
1. 在函數詳情頁面，點擊觸發器頁簽
2.創建觸發器，觸發器類型選擇APIG。由於程式碼中有認證邏輯，所以網關層不做認證
3.獲取創建的APIG調用地址，小程式前端即可根據業務需要，調用相應的rest介面。
總結
此次小程式開發識別到的問題
智慧校園app
- FullCode模式下，頁面的碎片化問題亟待解決，智慧校園app缺少頁面預覽工具以及通用的組件庫。
- 免登介面只能在容器中才能調用，而調試的時候部分介面強依賴ssoTicket，只能通過集成vconsole，然後在手機中執行getToken()指令才可以獲取ssoTicket。
- 公司內部沒有調試環境，公網調測，每次都需要傳包到開放平台，操作起來很麻煩。
- 文檔仍需補齊，一些非常規能力，如掃碼打開小程式功能，沒有相應的文檔支撐
- 缺少支撐一套前端調測多套環境的解決方案
FunctionGraph
- 程式碼分布在3個地方：前台程式碼由智慧校園app託管運行、網關api直接配置在APIG、函數程式碼在Function里。功能調試成功後，如果有一鍵歸檔（或者下載）功能或者下載工具會比較好。同樣，希望也有一鍵部署功能的工具。
- 當前加密配置粒度是單個函數，以連接資料庫為例，多個函數連接同一個資料庫，需要在每個函數中都增加資料庫帳號密碼加密配置，繁瑣而且無法保證數據一致。
能力待提升
智慧校園app
- 參照微信，求助IDE團隊，為提供小程式開發工具
- 參照welink為開發者提供開放平台的調測工具，並能一鍵生成不同語言的介面調用程式碼
- 構建小程式專門的雲開發平台，小程式流量走App基座的網關，打通各個雲服務，服務之間鑒權由開發平台承接，小程式開發者更專註於業務能力構建。
FunctionGraph
- 能夠通過函數應用生命周期管理功能解決函數開發、部署、發布（到APIG）一體化的問題
- 能夠實現用戶或租戶級別的配置共享
參考文檔：
//support.huaweicloud.com/usermanual-romalab/lab_03_0001.html
//www.huaweicloud.com/product/functiongraph.html
