寶嘉 3.0 · Database Schema Specification

寶嘉 3.0 資料庫 Schema 規格書

欄位命名對齊「訂單資料拋轉 API 串接需求說明 v20260601」

版本 v1.2（草案） 日期 2026-06 訂單主表 87 欄 資料表 15+

v1.2 修訂：① 新增 account 登入帳號表；② sale_scs 補 sync_status 欄位；③ 主鍵慣例改寫（區分 3.0 新表與 2.0 既有表）；④ 保險公司表 insurer 改名為 company（inquiry 要保人 insurer_* 欄位照舊不動）。

1. 文件目的與範圍

本文件定義寶嘉 3.0 之資料庫結構，涵蓋車輛訂單、詢價、銷售人員、保險公司與稽核等資料表。 欄位命名以「訂單資料拋轉 API 串接需求說明 v20260601」（寶嘉提供予上優之 API 規格）為準，訂單主表完整對應該規格之 87 個欄位。 保單資料維持在 2.0，3.0 僅前台即時顯示、不建表；理賠與佣金不納入 3.0。

2. 設計慣例

  • 命名：以 API 規格欄名為準（snake_case）；中文與 Excel 欄位代號對照見各表。
  • 主鍵：
  • 3.0 新建資料表（vehicle_order、account、company、inquiry_submission、line_account、audit_log）使用 id（BIGINT, auto increment）為代理主鍵。
  • 2.0 既有資料表沿用原型別，僅統一欄名為 id，不強制改型別：source／source_company 為 int、sale／sale_scs 為 uuid、inquiry 為 varchar(36)。
  • 訂單以 order_number 為業務唯一鍵（建 UNIQUE 索引）。
  • 時間戳：每表含 created_at、updated_at。
  • 金額採 DECIMAL；日期採 DATE（API 來源格式 YYYY-MM-DD）；字元集 utf8mb4。
  • 分類欄（_group，A–E）與明細欄（_detail，P–Q）依 API 規格保留、不去重，內容通常與主欄位相同。
  • 個資（PII）依授權狀態遮罩；bank_account、account_holder 等於儲存層加密（AES）。注意：API 傳輸層為明碼，加密為 3.0 落地後之保護。

3. 實體關係（ERD）

訂單為核心，向下展開詢價與送件/報價；業代隸屬據點、據點隸屬經銷商；保險公司（company）為送件對象；保單以 2.0 API 即時取得不落地。登入身分集中於 account 表，業代（sale）與保險公司（company）皆以 account_id 連結。

4. vehicle_order（車輛訂單）

訂單主表，完整對應 API 規格 87 欄。資料來源為上優 API，以 order_number（訂購單號）為唯一鍵，每筆拋轉帶完整欄位，缺漏以 null／空字串帶入，我方依 order_number 覆蓋。 購買人與車主之電話／行動電話分別為 buyer_phone／buyer_mobile（BV/BW）與 owner_phone／owner_mobile（BX/BY），未合併。

4.1 區塊：分類/排序（5 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
car_model string varchar(100) — 車型 A
car_model_code string varchar(50) — 車型代碼 B
salesperson_group string varchar(50) — 銷售人員(分類,同salesperson) C
customer_group string varchar(100) 個資/遮罩 客戶(分類,同customer) D
sales_category_group string varchar(50) — 銷售類別(分類) E

4.2 區塊：訂單資訊（10 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
dealer string varchar(100) — 經銷商 F
branch string varchar(100) — 據點 G
employee_code string varchar(30) — 員工代號 H
salesperson string varchar(50) — 銷售人員 I
vehicle_category string varchar(50) — 車輛分類 J
order_number string varchar(40) 必填 訂購單號(key) K
status string enum — 狀態 L
customer string varchar(100) 個資/遮罩 客戶 M
sales_category string varchar(50) — 銷售類別 N
payment_method string varchar(50) — 付款方式 O

4.3 區塊：配車資訊（8 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
car_model_code_detail string varchar(50) — 車型代碼(明細) P
car_model_detail string varchar(100) — 車型(明細) Q
exterior_color string varchar(80) — 外裝 R
stock_card_number string varchar(40) — 庫存卡號 S
manufacture_day date date — 製造日 T
engine_number string varchar(40) — 引擎# U
chassis_number string varchar(40) — 車身# V
vin_number string varchar(30) — VIN# W

