[實作筆記] 用 Github Rigstry 作自已的 Nuget Server

目標

使用 GitHub Package Registry 建立一個自已的 Nuget Server。

步驟

前置作業

申請

GitHub Package Registry 還在 Beta 階段,需要申請才能取得試用。
過程並不複雜,在此不贅述,請再自行查找網路。

建立 Repository

實測的結果,nuget push 並無法建立 Repository ,
並且會導致發佈失敗,故必需 優先建立 Packages 的 Repository
Repository 可以包含多個專案,並獨立發佈(發佈指令詳見下文)。

建立 .nuget 文檔

請以專案名稱命名檔案,ex:Marsen.Utility.nuget
請依實際情況調整 idversionprojectUrl
特別是 version 代表的是 Packages 的版本
更多訊息請參考

1
2
3
4
5
6
7
8
9
10
11
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
<metadata>
<id>Marsen.Utility</id>
<version>1.0.0</version>
<authors>Marsen Lin</authors>
<description>Marsen Utility</description>
<language>en-US</language>
<projectUrl>https://github.com/marsen/Marsen.Nuget.Packages</projectUrl>
</metadata>
</package>

取得授權 token

請參考Configuring NuGet for use with GitHub Package Registry 或是 Creating a personal access token for the command line
至少需要以下權限

  • repo Full control of private repositories
    • repo:status Access commit status
    • repo_deployment Access deployment status
    • public_repo Access public repositories
    • repo:invite Access repository invitations
  • write:packages Upload packages to github package registry
  • read:packages Download packages from github package registry

下載/安裝/設定 Nuget

  1. 下載 Latest Nuget,取得 nuget.exe
  2. 設定 Path (以 Windows 10 為例)
    • 控制台
    • 系統設定>進階設定
    • 環境變數 > Path
  3. 設定完 path 記得重啟 Terminal Session

新增 Nuget Source

新增

Name 、 Source 與 UserName 網址請依實際調整參數
Password 請代入 token

1
2
3
nuget sources Add -Name "Marsen.Nuget sources" /
-Source "https://nuget.pkg.github.com/marsen/index.json" /
-UserName marsen -Password 3*******************************1

設定 Key

1
nuget setapikey 3*******************************1 -Source "Marsen Nuget Sources"

刪除

1
nuget sources Remove -Name "Marsen.Nuget sources"

查詢

1
nuget sources

打包

1
nuget pack Marsen.Package.csproj -OutputDirectory c:\local_nugets

發佈

1
nuget push c:\local_nugets\Marsen.Utility.1.0.0.nupkg -Source "Marsen Nuget Sources"

結果

GitHub Package Registry

下一步

  1. 每次都要打版號好麻煩,能不能自動化 ?
  2. 透過 CI 建立,並傳入參數作為版號 ?
  3. 每次 commit 只要通過 UT 測試就發佈.beta版 ? CI 發佈正式版 ?

more…

參考

(fin)

[工作筆記] 2019 常用工具整理

輸入法

  • 無蝦米 (加速打字,未來不太看好,考慮更換中…)

網站

PC 工具

  • 文字比較工具
    • Win Merge
  • Git GUI
    • GitKraken(需收費)
    • Fork
  • Carnac
    • 顯示鍵盤點擊歷程
  • Windows 用 Launchers
    • Wox
  • 快速搜尋文件
    • Agent Ransack
  • 跨 PC 存放檔案
    • Dropbox
  • 截圖錄影工具
    • ShareX
    • Skitch
  • 遠端桌面管理
    • Remote Desktop Manager Free (試用中)
    • Remote Desktop Connection Manager

筆記工具

  • Evernote
    • 專案分類
    • 職涯規劃
    • 已完成的項目
  • Notion
    • GTD
    • 周記劃
  • HackMD
    • 暫存的記錄
    • 會議/社群活動即時記錄
    • Blog 草稿
    • 共筆
  • Blog
    • 技術實作記錄
    • 社群活動記錄

瀏覽器 & 外掛

95% 使用 Chrome ,4% 使用 FireFox,極少情況使用其它瀏覽器

Chrome

  • tampermonkey
    • 撰寫網頁小工具
  • One Tab
    • 快速收攏大量分頁,常用在特殊主題搜尋的暫存
  • Clear Cach
    • 清快取
  • grammarly
    • 拼字校正
  • Bitbucket Diff Tree
    • Bitbucket PR 差異比較
  • JSONView
    • 當 response 為 json 時更為好讀
  • LastPass: Free Password Manager
    • 密碼管理
  • Wappalyzer
    • 分析網站使用的框架與技術
  • cVim
    • 使用 Vim 的習慣操作網頁

文件編輯器

  • Vim
  • NotePad++
  • 記事本

個人工具

  • 桌面記時器 DesktopTimer.exe

開發工具

VS Code

  • ejs
  • C#
  • Chinese (Traditional) Language Pack for Visual Studio Code
  • Cucumber (Gherkin) Full Support
  • Docker
  • Git History
  • Git Project Manager
  • GitLens — Git supercharged
  • JSON Tools
  • Markdown All in One
  • markdownlint
  • Paste URL
  • PowerShell
  • Relative Line Numbers
  • Remote - WSL
  • REST Client
  • Settings Sync
  • Snippets and Syntax Highlight for Gherkin (Cucumber)
  • Sort lines
  • SQL Server (mssql)
  • stylus
  • Swagger Viewer
  • Unique Lines
  • Vim
  • vscode-icons
  • Vue 2 Snippets

