# 國光客運 project

###### tags: `國光客運`

:::danger
### 問題單
- [國光APP 對票務問題單](https://docs.google.com/spreadsheets/d/1nGo0_mSys8uufZejWAxsLJTzb_PUGy8GDX5di7JAfHA/edit#gid=0)
- [國光客運行動 APP - 問題單_20200331](https://docs.google.com/spreadsheets/d/1ZpfwRlAYdJO-C0zvUV3re3-zxhKgfUH5WaqeGw5A8Es/edit#gid=0)
- [【國光APP】問題單_20200331](https://docs.google.com/spreadsheets/d/1ZpfwRlAYdJO-C0zvUV3re3-zxhKgfUH5WaqeGw5A8Es/edit#gid=0)
:::

:::success
### 翻譯字串表
- [國光網訂翻譯檔](https://docs.google.com/spreadsheets/d/1g50G-SbL4BOncQmIGMgiRg_dNfUM-9M8iVfwWBNmB3o/edit#gid=1422406532)
- [國光客運行動 App - 本地化字串表](https://docs.google.com/spreadsheets/d/1Tkq3SkUVVeHZuz3Yi66nqS5CVND_gUsrEzUQifk1q-E/edit#gid=1063768579)
:::

:::warning
### 開發相關文件
- [國光客運行動 APP - 開發進度表 ](https://docs.google.com/spreadsheets/d/18D72yMMLTH5MIunXVf55dZppPbys_OxvUAMZMlllgjo/edit#gid=0)
- [國光客運行動 APP - API 一覽表 ](https://docs.google.com/spreadsheets/d/1FqQW17NpAznImsqvRwXLEgD3v2wmuzL9Q-Ght4pnNSM/edit#gid=338965732)
- [~~國光客運行動 APP - API 格式對應（JSON範例（範例幾乎都已過時，沒有更新））~~](https://drive.google.com/drive/folders/1gFDbNoCigsFTzx3gr7wcV-RnaqAIaADK)
- [國光客運行動 APP - 後台管理](http://192.168.0.166/KuoKuang/Managepanel/Login/Default.aspx)
- [國光客運行動 APP - 後台管理 (6月 SIT)](http://211.21.141.181/KuoKuang/Managepanel/Login/Default.aspx)
- [國光客運行動 APP - 後台管理 (8月 UAT)](https://211.21.141.182/Managepanel/Login/Default.aspx)
- [國光客運行動 APP_票務API_V01_20200207](https://docs.google.com/spreadsheets/d/1-fYAtYL-O1mcmOal2enUSkQqiz2OCysXubcI4BEN-5k/edit#gid=444386674)
- [~~國光客運行動 APP - API 一覽表(舊版)~~](https://docs.google.com/spreadsheets/d/18FHlZAHLduzJ9uulBmerWBVxGtVx4WEO0Q81h2kmOg8/edit#gid=1873254834)
- [國光客運使用手冊](https://hackmd.io/-n5J2Lc3QGGPgo5OoJkHSQ)
- [國光客運使用手冊（Google Doc）](https://docs.google.com/document/d/15gllOaNu2odRjgn9OqvtIUBXfimVDhzo4RqLMaBGxhA/edit?usp=sharing)
:::

:::info
~~05/04 結合測試 (國光Server + 票務介接)~~
~~05/11 測試 & Feedback~~
~~05/27 最終版測試~~
~~06/01 APP 上線 (審核時間估約7個工作天)~~
:::

## 專案 app 規格
- iOS 11 and later
- 「中/英/日/韓」多國語系(English base)
- 推播: 行事曆推播、本地推播、遠端推播

## PTX API

**PTX 介接資料如下，請妥善保存並勿使用於國光以外專案，謝謝。**
- 網址：https://ptx.transportdata.tw/PTX/
- 登入帳號: kuokuang
- 登入密碼: 國光汽車
- 基礎資料服務(L1) ( iOS app used )
- APP ID: efed56d64f384aa5b404206af6b7a62b
- APP Key: vVWFIZ0e27CYQpGHY9PDJV3P624
- 基礎加值服務(L2) ( android app used )
- APP ID: d4b2f5dc56ee45f499cd6eebc55d744b
- APP Key: ZN7LmZ7eQMlKDfwq8PfdqQmOAmY

## AES 加密相關資訊
- KEY：KU0KUANGKU0KUANG
- IV：Z999675OZ999675O

## 第三方網路服務
1. Firebase/Analytics
2. GoogleMap SDK
3. PTX webAPI

## ---
## 會議紀錄

## Apr.30 口頭討論記錄 (11:55~11:59)
1. api010(設定)裡的開關設定，會再新增 google map 能不能使用。
2. app 在需要使用 map 的地方需要先判斷這個開關的設定。
3. 若該開關設定為開，但是 google map SDK 不能使用的話，一樣要跳出對話窗阻止使用者使用 map 相關的功能。

## Apr.16 口頭討論記錄 (11:50~11:58)
1. app內的範圍，凡事有卡片樣式的地方，只要後端有給路線編號，UI 就需要顯示該路線編號。

## Apr.14 口頭討論記錄 (17:10~17:25)
1. 訂票查詢的細項頁，上半部資訊多一行顯示該筆訂單的所有座位號碼。
2. 交易紀錄的細項頁，下方票券卡片。如果沒有座位號，就不要顯示（不佔位）。

## Apr.01 會議紀錄 (17:10~17:58)

1. mobile 工程師給的開發預估日期進度太快了，PM 覺得工程師的進度沒辦法推那麼快，所以開會 sync 時程資訊。
2. PM 預估 4/10 後端會處理好信用卡網頁付款的功能，所以建議 mobile 可以 4/9, 4/10 與後端討論付款問題。
3. mobile 4/13 ~ 4/17 可以著手先完成購票流程
4. PM 預估 mobile 最晚 4/22 可以完成購票流程，整個 app 專案開發時程應該會延到五月中。
5. 協調 UI 元件太小，導致點擊操作的行為困難的問題。結論：工程師自行調整元件大小。
6. 協調 UI 元件跨行對齊問題。結論：設定固定寬度，在導入多國語後再去調整元件或是顯示用字串。

> 今日會議結論如下：
> ***欄位先採固定寬度***，之後套多國語系發現跑版，再行調整即可。
> 金流介接，我下禮拜會請Joy將格式開出來 (最晚4/10提供)。
> ***畫面上如果因為行高導致按鈕很難按，可自行拉高***。
> 按鈕寬度，由你們自行拿捏好點擊的寬度即可。
> 預計完成日請在下禮拜一先行評估給我。
> 進度100% 請先提供Betty測試。
> 部分頁面動畫效果被效能吃掉，請先忽略，功能流程先處理。
> 有些設計規則不會開到那麼詳細，再麻煩你們適當調整，
>
> 主旨 國光APP今日內部會議討論事項

## Feb.18 會議紀錄 (09:10~09:22)

1. api 編號 APP_A_00006, APP_A_00007, APP_A_00009 異動，將會加入公車站隸屬的區別(北區、中區、南區)。
2. 在使用者尚未選擇起訖乘車站時，app 預設選擇預設值。

## Feb.12 會議紀錄 (10:00~18:10)

1. `訂票時間` 與 `乘車時間` 切分成三個付款限制的規則(目前規則尚有漏洞，有待Cathy與國光討論)
1. 48hours 以上，限定須於乘車時間點往前推48小時前完成付款
2. 25hours 與 48hours 之間，限定須於當天晚上11點整前完成付款
3. 25hours 以內，限定一小時內需要完成付款
2. 回數票付款的票會出現在「」，他不可以更改班次、不可以分票、不可以取消班次。
3. 單組分票為及時分票，多組分票則需再詢問是否分給自己。
4. `臨櫃退票檢查資料`按鈕在分票的票種中不會顯示。
5. 退票須在票的右下角顯示已退票或主購者已退票
6. 設定頁面內的「票價資訊」需開啟 瀏覽器app 並使用「系統設定api」取得的 url 網址。

## Feb.11 會議紀錄 (10:00~18:10)

1. 購票流程中，填寫會員資料之後，點擊確定按鈕去使用 api 檢查是否有在黑名單之內。
2. 「訂單查詢」頁面，不會顯示座位號碼。因為伺服器取不到，且設計文件不會更新。
3. 如果訂購人已經是會員，則僅能使用自身的身分證購買車票。在非會員狀況下，才能使用他人身分證字號購買車票。
4. 回數票支付方式，app紀錄已經掃描過的有價回數票code，並於下次掃描時檢查是否重複。
5. 單程票 與 來回票 都可以做不同票種的混搭，例如 全票1張+孩童1張
6. android 跟 iOS 的本地化字串表，請統一譯本格式，提交給cathy。
7. 回數票方式付款，不行退款，故不顯示按鈕
8. `13_回數票 - 列表.jpg` visual design 新增區分 去/回 的文字描述
9. 確認付款後前往的頁面(`17_確認訂票資訊-2.jpg`)，不顯示返回按鈕

## Feb.10 會議記錄 (10:00~17:50)
1. 主要討論 web api 需要哪些功能，參見 [國光客運行動 APP API 一覽表 ](https://docs.google.com/spreadsheets/d/18FHlZAHLduzJ9uulBmerWBVxGtVx4WEO0Q81h2kmOg8/edit#gid=1873254834)
2. 與 android 同步。網路層錯誤不重試、請求超時等問題拋到 UI 顯示。
3. app 使用條款將以網頁的方式顯示，不包含按鈕，僅純粹的條款內容。
4. app 使用導覽的圖片，將需以圖片網址來顯示圖片。
5. 主頁面「緊急訊息」，以跑馬燈方式顯示，水平移動完時，再由上到下換至下一則。
6. 「全部訊息」的部分，app 需於本地端記錄用戶已閱讀。
7. 部分 api 的 response 會包含四種語言，目前有 伺服器錯誤訊息 與 公車站牌名稱
8. 使用「手機資訊」api 後獲得 `login_token`，其他所有的 api 都需使用該 token。
9. 購票流程中，「最愛路線」不主動檢查各路線是否於使用當下有效，也不主動刪除，僅以 `alert` 方式告知用戶。故若用戶再次選取同一路線，會再顯示相同的 `alert`。
10. 公司並未使用專案代號為專案命名。-> `KKCB0210`
11. 開發 bundle id 使用`群廣公司`的。上架才轉換成`國光客運`的。

## Feb.03 會議記錄 (17:10~18:55)
1. 確定開工拉！
2. 對外(國光客運) 5/8 開發完畢，要驗收
3. <span style="color:red">Cathy 要求 四月初 完成開發，內部測試驗收</span>
4. UI 版型可視為最終確定
5. 開發策略：以最少功能完成完整流程。e.g.支付方式先只支援一種
6. <span style="color:green">功能驗收：以「訂票服務」、「取票付款」為最重要功能，先做</span>
7. <span style="color:green">界面驗收：「首頁」、「列表」、「座位」為最重要功能，先做</span>
8. 界面實作準則以接近高鐵 app 為主
9. 「阿卡將 掃描後 圖片瀏覽 native 化」先在這兩天完成