postgresql-best-practices

| quick-reference.md | QUICK LOOKUP - Single-page cheat sheet (print this!) | | schema-architecture.md | START HERE - Schema separation pattern (data/private/api) | | coding-standards-trivadis.md | Coding standards & naming conventions (l, g, co) |

| plpgsql-table-api.md | Table API functions, procedures, triggers | | schema-naming.md | Naming conventions for all objects | | data-types.md | Data type selection (UUIDv7, text, timestamptz) | | indexes-constraints.md | Index types, strategies, constraints | | migrations.md | Native migration system documentation |

| anti-patterns.md | Common mistakes to avoid | | checklists-troubleshooting.md | Project checklists & problem solutions |

PostgreSQL 18+ 企業資料庫開發的全面最佳實務。提供架構 架構模式、表 API 設計、PL/pgSQL 編碼標準、遷移和資料倉儲。 當使用者出現以下情況時使用此技能： - 建立 PostgreSQL 模式、表格、函數、流程或觸發器 - 詢問 PostgreSQL 資料類型（uuid、text、timestamptz、jsonb、numeric） - 編寫 PL/pgSQL 程式碼並需要命名約定（l_、in_、io_、co_ 前綴） - 實作表 API 模式（SECURITY DEFINER 函數、模式分離） - 設定資料庫遷移或架構版本控制 - 需要索引最佳化、約束設計或查詢效能協助 - 詢問 PostgreSQL 18+ 功能（uuidv7、虛擬列、時間約束） - 使用 Medallion 架構建立資料倉儲（銅牌/銀牌/金牌） - 需要資料沿襲追蹤、ETL 模式或審核日誌記錄 - 審查資料庫程式碼的最佳實踐或反模式 - 從 Oracle PL/SQL 遷移到 PostgreSQL PL/pgSQL - 為資料庫變更設定 CI/CD 管道 核心模式： - 三模式分離：資料（表）→私有（內部）→api（外部） - 表 API：透過帶有 SET search_path 的 SECURITY DEFINER 函數進行所有訪問 - 原生遷移系統：Flyway/Liquibase 的純 PL/pgSQL 替代方案 - Trivadis 命名：l_（本地）、in_（輸入）、io_（輸入輸出）、co_（常數） 來源：wimolivier/postgresql-best-practices。