Microsoft Visual Studio Professional 2017 (預計升到 2019)

  • OzCode (付費軟體)
    • 增強除錯
  • ReSharper Ultimate (付費軟體)
    • dotCover (檢驗覆蓋率,需另外安裝)
    • 強化重構/測試
  • ILSpy
    • 反組譯工具
  • SpecFlow for Visual Studio 2017
    • BDD 開發
  • GhostDoc Community for VS2017 and Later (免費版)
    • 自動加入註解
  • ResXManger
    • 多語系 Resource 檔編輯
  • VsVim
    • Vim 支援工具
  • Snippet Designer
    • Snippet 編輯管理
  • Style Cop
    • 代碼審查
  • xUnit.net.TestGenerator
    • 加速寫單元測試(xUnit)
  • CodeMaid
    • 代碼審查 & 複雜度
  • Visual F# Tools [實驗性]
  • Roslyn Expression Evaluators [實驗性]
  • Roslyn Interactive Componets [實驗性]
  • Roslyn Language Service [實驗性]
  • Microsoft Library Manager
  • Develop Automated Tests VS2017
  • Visual Commander
  • Fix Mixed Tabs
  • Microsoft Visual Studio 測試平台
  • Microsoft Visual Studio Installer Projects
  • Microsoft Azure WebJobs 工具
  • Cloud Explorer for VS 2017

LINQPad 5 (付費)

快速檢驗 C# 語法的小工具

Terminal

  • Cmder | Console Emulator
  • Windows Powershell ISE

資料庫管理

  • Redis Desktop Manager (Redis)
  • SSMS (MsSQL)
  • Robo 3T (Mongo DB)

容器管理

  • Docker Desktop
  • Kitematic

(未完待續)

[實作筆記] 利用 .Net Core Project Template 加速開發

要知道的事

這篇是實作的紀錄,大部份資源都參考至 MSDN 線上文件
那裡會有更新更完整的文件支援。

前情提要

專案上作了一個跨市場的服務,以提供主服務對不同市場金流的支援。
首先有一個國際化的專案,用來制定 API 層級的標準化,
而在不同的市場,例如:馬來西亞、香港、烏克蘭等…。
在地化的項目需要建立外掛(Plugin)專案的方式進行開發…

建立一個全新的 Plugin 專案是一件麻煩的事,
首先要加入專案,再來要實作相對應的介面,
這裡指的是建立一個類別,然後繼承一堆介面,
ex:IPay、IRefund、ICheck…等,
並不包含商務邏輯的開發與實際的 API 或 SDK 串接,
而在公司的標準之下,我還必須引入一堆參考或 Nuget 套件。
同時因為國際化專案採用動態載入的機制,
有一些細節準則需要由 Plugin 專案遵循,才不會引發異常或 Runtime Error。

實作筆記

建立專案樣版 SOP

  1. 建立樣版資料夾,比如說 Blog.Plugin.Template

  2. 準備好你的專案檔與相關的必要檔案

    這裡的檔案你可以拿現成專案作修改,我個人是從頭手工打造了一個全新的Plugin。
    並且去除所有不相關不必要的資料夾、檔案、參考與程式。
    簡單的來說,這是一個殼、一個專案樣版(Template)而已。
    接下來會遇到的問題「參數化」,比如說專案的名稱,資料夾的名稱,或是程式本身的內容,會依據不同的 Plugin 專案而改變的部份。
    我把它分為檔案層級與內容層級的參數化。

    • 檔案層級參數化

      表示檔案名稱或是資料夾名稱等,我有動態抽換的需求。
      我會用 F-* 作為參數名稱,比如說 F-plugin-name
      接下來將資料夾或檔案名稱想被抽換的部份改成參數名稱就好,參考下圖。
      檔案層級參數化

    • 內容層級參數化

      比如說 Class Name、Namespace、建構子或方法,甚至是預設的註解,
      簡單的說只要是檔案內容相關的文字有必要被抽換,我就會使用這個參數設定。
      我會直接使用 C-* 參數名稱,比如說 C-plugin-name。 下面是個例子。
      內容層級參數化

  3. 建立 .template.config 資料夾

  4. .template.config 建立 template.json
    template.json 可以說是整個專案樣版的靈魂部份,更多的訊息可以在 MSDN 找到,
    我只說明 symbols 節點的部份,它用來方置參數的訊息,所以需要建立一個自訂義的子節點,在這裡我命名為 pluginName,同時指定他的 type 為 parameter,
    透過設定 defaultValue 給予預設值,最後將 fileRename 指定為 F-plugin-name, 將 (C-plugin-name) 指定為我的內容層級參數。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    {
    "$schema": "http://json.schemastore.org/template",
    "author": "MarkLin",
    "classifications": [ "Common", "SDK", "C#8" ],
    "identity": "Marsen.Blog.Plugin.Template",
    "name": "Marsen Blog Plugin Template",
    "shortName": "mbp",
    "tags": {
    "language": "C#",
    "type": "project"
    },
    "preferNameDirectory": true,
    "symbols":{
    "pluginName": {
    "type": "parameter",
    "defaultValue": "Demo",
    "fileRename": "F-plugin-name",
    "replaces":"(C-plugin-name)"
    }
    }
    }
  5. CLI強化,在.template.config 建立 dotnetcli.host.json
    這個檔案建立的目的,是為了讓我接下來使用 CLI 建立專案時能夠指定傳入的參數。
    這裡需指定 template.json 中的 symbol 並設定

    1
    2
    3
    4
    5
    6
    7
    8
    {
    "symbolInfo": {
    "pluginName": {
    "longName": "pluginName",
    "shortName": "p"
    }
    }
    }
  6. 執行 dotnet new i 註冊樣版
    執行命令前請確定所在位置包含.template.config 資料夾與相關的檔案

    1
    dotnet new -i ./
  7. 執行 dotnet new -u 查詢樣版列表資訊確認安裝已完成

  8. 應用

    在想建立專案的資料夾底下執行 dotnet new <template_name> 語法,
    並且可以透過 CLI 指定參數,我並沒有研究 GUI 的操作,有興趣的人請自行研究,
    如果能分享給我就不勝感激。

    1
    dotnet new mbp -p Marsen2
  9. 展示