4.4 區塊：客戶訂單進度（11 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
promised_delivery_date date date — 承諾交車 X
order_date date date — 訂單日期 Y
contract_review_date date date — 契約審閱日 Z
order_audit_date date date — 訂單審核日 AA
vehicle_allocation_date date date — 配車日 AB
payment_received_date date date — 入帳日期 AC
performance_license_date date date — 業績領牌日 AD
delivery_approval_date date date — 交車核准 AE
delivery_date date date — 交車日期 AF
sales_date date date — 銷售日期 AG
registered_agent string varchar(50) — 登錄業代 AH

4.5 區塊：領牌（2 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
license_review_date date date — 審核日期(領牌) AI
license_plate_date date date — 領牌日期(實際) AJ

4.6 區塊：車價/金額（7 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
selling_price number decimal(12,0) — 售價 AK
collected_amount number decimal(12,0) — 代收金額 AL
other_amount number decimal(12,0) — 其他 AM
total_amount number decimal(12,0) — 合計 AN
invoice_amount number decimal(12,0) — 發票金額 AO
list_price number decimal(12,0) — 訂價 AP
discount_amount number decimal(12,0) — 折扣金額 AQ

4.7 區塊：其他（19 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
prospect_create_date date date — 有望客建立日 AR
prospect_code string varchar(30) — 有望客代號 AS
order_days number int — 下訂天數 AT
license_plate_number string varchar(20) 個資/遮罩 牌照# AU
brand string varchar(50) — 品牌 AV
project_code string varchar(30) — 專案代號 AW
project_name string varchar(100) — 專案名稱 AX
loan_amount number decimal(12,0) — 貸款金額 AY
loan_periods number int — 貸款期數 AZ
loan_interest_rate number decimal(5,2) — 貸款利率 BA
factory_date date date — 出廠日期 BB
received_amount number decimal(12,0) — 已收 BC
contact_address string varchar(200) 個資/遮罩 聯絡地址 BD
invoice_address string varchar(200) 個資/遮罩 發票地址 BE
storage_location string varchar(30) — 庫位 BF
total_receivable number decimal(12,0) — 應收總額 BG
owner string varchar(100) 個資/遮罩 車主 BH
data_source string varchar(50) — 資料來源 BI
media_source string varchar(50) — 媒體來源 BJ

4.8 區塊：庫存週轉天數（11 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
stock_turnover_days number int — 庫存週轉天數(Excel標出廠日期) BK
transfer_in_date date date — 轉入日期 BL
bin_location_number string varchar(30) — 儲位# BM
return_date date date — 退購日期 BN
return_reason string varchar(200) — 退購原因 BO
order_suspended string varchar(10) — 訂單暫停 BP
remark string text — 備註 BQ
model_year string varchar(10) — 年式 BR
customer_authorization_status string varchar(30) — 客戶授權狀態 BS
owner_authorization_status string varchar(30) — 車主授權狀態 BT
unauthorized_categories string varchar(200) — 列舉不被授權的顧關類別 BU

4.9 區塊：購買人（2 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
buyer_phone string varchar(40) 個資/遮罩 電話(購買人) BV
buyer_mobile string varchar(20) 個資/遮罩 行動電話(購買人) BW

4.10 區塊：車主（2 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
owner_phone string varchar(40) 個資/遮罩 電話(車主) BX
owner_mobile string varchar(20) 個資/遮罩 行動電話(車主) BY

4.11 區塊：匯款帳號（10 欄）

API 欄名 API型別 DB 型別 屬性 Excel 原始欄名 / 代號
receipt_date date date — 點收日期 BZ
bank_code string varchar(10) 個資/遮罩 銀行代碼 CA
bank_name string varchar(50) — 銀行名稱 CB
bank_account string varchar(64) 個資/加密/遮罩 銀行帳號 CC
account_holder string varchar(100) 個資/加密/遮罩 戶名 CD
order_submit_date date date — 訂單送審日期 CE
registered_agent_employee_code string varchar(30) — 登錄業代員工代號 CF
registered_agent_branch string varchar(100) — 登錄業代據點 CG
order_source string varchar(50) — 訂單來源 CH
stock_purpose string varchar(50) — 庫存用途 CI

註：stock_turnover_days（BK）之 Excel 欄名標示為「出廠日期」，實際內容為庫存週轉天數，以 API 規格為準。

