Merge pull request #34 from ForteFibre/feature/email

feat(email): EMAIL-001 メールテンプレート管理機能の実装

Author: f0reachARR

.github/agents/impl.agent.md

@@ -10,7 +10,7 @@ tools:
     "todo",
     "ms-vscode.vscode-websearchforcopilot/websearch",
   ]
-model: "GPT-5.3-Codex"
+model: "GPT-5.4"
 ---
 
 与えられた実行計画に従って、実装を行ってください。TDD に倣って、以下のステップで実施します。
@@ -20,11 +20,12 @@ model: "GPT-5.3-Codex"
 1. 関連するドキュメントやコード、Issueの内容を確認する
 2. 網羅的なテストコードを使い作成する
 3. 開発ポリシーに従って #tool:edit などを使い実装する。変更はツールを利用し、 #tool:execute を使ったsedなどは使用しない。
-4. テストを #tool:execute などを使い実行し、成功を確認する
-5. 成功したらリファクタリングを行う
-6. リファクタリング後もテストが成功することを確認する
-7. 必要に応じてドキュメントを更新する
-8. 実装内容を説明する
+4. ある程度の編集粒度で、Gitにコミットする
+5. テストを #tool:execute などを使い実行し、成功を確認する
+6. 成功したらリファクタリングを行う
+7. リファクタリング後もテストが成功することを確認する
+8. 内容について、特筆すべき情報がある場合ドキュメントを作成・更新する
+9. 実装内容を説明する
 
 ## 注意事項
 

.github/agents/issue.agent.md

@@ -10,7 +10,7 @@ tools:
     "web",
     "ms-vscode.vscode-websearchforcopilot/websearch",
   ]
-model: "GPT-5.3-Codex"
+model: "GPT-5.4"
 ---
 
 あなたは、ユーザーが入力する要望 (issue, bug report, feature request など) をもとに、イシューを管理するエージェントです。以下のステップに基づき、要件と仕様の解像度を高めながら、イシューを管理してください。
@@ -22,18 +22,17 @@ model: "GPT-5.3-Codex"
 3. 現在のローカル レポジトリ状況を確認する
 4. 現在の GitHub Issues の状況を確認する
 5. #tool:ms-vscode.vscode-websearchforcopilot/websearch でウェブ検索を行い、要件および要件に必要な周辺知識の理解を深める
-6. 要件と調査結果に基づき、十分な情報を含めたIssue を作成/更新する
+6. 要件と調査結果に基づき、十分な情報を含めたIssue を1つ以上作成/更新する
 7. 作成された Issue に対して批判的にレビューを行う
 8. レビュー内容に基づき、Issue を改善する
-9. `gh`を使用して Issue を作成し、ユーザーに作成した Issue とその内容を報告する
+9. `gh`を使用して Issue を作成し、ユーザーに作成したIssueリストとその内容を報告する
+
+## 注意事項
+
+- Issue の作成においては、巨大な要件で1つのIssueを作成するのではなく、必要に応じて複数の Issue に分割することを検討してください
+- 既存の Issue と重複する内容がないか確認してください。重複する内容がある場合は、既存の Issue を更新する形で対応してください
 
 ## ツール
 
 - #tool:ms-vscode.vscode-websearchforcopilot/websearch: ウェブ検索
 - `gh`: GitHub リポジトリの操作
-
-## ドキュメント
-
-- `docs/`
-- `README.md`
-- `CONTRIBUTING.md`

.github/agents/orchestrator.agent.md

@@ -19,15 +19,14 @@ model: "GPT-5.3-Codex"
 
 ## 手順 (#tool:todo)
 
-要件に応じて、以下のステップを要件を満たすまで繰り返してください。
-
-1. #tool:agent/runSubagent で issue エージェントを呼び出し、イシューを作成する
-2. #tool:agent/runSubagent で plan エージェントを呼び出し、実装計画を立てる
-3. #tool:agent/runSubagent で impl エージェントを呼び出し、実装を行う
-4. #tool:agent/runSubagent で review エージェントを呼び出し、コードレビューと修正を行う
-5. 残っている要件に応じてステップ 3 と 4 を繰り返す
-6. #tool:agent/runSubagent で pr エージェントを呼び出し、プルリクエストを作成する
-7. 実装内容とプルリクエストのリンクをユーザーに通知する
+1. #tool:agent/runSubagent で issue エージェントを呼び出し、イシューを1つ以上作成する
+2. 作成したイシュー1つずつについて、以下を行い、実装を進める。エージェントにはissueのIDを渡して、イシューの内容を伝える。
+   - #tool:agent/runSubagent で plan エージェントを呼び出し、実装計画を立てる
+   - #tool:agent/runSubagent で impl エージェントを呼び出し、実装を行う
+   - #tool:agent/runSubagent で review エージェントを呼び出し、コードレビューと修正を行う
+   - レビューにてプルリクエストが作成OKとなるまで、上記の実装とレビューのサイクルを回す
+   - #tool:agent/runSubagent で pr エージェントを呼び出し、プルリクエストを作成する
+3. 実装内容とプルリクエストのリンクをユーザーに通知する
 
 ## 注意事項
 