我把這個例子放在 Github 上,有興趣的朋友可以試試看。

其它

移除專案樣板 SOP

  1. 執行 dotnet new -u 查詢樣版列表資訊,可以查到專案樣版的絕對路徑
  2. 執行 dotnet new -u <ABSOLUTE_FILE_SYSTEM_DIRECTORY>

更新專案樣版

直接進入專案樣版的絕對路徑

發佈

略…

參考

(fin)

[實作筆記] AWS Auto Scaling Group

前情提要

最近將一個服務掛上雲端(AWS),使用 EC2 ,
並且實作了 Auto Scaling ,特別紀錄一下。

概觀

以下使用的都是 AWS 的服務

  1. Auto Scaling Group (ASG) :
    本篇主角,根據指定的 Policies 與 LC 加開減少機器。

  2. Launch Configuration (LC) :
    一個 ASG 背後一定要搭配一個 LC,可以說是 ASG 的生命共同體,
    用來指定 EC2 的配置,並透過 User Data 指定實體起動時所需要執行的工作。
    註: 也有使用 Launch Template 的作法,這篇不會討論。

  3. Target Group (TG):
    由 1 到多個 EC2 實體(instance)組成,用來與 ELB(ALB) 搭配。

  4. ALB :
    流量負載平衡,與 TG 作為搭配。可以依不同條件轉導到不同 TG

Auto Scaling Group

組合零件

這有點像是在玩模型玩具,各個部份的小零件可以組成一個大零件,
再將各個部件結合,完成我所要的功能。
以下是這所需要的各個零件

  • Golden Image : 由實際的 EC2 Instance 建立。並包含 Cloud Watch Agent 的配置。
  • User Data : Lanuch Configuration 的一個子項目,可以在 EC2 啟動時,執行指定的命令,比如說在 WINDOWS 透過 Powershell 抓取新版程式來建置服務。
  • Launch Configuration : 由上述兩個零件 (Gloden Image & User Data) 組成,另外還可以設定 EBS、Plocies 等設定…
  • Target Group : 用來存放相關實體(EC2 Instance)的抽象概念, 可以設定 Health Check 來確定實體的健康情況。
  • Auto Scaling Group : 透過 Lanuch Configuration 來建立實體,並且可以將實體放入指定的 Target Group 之中。並且可以設定 Policy 來實現 Scaling Out/In.
  • ALB : 負載平衡的一種,透過設定,可以將 Request 導到對應的 Target Group。

紀錄

Add CloudWatch Agent

  1. Login EC2 Instance

  2. 安裝 CloudWatch Agent

  3. 準備一個 Json 檔如下

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    {  
    "agent":{
    "logfile":"c:\\ProgramData\\Amazon\\AmazonCloudWatchAgent\\Logs\\amazon-cloudwatch-agent.log"
    },
    "logs":{
    "logs_collected":{
    "files":{
    "collect_list":[
    {
    "file_path":"D:\\logs\\**.log",
    "log_group_name":"/MY/Service/Worker",
    "log_stream_name":"{instance_id}",
    "timezone":"UTC",
    "timestamp_format":"%Y-%m-%dT%H:%M:%S"
    }
    ]
    }
    },
    "log_stream_name":"default-log-stream",
    "force_flush_interval":5
    }
    }
  4. 開啟powershell,切換目錄至 AmazonCloudWatchAgent

    1
    cd "C:\Program Files\Amazon\AmazonCloudWatchAgent"
  5. 執行以下語法

    1
    ./amazon-cloudwatch-agent-ctl.ps1 -a fetch-config -m ec2 -c file:yourjsonfile.json -s

站台加入 Health Check

  • 加入靜態檔案(ex:check.html)
  • IIS Building * 80
    IIS Building * 80
  • 設定 Target Group 的 Health Check (ex:/check.html)
    AWS Target Gropu Health Check