5. 其他資料表

本章分兩部分：5.1–5.5 為沿用 2.0 既有資料表（欄名已套用第 9 章之命名統一）；5.6–5.11 為 3.0 新增資料表。vehicle_order（訂單，第 4 章）為 3.0 自上優同步之資料表，2.0 無對應。

5.A 沿用 2.0 既有資料表（統一命名後）

5.1 source（經銷商）

欄名 型別 說明
id int PK 主鍵（原 source_id）
source_type varchar(50) 客戶來源代碼（業務關聯鍵，保留不改）
name varchar(50) 經銷商名稱（原 source_name）
created_at / updated_at datetime 時間戳（原 createDate／updDate）

5.2 source_company（據點）

欄名 型別 說明
id int PK 主鍵（原 source_company_id）
source_type varchar(50) FK → source（業務關聯鍵，保留）
company_type varchar(2) 通路公司代碼（業務關聯鍵，保留）
name varchar(50) 據點名稱（原 company_name）
vol_pct / tf_pct decimal(4,2) 任意險／颱洪險佣金趴數
cps int 強制險佣金
business_scope varchar 業務範圍
created_at / updated_at datetime 時間戳

5.3 sale（銷售人員—人）

2.0 業代為 sale（人）＋ sale_scs（通路身分）一對多結構。sale 存人之基本資料。

欄名 型別 說明
id uuid PK 主鍵
account_id BIGINT FK → account（3.0 登入帳號；業代登入身分）
name varchar 姓名
mobile_tel varchar 手機
birth_date date 生日（原 birthDate）
note text 貼心備註
line_user_id varchar line_id
license tinyint 是否有證照
license_id varchar 登錄證號
training_end_date / training_hour date／decimal 受訓截止日／已受訓時數
created_at / updated_at / deleted_at datetime 時間戳／軟刪除

5.4 sale_scs（銷售人員—通路身分）

業代於各通路之身分；3.0 業代維護對應此表（含 company_type 通路歸屬）。異動經 API 送 2.0 審核後生效。

欄名 型別 說明
id uuid PK 主鍵（等同原業代系統編號）
sale_id uuid FK → sale（所屬業代）
code2 varchar 業代代碼
company_type varchar FK → source_company（通路代碼）
sync_status enum 3.0 業代異動送 2.0 審核狀態：pending／reviewing／approved／rejected，預設 pending
tel varchar 聯絡電話/室內（原 work_tel）
fax / email varchar 傳真／電子郵件（原 work_fax／work_email）
addr_city / addr_dist / addr_zipcode / addr_detail varchar 通訊地址（原 work_*）
is_quit / quitDate tinyint／date 是否離職／離職日期
vol_pct / tf_pct / cps decimal／int 佣金趴數與強制險佣金
created_at / updated_at / deleted_at datetime 時間戳／軟刪除

5.5 inquiry（詢價）

2.0 既有詢價表（欄名統一後）。3.0 詢價流程重新規劃，惟保留與此表之對應；新送件/報價明細另見 5.8。

欄名 型別 說明
id varchar(36) PK 詢價編號（原 inquiry_uuid）
insured_name / insured_id varchar 被保險人 姓名/統編（PII）
insured_birth_date date 被保人生日（原 insuredBirthDate）
insured_tel varchar 被保人聯絡電話
insured_addr_city / _dist / _zipcode / _detail varchar 被保人地址（原 insured_*）
insurer_name / insurer_id / insurer_birth_date varchar／date 要保人 姓名/統編/生日（照舊不動）
car_code8 / car_brand / car_model varchar 車型代碼／廠牌／車型
car_plate_number / car_eng_id / car_body_id varchar 牌照／引擎／車身號
inquiry_state varchar 保單狀態
create_from / creator varchar 建立來源（LINE/人員）／建立者
source_type / company_type / sale_scs_id varchar 成交通路／公司／業代（FK）
insurance_company varchar 成交保險公司（照舊不動）
inquiry_reject / memo varchar／text 未成交原因／備註
renewal_inquiry tinyint 是否續保件重詢
created_at / updated_at / deleted_at datetime 時間戳／軟刪除

5.B 3.0 新增資料表

以下為 2.0 無對應、3.0 新建之資料表。

5.6 account（3.0 統一登入帳號）★ 新增

