FSTS 術語表
本頁由 fb.fsts 的
docs/domain/domain.md §術語表ingest 而來。 源頭規範:僅由 BA Analyst 維護;PM / RD / QA / Code Reviewer 不得直接編輯。
核心實體
複委託系統 (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 關聯 OrderDetail。1
基礎設施
資料庫連線 (DB Connection)
系統可連接的外部資料庫連線設定,供轉檔寫入時動態切換目標庫。1
角色權限 (RBAC / Role)
以角色為基礎的存取控制,定義哪些角色可存取哪些 Sidebar 功能模組。格式為 Resource.Action。1
客戶基本資料 (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(每個使用者只有一個角色)
補充資訊
(未來 ingest 新來源會在此追加段落)