包成 Gloden Image

  1. 機器下 ALB

    機器下ALB

  2. 開啟 Ec2LaunchSettings.exe

    開啟 Ec2LaunchSettings.exe

  3. 透過 Ec2LaunchSettings 關機

    透過 Ec2LaunchSettings 關機

  4. Waitting Instance Stoped , Create Images

    Waitting Instance Stoped , Create Images

Create Launch Configuration

Create Launch Configuration

  1. Choose AMI
    Choose Gloden Image
  2. Choose Instance Type
    t2.small
  3. Configure details
    Add User Data
  4. Add Storage
    Set EBS
  5. Configure Security Group
  6. Review

Create Auto Scaling group

  1. Configure Auto Scaling group details
    Configure Auto Scaling group details
  2. Configure scaling policies

  3. Configure Notifications

  4. Configure Tags

  5. Review

參考

(fin)

[實作筆記] CPAU 加密仿登入

前情提要

登入 SQL Server 需要受到權限管控,
而在 Windows 中需要使用特定用戶身份登入時,
我們常常會選擇 runas 命令。

大概類似如下:

1
runas.exe /netnoly /user:MyCompany\Marsen "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Ssms.exe"

我會寫成一個 ps (PowerShell) File 來執行這件事。
但是會有一些問題。

問題

  1. 每次登入都輸入密碼好麻煩
  2. 密碼很長又複雜,Terminal 又看不出輸入是否正確,常常會打錯
  3. 密碼如果寫在 PowerShell 中會有風險

我希望點兩下就能以正確的身份開啟 SSMS 而且密碼不會被明碼存儲

CPAU

  1. 請先下載CPAU\

    • 我採用綠色安裝,如果有必要可以設為環境變數
  2. 準備好 PowerShell 檔,並命名為 dblogin.ps1

    1
    runas.exe /netnoly /user:MyCompany\Marsen "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Ssms.exe"
  3. 加密,以下的語法會產生以 MyCompany\Marsen 的身份登入執行 SSMS 的批次檔 run.bat

    1
    CPAU -u MyCompany\marsen -p *************** -ex "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio\Ssms.exe" -enc -file D:\run.bat
  4. 解密

    1
    CPAU -file D:\run.bat -dec

最後只要將步驟 4 的語法存成一個 bat 檔,就可以隨時點兩下執行了。

參考

(fin)

[閱讀筆記] 執行力的修練

與成功有約的四個實踐原則

四個實踐原則

紀律一、鎖定極重要目標

80 % 用來維持改進日常工作,
20% 的時間與心力投入能帶來影響的目標,
尋找與使命有更直接關連的目標。

法則

  1. 不能聚焦顧於兩個以上的極重要目標
  2. 選擇能幫助打贏戰爭(高層次)的戰役(低層次)
  3. 高階領導人可以否決,但不能命令(賦予所有權與參與感)
  4. 設定「在何時之前從X到Y」的終點線

問題

  1. 在我們營運的其它部份保持目前績效的前提下,哪一部份的改變能帶來最大的影響 ?
  2. 為了在這場戰爭中取勝,至少一定要打贏哪些戰役 ?

反思

影響地圖 ?
OKR

紀律二、從領先指標下手

領先指標的特徵

  1. 具有預測作用
  2. 團隊有能力影響它
  3. 領先指標可能是違反直覺的

找到槓桿(領先指標)的支點
領先指標

紀律三、設置醒目計分板

  • 優秀的團隊隨時知道自已是屬於領先還是落後。
  • 制定一個屬於「隊員」的計分板
    • 必須簡單
    • 必須顯而易見
    • 同時揭露領先與落後指標
    • 知道正在贏或輸
  • 賽局本身比計分板重要
    • 求「勝」而非求「不敗」

反思

  • 看板
  • Burn Down/Up Chart
  • 電子看板的便利,實體看版的可視性

紀律四、落實當責

為了把績效得分往前推進而向整個團隊作出承諾,並以有紀律的方式貫徹執行。

  • 《爛工作的三個跡象》
    1. 無人聞問
    2. 可有可無
    3. 無從評量

原則

  1. 每周的同一時間開會
  2. 別讓日常事項進入會議

議程

  1. 報告:報告上次作出的承諾
  2. 檢討:從成功和失敗中學習
  3. 計畫:釐清並作出新承諾

問題

  • 我可以作什麼會對領先指標有幫助 ?

反思

  • Scurm 四大會議的立會與 Retrospective

執行

極重要目標構想 目前的成果(從X) 期望的成果(到Y) 期限(在何時之前) 排序
領先指標構想 如何評量 排序

領先指標 Check List

  • 是否從團隊成員及其他人蒐集了大量意見與建議 ?
  • 是否有預測作用 ?
  • 團隊能不能影響它 ?
  • 它是不是可以被測量 ?
  • 蒐集他的價值是否高於成本 ?
  • 每個指標是否包含動詞 ?
  • 是否可以量化 ?

計分版主題

  1. 趨勢線
  2. 速度計
  3. 長條圖
  4. 紅綠燈
團隊極重要目標 落後指標
領先指標1 圖表
領先指標2 圖表

(fin)