3.0 所有登入者（業代、保險公司、管理者）共用此帳號表；其他角色表以 account_id 連結，稽核 actor_id 一律指向本表。

欄名 型別 說明
id BIGINT PK 主鍵
account_type enum 帳號類別：sale／insurer／admin
username varchar(100) 登入帳號（UNIQUE）
password_hash varchar(255) 密碼雜湊（bcrypt/argon2，不存明碼）
display_name varchar(100) 顯示名稱
email varchar(100) 電子郵件
active bool 是否啟用
last_login_at datetime 最後登入時間
created_at / updated_at / deleted_at datetime 時間戳／軟刪除

5.7 company（保險公司）★ 原 insurer 改名

保險公司亦為 3.0 使用者。（註：本表 company 指「保險公司」，與 company_type「通路公司代碼」為不同概念，勿混用。）

欄名 型別 說明
id BIGINT PK 主鍵
name varchar(100) 公司名稱
account_id BIGINT FK → account（3.0 登入帳號）
active bool 是否啟用
created_at / updated_at datetime 時間戳

5.8 inquiry_submission（詢價送件／報價，一對多保險公司）

一張 inquiry 可送多家保險公司，每家一筆；保險公司於 3.0 站內填報價。隸屬 2.0 inquiry。

欄名 型別 說明
id BIGINT PK 主鍵
inquiry_id varchar(36) FK → inquiry.id
company_id BIGINT FK → company.id（原 insurer_id）
status enum 送件/報價中/已報價/婉拒
inquiry_amount decimal(12,0) 報價金額
inquiry_doc_url varchar(300) 報價單檔案
valid_until date 報價到期日
submitted_at / replied_at datetime 送件／回報價時間
created_at / updated_at datetime 時間戳

5.9 line_account（LINE@ 綁定）

欄名 型別 說明
id BIGINT PK 主鍵
sale_id uuid FK → sale（1:1）
line_user_id varchar(64) LINE userId
bound_at datetime 綁定時間

5.10 audit_log（操作稽核）

欄名 型別 說明
id BIGINT PK 主鍵
actor_id BIGINT FK → account.id（操作者）
action varchar(50) view / create / update
target_table / target_id varchar／BIGINT 對象資料表／主鍵
detail text 異動內容摘要
created_at datetime 時間

5.11 policy_view（保單顯示，非實體表）

3.0 不儲存保單；前台即時呼叫 2.0 API。理賠與佣金不取用。欄位見需求規格書第 6 章。

6. 列舉值（Enum）定義

欄位 可能值
vehicle_order.status 受訂、配車、結帳、領牌、交車核准、交車、作廢、遺失、退購、銷退
sale_scs.sync_status（3.0 擴充） pending、reviewing、approved、rejected
account.account_type sale、insurer、admin
inquiry.inquiry_state 建檔中、（既有 2.0 狀態值）…
inquiry_submission.status 送件、報價中、已報價、婉拒

7. 上優訂單拋轉 API 規格（對應 v20260601）

7.1 端點與傳輸

項目 內容
方式 HTTP POST，application/json，UTF-8
測試機 https://dev.baojia.topspeedgroup.com.tw/api/sync/partner/order
正式機 https://baojia.topspeedgroup.com.tw/api/sync/partner/order
加密 明碼傳輸，無需 AES／Base64
白名單 來源 IP 須列入白名單，否則回 403
唯一鍵 order_number；資料異動須重送完整欄位以覆蓋
頻率 每筆 Request 拋一筆；本案約定每小時批次同步

7.2 Response

成功（HTTP 200）：回傳 message=success、order_number 與 action（created／updated）。

{
  "message": "success",
  "order_number": "AP300120",
  "action": "updated"
}
HTTP 情境 回應重點
200 新增或覆蓋成功 action = created / updated
400 必填缺漏或格式錯誤 errors：{ 欄位: [錯誤訊息] }
403 來源 IP 未列入白名單 Not Allowed IP Address…（提供 IP 加白名單）
500 系統處理錯誤 系統異常，請稍後再試或聯絡我們

7.3 格式約定

  • 日期欄：YYYY-MM-DD。
  • 金額／數值欄：純數字，不含千分位逗號或貨幣符號。
  • 缺漏欄位：以 null 或空字串帶入，不可省略 key，避免覆蓋殘留舊值。
  • 聯絡窗口：injwang@topspeedgroup.com.tw／02-2394-7788 #804 王先生。

