# 【CHT智能稅務案】教學筆記 04：文件圖表表達方式的經驗分享
內容：文件圖表表達方式的經驗分享

---
[目錄](https://hackmd.io/Y7i9O4hCQu6xOJ94__PhNg)

[教學筆記 01：編碼、檔案、斷行字元、Excel、其他基礎知識介紹](https://hackmd.io/7-FajauqT62vXpxOViWzBw)
[教學筆記 02：Linux 指令介紹 ](https://hackmd.io/9D_WXaT3TsCaBrsOQKYdTw)
[教學筆記 03：awk 指令介紹](https://hackmd.io/PHZRjtQMRi2v9Z-u6bD6Tg)
教學筆記 04：文件圖表表達方式的經驗分享
[教學筆記 05：以 C 語言開發資料庫存取程式 (ECPG)](https://hackmd.io/4jh_5A51TfieovVipQqoXA)
[推薦書籍](https://hackmd.io/t7T5FxfmT3Kih-b7PRUZrA)
[補充教材](https://hackmd.io/w-BNpl_TSuysG4_qaGtmFg)

---

### 一、前言
* 圖優於表，表優於文字。
* 這裡要講的，並非資料視覺化 (資料 → 圖表 → 解釋現象 or 產生洞見(insight) → 幫助決策)，而是說明如何將自己本身的計畫、經驗、想法，以文件作為媒介傳達給其他人，而使用技巧的經驗分享。其目的通常是為了傳達自己的想法與規劃、客觀描述系統行為或程式規格、或說明並解決某些問題。
* 陳述制度、規範、流程時，「說」、「寫」、「做」要一致。
* 對於一份簡單的圖表，須考慮到：
* 目的 → 對象 → 選擇揭露資訊 → 選擇呈現方法/工具。
* 例如：流程圖 (說明流程，表達與時間/先後次序有關的概念)。
* 撰寫一份更複雜的文件時，須使用較有條理的結構來論述，此時須使用更多的文字與圖表來協助，常用的結構包含下列幾個段落：
* 前言 (Why)：背景介紹、動機和目的 (源自於某些痛點、需求)。
* 方法 (How)：使用技術、方法或理論、架構與設計方式、規格或細節的描述。
* 結果：評估方式與標準、預估/計算產生的效益、改善前後的比較。
* 例如：專案改善文件。
* 補充：對長者簡報時，字體可以大一點。
* 強調一下：撰寫文件是作為協助溝通的工具，而不是作為讓自己毋須與別人溝通的藉口。

#### 範例 1：vi 編輯器的模式切換 (from 鳥哥私房菜)
* 目的：理解 vi 編輯器的模式之間如何切換。
* 對象：一般學習者。
* 揭露資訊：模式的種類、預設的模式、如何彼此切換。
網址：https://i.imgur.com/2wNs40m.gif
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 2：乙測環境 Trinity 原始碼備份工具 (from 教學筆記 02－作業四)
* 目的：說明作業的程式規格。
* 對象：本專案開發人員。
* 揭露資訊：程式規格 (使用方式、連線順序/方向、相關資訊)。
* 未揭露資訊：連線帳密、個人目錄名稱。
* 繪製工具：Visio。
網址：https://i.imgur.com/dhfm9iG.png
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 3：花東四天三夜出遊行程
* 目的：說明出遊的行程。
* 對象：一起出遊的夥伴。
* 揭露資訊：每日行程順序、地理位置。
* 繪製工具：Visio。
網址：https://i.imgur.com/Q1medjo.png
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 4：規劃演唱會當日行程表
* 目的：統籌集合、出發的時間地點，並說明行程。
* 對象：參加活動的夥伴。
* 揭露資訊：時間點、發生事件、參與人員、花費時間長度、相關資訊。
* 繪製工具：Excel。
網址：https://i.imgur.com/8V56Xjl.jpg

---

### 二、常用工具
* 螢幕截圖工具：
* 剪取工具
* Windows Office 軟體
* Excel
* Power Point
* 技巧1：播放投影片時「拉近顯示」
* 技巧2：附上圖片物件
* Visio
* 心智圖軟體
* XMind：https://actsmind.com/blog/xmind/xmind3download
* Graphviz 繪圖軟體：https://graphviz.org/download/
* Icon 網站，例如：https://www.flaticon.com/

---

### 三、財稅案
特性：由本組的角度而言，本專案以開發工作為主，討論如何一步一步地解決過程中遇到的每項問題(痛點)。因此所產生的文件會比較注重在解釋目前有什麼困難(議題)、議題的種類、利用什麼方法改進。

#### 範例 1：需求的分類
* 目的：說明各種 ETL/UT 作業的開發需求來源。
* 對象：開發團隊本身。
* 揭露資訊：需求來源的種類、細項、處理方式、重要程度。
* 繪製工具：XMind。
網址：https://i.imgur.com/hDlGWpR.png

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 2：開發一致性的維護
* 目的：說明 ETL/UT 作業的開發一致性的維護機制。
* 對象：開發團隊本身。
* 揭露資訊：開發一致性的各部份元件、流程順序(數字標號)、自動化的部分(紅色框)。
* 繪製工具：Visio。
網址：https://i.imgur.com/izEZjpH.png

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 3：DDL Generator 程式架構圖
* 目的：說明構成 DDL Generator 工具每個模組的結構。
* 對象：開發團隊本身。
* 揭露資訊：模組數量/功能、模組中所包含的程式階層、與乙測環境的連線協定、執行時間。
* 繪製工具：Visio。
網址：https://i.imgur.com/RvzNuk8.png

※ DDL Generator 外觀：
網址：https://i.imgur.com/ibUQxRh.png

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 4：利用 Graphviz 繪製彙總表流程圖
* 目的：描述彙總表作業彼此間的相依性關係。
* 對象：開發團隊本身。
* 揭露資訊：
* 總圖：彙總表所有作業間的相依性。
* 範例1：彙總表相依性總圖(ALL)：[gen_sum_graph_v0.16_all.svg](https://drive.google.com/file/d/1FNdPlL1mbklrPDmQKXYvbdGlwL9g_Ney/view?usp=sharing)
* 範例2：彙總表相依性總圖(非營業稅)：[gen_sum_graph_v0.16_nobbi.svg](https://drive.google.com/file/d/1R8pJR2z7A3SoDJ_-Sjpmt0Qv4WGKsl3s/view?usp=sharing)
* 子圖：以單一作業為視角，描述其上下游的相依性作業。
網址：https://i.imgur.com/3043gc4.jpg
* 範例1：與 SBD_VAT_INQ_EXPORT_Y_SUMY_G0001 相關的上下游作業
網址：https://i.imgur.com/xjcXN92.png
* 範例2：與三等親作業相關之上下游作業
網址：https://i.imgur.com/0tAvOUN.png
* 繪製工具：Graphviz + awk

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 5：Trinity Decoder 使用方式
* 目的：說明 Trinity Decoder 工具的功能。
* 對象：開發團隊本身。
* 揭露資訊：Trinity Decoder 工具的程式結構、密文轉為明文的過程。
* 繪製工具：Visio。
網址：https://i.imgur.com/x62vg70.png

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 6：ETL作業開發方式比較 (教學筆記 03)
* 目的：比較傳統與利用awk自動產生程式碼的ETL作業開發方式
* 對象：開發團隊本身。
* 揭露資訊：兩種開發方式的比較、每個STEP在開發時的動作分解圖示(類似科學管理)。
* 繪製工具：網站抓圖 + Visio。
網址：https://i.imgur.com/Zxm1rCW.png

網址：https://i.imgur.com/Ab5sVl4.png

---

### 四、中油案
特性：本案傾向於解決專題性的問題。例如：建立責任中心資料超市，以計算會計毛利，使會計人員易於查詢與使用。
對象：中油各單位長官與專業人員。
功能：解釋資料來龍去脈、計算邏輯。
下載：油銷責任中心資料超市說明-1090312.pptx *<連結已移除>*

#### 範例 1：動機、分析原因、解決方案：
* 繪製工具：Visio。
網址：https://i.imgur.com/JKoud9g.png
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 2：資料關係說明：部分/階層/從屬
* 繪製工具：(不是我畫的)。
網址：https://i.imgur.com/lhia8wc.png
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 3：資料流程 & 資料分類 (粗略)
* 繪製工具：Visio。
網址：https://i.imgur.com/j0VOXBF.jpg
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 4：ER Model & 資料分類 (細部)
* 繪製工具：Visio。
網址：https://i.imgur.com/ejjCOC0.jpg
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 5.1：資料超市的計算邏輯 (下游欄位如何根據上游而計算出來)
* 繪製工具：Excel。

**※ 使用Power Point 小技巧：**
1. 圖片太大難以說明 ==> 「拉近顯示」功能。
2. 沒有「拉近顯示」功能 ==> 插入物件。
3. 過多的附加資訊 ==> 利用超連結至附件。
網址：https://i.imgur.com/vne8EaA.jpg
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#### 範例 5.2：資料超市的計算範例
* 繪製工具：Excel。

**※ 小技巧**：給予欄位編號 (A)、(B)、... 使得計算易於理解
網址：https://i.imgur.com/xyDJeb0.jpg

---

### 五、北分帳務處(內案)
以下以 CPVSP 卡務管理系統的改善案件作為說明範例：
下載：CPVSP預警機制-TL-1030620.pptx *<連結已移除>*
#### 範例 1：CPVSP 卡務管理系統的改善專案
* 專案說明：改善系統偶爾發生遺漏處理客戶儲值行為的缺點。
* 揭露資訊：簡介、專案目的、改善方案、作業流程說明。
* 對象：程式開發單位、其他業務配合單位。
* 繪製工具：Visio + Excel + Power Point。
1. 現況說明：
網址：https://i.imgur.com/bq5c2fq.png

2. 現有流程與待改善之處 → 產生痛點：
網址：https://i.imgur.com/XpJRHqK.png

3. 提出改善方案：
網址：https://i.imgur.com/3uzKhXE.png

4. 改善前後的案例說明：
網址：https://i.imgur.com/ZEPwSRE.png

網址：https://i.imgur.com/pet174F.png

---

### 六、大數據處(內案)

大數據處內部存在許多待解決的技術性議題，以下列舉一些已解決的技術型任務來說明：

#### 範例 1：小工具/小程式說明 (去除尾筆 + 檢查筆數)
* 目的：撰寫工具程式說明文件。
* 對象：該工具之所有使用者。
* 揭露資訊：輸出與輸入、參數說明。
* 繪製工具：Visio + Excel。
下載：檔案去尾筆功能設計-1070308.xlsx *<連結已移除>*
網址：https://i.imgur.com/0Xb42qW.png

#### 範例 2：網格資料套疊機制開發
* 目的：解決地圖網格搜尋效能不佳的問題。
* 對象：使用地圖網格之行銷/資料分析人員。
* 揭露資訊：緣由、解釋現有的搜尋方式為何效能不彰、解決方式：新的搜尋演算法、實驗結果。
* 繪製工具：Visio + Excel + Power Point。
下載：網格資料套疊機制開發.pptx *<連結已移除>*

---
~~以論文形式解決問題
緒論 (背景介紹、簡介、研究動機和目的(痛點、需求)、研究介紹)
相關文獻 (相關研究)
研究方法 (方法架構、實驗相關資料集、方法設計) (改善前後的比較)
實驗結果與分析 (效能評估測量標準、實驗結果分析)
結論與未來研究 (Future Work)~~

---