[閱讀筆記] 學徒模式--優秀軟體開發者的養成之路

送書啦

前情提要

最近公司來了幾個來自 Build School 的學員,
作為暑期工讀生,開發一些 Side Project ,
雖然工作很忙,不過我倒是對帶新人還蠻有信心的。

這些小朋友問了一些問題,讓我想到自已剛畢業和剛從資策會出來的那時候。
有的問題很大,大到可能要一輩子都無法解決。
有的問題很小,小到聽了會笑,但對他們來說可能像是眼裡的一粒沙。

我在學習的初期,最困難的問題是不知道怎麼問問題。 而過了一陣子後,我發現一個更糟的狀況,我不知道我有問題。 而這本書大致上解決了我的上述的兩個問題。

為何選擇這本書?

非常好讀,你不需要從頭讀到尾。
首先是每個篇幅非常的短,大概只要 5~10 分鐘就能讀完。
再來是除了第一章外,每一大章都會有一個地圖,
讓你能看見全貌。

如何讀這本書

而每一篇都包含情境、問題、解決方案與參照,
情境與問題就像是這本書的 GPS ,
讓你知道你落在這本書的哪個點上 。
解決方案是通篇的主體,但是對我來說後面的行動更為重要,
我開始練習 Kata、寫 Blog、尋找導師大多是因這本書而開始的。

最後,都會附上相關章節的參照。
這非常有幫助,原因是在這張地圖上,
你可能會同時落在幾個點上。
那麼地圖與參照就會非常有幫助,你可以查找地圖發現有關連的章節,
也可以直接透過參照找到其它章節。

會不會是雞湯文

會不會變成雞湯,其實取決於你自已。
書上的行動,你作了嗎 ?
如果不行動,就當作喝雞湯吧。

這本書的缺點

這本書強調的是如何成為一個工匠,
如何成為一個達人。
我知道的現實是,很多工程人員到了一定的程度就會轉換職務
如果你的目標是成為管理者,業務等…職務
我想這本書在幫助上可能會少一半。
畢竟這不是一本教你管理、銷售或領導的書。

最後的 mur mur

現實上的工匠真的很少,這不是條發大財的路。
走起來也很辛苦,不過這是個革命的時代,
各行各業都在與軟體產業發生衝突與融合,
如果能有更多優秀的工程師,我們就不需要工程師了。

鍚將會扮演它的角色,直到這個世界不再需要鍚為止,
然後鍚就會變成金子。 —El Alquimista

期許自已和看到這篇文章的你都能成為更好的工程師。

(fin)

[閱讀筆記] 第八個習慣 --- 從成功到卓越

找到自已內在的聲音

第八個習慣

  • small things listen to your head , big things listen to your heart

  • 孟加拉微形貸款的反思

    讓 99% 的人生活更好,並賺取收入成為 1 % 富者

  • Most ailing organisations have developed a functional blindness to their own defects. They are not suffering because they cannot resolve their problems, but because they cannot see their problems. — John Gardner → 看見全貌 — 李智樺(Rudy Lee)

  • 願景和心聲是慢慢演化出來的…感覺到人類的某種需求,而且他們的良知的回應試圖滿足這些需求就會出現願景

  • 個人領導(發揮影響力)是一種選擇,是一種自已必須去贏得的自由——只有當你贏得之後,領導才會變成一種選擇。

  • 3+1 的世界(Marsen Lin)

Column Core First Second Third
全人思維模式 心靈 心智 身體 情感
四種才能 SQ 精神 IQ 智力 PQ 身體 EQ 情感
人類四項基本需求 發揮影響力 學習 生活
四種才能的最高表現 良知 願景 自律 熱情
四種才能的反模式 自我 受害者心理 放縱 淪為社會的鏡子
將人物化的管理 老闆 規定 效率 控制
領導的四項職責 以身作則 探索方向 整合體系 充份授權
四大管理措施 文化 策略 結構 執行
完整工作中的全人 服務 計畫 執行 評估
  • 現況

報酬: 不公 / 一般 / 很好
尊重: 有 / 無
自主性: 有 / 無
意義: 有 / 無
愛 : 有 / 無

  • 通往卓越的地圖 vs 選擇地圖

    通往卓越的地圖

    選擇地圖

  • 目的和手段是不可分的,目的實際存在於手段之中。

  • 用於實現目的手段與目的同樣重要 — 康德

  • 只要目的合理,用什麼樣的手段都是合理的。— 馬基維利

  • 在刺激和回應之間有一段空間,我們有自由和能力選擇自已的回應

    聰明是一種天賦,而善良是一種選擇。

  • 所有事物都是經過兩次創造,一次是心智上的創造,一次是實際的創造

問題

  • 我在家庭、社區、工作單位裡感受到什麼需求 ?
  • 我是否擁有可以滿足這個需求的天賦才能 ?
  • 滿足這個需求的機會是否能激起我的熱情 ?
  • 我的良知是否在激勵我積極投入、採取行動 ?

激勵他人尋找內在的聲音

  • 領導是一種如何充份授權的藝術。
  • 對人充份授權,對物進行管理與控制
  • 工業時代的管理,老闆/規定/效率/控制

