FSTS 術語表

本頁由 fb.fsts 的 docs/domain/domain.md §術語表 ingest 而來。 源頭規範:僅由 BA Analyst 維護;PM / RD / QA / Code Reviewer 不得直接編輯。

1

核心實體

複委託系統 (FSTS)

Foreign Stock Trading System。券商受理投資人委託向海外市場下單買賣有價證券的後台管理系統。1

FD 檔案 (FD File) {#fd-file}

COBOL 主機產出的固定長度二進位交換檔,每筆記錄長度固定(record_length byte)。必須配合 INI Layout 才能解析。1

INI Layout {#ini-layout}

定義一種 FD 檔案的欄位對應結構(起始位置、長度、型別),是轉檔的「讀取規格」。Code 全域唯一1

INI Mapping {#ini-mapping}

將一個 INI Layout 對應到目標資料庫表的設定,是轉檔的「寫入規格」。Code 全域唯一;參照 Layout + DbConnection。1

轉檔 (File Conversion) {#conversion}

INI Mapping 設定,將 FD 檔案解析並批次寫入目標資料庫的執行動作。使用 SqlBulkCopy 批次寫入。1

OCCURS 群組 {#occurs-group}

COBOL FD 中的重複欄位群組OCCURS N TIMES),一筆 FD 記錄展開為 1 筆主檔 + N 筆明細is_occurs_field=1 的欄位群組。1

詳見 核心流程 B:OCCURS 展開

基本資料類

代碼設定 (AllCode)

系統通用代碼表,統一管理各業務下拉選單的選項(CodeType + CodeCode + CodeName)。1

國家市場 (Country Market)

有價證券掛牌交易的國家及市場組合基本資料(如 US/NYSE)。1

交易所 (Exchange)

有價證券掛牌的交易所基本資料(如紐約證交所 NYSE)。1

股票 (Stock / Product)

在特定交易所上市的有價證券,對應系統中的 Product 實體。1

貨幣 (Currency)

交易結算所使用的幣別基本資料(如 USD、TWD)。1

稽核與異動

操作紀錄 (Audit Log)

記錄使用者對系統執行新增/修改/刪除/轉檔等操作的稽核日誌。由 AuditActionFilter 自動記錄。1

異動紀錄 (Change Log)

記錄系統各模組資料列(Record)層級的 Before/After 欄位變更歷程,儲存 JSON 格式的異動前後資料。由各模組 Handler 主動呼叫 WriteChangeLogService 寫入:Create 時 BeforeValue=null,Delete 時 AfterValue=null。1

交易與委託

上游券商 (Upstream Broker)

接受複委託下單的國外或境外券商(如 Interactive Brokers)。1

委託回報 (Order Report)

交易員透過 COBOL 主機系統送出委託後,系統回傳的委託執行狀態紀錄。儲存於 OrderDetail;包含委託日期、委託書號、處理狀態(ProcessFlag)、成交股數等。資料由 FSIO FD 轉檔寫入,唯讀1

成交回報 (Match Detail)

委託部分或全部成交後,清算系統(如 CBL)回傳的成交明細。儲存於 MatchDetail;一筆委託可有多筆成交回報(分單號 ExecAllocSeqNo 區分)。資料由 FHIO-F FD 轉檔寫入,唯讀;以 OrderNo + BrokerNo 關聯 OrderDetail1

基礎設施

資料庫連線 (DB Connection)

系統可連接的外部資料庫連線設定,供轉檔寫入時動態切換目標庫。1

角色權限 (RBAC / Role)

以角色為基礎的存取控制,定義哪些角色可存取哪些 Sidebar 功能模組。格式為 Resource.Action1

客戶基本資料 (CustomerBaseInfo)

券商客戶的個人基本資料,對應 DB 表 CustomerBaseInfo複合主鍵 BrokerNo(券商代號)+ AccountNo(客戶帳號)。身份別 IdentityType 01~08。1

實體關聯約束

IniLayout ──────┐
                ├── IniMapping(多個 Mapping 可對應同一個 Layout)
DbConnection ───┘        │
                         └── IniMappingOccurs(一個 Mapping 最多一個 OCCURS 設定)

IniLayout ──── IniLayoutField(一個 Layout 有多個欄位)
           └── IniLayoutOccurs(OCCURS 群組定義,含 occurs_count)
                    └── IniLayoutOccursField(OCCURS 群組的欄位模板)

Role ─── RolePermission(多個 Resource+Action 權限)
User ─── Role(每個使用者只有一個角色)

2

補充資訊

(未來 ingest 新來源會在此追加段落)


參考資料

Footnotes

  1. domain.md §術語表 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

  2. domain.md §資料關聯約束