8. 索引與安全建議

  • order_number 建 UNIQUE 索引（覆蓋鍵）；dealer、branch、employee_code、status、order_audit_date 建索引以利篩選。
  • 業代僅能讀取本人訂單與詢價，於應用層以 sale_scs／employee_code 過濾。
  • bank_account、account_holder、insured_id_no 採欄位級加密，金鑰由 KMS 管理。
  • API 雖為明碼傳輸，仍建議以 IP 白名單＋HTTPS 保護；落地資料依授權狀態遮罩並寫入 audit_log。

9. 2.0 既有資料表欄位命名統一

針對 2.0 既有之 source（經銷商）、source_company（據點）、sale＋sale_scs（銷售人員）、inquiry（詢價）四組資料表，將「同概念但命名不一致」之欄位統一為同一組名稱，以利 3.0 介接與維護。

原則：保留跨表關聯鍵 source_type、company_type 不變（2.0 多表依其 JOIN）；主鍵代理鍵統一為 id；時間戳統一為 created_at／updated_at；地址統一為 addr_ 格式。

9.1 同概念欄位統一對照

「—」表示該表無此概念欄位；「（已是）」表示現況已符合統一命名。

統一名稱 概念 source source_company sale sale_scs inquiry
id 主鍵（代理鍵）統一為 id source_id source_company_id id（已是） id（已是） inquiry_uuid
source_type 經銷商/通路來源代碼（關聯鍵）— 已一致，保留 source_type source_type — （無，經 company_type 間接） source_type
company_type 據點/通路公司代碼（關聯鍵）— 已一致，保留 — company_type — company_type company_type
name 名稱（經銷商名/據點名/業代名）統一為 name source_name company_name name（已是） — —
mobile_tel 手機統一為 mobile_tel — — mobile_tel（已是） — —
tel 市話/聯絡電話統一為 tel — — — work_tel insured_tel（被保人）→ 另列
fax 傳真統一為 fax — — — work_fax —
email 電子郵件統一為 email — — — work_email —
addr_city 地址-縣市統一為 addr_city — — — work_city insured_city
addr_dist 地址-鄉鎮市區統一為 addr_dist — — — work_dist insured_dist
addr_zipcode 地址-郵遞區號統一為 addr_zipcode — — — work_zipcode insured_zipcode
addr_detail 地址-詳細統一為 addr_detail — — — work_addr insured_addr
birth_date 生日統一為 birth_date（原 birthDate/insuredBirthDate 駝峰不一致） — — birthDate — insuredBirthDate / insurerBirthDate
vol_pct 任意險佣金趴數 — 已一致，保留 — vol_pct — vol_pct —
tf_pct 颱洪險佣金趴數 — 已一致，保留 — tf_pct — tf_pct —
cps 強制險佣金 — 已一致，保留 — cps — cps —
created_at 建立時間統一為 created_at（原 createDate） createDate createDate created_at（已是） created_at（已是） createDate
updated_at 更新時間統一為 updated_at（原 updDate） updDate updDate updated_at（已是） updated_at（已是） updDate
deleted_at 軟刪除時間 — 統一為 deleted_at（已一致） — — deleted_at deleted_at deleted_at

9.2 統一後各表欄位

★ 標示為本次改名之欄位；「原欄名」為 2.0 現行名稱。

9.2.1 source（經銷商）

統一欄名 原欄名 型別 說明
★ id source_id int PK 通路客戶來源編號
source_type — varchar(50) 客戶來源代碼（業務鍵）
★ name source_name varchar(50) 客戶來源名稱
★ updated_at updDate timestamp 更新時間
★ created_at createDate datetime 建立日期

9.2.2 source_company（據點）

統一欄名 原欄名 型別 說明
★ id source_company_id int PK 通路所屬通路編號
source_type — varchar(50) 通路客戶來源代碼（FK→source）
company_type — varchar(2) 通路公司代碼（業務鍵）
★ name company_name varchar(50) 通路公司名稱
vol_pct — decimal(4,2) 任意險佣金趴數
tf_pct — decimal(4,2) 颱洪險佣金趴數
cps — int 強制險佣金
business_scope — varchar 業務範圍
★ updated_at updDate timestamp 更新時間
★ created_at createDate datetime 建立日期