七、以身作則

  • 不論什麼時候,如果你認為問題在別人身上,那麼這個想法本身就有問題。
  • 主動,是自我授權的一種形式
  • 有的時候,在某些文化中,得到原諒比得到批准來得容易
  • 7種自我授權
    1. 坐等吩附
    2. 詢問
    3. 提出建議
    4. 我想做
    5. 執行並立刻報告
    6. 執行後定期報告
    7. 只管去做
  • 做一個燈塔,不要當法管; 作一個榜樣,不要當批評家。

八、成為表率

  • 七個習慣

    • 主動積極
    • 以終為始
    • 要事第一
    • 雙贏思維
    • 知彼解已
    • 統合綜效
    • 不斷更新
  • 有系統的個人計劃

    • 「確定任務與價值」
    • 願景和價值觀
      1. 每日計劃
      2. 每周計劃
      3. 設定目標
      4. 確定任務和價值

九、贏得信任

  • 儲蓄

    1. 先努力理解他人
    2. 信守承諾
    3. 誠實、開誠布公
    4. 和善、有禮
    5. 雙贏或無交易的思維方式
    6. 明確的期望
    7. 對不在場者保持忠誠
    8. 道歉
    9. 接受回饋意見
    10. 寬恕
  • 支出

    1. 先求被他人理解
    2. 破壞承諾
    3. 圓滑的操縱
    4. 冷漠、無禮
    5. 我贏你輸或我輸你贏的思維方式
    6. 破壞期望
    7. 不忠誠、欺騙
    8. 驕傲、自負、傲慢
    9. 不接受回饋意見
    10. 心懷怨恨
  • 必要的犧牲

    1. 不耐煩、自我中心
    2. 情緒、感情、時間
    3. 自我中心、傲慢、控制
    4. 自我、時間、感覺、成見、偏見
    5. 勝者為王、競爭意識
    6. 蜻蜓點水式的交流
    7. 某些社會認可、祕而不宣
    8. 自我、傲慢、驕傲、時間
    9. 自我、傲慢、驕傲、起反作用的溝通
    10. 驕傲、自我中心
  • 內在原則

    1. 相互了解
    2. 完整/執行
    3. 遠見/價值觀、統一/執行、相互了解
    4. 遠見/價值觀、完整/執行
    5. 相互尊重/互惠
    6. 相互尊重/互惠、相互了解、創造性合作、更新
    7. 遠見/價值觀、完整/執行
    8. 遠見/價值觀、完整/執行
    9. 相互了解
    10. 遠見/價值觀、統一/執行
  • 真正的付出,必須是對方願意接受的東西

  • 說謊是將問題推給未來,誠實則是將問題留給過去

  • 成年人只是大孩子而已

  • 你如何看待我的角色與目標 ? 你如何看待自已的角色與目標 ?

  • 我們自已選擇什麼樣的回應方式,是決定生活的關鍵因素

  • 信任和愛一樣

    • 愛是一個動詞,而愛情是愛的結果
    • 讓自已的情感服從價值
    • 信任需要冒險、磨練, 沒有風險是最大的冒險
  • 個人層次

    • 態度積極的好榜樣。
    • 不要抱怨、比較、批評、競爭和爭鬥。
    • 作一個燈塔式的人物,而不要作法官式的人,作一個榜樣而不要作批評家
    • 無力改變所有的事情(別人)時,改變自已
  • 人們需感覺自已被欣賞,需要感覺到自已所從事的工作是有價值的

十 融合心聲

  • 雙贏思維只要有一方願意改變就可以了

改變得從願意改變的那個人開始 — 改變提問,改變人生

  • 傾聽的連續性

    1. 忽略
    2. 假裝在聽
    3. 選擇性傾聽
    4. 專心傾聽
    5. 以同理心傾聽 (以對方的框架思考)
  • 解決方案

    1. 你輸我贏/你贏我輸 [交易]
    2. 妥協 [交易]
    3. 相互了解(沒有共識) [轉變]
    4. 你輸我贏/你贏我輸(增加了解與關心) [轉變]
    5. 妥協(在關係上取得統合綜效) [轉變]
    6. 在問題和關係上取得統合綜效 [轉變]
  • 人們會看到同樣的事實,但是以個人的經驗加上不同的解釋,創造意義並產生行為

  • 一但你有了身分上的權利,你會認定只有一個答案是對的,自我愈強烈,愈固執,愈僵化。

  • 沉默是必要的,問一個問題「說出自已的真正想法,會比沉默好嗎 ?」

  • 兩個步驟

    1. 問「是否願意尋求一種比雙方的方法更好的解決方案 ?」
    2. 覆述對方的意見直到對方認可,確定你真正理解他的意思。
  • 第三選擇不一定是第三個方案,而是心態上真正的理解對方,而非妥協

  • 領導是一種選擇,而非一種職位

  • 與人和文化有關時,快就是慢,慢就是快

十一 同心協力

問題

  1. 你清楚了解組織的目標嗎 ?
  2. 你對組織忠誠奉獻嗎 ?

四個現實問題

  1. 市場狀況
  2. 核心競爭力
  3. 利益關系人的期望與所需
  4. 價值觀

