Goの巨大ファイルをどう分割する？単一責任原則で600行のコードをリファクタリングする方法

// ❌ 悪い例：pkg/cognito/client.go（600行超）
package cognito

type CognitoClient struct {
    // ...
}

// --- 認証の責任 ---
func (c *CognitoClient) SignUp(...) { /* ... */ }
func (c *CognitoClient) SignIn(...) { /* ... */ }

// --- パスワード管理の責任 ---
func (c *CognitoClient) ChangePassword(...) { /* ... */ }
func (c *CognitoClient) ForgotPassword(...) { /* ... */ }

// --- ユーザー管理の責任 ---
func (c *CognitoClient) GetUser(...) { /* ... */ }
func (c *CognitoClient) UpdateUser(...) { /* ... */ }

// --- 管理者機能の責任 ---
func (c *CognitoClient) AdminConfirmUser(...) { /* ... */ }
func (c *CognitoClient) AdminDeleteUser(...) { /* ... */ }

// --- 内部実装の責任 ---
func calculateSecretHash(...) { /* ... */ }
func isValidEmail(...) { /* ... */ }

// ✅ 改善後のパッケージ構造
pkg/cognito/
├── auth_service.go      # 認証サービスの責任
├── password_service.go  # パスワードサービスの責任
├── user_service.go      # ユーザーサービスの責任
├── admin_service.go     # 管理者サービスの責任
├── base.go              # 全サービスで共有される共通基盤（クライアント、設定など）
└── manager.go           # 全サービスを統合し、外部に単一の窓口を提供

// ✅ pkg/cognito/base.go
package cognito

// 共通設定
type Config struct { /* ... */ }

// 共通クライアント（各サービスに埋め込まれる）
type BaseClient struct {
    client *cognitoidp.CognitoIdentityProvider
    config *Config
}

// 共通ユーティリティ
func (b *BaseClient) CalculateSecretHash(username string) (string, error) { /* ... */ }

// ✅ pkg/cognito/auth_service.go
package cognito

type AuthService struct {
    *BaseClient // 共通基盤を埋め込む
}

func NewAuthService(baseClient *BaseClient) *AuthService {
    return &AuthService{BaseClient: baseClient}
}

func (s *AuthService) SignUp(req *SignUpRequest) (*SignUpResult, error) {
    // 認証に関するロジックのみを記述
}

func (s *AuthService) SignIn(req *SignInRequest) (*SignInResult, error) {
    // 認証に関するロジックのみを記述
}

// ✅ pkg/cognito/manager.go
package cognito

// CognitoManagerは全てのCognitoサービスを統合管理する
type CognitoManager struct {
    Auth     *AuthService
    Password *PasswordService
    User     *UserService
    Admin    *AdminService
}

func NewCognitoManager(client *cognitoidp.CognitoIdentityProvider, config *Config) *CognitoManager {
    baseClient := NewBaseClient(client, config)
    return &CognitoManager{
        Auth:     NewAuthService(baseClient),
        Password: NewPasswordService(baseClient),
        User:     NewUserService(baseClient),
        Admin:    NewAdminService(baseClient),
    }
}

// ✅ 改善後の利用例
func main() {
    cognitoMgr := cognito.NewCognitoManager(client, config)

    // 認証機能を使いたい場合
    signUpResult, err := cognitoMgr.Auth.SignUp(...)

    // パスワード機能を使いたい場合
    err = cognitoMgr.Password.ChangePassword(...)
}