terminalip192htw
Home/01 / PROJECT

Shop

E-commerce Platform

Stack
Next.jsSupabaseGoogle CloudVercelPostgreSQL
StatusArchived
Shop E-commerce Platform Interface

專案資料

專案代號:shop

定位:一個輕量化的商城系統

類型:學習專案

狀態:已停止維護,進入公開封存

架構:Next.js + Supabase + PostgreSQL


Overview

Shop 最初是以一個相對直接的電商需求開始:

建立一個可以讓使用者瀏覽商品、加入購物車並完成訂單流程的校園型電商系統。

但實際開發後,我逐漸意識到,商城並不是由幾張商品與訂單資料表組成的簡單系統,而是許多彼此存在依賴關係的 domain 所共同構成:

  • 商品

  • SKU

  • 庫存

  • 購物車

  • 訂單

  • 使用者

  • Authentication

  • Authorization

  • RLS

  • 後台管理

  • 批次出貨

  • 不同商品狀態

  • 資料模型

What I Built

已完成

  • 商品瀏覽
  • 商品詳細資訊
  • 商品管理
  • SKU / 商品規格選擇
  • 購物車
  • 訂單建立
  • SKU
  • Inventory
  • User authentication
  • 使用者檔案
  • RLS

已規劃

  • 庫存管理
  • 訂單 / 出貨流程的基礎架構
  • IAM

From Prototype to System

開發初期,我習慣以功能為單位直接組合元件、資料存取與商業邏輯。這種方式在需求還很小的時候非常有效,但隨著商品、SKU、庫存與使用者權限逐漸增加,原本的結構開始出現大量重複與隱性耦合。這時候,問題已經不再是「下一個功能怎麼做」,而是「這個系統要怎麼繼續存在」。我需要一個完整有結構規劃的架構,而不是一道臨時砌起來的牆。

Architecture Refactoring

Domain-Driven Design

DDD 並不是一開始就採用的架構,而是在系統規模增加後,為了解決 domain logic 分散與責任不清而逐步引入。對我而言,DDD 在這個專案裡並不是一套需要完整照搬的架構,而是一種重新思考「這段邏輯到底屬於誰」的方法。

Type System & Reusability: Building for Reuse

最初的實作有大量針對單一情境撰寫的 code。隨著不同 domain 出現類似需求,我開始把相似部分開始抽象化,減少重複。我開始將 Repository、Service、資料存取模式與 Generic Types 等重複結構抽象化,讓不同 domain 可以共享相同的處理方式。 重構的目的並不是單純減少程式碼,而是讓相同的 domain operation 能夠被一致地處理。

Authentication & Authorization

Authentication 主要由 Supabase Auth 負責,應用程式則將 auth.users 作為 canonical identity,再由 application layer 管理 profile 與其他 domain information。隨著 server-side rendering 與資料存取需求增加,我也開始區分 server 與 browser client,並使用 @supabase/ssr 處理不同 runtime 下的 authentication context。

Data Modeling

我原本以為商品就是 Product,後來才發現實際 commerce system 裡,Product、Variant、SKU 與 Inventory 是不同概念。

Product
│
├── SKU
│   ├── Variant
│   └── Price
│
└── Inventory
    ├── Available
    ├── Reserved
    └── Incoming

這個結構並不是一開始就存在,而是在實際處理商品規格與庫存狀態後逐漸形成。尤其 SKU 與 Inventory 的拆分,讓我第一次真正理解到,一個「商品」在商業系統裡可能同時存在多種規格、價格與庫存狀態。

Security & Data Access

當商品、庫存與使用者資料開始具有不同的存取需求後,我第一次真正需要思考「誰可以看到什麼資料」。最初我曾經設計較完整的 Role / Permission 模型,但重新檢視 MVP 的實際需求後,發現這會帶來超出產品需求的複雜度。因此後續更傾向讓資料庫層的 RLS 處理實際需要的資料隔離,而不是提前建立完整的 IAM 系統。

Problems & Constraints

What I Overbuilt

一開始我為系統設計了較完整的 Role / Permission 架構,但隨著實際需求逐漸明確,我發現這套授權模型在目前產品階段並沒有實際需求。因此後續重新檢視架構時,我開始把「未來可能需要」與「現在真的需要」分開。這也讓我第一次意識到,工程上的複雜度本身也是一種成本。

Prototype inheritance

最大的問題其實不是技術選型,而是早期開發留下的結構。早期的做法對快速驗證想法非常有效,但這些決策在系統規模增加後開始產生反作用。一開始為了快速驗證需求,大量程式碼直接以功能為中心組合。當系統變大後:之間開始出現大量隱性耦合。因此後續大量時間並不是在新增功能,而是在:整理以前為了快速前進而留下的技術債。

What I Learned

Engineering

我開始理解大型程式碼庫中的 abstraction、

domain boundaries、generic types 與 reusable architecture。

System Design

我開始理解 authentication、authorization、RLS、inventory、SKU 等系統之間其實存在複雜的相依關係。

Product

我開始理解「把功能做出來」和「設計一個能持續演進的產品」是兩件不同的事情

What I Would Do Differently

如果重新開始,我不會一開始就建立完整的 authorization、permission 或 automation 架構。

我會先從 Product → SKU → Inventory → Cart → Order 這條真正的使用者流程開始,再根據實際出現

的問題增加抽象層。

這個專案讓我開始意識到,好的架構不只是預測未來,而是讓系統能夠在需求改變時低成本地改變。

Outcome

Shop 最終沒有以最初規劃的完整電商產品形式完成,而是在重新檢視產品定位後轉為公開封存。但它也是目前對我工程能力影響最大的專案之一。它讓我第一次真正面對一個已經不能靠快速拼湊繼續維持的 codebase,並開始透過 domain modeling、type system、data modeling 與 access control 重新整理系統。