刺蝟概念

  1. 你真正的專長是什麼 ?
  2. 你對什麼事充滿熱情 ?
  3. 人們會對什麼掏腰包 ?
  • 你的良知期望怎麼作 ?

十二 整合體系

問題

  • 你是怎麼想的 ?
  • 成長過程中,你最喜歡做什麼 ? 有什麼優秀的表現 ?

持續整合不只是工程的事,而是整個組織與公司的事。

十三 充分授權

  • 透過目標與責任以達到預期結果。
  • 若以授權的名義放任員工,自律也無法實現。
  • The Doctrine of Stubborn refusal — 出於良知
  • 服務型的領導人的問題
    • 工作進度如何 ? 依據看板
    • 你正在學習什麼 ?
    • 你的目標是什麼 ?
    • 我能幫你作什麼 ?
    • 作為一個幫助者,我表現得如何 ?
  • 選擇的自由與能力
    • 領導
      • 意義 : 創造性刺激
      • 愛 : 真心誠意的保證
      • 職責: 愉快的合作
    • 管理
      • 獎勵 : 自願服從
      • 恐懼 : 願意服從
      • 憤怒 : 反抗或退出
  • 為不同意見保留一席之地,建立回饋機制讓他理解別人的感受。

問題

  • 誰喜歡現在的方式 ?
  • 誰可以作 ? 誰有能力作 ? 誰有責任作 ?
  • 真正的考驗是改變能不能持久 ? → 回顧與重溫約定。(類似 Retrospective)
  • 你的建議是什麼 ? 你們的意見是什麼 ?
  • 知而不行,是為不知
  • 你所知道的東西 還不足以讓你提出合適的問題

參考

(fin)

[學習筆記] 重構使用 Introduce Variable for Substring

要知道的事

  • 這是個人的學習記錄
  • 可能對你沒幫助
  • 不知不知最可怕。快不起來,因為你不覺得慢
  • 希望對你有幫助
  • 使用 Visual Studio & ReSharper

問題

把原本的程式
string url = “http://localhost:5000/api/v3.3/refund/PayPal/SF188964T"

變成下面這樣

string domain = “http://localhost:5000";
string code = “SF188964T”;
string payType = “PayPal”;
string url = $”{domain}/api/refund/{payType}/{code}”;

你會怎麼作 ?

我原本的作法,一個字一個挖出來,命名變數,再填回去。

怎麼作可以更快 ?

透過 Resharper 的 Refactor > Introduce Variable > Introduce Variable for Substring 即可快速重構。

參考 91 的影片

我實測原本的開發時間約為2~3分鐘,善用工具約可以在 30 ~ 45 s 完成。
效能提昇 400 % !!!!!(聽起來就很威)

當然結合了 Vim 與 Visual Studio 的工具才達到這樣的速度,強烈推薦以下課程。

我只推薦好東西

【極速開發+】 202002 第九梯次 台北

課程優點

  1. 學心法也學作法,不是只有理論的打高空
  2. 認識同好 ,來上課的同學都是願意精進自已的人,所以身上有很多寶可以挖
  3. 認識 91 ,遇到 91 盡量挖就對了,偷到一招半式都完勝 10 年在那邊處理 NullReferenceException
  4. 學習怎麼學習

其它本周學習事項

  1. 可以讓中斷點停留在 lambda express 中
  2. MSTest 請用 DescriptionAttribute 加入測試描述
  3. .Net MVC Model Binding 若欄位為空字串預設為轉為 Null

本周待確認事項

  1. 如何對 HttpClient 測試 ?
  2. 如何用 FluentValidation 作測試 ?

(fin)

[實作筆記] Stripe 串接

Agenda

  • Stripe 簡介
  • 註冊
  • 付款

Stripe 簡介

Stripe是一家提供讓個人或公司在網際網路上接受付款服務的科技公司。
Stripe提供在網上接受付款所需的技術、避免信用卡詐騙技術及銀行基礎設施

– 引述自 Wiki

Our mission is to increase
the GDP of the internet

– 引述自 Stripe 官網

業務範圍大多為歐美,亞洲方面支援香港、新加坡與日本等國…

註冊

只需要透過信箱即可註冊, 註冊後需要到信箱收取確認信以開通帳戶,
如果真的要在線上使用需要提供公司相關的資訊,
但以開發者而言,此時的 Stripe 已經提供一組測試 api 供你使用,
隨後即可以登入後台操作。
請在 Dashboard 的左邊側欄>開發者>API 密鑰,取得Secret key
在後面呼叫 API 中都會使用這組 Secret Key 請特別留意。

付款

這裡只介紹 Stripe 信用卡的付款方法,
並根據 Stripe 文件整理一些資訊給大家。

如下圖,這是一個標準的 Stripe 結帳流程,
stripe overview

主要的兩個步驟在 Create SourceCreate Charge
這裡會透過呼叫 Stripe API 以完成付款流程。

下面會介紹幾種信用卡的付款方式, 僅供參考,實際作業請以最新的 Stripe 文件為準。
過程中如有呼叫 API 都會用 curl 帶過,
Secret Key 一律以 sk 表示, Public Key 以 pk 表示
Stripe 有提供多種語言的範例或是提供 SDK 或 Libary, 請親自去看它們的文件囉。

