feat: メール一括送信APIでユーザーID指定による送信をサポート (#259)

* feat: メール一括送信APIでユーザーID指定による送信をサポート

addressesに加えてuserIdsでも送信先を指定可能にし、ユーザーIDから学籍番号を取得して大学メールアドレスを自動生成する機能を追加。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: PR #259 レビュー指摘事項を修正

- SQLでuser_profiles.student_numberをusers.student_numberに修正し不要なJOINを削除
- UserIdsのvalidateタグからuuidを削除（openapi_types.UUIDに適用不可のため）
- sendToAdminのdefault: falseをスキーマに復活

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: newt239

document/bundle.gen.yml

@@ -3211,19 +3211,25 @@ components:
             ja: 備考
     ReqPostMail:
       required:
-        - addresses
         - subject
         - body
       properties:
         addresses:
           type: array
-          minItems: 1
           items:
             type: string
             format: email
           x-oapi-codegen-extra-tags:
-            validate: required
+            validate: 'omitempty,dive,email'
             ja: 送信先アドレス
+        userIds:
+          type: array
+          items:
+            type: string
+            format: uuid
+          x-oapi-codegen-extra-tags:
+            validate: 'omitempty,dive'
+            ja: 送信先ユーザーID
         subject:
           type: string
           x-oapi-codegen-extra-tags:

document/schemas/req_post_mail.yml

@@ -1,17 +1,23 @@
 required:
-  - addresses
   - subject
   - body
 properties:
   addresses:
     type: array
-    minItems: 1
     items:
       type: string
       format: email
     x-oapi-codegen-extra-tags:
-      validate: required
+      validate: omitempty,dive,email
       ja: 送信先アドレス
+  userIds:
+    type: array
+    items:
+      type: string
+      format: uuid
+    x-oapi-codegen-extra-tags:
+      validate: omitempty,dive
+      ja: 送信先ユーザーID
   subject:
     type: string
     x-oapi-codegen-extra-tags:

pkg/api/models.gen.go

@@ -0,0 +1 @@
+SELECT BIN_TO_UUID(users.id) AS user_id, users.student_number FROM users WHERE BIN_TO_UUID(users.id) IN /*userIds*/('00000000-0000-0000-0000-000000000000');