opencode-cursor-agent/refactor.md

.
├── build/                   # [Infrastructure] 存放 Dockerfile 與建置相關腳本
├── docker-compose.yml       # [Infrastructure] 本地開發環境編排 (Mongo, Redis, etc.)
├── etc/                     # [Configuration] 存放各環境的 yaml 設定檔範本
├── generate/                # [Contract] Interface First 定義區
│   └── api/                 # 存放 .api 原始定義，作為服務間的通訊契約
│   └── database/            # 如果有必要，請幫我放建立db 的檔案
├── internal/                # [Framework Layer] 強依賴 go-zero 框架的實作區
│   ├── config/              # 框架層的 Config mapping
│   ├── logic/               # Adapter: 負責將框架 Request 轉接至 pkg/usecase
│   ├── server/              # Transport: gRPC/HTTP Server 實作 (僅處理協議)
│   └── svc/                 # DI Center: 依賴注入中心，管理全域 Resource (DB, Client)
├── pkg/                     # [Core Domain] 核心業務邏輯 (不依賴 go-zero 框架)
│   ├── domain/              # <Domain Layer> 
│   │   ├── entity/          # 純粹的業務物件 (POJO/POCO)，不含資料庫標籤
│   │   ├── repository/      # Repository Interface: 定義資料存取規範 (DIP)
│   │   ├── const/           # 常數
│   │   └── usecase/         # Usecase Interface: 定義業務功能的 API 契約
│   ├── repository/          # <Infrastructure Layer> 
│   │   ├── *_test.go        # 使用 Testcontainers (Real DB) 進行整合測試
│   │   └── *.go             # 實作 domain/repository 接口 (MongoDB/Redis)
│   └── usecase/             # <Application Layer> 
│       ├── *_test.go        # 核心業務邏輯的 Unit Test (使用 Mock)
│       └── *.go             # 實作業務流程，協調 Repository 與 Utils
├── Makefile                 # [Automation] 封裝 protoc, test, build 等常用指令
├── go.mod                   # [Dependency]
└── main.go                  # [Entry] 服務啟動進入點