使用 Checkout Session

Step 1. 建立 Session

1
2
3
4
5
6
7
8
9
10
11
curl https://api.stripe.com/v1/checkout/sessions \
-u sk_test_dAa6L6BL4gZDuscgJcl3an8K00aJL2yIaW: \
-d payment_method_types[]=card \
-d line_items[][name]=T-shirt \
-d line_items[][description]="Comfortable cotton t-shirt" \
-d line_items[][images][]="https://example.com/t-shirt.png" \
-d line_items[][amount]=500 \
-d line_items[][currency]=hkd \
-d line_items[][quantity]=1 \
-d success_url="https://example.com/success" \
-d cancel_url="https://example.com/cancel"

Step 2. 建立 CheckOut 頁面

Step 1 會取得一組 session_id ,請填入頁面中的{session_id}pk 請填入 public key

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<script src="https://js.stripe.com/v3/"></script>
<script>
var stripe = Stripe('pk');
stripe.redirectToCheckout({
// Make the id field from the Checkout Session creation API response
// available to this file, so you can provide it as parameter here
// instead of the {{CHECKOUT_SESSION_ID}} placeholder.
sessionId: '{session_id}'
}).then(function (result) {
// If `redirectToCheckout` fails due to a browser or network
// error, display the localized error message to your customer
// using `result.error.message`.
});
</script>

Step 3. 載入頁面

調整你的付款流程,引導消費者到 Step 2. 的頁面,
會自動轉導到 Stripe 的標準頁,並且出現填寫信用卡的資訊,
消費者需要手動輸入卡號後,確認付款。
如果確認會引導至 Step 1 的 success_url
消費者取消的話會引導至 Step 1 的 cancel_url

說明

這是標準的第三方串接步驟,可以發現在 Step 3 的時候,
消費者會被帶離你原本的站台到 Stripe 的付款頁面,
這樣的好處是你不需要經手敏感的資料,像是信用卡卡號,
但是有時候,轉導到外部頁面會讓消費者不安進而中斷結帳,
那我們可以參考其它的作法。

使用 Source

一般來說,Source 是 Stripe 最常用的付款方式,
但在歐洲相關規定調整後,信用卡不再建議使用這個 API。
可以參考官方文件的說明

Card Payments with Sources
Use Sources to accept card payments from around the world.

Use of this API is no longer recommended. We recommend adopting the Payment Intents API.
This new integration lets you benefit from Dynamic 3D Secure and helps you prepare for
Strong Customer Authentication regulation in Europe.

不過理論上您的客戶中沒有歐洲人的話,還是可以呼叫這個 API ,
作法如下:

Step 1. Create Source 並指定 Type 為 Card

1
2
3
4
5
6
7
8
9
curl https://api.stripe.com/v1/sources
-u sk
-d type=card
-d currency=hkd
-d owner[email]="[email protected]"
-d card[number]={{cardNumber}}
-d card[exp_month]=12
-d card[exp_year]=2020
-d card[cvc]=123

Step 2. Charge With Source

Step 1 可以取得 source id,利用 source id 呼叫 charge API 付款

1
2
3
4
5
6
7
8
curl https://api.stripe.com/v1/charges
-u sk
-d source={{source id}}
-d amount=411
-d currency=hkd
-d description="Charge for [email protected]"
-d metadata[a]="b"
-d metadata[b]=123

使用 Token

不過 Sorce 信用卡在官方文件上不再被建議使用,
我們可以看看另一個類似的方法 Token

Step 1. Create Token 並傳入卡號

1
2
3
4
5
6
curl https://api.stripe.com/v1/tokens
-u sk
-d card[number]={{cardNumber}}
-d card[exp_month]=12
-d card[exp_year]=2020
-d card[cvc]=123

Step 2. Charge With Token

Step 1 可以取得 token id,利用 source id 呼叫 charge API 付款

1
2
3
4
5
6
7
8
curl https://api.stripe.com/v1/charges
-u sk
-d source={{token id}}
-d amount=412
-d currency=hkd
-d description="Charge for [email protected]"
-d metadata[a]="c"
-d metadata[b]=663

使用 Payment Intent

終於來到 Payment Intent 了,
實際上這是目前 Stripe 最推薦的信用卡支付方式,
呼叫的作法也很類似於 Source 與 Token,
沒什麼特別考量的話,建議使用這個付款方式。

Step 1. Create Payment Method 並傳入卡號

1
2
3
4
5
6
7
8
curl https://api.stripe.com/v1/payment_methods
-u sk
-X POST
-d type=card
-d card[number]={{cardNumber}}
-d card[exp_month]=12
-d card[exp_year]=2020
-d card[cvc]=123

Step 2. Create Payment Intent With Payment Method

Step 1 可以取得 payment method id,
利用 payment method id 呼叫 payment intents API 付款

1
2
3
4
5
6
7
curl https://api.stripe.com/v1/payment_intents  
-u sk
-d payment_method={{payment method id}}
-d amount=555
-d currency=hkd
-d confirmation_method=manual
-d confirm=true

小結

想快速成立訂單請用 Session 的作法,
想要避免轉換率下降,請使用 Payment Intents。

參考

(fin)