.github/agents/plan.agent.md

@@ -9,7 +9,7 @@ tools:
     "web",
     "ms-vscode.vscode-websearchforcopilot/websearch",
   ]
-model: "GPT-5.3-Codex"
+model: "GPT-5.4"
 ---
 
 与えられたイシューの実装計画を立ててください。
@@ -18,9 +18,10 @@ model: "GPT-5.3-Codex"
 
 1. 現在のレポジトリ状況を確認し、リモートとの同期を行う
 2. 指定されたイシューの内容を確認する。イシューが存在しない場合は、処理を中止しユーザーに通知する。
-3. レポジトリ (コード、ドキュメント) を確認する
+3. レポジトリ (仕様、コード、ドキュメント) を確認する
 4. ウェブ検索で情報を収集する
-5. 実装計画をユーザーに提示する
+5. 技術的制約により仕様を変更する場合、仕様ファイル(`spec-*.md`)に反映する
+6. 実装計画をユーザーに提示する
 
 ## ツール
 
@@ -29,9 +30,7 @@ model: "GPT-5.3-Codex"
 
 ## ドキュメント
 
-- `docs/`
-- `README.md`
-- `CONTRIBUTING.md`
+- `spec-*.md`
 
 ## ブランチ戦略
 

.github/agents/pr.agent.md

@@ -9,7 +9,7 @@ tools:
     "web",
     "ms-vscode.vscode-websearchforcopilot/websearch",
   ]
-model: "GPT-5.3-Codex"
+model: "Claude Sonnet 4.6"
 ---
 
 与えられたイシューと実装に対する、プルリクエストを作成してください。

.github/agents/review.agent.md

@@ -1,5 +1,5 @@
 ---
-description: 実装内容をレビューし、建設的なフィードバックを提供します。
+description: Issueベースで実装内容をレビューし、建設的なフィードバックを提供します。
 tools:
   [
     "execute",
@@ -9,20 +9,22 @@ tools:
     "web",
     "ms-vscode.vscode-websearchforcopilot/websearch",
   ]
-model: "GPT-5.3-Codex"
+model: "GPT-5.4"
 ---
 
 実装内容をレビューしてください。批判的に評価を行い、発言についての中立的なレビューを提供してください。新たな情報を検索、分析することを推奨します。あくまでレビューの提供までがあなたの役割です。
 
 ## 手順 (#tool:todo)
 
