1. はじめに

これはECサイトのオペレーター管理システムにおける中核となるモデル実装である
システム管理者（system_admin）と店舗管理者（store_admin）の2つの権限を持つユーザーを管理し、セキュアなパスワード管理とデータの整合性を保証する

環境構成

主要な技術スタック：
Go v1.23.3
Gin Web Framework v1.10.0
GORM v1.25.12
PostgreSQL v17.0

2. モデル設計の特徴

2.1 権限管理システム

const (
    RoleSystemAdmin = "system_admin" // システム管理者権限
    RoleStoreAdmin  = "store_admin"  // 店舗管理者権限
)

定数として権限を定義することで、タイプセーフな権限管理を実現している

権限値の誤入力を防止
コード補完による開発効率の向上
権限の一元管理が可能

2.2 詳細なモデル構造

type Operator struct {
    ID           string         `gorm:"type:uuid;primary_key" json:"id"`
    Email        string         `gorm:"unique;not null" json:"email" validate:"required,email"`
    Username     string         `gorm:"not null" json:"username" validate:"required"`
    PasswordHash string         `gorm:"not null" json:"password_hash" validate:"required,password"`
    Role         string         `gorm:"not null" json:"role" validate:"required,oneof=system_admin store_admin"`
    StoreID      string         `gorm:"type:uuid;not null" json:"store_id" validate:"required,uuid"`
    AvatarURL    string         `json:"avatar_url" validate:"omitempty,url"`
    CreatedBy    string         `gorm:"type:uuid;not null" json:"created_by" validate:"required,uuid"`
    UpdatedBy    string         `gorm:"type:uuid" json:"updated_by" validate:"required,uuid"`
    DeletedBy    *string        `gorm:"type:uuid" json:"deleted_by,omitempty" validate:"omitempty,uuid"`
    CreatedAt    time.Time      `gorm:"autoCreateTime;not null" json:"created_at"`
    UpdatedAt    time.Time      `gorm:"autoUpdateTime" json:"updated_at"`
    DeletedAt    gorm.DeletedAt `gorm:"index" json:"deleted_at"`
    Store        Store          `gorm:"foreignKey:StoreID" json:"store"`
}

2.2.1 主要フィールドの詳細解説

識別子管理
- ID: UUIDv7形式を採用し、グローバルでユニークな識別子を保証
- データベース移行やシステム統合時の整合性を確保
認証情報
- Email: ユニーク制約付きで重複登録を防止
- PasswordHash: ハッシュ化されたパスワードを保存し、平文での保存を回避
- Username: システム内での表示名として使用
権限とアクセス制御
- Role: system_admin/store_adminの2値のみを許容
- StoreID: 所属店舗との紐付けによる適切なアクセス制御
- Store: 店舗情報との1対1のリレーション
監査証跡
- CreatedBy/UpdatedBy/DeletedBy: 操作者のトレーサビリティを確保
- CreatedAt/UpdatedAt: 自動タイムスタンプによる操作日時の記録
- DeletedAt: 論理削除のサポート
プロフィール情報
- AvatarURL: オプショナルなプロフィール画像のURL

2.3 バリデーション機能

各フィールドに対して厳密なバリデーションルールを適用：

validate:"required,email"           // メールアドレスの形式検証
validate:"required,password"        // カスタムパスワードルール
validate:"required,oneof=system_admin store_admin"  // 権限値の制限
validate:"required,uuid"            // UUID形式の検証
validate:"omitempty,url"           // URLフォーマットの検証

3. パスワードセキュリティ

3.1 パスワードポリシー

厳格なパスワードポリシーを実装し、セキュリティ要件を満たしている：

const minPasswordLength = 8

func validatePassword(fl validator.FieldLevel) bool {
    password := fl.Field().String()
    if len(password) < minPasswordLength {
        return false
    }
    return hasRequiredCharacterTypes(password)
}

今回のパスワードは以下の要件を全て満たす

最小8文字以上の長さ
大文字（A-Z）を1文字以上含む
小文字（a-z）を1文字以上含む
数字（0-9）を1文字以上含む
記号（!@#$等）を1文字以上含む

3.2 文字種別チェックの実装

func hasRequiredCharacterTypes(password string) bool {
    var (
        hasUpper, hasLower, hasNumber, hasSymbol bool
    )

    for _, char := range password {
        switch {
        case unicode.IsUpper(char):
            hasUpper = true
        case unicode.IsLower(char):
            hasLower = true
        case unicode.IsNumber(char):
            hasNumber = true
        case unicode.IsPunct(char) || unicode.IsSymbol(char):
            hasSymbol = true
        }

        if hasUpper && hasLower && hasNumber && hasSymbol {
            return true
        }
    }
    return false
}

このチェック機能により：

効率的な文字種別判定（1回のループで全条件をチェック）
早期リターンによるパフォーマンス最適化
Unicode対応による多言語サポート

4. データベース連携

4.1 UUIDの自動生成

func (o *Operator) BeforeCreate(tx *gorm.DB) error {
    if o.ID != "" {
        return nil
    }
    id, err := uuid.NewV7()
    if err != nil {
        return err
    }
    o.ID = id.String()
    return nil
}

GORMのフックを利用して：

レコード作成前に自動的にUUIDを生成
既存IDの上書きを防止
エラーハンドリングによる信頼性確保

4.2 データベース制約

gorm:"type:uuid;primary_key": UUIDタイプの主キー
gorm:"unique;not null": ユニーク制約と非NULL制約
gorm:"index": インデックスによる検索最適化
gorm:"foreignKey:StoreID": 外部キー制約による参照整合性の確保

5. 拡張性と保守性

このモデルは以下の特徴により、高い拡張性と保守性を実現しています：

モジュール性
- 各機能が明確に分離され、独立してテスト可能
- カスタムバリデーションの追加が容易
型安全性
- 厳密な型チェックによるバグの早期発見
- コンパイル時のエラーチェック
監査対応
- 完全な操作履歴の追跡が可能
- コンプライアンス要件への対応
セキュリティ
- パスワードの安全な管理
- アクセス制御の適切な実装

6. まとめ

このモデルは、セキュリティ、保守性、拡張性のバランスが取れた実装となっており、実際のプロダクション環境での使用に適している
また、GORMやvalidatorなどの標準的なライブラリを活用することで、信頼性の高いシステムを効率的に構築することができる
今後の開発においても、このモデルを基盤として、さらなる機能拡張や改善を行うことが可能
セキュリティ要件の変更やビジネスルールの追加にも、柔軟に対応できる設計となっている