はじめまして！フリーランスエンジニアのこたろうです。
アプリケーションのフォルダ構成の改善とWebフレームワークの比較について、学びで得た知見を共有します。

フォルダ構成の改善

1. なぜCORS設定とルーティングを分離するのか？

プログラムを書く際、1つのファイルに多くの処理を書くと、以下の問題が発生します：

コードが読みにくくなる
修正が難しくなる
他の人が理解しにくい

そこで、CORS設定とルーティングを別ファイルに分けることで：

各ファイルの役割が明確になる
コードが整理され、読みやすくなる
修正が容易になる

CORS設定の分離例

// config/cors.go

// CORSとは？
// Cross-Origin Resource Sharing（CORS）は、
// 異なるドメインからのアクセスを制御する仕組みです。
// 例：localhost:3000のフロントエンドから
//     localhost:8080のバックエンドにアクセスする場合に必要

func CorsMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // どのドメインからのアクセスを許可するか
        w.Header().Set("Access-Control-Allow-Origin", "*")
        
        // どのHTTPメソッドを許可するか
        w.Header().Set("Access-Control-Allow-Methods", 
            "GET, POST, PUT, DELETE, OPTIONS")
        
        // どのヘッダーを許可するか
        w.Header().Set("Access-Control-Allow-Headers", 
            "Content-Type, Authorization")
        
        // プリフライトリクエストの処理
        if r.Method == "OPTIONS" {
            w.WriteHeader(http.StatusOK)
            return
        }
        
        next.ServeHTTP(w, r)
    })
}

ルーティングの分離例

// config/router.go

// ルーティングとは？
// URLと処理（関数）を紐付けることです
// 例：/api/todosにアクセスしたら、GetTodos関数を実行する

func NewRouter() *mux.Router {
    router := mux.NewRouter()
    
    // GETメソッド：データの取得
    router.HandleFunc("/api/todos", controllers.GetTodos).
        Methods("GET")
    
    // POSTメソッド：データの作成
    router.HandleFunc("/api/todos", controllers.CreateTodo).
        Methods("POST")
    
    // PUTメソッド：データの更新
    router.HandleFunc("/api/todos/{id}", controllers.UpdateTodo).
        Methods("PUT")
    
    // DELETEメソッド：データの削除
    router.HandleFunc("/api/todos/{id}", controllers.DeleteTodo).
        Methods("DELETE")
    
    return router
}

2. レイヤードアーキテクチャとは？

アプリケーションを以下の3つの層に分けて管理する方法です：

Controllers層（入口）
- ユーザーからのリクエストを受け取る
- データの形式をチェック
- Services層に処理を依頼
- 結果をユーザーに返す
Services層（ビジネスロジック）
- アプリケーションの主要な処理を行う
- データの加工や計算
- 複雑なチェック処理
- Repositories層にデータの操作を依頼
Repositories層（データ操作）
- データベースとのやり取り
- データの保存、取得、更新、削除

フォルダ構成例

├── controllers/
│   └── todo_controller.go  （リクエストの受付）
├── services/
│   └── todo_service.go     （ビジネスロジック）
└── repositories/
    └── todo_repository.go  （データベース操作）

実装例と説明

// repositories/todo_repository.go
// データベース操作を担当
type TodoRepository interface {
    FindAll() ([]Todo, error)      // 全データ取得
    FindByID(id int) (*Todo, error) // 1件取得
    Create(todo *Todo) error       // データ作成
    Update(todo *Todo) error       // データ更新
    Delete(id int) error           // データ削除
}

// services/todo_service.go
// ビジネスロジックを担当
type TodoService struct {
    repo TodoRepository  // repositoryを使用
}

func (s *TodoService) GetTodos() ([]Todo, error) {
    // 1. repositoryからデータを取得
    todos, err := s.repo.FindAll()
    if err != nil {
        return nil, err
    }
    
    // 2. 必要な加工や計算を行う
    // （例：期限切れのTODOに印をつけるなど）
    for i := range todos {
        if todos[i].DueDate.Before(time.Now()) {
            todos[i].IsExpired = true
        }
    }
    
    return todos, nil
}

// controllers/todo_controller.go
// リクエストの受付を担当
type TodoController struct {
    service *TodoService  // serviceを使用
}

func (c *TodoController) GetTodos(w http.ResponseWriter, r *http.Request) {
    // 1. リクエストのチェック
    // （必要に応じてバリデーションなど）
    
    // 2. serviceに処理を依頼
    todos, err := c.service.GetTodos()
    if err != nil {
        // エラー時の処理
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    
    // 3. 結果をJSONで返す
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(todos)
}

このように分けることで：

コードが整理され、理解しやすくなる
テストが書きやすくなる
修正が容易になる
チーム開発がスムーズになる

gorilla/muxとginの比較

gorilla/mux

標準パッケージnet/httpを拡張したシンプルなフレームワーク

メリット

学習が簡単
- 標準パッケージの知識がそのまま使える
- シンプルな機能で分かりやすい
柔軟なルーティング
- URLに変数を含められる
- HTTPメソッドで分岐できる

// gorilla/muxの例
r := mux.NewRouter()

// URLに変数を含む例（/api/todos/1 など）
r.HandleFunc("/api/todos/{id}", getTodo).Methods("GET")

// 複数のHTTPメソッドを設定
r.HandleFunc("/api/todos", handler).
    Methods("GET", "POST")

gin

高機能で高速なWebフレームワーク

メリット

便利な機能が豊富
- バリデーション（データチェック）
- ミドルウェア（共通処理）
- エラーハンドリング
高いパフォーマンス
- 処理が速い
- メモリ使用量が少ない

// ginの例
r := gin.Default()

// シンプルなルーティング
r.GET("/api/todos/:id", getTodo)

// バリデーション機能の例
type Todo struct {
    Title string `binding:"required,min=1,max=100"`
    Done  bool
}

どちらを選ぶべき？

小規模なプロジェクト
→ gorilla/mux
- シンプルで学習コストが低い
- 標準パッケージの勉強になる
大規模なプロジェクト
→ gin
- 便利な機能が揃っている
- パフォーマンスが重要な場合

参考文献:
-『Goで作るはじめてのWebアプリケーション改訂版』技術評論社

https://techbookfest.org/product/jXDAEU1dR53kbZkgtDm9zx