+1. 与えられた課題が何であるかをIssueから理解する
 1. 網羅的に情報を収集する
    - レポジトリの分析
    - ドキュメント群の分析
    - ウェブ検索 (#tool:ms-vscode.vscode-websearchforcopilot/websearch) によるベストプラクティス、pitfalls、代替案の調査
    - 要件の確認と理解
-2. 収集した情報をもとに、実装内容を批判的に評価する (正確性、完全性、一貫性、正当性、妥当性、関連性、明確性、客観性、バイアスの有無、可読性、保守性、テストが十分であるかなどの観点)
-3. 改善点や懸念点があれば指摘し、アクションプランを示す
+   - spec-*.mdに含まれる仕様の確認
+1. 収集した情報をもとに、実装内容を批判的に評価する (正確性、完全性、一貫性、正当性、妥当性、関連性、明確性、客観性、バイアスの有無、可読性、保守性、テストが十分であるかなどの観点)
+1. 改善点や懸念点があれば指摘し、アクションプランを示す
 
 ## ツール
 

apps/backend/package.json

@@ -25,11 +25,13 @@
     "better-auth": "^1.5.6",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.9",
+    "nodemailer": "^8.0.5",
     "pg": "^8.13.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
+    "@types/nodemailer": "^8.0.0",
     "@types/pg": "^8.20.0",
     "drizzle-kit": "^0.31.10",
     "tsx": "^4.19.3"

apps/backend/src/__tests__/app.issue11.integration.test.ts

@@ -1211,10 +1211,13 @@ describe('issue #11 api integration', () => {
     expect(approveRes.status).toBe(200);
     expect(mockSendEmail).toHaveBeenCalledWith({
       to: 'owner@approve.example',
-      subject: 'Approve University の代表者招待',
-      html: expect.stringMatching(
-        /^招待リンク: invitation:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/,
-      ),
+      template: 'university-owner-invitation-link',
+      payload: {
+        universityName: 'Approve University',
+        invitationLink: expect.stringMatching(
+          /^http:\/\/localhost:3000\/invite\/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/,
+        ),
+      },
     });
     const approveJson = (await approveRes.json()) as {
       data: { status: string; createdOrganizationId: string };

apps/backend/src/auth.ts

@@ -4,6 +4,7 @@ import { organization } from 'better-auth/plugins';
 import { db } from './db/index.js';
 import * as schema from './db/schema.js';
 import { env } from './lib/config.js';
+import { buildInvitationLink } from './lib/invitation-link.js';
 import { verifyPassword } from './lib/password.js';
 import { emailService } from './services/email/index.js';
 
@@ -27,18 +28,50 @@ export const auth = betterAuth({
   trustedOrigins: env.CORS_ALLOWED_ORIGINS,
   emailAndPassword: {
     enabled: true,
+    requireEmailVerification: true,
+    autoSignIn: false,
+    async sendResetPassword({ user, url }) {
+      await emailService.sendEmail({
+        to: user.email,
+        template: 'password-reset',
+        payload: {
+          userName: user.name,
+          resetLink: url,
+        },
+      });
+    },
+    revokeSessionsOnPasswordReset: true,
     password: {
       verify: verifyPassword,
     },
   },
+  emailVerification: {
+    sendOnSignUp: true,
+    sendOnSignIn: true,
+    autoSignInAfterVerification: true,
+    async sendVerificationEmail({ user, url }) {
+      await emailService.sendEmail({
+        to: user.email,
+        template: 'email-verification',
+        payload: {
+          userName: user.name,
+          verificationLink: url,
+        },
+      });
+    },
+  },
   plugins: [
     organization({
       async sendInvitationEmail(data) {
-        const inviteLink = `${env.APP_URL}/invite/${data.id}`;
+        const inviteLink = buildInvitationLink(data.id);
         await emailService.sendEmail({
           to: data.email,
-          subject: `${data.organization.name} への招待`,
-          html: `${data.inviter.user.name} さんが ${data.organization.name} へ招待しました: ${inviteLink}`,
+          template: 'organization-invitation',
+          payload: {
+            organizationName: data.organization.name,
+            inviterName: data.inviter.user.name,
+            inviteLink,
+          },
         });
       },
     }),

apps/backend/src/lib/config.ts

@@ -1,4 +1,4 @@
-type Env = {
+export type Env = {
   DATABASE_URL: string;
   PORT: number;
   BETTER_AUTH_SECRET: string;
@@ -12,9 +12,16 @@ type Env = {
   S3_BUCKET_RULES: string;
   S3_BUCKET_SUBMISSIONS: string;
   S3_FORCE_PATH_STYLE: boolean;
-  EMAIL_PROVIDER: 'console' | 'sendgrid';
+  EMAIL_PROVIDER: 'console' | 'sendgrid' | 'smtp';
   SENDGRID_API_KEY?: string;
   SENDGRID_FROM: string;
+  SMTP_HOST?: string;
+  SMTP_PORT: number;
+  SMTP_USER?: string;
+  SMTP_PASS?: string;
+  SMTP_FROM?: string;
+  SMTP_SECURE: boolean;
+  SMTP_REQUIRE_TLS: boolean;
 };
 
 const toBool = (value: string | undefined, fallback: boolean): boolean => {
@@ -51,7 +58,17 @@ export const env: Env = {
   S3_BUCKET_RULES: process.env.S3_BUCKET_RULES ?? 'robocon-rules',
   S3_BUCKET_SUBMISSIONS: process.env.S3_BUCKET_SUBMISSIONS ?? 'robocon-submissions',
   S3_FORCE_PATH_STYLE: toBool(process.env.S3_FORCE_PATH_STYLE, true),
-  EMAIL_PROVIDER: process.env.EMAIL_PROVIDER === 'sendgrid' ? 'sendgrid' : 'console',
+  EMAIL_PROVIDER:
+    process.env.EMAIL_PROVIDER === 'sendgrid' || process.env.EMAIL_PROVIDER === 'smtp'
+      ? process.env.EMAIL_PROVIDER
+      : 'console',
   SENDGRID_API_KEY: process.env.SENDGRID_API_KEY,
   SENDGRID_FROM: process.env.SENDGRID_FROM ?? 'noreply@example.com',
+  SMTP_HOST: process.env.SMTP_HOST,
+  SMTP_PORT: Number(process.env.SMTP_PORT ?? 587),
+  SMTP_USER: process.env.SMTP_USER,
+  SMTP_PASS: process.env.SMTP_PASS,
+  SMTP_FROM: process.env.SMTP_FROM,
+  SMTP_SECURE: toBool(process.env.SMTP_SECURE, false),
+  SMTP_REQUIRE_TLS: toBool(process.env.SMTP_REQUIRE_TLS, false),
 };