資料表流程

資料表流程模板

# <table> 狀態變動
 
文件狀態：草稿 / 已對 legacy / 已對 new API / 已實測
最後驗證：YYYY-MM-DD
來源：legacy code / new code / PHPUnit / DB baseline
 
## 目的
 
這份文件回答 `<table>` 在核心流程中扮演什麼角色，以及哪些欄位會被哪些流程改變。
 
## 不回答什麼
 
- 不重寫完整 business flow。
- 不放單次 curl / 測試 ID。
- 不放所有欄位 dictionary。
 
## 核心角色
 
描述這張 table 是 aggregate root、狀態表、關聯表、交易表或 lookup table。
 
## 重要欄位
 
| 欄位 | 意義 | 常見修改流程 |
|---|---|---|
| `<field>` | `<meaning>` | `<flow>` |
 
## 狀態流
 
```text
initial
-> state A
-> state B
```
 
## 會建立 / 更新這張表的流程
 
| 流程 | 建立 / 更新 | 入口文件 |
|---|---|---|
| `<flow>` | 建立 / 更新 | `[[...]]` |
 
## 關聯表
 
- `<related_table>`：說明關係。
 
## 第一輪排查 SQL
 
涉及 `pro360_api_82` 時，先用容器 PHP 8.2 + DBFactory 查 schema，再查資料。
 
```sql
SHOW COLUMNS FROM <table>;
```
 
```sql
SELECT *
FROM <table>
WHERE id = <id>;
```
 
## 常見誤判
 
- `<field>` 不能單獨代表 `<business meaning>`。
 
## 相關文件
 
- [[../業務流程/README]]
- [[../資料表流程/README]]