第三方金流串接 – 資料庫規劃

奧莉薇

更新於 2025/01/07發佈於 2024/10/15閱讀時間約 8 分鐘

※ 架構設計：

※ 資料庫規劃 — 產品表：

id：流水號，唯一代替產品名稱的辨識代碼，AUTO_INCREMENT。
name：VARCHAR(255)，NOT NULL。
amount：INTEGER（整數），UNSIGNED（不能是負數）。
description：TEXT，描述產品。
pre_order：作為金流交易賣出物品時的預扣額度。

※ 資料庫中建立產品資料庫：

在src資料夾內建立一個database的資料夾：

在database資料夾中建立products.sql檔案：

在 MySQL 中建立名為 products 的資料表內容：

CREATE TABLE `products` (
`id` int UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
`name` varchar(255) NOT NULL DEFAULT '',
`amount` int UNSIGNED NOT NULL  DEFAULT 0,
`description` text,
`pre_order`  int UNSIGNED NOT NULL  DEFAULT 0,
`price`int UNSIGNED NOT NULL  DEFAULT 0
);

程式碼說明：

CREATE TABLE products：這句命令表示創建一個名為 products 的資料表。
id：整數型欄位，不允許負數 (UNSIGNED)，不能為空 (NOT NULL)，自動遞增 (AUTO_INCREMENT)，並設置為主鍵 (PRIMARY KEY)。
name：變長字元串 (VARCHAR)，最大長度為 255 字元，不能為空，預設值為空字串 ('')。
amount：整數，不允許負數(UNSIGNED)，不能為空，預設值為 0。
description：文字型欄位 (TEXT)，用於存儲產品描述。
pre_order：整數，不允許負數(UNSIGNED)，不能為空，預設值為 0。

※ 打開MySQL Workbench新增products 表格：

專案要和資料庫連線：

刪除已有表格：

DROP TABLE IF EXISTS `products`;

建立新的表格：

CREATE TABLE `products` (
  `id` INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
  `name` VARCHAR(255) NOT NULL DEFAULT '',
  `amount` INT UNSIGNED NOT NULL DEFAULT 0,
  `description` TEXT,
  `pre_order` INT UNSIGNED NOT NULL DEFAULT 0
);

新增price欄位：

ALTER TABLE `products` ADD COLUMN `price` int UNSIGNED NOT NULL DEFAULT 0;

※ 資料庫規劃 — 訂單表：

id：VARCHAR(20) NOT NULL PRIMARY KEY。（大部分金流的 API，它們的 ID 都要求是一個亂數的字串）
total：INT UNSIGNED NOT NULL DEFAULT 0。
created_at：DATETIME NOT NULL DEFAULT NOW()。
updated_at：DATETIME NOT NULL DEFAULT NOW()。
payment_provider：ENUM('PAYPAL', 'ECPAY')。
payment_way：ENUM('CSV', 'CC', 'ATM', 'PAYPAL')。
status：ENUM('WAITING', 'SUCCESS', 'FAILED', 'CANCEL')。
contents：JSON DEFAULT NULL （商品內容[{商品ID，商品數量，商品價格}]）

※ 訂單：產品的對應表

product_id
order_id

※ 資料庫中建立訂單資料庫：

在database資料夾內建立orders.sql檔案：

在 MySQL 中建立名為orders 的資料表內容：

CREATE TABLE `orders` (
  `id` varchar(20) NOT NULL PRIMARY KEY COMMENT '大部分金流的API它們的ID都要求是一個亂數的字串',
  `total` int unsigned NOT NULL DEFAULT 0,
  `created_at` datetime NOT NULL DEFAULT now(),
  `updated_at` datetime NOT NULL DEFAULT now(),
  `payment_provider` enum('PAYPAL', 'ECPAY'),
  `payment_way` enum('CVS', 'CC', 'ATM', 'PAYPAL'),
  `status` enum('WAITING', 'SUCCESS', 'FAILED', 'CANCEL'),
  `contents` JSON DEFAULT NULL COMMENT '商品內容 [{商品ID, 商品數量, 商品價格}]'
);

程式碼說明：

CREATE TABLE orders：這句命令表示創建一個名為 orders 的資料表。
id：VARCHAR(20) NOT NULL PRIMARY KEY，並帶有註解「大部分金流的 API 它們的 ID 都要求是一個亂數的字串」，表示每個訂單的唯一識別碼。
total：INT UNSIGNED NOT NULL DEFAULT 0，表示訂單的總金額，預設為 0。
created_at：DATETIME NOT NULL DEFAULT NOW()，表示訂單創建的時間，預設為當前時間。
updated_at：DATETIME NOT NULL DEFAULT NOW()，表示訂單最後更新的時間，預設為當前時間。
payment_provider：ENUM('PAYPAL', 'ECPAY')，表示支付提供商，可選擇 PAYPAL 或 ECPAY。enum（枚舉型別）：通常用於表示相關的值集合。
payment_way：ENUM('CVS', 'CC', 'ATM', 'PAYPAL')，表示支付方式，可選擇 CVS、信用卡、ATM 或 PAYPAL。
status：ENUM('WAITING', 'SUCCESS', 'FAILED', 'CANCEL')，表示訂單狀態，可選擇等待、成功、失敗或取消。
contents：JSON DEFAULT NULL，並帶有註解「商品內容 [{商品ID, 商品數量, 商品價格}]」，表示訂單中的商品內容，預設為空。