金融業務中的命名慣例

There are only two hard things in Computer Science: cache invalidation and naming things" - Phil Karlton

計算機科學中最難的兩件事情是命名和緩存失效。在面向對象開發實踐中，對一個實體對象進行有效的命名，體現了程序員對該問題域的分析理解程度。在本篇文章中，主要就金融業務中的證券領域的常見實體對象以及命名實踐進行小結。

本文將從帳戶資金、交易業務這兩個方面入手，介紹下常見業務實體以及命名。本文所有內容來自日常的開發實踐以及心得體會，歡迎在文章結尾處評論交流以及轉載，轉載請註明出處。

整體原則

業務實體命名需知足一致性原則。

一致性原則

具體細分有兩點：

• 在同一個工程中，同一個邏輯對象在不一樣場合下的名稱要相同，以資金爲例子，不要一個地方使用AvailFund，另外一個地方使用AvailCapital, 其餘地方使用AvailMoney,AvailBalance。一種名稱只能關聯一種邏輯對象，在整個生命週期中，最好不要改動。

• 在基於第三方接口文檔進行二次開發時，變量命名最好同接口文檔中提供的字段命名相一致，保持文檔和實現的一致性，下降閱讀負擔。

• 縮寫一致性，好比數量，可用quantity, 也可用qty，還可用amount和amt。在同一個工程中，最好只採用一種詞彙來表示數量，可在覈心詞彙前面加上相關業務的表達前綴，好比委託數量 OrderQty，成交數量 DealQty , 這裏的核心詞彙要保持邏輯一致。

帳戶資產方面

資金資產方面，常見的英文名稱有fund、capital、asset

fund: an amount of money that has been saved or has been made available for a particular purpose
資金：爲特定目的而集中彙總的錢。

capital: a large amount of money that is invested or is used to start a business
資本：用來投資或者開啓新業務的一大筆資金，帶有資本追利含義

asset: a thing of value, especially property, that a person or company owns, which can be used or sold to pay debts
資產：我的或公司擁有的財產全部權，可以使用或者變賣償還債務。在金融行業，既包括帳戶資金，又包括股票、基金等有價證券在內的資產，是彙總的概念。

balance: the amount that is left after taking numbers or money away from a total
餘額：帳戶變更後剩下的餘額。

marketvalue：what sth would be worth if it were sold
市值：持有的有價證券如今賣出的價值

交易業務

交易的核心是委託(entrust)，委託有兩個方面的要素：人和票。

識別人的要素有：

• 股東代碼(stockHolder)
• 資金帳戶(fundAcct)

識別票的要素有：

• 股票代碼（stockCode）
• 交易市場（market）
• 委託方向(entrustDir)
• 價格類型（priceType）
• 委託價格（entrustPrice）
• 委託數量(entrustAmount)

一筆委託報出後，櫃檯會返回委託序號來標誌該筆委託，可經過該委託序號對原委託進行撤單。如有批量委託的需求(ETF品種)，前端通常向後臺得到委託批次號，而後在報單時帶上該批次號，櫃檯會返回該批次號對應的委託序號。