9.2.3 sale（銷售人員-人）

統一欄名 原欄名 型別 說明
id — uuid PK 編號
account_id （3.0 新增） BIGINT FK → account（登入帳號）
name — varchar 姓名
mobile_tel — varchar 聯絡號碼(手機)
★ birth_date birthDate date 生日
note — text 貼心備註
line_user_id — varchar line_id
license — tinyint 是否有證照
license_id — varchar 登錄證號
training_end_date — date 受訓截止日
training_hour — decimal(4,1) 本年度受訓時數
created_at — datetime 建立時間
updated_at — datetime 更新時間
deleted_at — datetime 刪除時間

9.2.4 sale_scs（銷售人員-通路身分）

統一欄名 原欄名 型別 說明
id — uuid PK 編號(等同原業代系統編號)
sale_id — uuid 所屬業代（FK→sale）
code2 — varchar 業代代碼
company_type — varchar 通路代碼（FK→source_company）
sync_status （3.0 新增） enum 送 2.0 審核狀態：pending／reviewing／approved／rejected，預設 pending
★ tel work_tel varchar 聯絡電話(室內)
★ fax work_fax varchar 傳真電話
★ email work_email varchar 電子郵件
★ addr_city work_city varchar 通訊地址_縣市
★ addr_dist work_dist varchar 通訊地址_鄉鎮市區
★ addr_zipcode work_zipcode varchar 通訊地址_郵遞區號
★ addr_detail work_addr varchar 通訊地址_詳細地址
is_quit — tinyint 是否已離職
quitDate — date 離職日期
vol_pct — decimal(4,2) 任意險佣金趴數
tf_pct — decimal(4,2) 颱洪險佣金趴數
cps — int 強制險佣金
created_at — datetime 建立時間
updated_at — datetime 更新時間
deleted_at — datetime 刪除時間

9.2.5 inquiry（詢價）

統一欄名 原欄名 型別 說明
inquiry_id — int 流水號
★ id inquiry_uuid varchar(36) PK 詢價編號
insured_name — varchar 被保險人(姓名/公司)
insured_id — varchar 被保險人身分證/統編
★ insured_birth_date insuredBirthDate date 被保險人生日
insured_tel — varchar 被保人連絡電話
★ insured_addr_city insured_city varchar 被保人地址_縣市
★ insured_addr_dist insured_dist varchar 被保人地址_鄉鎮市區
★ insured_addr_zipcode insured_zipcode int 被保人地址_郵遞區號
★ insured_addr_detail insured_addr varchar 被保人地址_詳細地址
insurer_name — varchar 要保人姓名/公司
insurer_id — varchar 要保人身分證/統編
★ insurer_birth_date insurerBirthDate date 要保人生日
car_code8 — varchar 車型代碼
car_brand — varchar 廠牌
car_model — varchar 車型
car_plate_number — varchar 牌照號碼
car_eng_id — varchar 引擎號碼
car_body_id — varchar 車身號碼
inquiry_state — varchar 保單狀態
createFrom — varchar 建立來源(LINE/人員)
creator — varchar 建立者
source_type — varchar 成交通路代碼（FK→source）
company_type — varchar 成交通路公司代碼（FK→source_company）
sale_scs_id — varchar 成交業代（FK→sale_scs）
insurance_company — varchar 成交保險公司
inquiry_reject — varchar 未成交原因
memo — text 備註
renewal_inquiry — tinyint 是否續保件重詢
★ updated_at updDate timestamp 更新時間
★ created_at createDate datetime 建立日期
deleted_at — datetime 刪除時間(softDelete)

9.3 對 3.0 的影響與建議

  • sale 與 sale_scs 為一對多：sale 存「人」、sale_scs 存「人在各通路的身分」；3.0 業代維護應對應 sale_scs（含 company_type 通路歸屬）。
  • source_type、company_type 維持為關聯鍵不改名，避免牽動 2.0 既有 insurance、bonus、inquiry_scs 等表。
  • inquiry 之被保人地址改為 insured_addr_，與 sale_scs 之 addr_ 格式一致但保留語意前綴；如需完全共用欄名可再議。
  • 改名建議以 Laravel migration renameColumn 漸進處理，並於 Model 設定 $casts／存取器維持相容。
寶嘉 3.0 資料庫 Schema 規格書 · v1.2（草案）· 2026-06 · 內部技術文件